Käytännöt
Miten avaimet ja rajat toimivat MCP-palvelimessa, mihin voit luottaa, miten muutoksista ilmoitetaan ja mitä työkalukutsuistasi kirjataan.
Palvelin hyväksyy vain MCP-avaimet, jotka luodaan MCP-konsolissa ja lähetetään otsakkeessa Authorization: Bearer YOUR_API_KEY tai X-API-Key: YOUR_API_KEY. Data API- ja widget-avaimet hylätään vastauksella 401. Avaimen luominen tai kierrättäminen vaatii vahvistetun sähköpostiosoitteen; avain näytetään vain kerran, se voi vanhentua 30, 90 tai 365 päivän kuluttua tai ei koskaan, ja Free, Starter ja Pro sallivat 2, 5 ja 10 voimassa olevaa avainta.
Jokaisella suunnitelmalla on kuukausittainen työkalukutsujen määrä – Free 2 500, Starter 50 000, Pro 250 000 – ja purskeraja, joka on 30, 60 tai 120 pyyntöä minuutissa. Purskeraja laskee jokaisen pyynnön osoitteeseen /mcp; kuukausikvootti laskee vain työkalukutsut, myös virheeseen päättyvät kutsut, kuten tuntemattoman kolikon haun. Kuukausi on Free-suunnitelmassa UTC-ajan kalenterikuukausi, ja maksullisissa suunnitelmissa se alkaa uusimispäivästäsi.
Kuukausikvootin ylittyessä työkalu vastaa rate_limited (HTTP 429) ja kertoo rajan, käytön ja nollautumisajan; purskerajan ylittyessä itse pyyntö saa HTTP-vastauksen 429. Työkalu, joka ei sisälly suunnitelmaasi, vastaa plan_required ja nimeää sen avaavan suunnitelman.
Sopimuksen muodostavat työkalujen nimet, niiden syötteet ja tulokset. Kaikki työkalut ovat vain luettavia: mikään niistä ei voi muuttaa tiliäsi tai mitään dataa. Jokainen työkalu vastaa Data API v1 -rajapinnasta, joten tulokset noudattavat sen sääntöjä – hinnat, kurssit ja määrät desimaalimerkkijonoina sekä sama validointi – ja ne palautetaan JSON-tekstinä sekä kenttänä structuredContent. Virheet ovat muotoa code (HTTP status): message.
Palvelin ilmoittaa itsensä nimellä Bitculator 1.0.0 kentässä serverInfo ja tiedostossa /.well-known/mcp/server-card.json, ja se vastaa asiakkaan pyytämällä MCP-protokollaversiolla väliltä 2024-11-05–2025-11-25.
Näitä ei koskaan tapahdu ilman ennakkoilmoitusta:
Näitä voi tapahtua milloin tahansa, ja ne kirjataan muutoslokiin:
Poistettavaksi ajoitetusta työkalusta tai syötteestä ilmoitetaan muutoslokissa, ja sen kuvaus kertoo siitä samasta päivästä alkaen. Poisto tapahtuu aikaisintaan kuusi kuukautta ilmoituksen jälkeen.
Jokainen työkalukutsu kirjataan tilisi, avaimen, työkalun datapäätepisteen ja laskutusjakson kanssa sekä päivittäisenä määränä, jotta kvoottiasi voidaan valvoa ja käyttösi näyttää. Näitä tietueita säilytetään 12 kuukautta. Itse JSON-RPC-viestejä ja asiakasohjelmasi tietoja ei tallenneta.
Kun työkalu epäonnistuu palvelinvirheeseen, osa sisäisestä vastauksesta kirjoitetaan palvelinlokiin, jotta virhe voidaan korjata.
Jos uskot löytäneesi tietoturva-aukon sivustolta bitculator.com, Data API -rajapinnasta, MCP-palvelimesta tai SDK-kirjastoista, lähetä sähköpostia osoitteeseen contact@bitculator.com ja kerro mikä osoite tai päätepiste on kyseessä, miten se toistetaan ja mikä vaikutus siitä seuraa. Vastaamme kolmen työpäivän kuluessa.
Pidä ilmoitus yksityisenä, kunnes vika on korjattu, älä käsittele tai muuta dataa joka ei ole sinun, äläkä aja palvelunestohyökkäyksiä tai automaattista skannausta tuotantoa vastaan. Vilpittömässä mielessä näiden ehtojen mukaan tehdyistä ilmoituksista ei seuraa oikeustoimia. Maksettua palkkio-ohjelmaa ei ole; maininta annetaan pyynnöstä.
Sama yhteystieto on julkaistu koneluettavasti osoitteessa /.well-known/security.txt (RFC 9116).
Komponenttien tila reaaliajassa, avoimet häiriöt ja viimeisten 30 päivän katkokset löytyvät tilasivulta ja osoitteesta /status.json.