Vælg transporten bevidst
En lokal stdio-server og en ekstern HTTP-tjeneste har forskellige udrulningsbehov. Brug en understøttet ekstern transport, TLS og en autentificeret rute. Kontroller klient- og serverversionerne i stedet for at antage, at alle implementeringer understøtter de samme funktioner.
Behandl ethvert værktøj som en API
Validér argumenter, håndhæv brugerspecifik autorisation og begræns ressourcer. Eksponér ikke vilkårlig shell-udførelse som et bekvemmelighedsværktøj. Begræns udgående destinationer, hvor et værktøj henter URLer, og hold hemmeligheder ude af beskrivelser og svar.
Hold identitetsindsamlingen proportional
En host uden KYC kan minimere udbyderens tilmeldingsdata, men MCP-tjenesten kan stadig have brug for sine egne brugere, sessionssikkerhed og misbrugskontroller. Forklar, hvad den logger, og undgå at opbevare værktøjsinput uden et defineret formål.
Udrul for operationel klarhed
Kør under en dedikeret bruger, brug sundhedstjek, begræns anmodningstider og hold reverse proxyens buffering og timeouts kompatible med protokollen. Test godkendelse, tilbagekaldelse, afbrydelser og genforsøg, før du giver skriveadgang.
Tilpas godkendelse til den understøttede protokol
For en HTTP-baseret MCP-udrulning skal du gennemgå protokollens aktuelle autorisationskrav og klientens understøttede version. OAuth-baseret ressourceadgang involverer token-audience, discovery og scope, ikke blot en adgangskode på hjemmesiden. Brug HTTPS, validér tokens for den tilsigtede ressource, og hold bearer-legitimationsoplysninger ude af query-strenge. En stdio-server bruger en anden lokal legitimationsgrænse.
- Test en uautentificeret anmodning
- Test en godkendt anmodning uden for dens anvendelsesområde
- Tilbagekald en legitimationsoplysning og bekræft, at den holder op med at virke
Officiel dokumentation: MCP autorisationsspecifikation
Udgiv et begrænset første værktøjssæt
Start med skrivebeskyttede værktøjer, der returnerer en afgrænset mængde data. Tilføj kun filskrivninger, serverlivscyklushandlinger eller eksterne beskeder, når deres tilladelser og duplikatadfærd er forstået. Behandl returnerede websider og dokumenter som ubetroet input; de må ikke i det skjulte udvide værktøjsserverens beføjelser.
Fastlå protokoladfærden, før du skriver proxyregler
Notér både serverens SDK-udgivelse og den MCP-revision, som klienten vil bruge. I 2026-07-28 Streamable HTTP-revisionen bruger anmodninger et POST-endpoint; ældre eksempler, der er afhængige af protokolsessioner eller en selvstændig GET-stream, er en anden revision. Fjern ikke et tilsyneladende kompatibilitetskrav, før du ved, hvilken klient du understøtter. En reverse proxy skal bevare de nødvendige headers, HTTP-status og respons-streamingadfærd for den pågældende version.
- Start med et skrivebeskyttet værktøj på en loopback-listener, og placer derefter den tilsigtede HTTPS/autentificeringsgrænse foran det.
- Test et normalt resultat, et streamingresultat, en timeout og en afbrudt klient gennem den offentlige proxy.
- Valider tilladte Origin-værdier som krævet af transporten; et Origin-tjek er ikke en erstatning for at autentificere den kaldende part.
- Hvis hændelser først ankommer til sidst, skal du undersøge proxy-buffering og timeout-adfærd, før du ændrer værktøjskoden.
Officiel dokumentation: MCP 2026-07-28: Streamable HTTP
Test autorisationsfejl lige så bevidst som succes
For OAuth-beskyttet HTTP-adgang er MCP-serveren en beskyttet ressource. Test metadata-discovery, den forventede issuer og token-audience samt de scopes, der kræves til en bestemt operation. Hold autorisationstokenet ude af URL-query-strenge, og videresend det aldrig uændret til en urelateret downstream-tjeneste. En klientvendt autentificeringsfejl skal bevare den relevante HTTP-challenge, så klienten kan gendanne via sin understøttede flow.
- Intet token eller et udløbet token: det beskyttede endepunkt afviser adgang i stedet for at returnere private værktøjsdata.
- Gyldigt token med utilstrækkelig tilladelse: den anmodede ressource forbliver utilgængelig.
- Token til et andet publikum: afvis det, selv om signaturen ellers er gyldig.
- Uventet ekstern URL eller filsti: valider mod værktøjets autoritet, før du henter eller skriver.
- Logfiler og fejlspor: Behold en operationsidentifikator og resultatet, mens tokens og private værktøjsinput fjernes.
Officiel dokumentation: MCP 2026-07-28: HTTP-autorisation · MCP: bedste sikkerhedspraksis