Ansluta en MCP-server på Azure Functions till en Foundry Agent Service-agent

Den här artikeln visar hur du ansluter din Model Context Protocol (MCP)-server som finns på Azure Functions till Microsoft Foundry Agent Service. När du har slutfört den här guiden kan agenten identifiera och anropa de verktyg som exponeras av MCP-servern.

Den här artikeln följer den här grundläggande processen för att konfigurera MCP-serveranslutningen från Foundry Agent Service:

  • Skapa och distribuera en MCP-server till funktionsappen i Azure.
  • Hämta URL:en för MCP-serverns slutpunkt.
  • Hämta autentiseringsuppgifterna (efter behov).
  • Inaktivera nyckelbaserad autentisering (när det inte behövs).
  • Lägg till en MCP-serververktygsanslutning till en befintlig agent.

Förutsättningar

Kontrollera att du har dessa resurser på plats innan du börjar:

Granska anslutningsalternativ

Den här tabellen sammanfattar de alternativ som stöds för att autentisera agentanslutningen till en MCP-server i Foundry Agent Service:

Metod Description Användningsfall Ytterligare konfiguration Functions har stöd för
Nyckelbaserad (standard) Agenten autentiserar genom att skicka en åtkomstnyckel för delad funktion i begärandehuvudet. Den här metoden är standardautentiseringen för HTTP-slutpunkter i Functions. Använd under utveckling eller när MCP-servern inte kräver Microsoft Entra autentisering. None Yes
Microsoft Entra Agenten autentiserar med antingen sin egen identitet (agentidentitet) eller den delade identiteten för Foundry-projektet (projekthanterad identitet). Använd agentidentitet för produktionsscenarier, men begränsa delad identitet till utveckling. Aktivera inbyggd MCP-autentisering, vilket också inaktiverar nyckelbaserad autentisering. Projekthanterad (delad) identitet
OAuth-identitetsvidarebefordran Agenten uppmanar användarna att logga in och auktorisera åtkomst med hjälp av den angivna token för att autentisera. Använd i produktion när varje användare måste autentisera med sin egen identitet och användarkontexten måste bevaras. Aktivera inbyggd MCP-autentisering, vilket också inaktiverar nyckelbaserad autentisering. Yes
Oautentiserad åtkomst Agenten gör oautentiserade anrop. Använd under utveckling eller när din MCP-server endast får åtkomst till offentlig information. Inaktivera nyckelbaserad autentisering. Yes

Mer information om autentiseringsalternativen för MCP-servern som Foundry Agent Service stöder finns i Konfigurera autentisering för MCP-verktyg.

Hämta fjärrslutpunkten för MCP-servern

Innan du kan koppla agenten till en Functions-hostad MCP-server måste du hämta slutpunkts-URL:en för tjänsten. Det specifika URL-formatet beror på hur du skapade och distribuerade MCP-servern:

https://<FUNCTION_APP_NAME>.azurewebsites.net/runtime/webhooks/mcp

Mer information finns i Remote MCP-servrar i Azure Functions.

Hämta autentiseringsuppgifter

De autentiseringsuppgifter som agenten behöver för att ansluta till MCP-servern beror på hur du planerar att skydda anslutningen. Välj fliken som anger alternativet för anslutningsautentisering.

När du använder en åtkomstnyckel för att ansluta till MCP-serverslutpunkten använder du en delad hemlig nyckel för att göra det svårare för slumpmässiga agenter att ansluta till servern.

Viktigt!

Även om åtkomstnycklar kan bidra till att förhindra oönskad slutpunktsåtkomst som standard kan du överväga att använda Microsoft Entra ID- eller OAuth-identitetsautentisering för att ge förbättrad säkerhet till MCP-serverslutpunkterna i produktion.

Namnet på den åtkomstnyckel som du behöver beror på din MCP-serverdistribution:

MCP-servertyp Nyckelnamn Nyckeltyp
MCP-tilläggsbaserad server mcp_extension Systemnyckel
MCP-server med egen värd default Värdnyckel

Hämta nyckeln från Azure-portalen:

  1. Gå till funktionsappresursen i Azure-portalen.
  2. Expandera listrutan Funktioner i den vänstra menyn.
  3. Välj App-nycklar.
  4. Kopiera antingen mcp_extension nyckeln (under Systemnycklar) eller default nyckeln (under Värdnycklar), beroende på din MCP-servertyp.

Mer information finns i Work with access keys in Azure Functions.

Lägg till MCP-servern

Processen för att skapa agentanslutningen till MCP-servern beror på dina specifika alternativ för slutpunktsautentisering.

När du använder nyckelbaserad autentisering autentiserar agenten genom att skicka en funktionsåtkomstnyckel i begärandehuvudet till MCP-servern.

Så här ansluter du till MCP-serverslutpunkten:

  1. Gå till Foundry-portalen (nya Foundry).

  2. Välj fliken Skapa överst på sidan och välj en agent för att ansluta till MCP-servern.

  3. På fliken Playground expanderar du listrutan Verktyg och väljer Lägg till.

  4. På fliken Anpassad i Välj ett verktyg väljer du Modellkontextprotokoll (MCP)>Skapa.

  5. I verktyget Add Model Context Protocol, ange information från denna tabell för att konfigurera en åtkomstnyckelbaserad anslutning:

    Fält Description Example
    Namn En unik identifierare för MCP-servern. Använd funktionsappens namn som standard. contoso-mcp-tools
    Fjärrslutpunkt för MCP-server URL-slutpunkten för MCP-servern. https://contoso-mcp-tools.azurewebsites.net/runtime/webhooks/mcp
    autentisering Den autentiseringsmetod som ska användas. Key-based
    Referensuppgifter Nyckel/värde-paret för att autentisera med funktionsappen. x-functions-key: aaaaaaaa-0b0b-1c1c-2d2d-333333333333

  6. Välj Anslut för att skapa en anslutning till MCP-serverslutpunkten. Ditt servernamn visas under Verktyg.

  7. Välj Spara för att spara MCP-verktygskonfigurationen i din agent.

Testa dina MCP-verktyg

När du har anslutit MCP-servern till din agent kontrollerar du att verktygen fungerar korrekt.

  1. I Agent Builder hittar du chattfönstret under Playground.
  2. Ange en uppmaning som utlöser ett av dina MCP-verktyg. Om mcp-servern till exempel har ett hälsningsverktyg kan du prova: Use the greeting tool to say hello.
  3. Om du använder OAuth-identitetsgenomströmning väljer du Öppna medgivande och loggar in med ditt Entra-konto.
  4. När agenten begär att anropa ett MCP-verktyg granskar du verktygets namn och argument och väljer Godkänn för att tillåta anropet.
  5. Kontrollera att verktyget returnerar det förväntade resultatet.

Din agent kan nu använda verktygen som exponeras av MCP-servern på Azure Functions.

Dessa ytterligare artiklar kan hjälpa dig att skapa dina funktioner för agent- och funktionsappar:

  • Uppdaterades senast