Ansluta till Model Context Protocol-servrar (förhandsversion) (klassisk)

Du kan utöka funktionerna i Foundry-agenten genom att ansluta den till verktyg som finns på fjärrvärdsbaserade Model Context Protocol (MCP)-servrar (du använder din egen MCP-server-endpoint). Utvecklare och organisationer underhåller dessa servrar. Servrarna exponerar verktyg som MCP-kompatibla klienter, till exempel Foundry Agent Service, kan komma åt.

MCP är en öppen standard som definierar hur program tillhandahåller verktyg och kontextuella data till stora språkmodeller (LLM). Det möjliggör konsekvent och skalbar integrering av externa verktyg i modellarbetsflöden.

Överväganden vid användning av icke-Microsoft-tjänster och servrar

Din användning av anslutna icke-Microsoft-tjänster omfattas av villkoren mellan dig och tjänstleverantören. När du ansluter till en tjänst som inte är Microsoft skickas en del av dina data (till exempel promptinnehåll) till den icke-Microsoft tjänsten, eller så kan ditt program ta emot data från den icke-Microsoft tjänsten. Du ansvarar för din användning av icke-Microsoft-tjänster och data, tillsammans med eventuella avgifter som är associerade med den användningen.

De mcp-fjärrservrar som du bestämmer dig för att använda med MCP-verktyget som beskrivs i den här artikeln har skapats av tredje part, inte Microsoft. Microsoft har inte testat eller verifierat dessa servrar. Microsoft har inget ansvar för dig eller andra när det gäller din användning av fjärr-MCP-servrar.

Vi rekommenderar att du noggrant granskar och spårar vilka MCP-servrar du lägger till i Foundry Agent Service. Vi rekommenderar också att du förlitar dig på servrar som hanteras av betrodda tjänstleverantörer själva i stället för proxyservrar.

Med MCP-verktyget kan du skicka anpassade huvuden, till exempel autentiseringsnycklar eller scheman, som en fjärr-MCP-server kan behöva. Vi rekommenderar att du granskar alla data som delas med fjärranslutna MCP-servrar och att du loggar data i granskningssyfte. Var medveten om metoder än de från Microsoft för lagring och plats för data.

Så här fungerar det

Du måste ta med en fjärr-MCP-server (en befintlig MCP-serverslutpunkt) till Foundry Agent Service. Du kan ta med flera fjärranslutna MCP-servrar genom att lägga till dem som verktyg. För varje verktyg måste du ange ett unikt server_label värde inom samma agent och ett server_url värde som pekar på den fjärranslutna MCP-servern. Se noga till att granska vilka MCP-servrar som du lägger till i Foundry Agent Service.

MCP-verktyget stöder anpassade huvuden, så att du kan ansluta till MCP-servrarna med hjälp av de autentiseringsscheman som de kräver eller genom att skicka andra huvuden som MCP-servrarna kräver. Du kan bara ange rubriker genom att inkludera dem i tool_resources vid varje körning. På så sätt kan du placera API-nycklar, OAuth-åtkomsttoken eller andra autentiseringsuppgifter direkt i din begäran.

Den vanligaste rubriken är auktoriserings-headern. Rubriker som du skickar in är endast tillgängliga för den aktuella körningen och sparas inte.

Mer information om hur du använder MCP finns i:

• Metodtips för säkerhet på webbplatsen för Model Context Protocol.
• Förstå och minska säkerhetsrisker i MCP-implementeringar i Microsoft Security Community Blog.

Användningsstöd

Konfiguration

1. Skapa en Foundry-agent genom att följa stegen i snabbstarten.

2. Hitta den fjärranslutna MCP-server som du vill ansluta till, till exempel GitHub MCP-server. Skapa eller uppdatera en Foundry-agent med ett mcp verktyg med följande information:

   1. server_url: URL:en för MCP-servern; till exempel https://api.githubcopilot.com/mcp/.
   2. server_label: En unik identifierare för den här MCP-servern för agenten. till exempel github.
   3. allowed_tools: En valfri lista över verktyg som agenten kan komma åt och använda.

3. Skapa en körning och skicka ytterligare information om mcp verktyget i tool_resources med rubriker:

   1. tool_label: Använd den identifierare som du angav när du skapade agenten.
   2. headers: Skicka en uppsättning rubriker som MCP-servern kräver.
   3. require_approval: Du kan också avgöra om godkännande krävs. Värden som stöds är:
      • always: En utvecklare måste ge godkännande för varje anrop. Om du inte anger något värde är det här standardvärdet.
      • never: Inget godkännande krävs.
      • {"never":[<tool_name_1>, <tool_name_2>]}: Du anger en lista över verktyg som inte kräver godkännande.
      • {"always":[<tool_name_1>, <tool_name_2>]}: Du anger en lista över verktyg som kräver godkännande.

4. Om modellen försöker anropa ett verktyg på MCP-servern med det godkännande som krävs får du körningsstatusen requires_action. I fältet requires_action kan du få mer information om vilket verktyg i MCP-servern som anropas, argument som ska skickas och call_id värde. Granska verktyget och argumenten så att du kan fatta ett välgrundat beslut för godkännande.

5. Skicka ditt godkännande till agenten med call_id genom att ange approve till true.

Värd för en lokal MCP-server

Agenttjänstens körning accepterar endast en fjärr-MCP-serverslutpunkt. Om du vill lägga till verktyg från en lokal MCP-server måste du själv vara värd för den på Azure Container Apps eller Azure Functions för att få en fjärr-MCP-serverslutpunkt. Tänk på följande när du försöker vara värd för lokala MCP-servrar i molnet:

Kända begränsningar

• Timeout för icke-strömmande MCP-verktyg: Icke-strömmande MCP-verktygsanrop har en tidsgräns på 50 sekunder. Om MCP-servern tar längre tid än 50 sekunder att svara misslyckas samtalet. För att undvika tidsgränser, se till att MCP-servern svarar inom den här gränsen. Om ditt användningsfall kräver längre bearbetningstider kan du överväga att optimera logiken på serversidan eller dela upp åtgärden i mindre steg.

Relaterat innehåll

• Kodexempel för verktyget Model Context Protocol