MCP-integration: bygg ett testbart kontrakt mellan AI och verktyg

Den ursprungliga specifikationen beskriver en värdapplikation, klienter inne i denna och servrar som exponerar funktioner genom JSON-RPC. Servrar kan erbjuda resurser, promptar och verktyg. En resurs ger kontext medan ett verktyg exponerar en operation. Att blanda samman begreppen försvårar granskningen eftersom dokumentläsning och ändring av register har olika konsekvenser när något går fel. 1

Anthropics lansering beskrev MCP som ett sätt att minska behovet av specialbyggda anslutningar. Det är ett standardiseringsmål, inte bevis för identiskt beteende hos alla servrar. 2 Håll protokollgränsen skild från verksamhetens API-kontrakt. Ett korrekt MCP-meddelande kan fortfarande innehålla ett verksamhetsfel, exempelvis en otillgänglig vara eller en kundpost som användaren saknar rätt att läsa.

Tänk på en integration med servicedesk. Ett uppslagsverktyg tar emot ett ärendenummer och lämnar ett litet strukturerat svar. Ett separat ändringsverktyg accepterar uttryckligen tillåtna fält. Detta är lättare att testa än en generell operation som tar fria instruktioner och har bred databasåtkomst. Modellen ska välja definierade funktioner, inte själv hitta på reglerna för validering.

Dokumentera obligatoriska indata, tillåtna värden, svarens struktur och verksamhetsfel. Skilj mellan tomt resultat och nekad begäran. Bevara identifierare så att värdapplikationen kan visa informationens ursprung. Företagets kunskap handlar om nyttan med ansluten information. MCP-integrationen behöver den snävare garantin att varje returnerat fält har en känd betydelse och ett behörighetskontrollerat ursprung.

En server översätter ofta modellens val av åtgärd till ett befintligt API-anrop. Översättningen måste bevara den agerande användarens rättigheter. En gemensam tjänsteidentitet kan få demonstrationen att fungera men samtidigt ge alla bredare åtkomst. Verksamhetssystemet måste därför kontrollera behörighet oberoende av vad modellen säger att användaren ville göra eller vad verktygsbeskrivningen anger som möjligt.

Skilj lokala processers inloggningsuppgifter från autentisering mot fjärrtjänster. Kopiera inte en lösning för fjärrauktorisering till en lokal transport utan att kontrollera aktuell protokollversion och hotbild. Auktoriseringsdetaljer har utvecklats efter den första specifikationen. Texten från november 2024 presenteras därför inte som fullständig auktoriseringsvägledning för en integration som sätts i drift under 2026.

Registrera serverversion, SDK-version, transport och förhandlade funktioner i integrationsförteckningen. Enbart protokollets namn räcker inte för reproducerbarhet. Testa uppstart, upptäckt av funktioner, felaktiga indata, saknade fält och svar som är större än värdapplikationen rimligen kan hantera. En uppgradering av servern bör utlösa kontraktstester innan nya funktioner görs tillgängliga för användare i produktion.

Behåll testdata för både godkända och avvisade operationer. Kontrollera att strukturerade svar är stabila när underliggande API:er ändras och att felmeddelanden inte avslöjar hemligheter. Övergripande regler om mandat och godkännanden hör till agentsäkerhet. Bidraget här är en upprepningsbar kompatibilitetskontroll som upptäcker ändringar innan modellen börjar använda ett förändrat kontrakt.

En timeout visar inte om verksamhetssystemet genomförde åtgärden. Vid skrivningar bör en operationsidentifierare användas där tjänsten stöder detta, följt av avstämning innan ett nytt försök görs. Det är ett integrationsmönster, inte ett påstående om att MCP garanterar exakt en exekvering. Även läsverktyg behöver gränser eftersom fria frågor kan överbelasta databaser eller lämna ut onödiga personuppgifter.

Ge värdapplikationen användbara felkategorier i stället för ett allmänt formulerat svar som liknar framgång. Skilj ogiltiga indata, otillgänglig tjänst, nekad åtkomst och oklar genomförandestatus åt. Applikationen kan då begära rättning, försöka igen inom givna gränser eller eskalera. AI-säkerhet är relevant, men tydliga felbetydelser gör kontrollerad återhämtning tekniskt möjlig.

Börja med ett enda läsverktyg och representativa användare. Verifiera att tillåtna poster kan nås, förbjudna poster förblir otillgängliga och saknade poster ger entydiga besked. Lägg till en återställbar skrivning först när identitetsöverföring och felhantering fungerar. Logga tillräckliga metadata för felsökning utan att som standard behålla hela känsliga svarsinnehåll efter att uppgiften avslutats.

Godkännandet bör omfatta omstart av värdapplikationen, serveruppgradering, timeout och ändrad behörighet under en session. Utse ansvariga på båda sidor av anslutningen. Rådgivning kan hjälpa till att prioritera integrationsförteckningen. Lärdomen från lanseringen 2024 är inte bara att verktyg blev lättare att ansluta. Kontrakten behöver fortfarande konstrueras, testas och förvaltas med tydligt ägarskap.