In dit artikel leest u hoe u uw Model Context Protocol (MCP)-server verbindt die wordt gehost op Azure Functions met de Microsoft Foundry Agent-service. Nadat u deze handleiding hebt voltooid, kan uw agent de hulpprogramma's detecteren en aanroepen die beschikbaar zijn gesteld door uw MCP-server.
Dit artikel volgt dit basisproces voor het configureren van de MCP-serververbinding vanuit Foundry Agent Service:
- Maak en implementeer een MCP-server in uw functie-app in Azure.
- Haal de URL van het MCP-servereindpunt op.
- Haal de verificatiereferenties op (indien nodig).
- Schakel verificatie op basis van sleutels uit (wanneer dit niet nodig is).
- Voeg een MCP-serverhulpprogrammaverbinding toe aan een bestaande agent.
Vereiste voorwaarden
Voordat u begint, moet u ervoor zorgen dat u over deze resources beschikt:
Opties voor verbinding controleren
Deze tabel bevat een overzicht van de momenteel ondersteunde opties voor het verifiëren van uw agentverbinding met een MCP-server in Foundry Agent Service:
| Methode |
Description |
Gebruiksituatie |
Aanvullende instellingen |
Functions ondersteunt |
|
Op basis van sleutels (standaard) |
Agent wordt geverifieerd door een gedeelde functietoegangssleutel in de verzoekheader door te geven. Deze methode is de standaardverificatie voor HTTP-eindpunten in Functions. |
Gebruik deze functie tijdens de ontwikkeling of wanneer de MCP-server geen Microsoft Entra verificatie vereist. |
Geen |
Yes |
|
Microsoft Entra |
Agent verifieert met behulp van een eigen identiteit (agentidentiteit) of de gedeelde identiteit van het Foundry-project (door project beheerde identiteit). |
Gebruik agentidentiteit voor productiescenario's, maar beperk de gedeelde identiteit tot ontwikkeling. |
Ingebouwde MCP-verificatie inschakelen, waardoor ook verificatie op basis van sleutels wordt uitgeschakeld. |
Door project beheerde (gedeelde) identiteit |
|
Passthrough voor OAuth-identiteit |
De agent vraagt gebruikers om zich aan te melden en toegang te autoriseren met behulp van het opgegeven token om te verifiëren. |
Gebruik in productie wanneer elke gebruiker zich moet authenticeren met zijn eigen identiteit en gebruikerscontext moet worden behouden en bewaard. |
Ingebouwde MCP-verificatie inschakelen, waardoor ook verificatie op basis van sleutels wordt uitgeschakeld. |
Yes |
|
Niet-geverifieerde toegang |
Agent voert niet-geverifieerde aanroepen uit. |
Gebruik deze functie tijdens de ontwikkeling of wanneer uw MCP-server alleen openbare informatie opent. |
Schakel verificatie op basis van sleutels uit. |
Yes |
Zie Verificatie voor MCP-hulpprogramma's instellen voor meer informatie over de opties voor MCP-serververificatie die door de Foundry Agent-service worden ondersteund.
Het externe MCP-servereindpunt ophalen
Voordat u de agent kunt verbinden met een Functions-hosed MCP-server, moet u de eindpunt-URL voor de service ophalen. De specifieke URL-indeling is afhankelijk van hoe u uw MCP-server hebt gemaakt en geïmplementeerd:
https://<FUNCTION_APP_NAME>.azurewebsites.net/runtime/webhooks/mcp
Zie Remote MCP-servers in Azure Functions voor meer informatie.
Referenties ophalen
De referenties die uw agent nodig heeft om verbinding te maken met de MCP-server, is afhankelijk van de manier waarop u de verbinding wilt beveiligen. Kies het tabblad waarmee de optie voor verbindingsverificatie wordt aangegeven.
Wanneer u een toegangssleutel gebruikt om verbinding te maken met uw MCP-servereindpunt, gebruikt u een gedeelde geheime sleutel om het moeilijker te maken voor willekeurige agents om verbinding te maken met uw server.
Belangrijk
Hoewel toegangssleutels kunnen helpen ongewenste eindpunttoegang standaard te voorkomen, kunt u overwegen om Microsoft Entra ID of OAuth-identiteitsverificatie te gebruiken om uw MCP-servereindpunten in productie te verbeteren.
De naam van de toegangssleutel die u nodig hebt, is afhankelijk van uw MCP-serverimplementatie:
| MCP-servertype |
Sleutelnaam |
Sleuteltype |
| MCP-server op basis van extensie |
mcp_extension |
Systeemsleutel |
| Zelfgehoste MCP-server |
default |
Hostsleutel |
De sleutel ophalen uit de Azure-portal:
- Ga naar de resource van uw functie-app in de Azure portal.
- Vouw de vervolgkeuzelijst Functions uit in het linkermenu.
- Selecteer App-sleutels.
- Kopieer de
mcp_extension sleutel (onder Systeemsleutels) of de default sleutel (onder Hostsleutels), afhankelijk van uw MCP-servertype.
Zie Werk met toegangssleutels in Azure Functions voor meer informatie.
Zowel Agent Identity als Project Managed Identity gebruiken Microsoft Entra-verificatie. Op dit moment biedt Functions alleen ondersteuning voor door Project beheerde identiteit, waarvoor uw server ingebouwde verificatie en autorisatie moet gebruiken.
Als uw server-app geen door de gebruiker toegewezen beheerde identiteit heeft, maakt u er eerst een.
Verbind de door de gebruiker toegewezen beheerde identiteit vanuit uw server-app met uw Foundry-project:
Zoek in de Azure portal naar Foundry. Selecteer in Microsoft Foundry uw Foundry-resource in Alle resources.
In Resourcebeheer>Identity>Door gebruiker toegewezen, selecteer + Toevoegen. Selecteer de door de gebruiker toegewezen beheerde identiteit die wordt gebruikt door uw server-app en selecteer vervolgens Toevoegen.
Selecteer de zojuist toegevoegde identiteit en kopieer de waarde van de client-id .
Voeg de door de gebruiker toegewezen beheerde identiteit toe als een toegestane clienttoepassing in uw server-app:
Ga naar de app-resource in de Azure-portal.
Selecteer Instellingen>Authenticatie in het linkermenu.
Selecteer het pictogram Bewerken voor uw geregistreerde Entra-id-provider.
Stel in uw provider de vereiste clienttoepassing in op Aanvragen van specifieke clienttoepassingen toestaan en selecteer de knop Bewerken naast Toegestane clienttoepassingen.
Voeg de client-id van uw door de gebruiker toegewezen beheerde identiteit toe en selecteer OK en vervolgens Opslaan.
Haal de Application ID URI op uit de Entra-app-registratie van uw server-app; deze hebt u nodig om de Entra-verificatieregistratie voor uw agent te voltooien:
Selecteer op de pagina Verificatie voor uw app de naam van de geregistreerde Entra-id-provider. Door deze selectie wordt u naar de resourcepagina van de Entra-app gebracht.
Selecteer een>API beheren in het linkermenu.
Kopieer de Application ID URI boven aan de pagina. Deze id-waarde ziet er als api://aaaabbbb-0000-cccc-1111-dddd2222eeee uit.
OAuth identity passthrough vraagt gebruikers zich aan te melden en toegang te verlenen tot uw MCP-server. Voor een door Functions gehoste MCP-server met ingebouwde verificatie gebruikt u aangepaste OAuth met een Microsoft Entra-app-registratie.
De vereiste inloggegevens ophalen uit de Azure-portal:
Ga naar de resource van uw functie-app in de Azure portal.
Selecteer Instellingen>Authenticatie in het linkermenu.
Selecteer de naam van de Entra-app naast Microsoft. Met deze selectie gaat u naar de Entra-app-resource.
Kopieer vanuit Essentials op de overzichtspagina de waarden uit deze velden:
-
Applicatie (cliënt) ID
-
Directory (huurder) ID
-
Application ID-URI
Gebruik de tenant-id om deze vereiste OAuth-URL's samen te stellen:
| URL-type |
Formaat |
|
Verificatie-URL |
https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/authorize |
|
Token-URL |
https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/token |
|
URL vernieuwen |
https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/token |
Vervang <TENANT_ID> door uw werkelijke tenant-id-waarde. Sla deze waarden op voor later gebruik.
SelecteerCertificaten en geheimen beheren>. Maak een nieuw clientgeheim als er nog geen clientgeheim is en kopieer de waarde voor later gebruik.
Selecteer Beheren>Stel een API bloot en kopieer de bestaande scope.
Nadat u OAuth-identiteitspassthrough hebt geconfigureerd in de Foundry-portal, ontvangt u een omleidings-URL. U moet terugkeren naar uw Entra-app-registratie om deze omleidings-URL toe te voegen aan de Microsoft Entra app-registratie.
Omdat niet-geverifieerde toegang geen gedeelde geheimen of verificatie vereist, hoeft u geen referenties te verzamelen. U moet echter verificatie op basis van sleutels uitschakelen , zodat uw servereindpunt anonieme toegang toestaat.
Belangrijk
Met deze optie heeft elke client of agent toegang tot uw MCP-servereindpunt. Gebruik dit alleen voor hulpprogramma's die alleen openbare informatie-lezen retourneren, of tijdens privéontwikkeling.
Uw MCP-server toevoegen
Het proces voor het maken van de agentverbinding met de MCP-server is afhankelijk van uw specifieke opties voor eindpuntverificatie.
Wanneer u verificatie op basis van sleutels gebruikt, wordt de agent geverifieerd door een functietoegangssleutel in de aanvraagheader door te geven aan uw MCP-server.
Verbinding maken met uw MCP-servereindpunt:
Ga naar de Foundry-portal (nieuwe Foundry).
Selecteer het tabblad Opbouwen boven aan de pagina en selecteer een agent om verbinding te maken met uw MCP-server.
Vouw op het tabblad Speeltuin de vervolgkeuzelijst Hulpmiddelen uit en selecteer Toevoegen.
Op het tabblad Aangepast in Selecteer een hulpprogramma, selecteer Modelcontextprotocol (MCP)>Maken.
Geef in Modelinhoudsprotocol toevoegen-hulpprogramma informatie uit deze tabel op om een verbinding op basis van een toegangssleutel te configureren.
| Veld |
Description |
Example |
|
Naam |
Een unieke id voor uw MCP-server. Gebruik de naam van uw functie-app als de standaardwaarde. |
contoso-mcp-tools |
|
Extern MCP-servereindpunt |
Het URL-eindpunt voor uw MCP-server. |
https://contoso-mcp-tools.azurewebsites.net/runtime/webhooks/mcp |
|
Authentication |
De verificatiemethode die moet worden gebruikt. |
Key-based |
|
Credential |
Het sleutel-waardepaar voor verificatie met uw functie-app. |
x-functions-key: aaaaaaaa-0b0b-1c1c-2d2d-333333333333 |
Selecteer Verbinding maken om een verbinding met uw MCP-servereindpunt te maken. U ziet uw servernaam onder Extra staan vermeld.
Selecteer Opslaan om de configuratie van het MCP-hulpprogramma op te slaan in uw agent.
Wanneer u Microsoft Entra-verificatie gebruikt, wordt de agent geverifieerd met behulp van een beheerde identiteit om verbinding te maken met uw MCP-server.
Verbinding maken met uw MCP-servereindpunt:
Ga naar de Foundry-portal (nieuwe Foundry).
Selecteer het tabblad Opbouwen boven aan de pagina en selecteer een agent om verbinding te maken met uw MCP-server.
Vouw op het tabblad Speeltuin de vervolgkeuzelijst Hulpmiddelen uit en selecteer Toevoegen.
Op het tabblad Aangepast in Selecteer een hulpprogramma, selecteer Modelcontextprotocol (MCP)>Maken.
Voer in Add Model Content Protocol-hulpprogramma de gegevens uit deze tabel in om een Microsoft Entra-gebaseerde verbinding te configureren:
| Veld |
Description |
Example |
|
Naam |
Een unieke id voor uw MCP-server. U kunt de naam van uw functie-app gebruiken. |
contoso-mcp-tools |
|
Extern MCP-servereindpunt |
Het URL-eindpunt voor uw MCP-server. |
https://contoso-mcp-tools.azurewebsites.net/runtime/webhooks/mcp |
|
Authentication |
De verificatiemethode die moet worden gebruikt. |
Microsoft Entra |
|
Typ |
Het identiteitstype dat de agent gebruikt om te verifiëren. |
Project Managed Identity |
|
Audiëntie |
De toepassings-id-URI van de Entra-registratie van uw functietoepassing. Deze waarde vertelt de id-provider voor welke app het token is bedoeld. |
api://aaaabbbb-0000-cccc-1111-dddd2222eeee |
Selecteer Verbinding maken om een verbinding met uw MCP-servereindpunt te maken. U ziet uw servernaam onder Extra staan vermeld.
Selecteer Opslaan om de configuratie van het MCP-hulpprogramma op te slaan in uw agent.
Wanneer u OAuth-identiteitspassthrough gebruikt, vraagt de agent de gebruiker zich aan te melden en gebruikt vervolgens het geretourneerde toegangstoken bij het maken van verbinding met de server.
Ga naar de Foundry-portal (nieuwe Foundry).
Selecteer het tabblad Opbouwen boven aan de pagina en selecteer een agent om verbinding te maken met uw MCP-server.
Vouw op het tabblad Speeltuin de vervolgkeuzelijst Hulpmiddelen uit en selecteer Toevoegen.
Op het tabblad Aangepast in Selecteer een hulpprogramma, selecteer Modelcontextprotocol (MCP)>Maken.
Voer in het hulpprogramma Add Modelinhoudsprotocol de informatie uit deze tabel in om de OAuth Identity Passthrough-verbinding te configureren.
| Veld |
Description |
Example |
|
Naam |
Een unieke id voor uw MCP-server. U kunt de naam van uw functie-app gebruiken. |
contoso-mcp-tools |
|
Extern MCP-servereindpunt |
Het URL-eindpunt voor uw MCP-server. |
https://contoso-mcp-tools.azurewebsites.net/runtime/webhooks/mcp |
|
Authentication |
De verificatiemethode die moet worden gebruikt. |
OAuth Identity Passthrough |
|
Client-ID |
De client-id van uw function-app Entra-registratie |
00001111-aaaa-2222-bbbb-3333cccc4444 |
|
Geheim van de klant |
Het clientgeheim van uw functie-applicatie Entra-registratie |
abcEFGhijkLMNopqRST |
|
Token-URL |
Het eindpunt dat uw server-app aanroept om een autorisatiecode of referentie voor een toegangstoken uit te wisselen. |
https://login.microsoftonline.com/aaaabbbb-0000-cccc-1111-dddd2222eeee/oauth2/v2.0/token |
|
Verificatie-URL |
Het eindpunt waar gebruikers worden omgeleid om te verifiëren en autorisatie te verlenen aan uw server-app. |
https://login.microsoftonline.com/aaaabbbb-0000-cccc-1111-dddd2222eeee/oauth2/v2.0/authorize |
|
URL vernieuwen |
Het eindpunt dat wordt gebruikt om een nieuw toegangstoken te verkrijgen wanneer het huidige is verlopen. |
https://login.microsoftonline.com/aaaabbbb-0000-cccc-1111-dddd2222eeee/oauth2/v2.0/token |
|
Scopes |
De specifieke machtigingen of toegangsniveaus voor resources die uw server-app aanvraagt bij de autorisatieserver |
api://aaaabbbb-0000-cccc-1111-dddd2222eeee/user_impersonation |
Selecteer Verbinding maken om een verbinding met uw MCP-servereindpunt te maken.
Nadat u uw credential provider hebt gemaakt, ontvangt u een omleidings-URL. Voordat u dit venster sluit , moet u de URL-waarde kopiëren. U moet deze omleidings-URL toevoegen aan uw Entra-app-registratie.
Ga terug naar de registratie van uw Entra-app en selecteer onder Beheren>Verificatie+ Omleidings-URI toevoegen. Selecteer Web, plak de gekopieerde omleidings-URI-waarde en selecteer Configureren.
Ga terug naar het agentvenster en selecteer>Opslaan sluiten om de configuratie van het MCP-hulpprogramma in uw agent op te slaan.
Gebruik alleen niet-geverifieerde toegang wanneer voor uw MCP-server geen verificatie is vereist en alleen openbare informatie wordt geopend.
Verbinding maken met uw MCP-servereindpunt:
Ga naar de Foundry-portal (nieuwe Foundry).
Selecteer het tabblad Opbouwen boven aan de pagina en selecteer een agent om verbinding te maken met uw MCP-server.
Vouw op het tabblad Speeltuin de vervolgkeuzelijst Hulpmiddelen uit en selecteer Toevoegen.
Op het tabblad Aangepast in Selecteer een hulpprogramma, selecteer Modelcontextprotocol (MCP)>Maken.
Geef in het hulpprogramma Modelinhoudsprotocol toevoegen informatie op uit deze tabel om een niet-geverifieerde verbinding te configureren:
| Veld |
Description |
Example |
|
Naam |
Een unieke id voor uw MCP-server. U kunt de naam van uw functie-app gebruiken. |
contoso-mcp-tools |
|
Extern MCP-servereindpunt |
Het URL-eindpunt voor uw MCP-server. |
https://contoso-mcp-tools.azurewebsites.net/runtime/webhooks/mcp |
|
Authentication |
De verificatiemethode die moet worden gebruikt. |
Unauthenticated |
Selecteer Verbinding maken om een niet-geverifieerde verbinding met uw MCP-servereindpunt te maken. U zou nu uw servernaam moeten zien onder Extra.
Selecteer Opslaan om de configuratie van het MCP-hulpprogramma op te slaan in uw agent.
Nadat u de MCP-server hebt verbonden met uw agent, controleert u of de hulpprogramma's correct werken.
- Zoek in agent builder het chatvenster onder Playground.
- Voer een prompt in waarmee een van uw MCP-hulpprogramma's wordt geactiveerd. Als uw MCP-server bijvoorbeeld een begroetingsprogramma heeft, kunt u het volgende proberen:
Use the greeting tool to say hello
- Als u OAuth-identiteitspassthrough gebruikt, selecteert u Toestemming openen en meldt u zich aan met uw Entra-account.
- Wanneer de agent vraagt om een MCP-hulpprogramma aan te roepen, controleert u de naam en argumenten van het hulpprogramma en selecteert u Goedkeuren om de aanroep toe te staan.
- Controleer of het hulpprogramma het verwachte resultaat retourneert.
Uw agent kan nu gebruikmaken van de hulpprogramma's die worden weergegeven door uw MCP-server die wordt gehost op Azure Functions.
Verwante artikelen
Deze aanvullende artikelen kunnen u helpen bij het bouwen van de mogelijkheden van uw agent- en functie-app: