Valitse siirtotapa harkiten
Paikallisella stdio-palvelimella ja etäisellä HTTP-palvelulla on erilaiset käyttöönoton tarpeet. Käytä tuettua etäsiirtoa, TLS ja todennettua reittiä. Tarkista asiakas- ja palvelinversiot sen sijaan, että olettaisit jokaisen toteutuksen tukevan samoja ominaisuuksia.
Käsittele jokaista työkalua kuin API
Vahvista argumentit, valvo käyttäjäkohtaista valtuutusta ja rajoita resursseja. Älä tarjoa mielivaltaista komentotulkin suoritusta mukavuustyökaluna. Rajoita lähtevät kohteet, kun työkalu hakee URL-osoitteita, ja pidä salaisuudet poissa kuvauksista ja vastauksista.
Pidä henkilöllisyyden kerääminen oikeasuhtaisena
Ilman KYC:tä toimiva palveluntarjoaja voi minimoida rekisteröitymistiedot, mutta MCP -palvelu voi silti tarvita omat käyttäjänsä, istunnon suojauksen ja väärinkäytön torjunnan. Selitä, mitä se lokittaa, ja vältä työkalujen syötteiden säilyttämistä ilman määriteltyä tarkoitusta.
Ota käyttöön toiminnallisen selkeyden vuoksi
Aja omistetun käyttäjän alla, käytä terveystarkastuksia, rajaa pyyntöjen kestoa ja pidä käänteisvälityspalvelimen puskurointi ja aikakatkaisut protokollan kanssa yhteensopivina. Testaa todennus, peruutus, yhteyden katkeamiset ja uudelleenyritykset ennen kirjoitusoikeuksien myöntämistä.
Yhdenmukaista todennus tuetun protokollan kanssa
HTTP-pohjaisessa MCP-käyttöönotossa tarkista protokollan nykyiset valtuutusvaatimukset ja asiakkaan tuettu versio. OAuth-pohjainen resurssien käyttö edellyttää tunnuksen kohdeyleisöä, löytämistä ja laajuutta, ei pelkästään salasanaa etusivulla. Käytä HTTPS, validoi tunnukset aiottua resurssia varten ja pidä bearer-tunnistetiedot poissa kyselymerkkijonoista. stdio-palvelin käyttää erilaista paikallista tunnistetietojen rajaa.
- Testaa todentamaton pyyntö
- Testaa todennettua pyyntöä sen laajuuden ulkopuolella
- Peruuta tunnus ja varmista, että se lakkaa toimimasta
Virallinen dokumentaatio: MCP-valtuutusmäärittely
Julkaise rajattu ensimmäinen työkalusarja
Aloita vain luku -työkaluilla, jotka palauttavat rajatun määrän dataa. Lisää tiedostokirjoitukset, palvelimen elinkaaritoiminnot tai ulkoiset viestit vasta, kun niiden käyttöoikeudet ja toistokäyttäytyminen on ymmärretty. Käsittele palautettuja verkkosivuja ja asiakirjoja epäluotettavana syötteenä; ne eivät saa hiljaisesti laajentaa työkalupalvelimen valtuuksia.
Kiinnitä protokollan toiminta ennen välityssääntöjen kirjoittamista
Kirjaa sekä palvelimen SDK -julkaisu että MCP -versio, jota asiakas käyttää. 2026-07-28 Streamable HTTP -versiossa pyynnöt käyttävät POST-päätepistettä; vanhemmat esimerkit, jotka nojaavat protokollaistuntoihin tai erilliseen GET-virtaan, ovat eri versio. Älä poista näennäistä yhteensopivuusvaatimusta ennen kuin tiedät, mitä asiakasta tuet. Käänteisen välityspalvelimen on säilytettävä vaaditut otsikot, HTTP -tila ja vastauksen suoratoistokäyttäytyminen kyseiselle versiolle.
- Aloita vain luku -työkalulla loopback-kuuntelijassa ja aseta sitten aiottu HTTPS/todennusraja sen eteen.
- Testaa julkisen välityspalvelimen kautta normaali tulos, suoratoistotulos, aikakatkaisu ja yhteyden katkaissut asiakas.
- Vahvista sallitut Origin-arvot siirtokerroksen edellyttämällä tavalla; Origin-tarkistus ei korvaa kutsujan todennusta.
- Jos tapahtumat saapuvat vasta lopussa, tarkista välityspalvelimen puskurointi ja aikakatkaisukäyttäytyminen ennen työkalukoodin muuttamista.
Virallinen dokumentaatio: MCP 2026-07-28: Suoratoistettava HTTP
Testaa valtuutusvirheet yhtä huolellisesti kuin onnistumiset
OAuth-suojatussa HTTP-käytössä MCP-palvelin on suojattu resurssi. Testaa metatietojen haku, odotettu myöntäjä ja tokenin kohdeyleisö sekä tiettyyn toimintoon tarvittavat käyttöoikeusalueet. Pidä valtuutustoken poissa URL-kyselymerkkijonoista äläkä välitä sitä muuttamattomana asiaankuulumattomalle alavirran palvelulle. Asiakkaalle näkyvässä todennusvirheessä on säilytettävä asianmukainen HTTP-haaste, jotta asiakas voi palautua tuetun toimintonsa kautta.
- Ei tokenia tai vanhentunut token: suojattu päätepiste hylkää pääsyn sen sijaan, että palauttaisi yksityisiä työkalutietoja.
- Kelvollinen tunnus, mutta riittämättömät oikeudet: pyydetty resurssi pysyy saavuttamattomana.
- Toiselle yleisölle tarkoitettu token: hylkää se, vaikka sen allekirjoitus olisi muuten kelvollinen.
- Odottamaton ulkoinen URL tai tiedostopolku: vahvista työkalun valtuudet ennen noutoa tai kirjoitusta.
- Lokit ja virhejäljet: säilytä toimintotunniste ja lopputulos poistamalla tokenit ja yksityiset työkalusyötteet.
Virallinen dokumentaatio: MCP 2026-07-28: HTTP-valtuutus · MCP: turvallisuuden parhaat käytännöt