Pravila

Pravila MCP servera

Kako funkcionišu ključevi i ograničenja na MCP serveru, na šta možete da se oslonite, kako se objavljuju promene i šta se beleži o vašim pozivima alatki.

Ključevi

Server prihvata samo MCP ključeve, kreirane u MCP konzoli i poslate kao Authorization: Bearer YOUR_API_KEY ili X-API-Key: YOUR_API_KEY. Ključevi za Data API i za vidžete odbijaju se sa 401. Za kreiranje ili rotaciju ključa potrebna je potvrđena adresa e-pošte; ključ se prikazuje jednom, može da istekne posle 30, 90 ili 365 dana ili nikada, a Free, Starter i Pro dozvoljavaju 2, 5 i 10 aktivnih ključeva.

Ograničenja i pravična upotreba

Svaki plan ima mesečni broj poziva alatki - Free 2.500, Starter 50.000, Pro 250.000 - i minutni limit od 30, 60 ili 120 zahteva u minuti. Minutni limit broji svaki zahtev ka /mcp; mesečna kvota broji samo pozive alatki, uključujući pozive koji se završe greškom, na primer zbog nepoznate kovanice. Na Free planu mesec je kalendarski mesec po UTC-u, a na plaćenim planovima računa se od vašeg dana obnove.

Preko mesečne kvote alatka odgovara sa rate_limited (HTTP 429), uz ograničenje, potrošnju i vreme resetovanja; preko minutnog limita HTTP 429 dobija sam zahtev. Alatka koju vaš plan ne uključuje odgovara sa plan_required i navodi plan koji je otključava.

Na šta možete da se oslonite

Ugovor čine imena alatki, njihovi ulazi i njihovi rezultati. Sve alatke su samo za čitanje: nijedna ne može da promeni vaš nalog ni bilo kakve podatke. Svaka alatka odgovara iz Data API-ja v1, pa rezultati prate njegova pravila - cene, kursevi i ponude kao decimalni stringovi i ista validacija - i stižu kao JSON tekst plus structuredContent. Greške glase code (HTTP status): message.

Server se predstavlja kao Bitculator 1.0.0 u serverInfo i u /.well-known/mcp/server-card.json i odgovara u verziji MCP protokola koju klijent zatraži, od 2024-11-05 do 2025-11-25.

Šta se računa kao nekompatibilna promena

Ovo se nikada ne dešava bez prethodne najave:

• Uklanjanje ili preimenovanje alatke ili nekog od njenih ulaza, ili pretvaranje opcionog ulaza u obavezan.
• Uklanjanje polja rezultata ili promena njegovog tipa ili značenja.
• Smanjenje broja poziva alatki ili minutnog limita koji plan već ima.

Ovo može da se dogodi u svakom trenutku i beleži se u dnevniku promena:

• Nove alatke, novi opcioni ulazi i nova polja rezultata.
• Jasniji opisi alatki i uputstva servera.
• Novi kodovi grešaka za nove situacije - oslanjajte se na kod, nikada na poruku.
• Veća ograničenja i kvote.

Ukidanje

Alatka ili ulaz zakazan za uklanjanje objavljuje se u dnevniku promena, a od tog dana to navodi i njegov opis. Uklanjanje se dešava najranije šest meseci posle objave.

Šta se beleži

Svaki poziv alatke beleži se sa vašim nalogom, ključem, krajnjom tačkom podataka alatke i obračunskim periodom, plus dnevni broj, radi sprovođenja vaše kvote i prikaza vašeg korišćenja. Ovi zapisi se čuvaju 12 meseci. Same JSON-RPC poruke i podaci o vašem klijentu se ne čuvaju.

Kada alatka ne uspe zbog serverske greške, deo internog odgovora upisuje se u serverski log kako bi greška mogla da se ispravi.

Odgovorno prijavljivanje

Ako mislite da ste našli bezbednosnu ranjivost na bitculator.com, u Data API-ju, na MCP serveru ili u SDK-ovima, pišite na contact@bitculator.com i navedite pogođeni URL ili krajnju tačku, korake za reprodukciju i uticaj koji vidite. Odgovor dobijate u roku od tri radna dana.

Molimo da prijava ostane privatna dok problem ne bude ispravljen, da ne pristupate podacima koji nisu vaši i da ih ne menjate, i da na produkciji ne izvodite napade uskraćivanjem usluge niti automatsko skeniranje. Prijave u dobroj veri pod ovim uslovima neće biti dočekane pravnim postupkom. Ne postoji plaćeni program nagrada; zasluga se navodi na zahtev.

Isti kontakt objavljen je i mašinski čitljivo na /.well-known/security.txt (RFC 9116).

Status i incidenti

Status komponenti uživo, otvoreni incidenti i prekidi rada u poslednjih 30 dana nalaze se na stranici statusa i na /status.json.