Voeg een Model Context Protocol (MCP)-server toe aan je agent als hulpmiddel (preview)

[Dit artikel maakt deel uit van de voorlopige documentatie en kan nog veranderen.]

Model Context Protocol (MCP) is een standaard voor het blootstellen van tools aan een agent. Wanneer je een MCP-server toevoegt aan je agent, wordt elk hulpmiddel dat de server blootstelt beschikbaar voor de agent om aan te roepen tijdens een gesprek.

Gebruik deze handleiding wanneer je een MCP-server aan een agent wilt toevoegen in de nieuwe ervaring. Voor een overzicht van de tooltypes in de nieuwe ervaring, zie Beschikbare tools voor agenten.

Prerequisites

• Een agent die in de nieuwe ervaring is gecreëerd. Zie Een agent maken.
• De URL van een MCP-server die bereikbaar is vanuit Copilot Studio. Als je er nog geen hebt, raadpleeg dan een nieuwe Model Context Protocol (MCP)-server maken.
• Alle inloggegevens die door de server vereist zijn (bijvoorbeeld een API-sleutel of een client-ID en geheim voor een ondersteund authenticatieschema).

Voeg een MCP-server toe via het tabblad Bouw

1. Log in bij Copilot Studio en open je agent.

2. Selecteer in de navigatiebalk van de agent het tabblad Bouw .

3. Selecteer in het componentenpaneel rechts Tools.

4. Selecteer in het menu 'Voeg een tool toe'naast de zoekbalk en kies vervolgens Model Context Protocol (MCP).

5. Op de pagina 'Add MCP server ' vult u de volgende gegevens in:

   • Naam: een korte, beschrijvende naam die de agent helpt beslissen wanneer hij de tools van deze server moet gebruiken. Dit is de naam die de agent ziet.
   • Beschrijving: een samenvatting van één of twee zinnen van wat de server doet en wanneer de agent het zou moeten gebruiken.
   • Server-URL: het HTTPS-eindpunt van de MCP-server.
   • Authenticatie: kies de authenticatiemethode die de server vereist en voer de referenties of configuratiewaarden in die die methode nodig heeft.

6. Selecteer Toevoegen om te verbinden.

   Copilot Studio neemt contact op met de MCP-server, onderhandelt over de protocolhandshake en vermeldt vervolgens de tools die de server blootlegt.

7. Bekijk de lijst met hulpmiddelen die verschijnen.

   Controleer voor elk hulpmiddel de naam en beschrijving. Als een tool geen duidelijke beschrijving heeft, zijn agentenreacties die de tool betreffen minder betrouwbaar. Vraag de auteur van de MCP-server om de beschrijving te verbeteren voordat je in productie op de tool gaat vertrouwen.

8. Selecteer Opslaan om de server klaar te maken.

De server verschijnt in de Tools-lijst van de agent op het tabblad Bouw .

De server testen

Nadat je de server hebt toegevoegd, test je hem voordat je de agent publiceert.

1. Selecteer het tabblad Voorbeeldweergave .

2. Stel de agent een vraag die een van de tools van de server vereist.

3. Controleer het antwoord van de agent. Open de activiteitstrace om te controleren welke tool is aangeroepen, welke argumenten zijn doorgegeven en wat de tool teruggeeft. Zie Gebruik de activiteitstrace om je agent te debuggen.

Als de agent het hulpmiddel niet oproept wanneer je verwacht, verfijn dan de toolnaam, de toolbeschrijving of de instructies van de agent. Zie Agentgegevens en instructies configureren.

Beheer de server nadat je hem hebt toegevoegd

Om een MCP-server te verwijderen of tijdelijk uit te schakelen, gebruik je de standaard toolbeheerflow. Zie Beheren en verwijder tools in een agent.

Als de URL, authenticatie of blootgestelde tools van een server veranderen nadat je deze hebt toegevoegd, bewerk dan de serververmelding in hetzelfde Tools-dialoog om de verbinding te verversen en lees de lijst met tools opnieuw.

Limits

• Elke agent kan verbinding maken met meerdere MCP-servers, maar het totale aantal MCP-serverinstanties dat gelijktijdig in één gesprek kan draaien, is beperkt. Als je meer MCP-servers koppelt dan de cap toestaat en de agent probeert ze allemaal in dezelfde beurt te gebruiken, worden de extra servers overgeslagen en zijn hun tools niet beschikbaar voor die beurt.
• Houd het aantal MCP-servers dat aan een enkele agent gekoppeld is klein, en verwijder servers die je niet meer gebruikt, zodat de agent ruimte heeft om de servers aan te roepen die je belangrijk vindt.
• Elke MCP-server telt mee tegen het totale aantal tools dat een agent kan hosten.

Verwante informatie

• Overzicht van tools voor agenten
• Beschikbare tools voor agenten
• Voeg een tool toe aan een agent
• Beheer en verwijder tools in een agent
• Maak een nieuwe Model Context Protocol (MCP)-server aan
• Overzicht van Model Context Protocol (MCP) in Copilot Studio