Voeg een Model Context Protocol (MCP)-server toe aan je agent als hulpmiddel (GitHub Copilot) (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, kan de agent elke tool gebruiken die de server tijdens een gesprek beschikbaar stelt.

Gebruik deze handleiding wanneer je een MCP-server wilt toevoegen aan een agent die wordt aangedreven door de GitHub Copilot harness. Voor een overzicht van de tooltypes, zie Beschikbare tools voor agenten (GitHub Copilot).

Het tabblad MCP in het dialoog 'Add a tool' geeft een lijst met MCP-servers die al voor uw organisatie zijn gepubliceerd, zoals Microsoft 365-services, Foundry IQ en Fabric IQ.

  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 en vervolgens Tool toevoegen.

  4. Selecteer in het dialoogvenster 'Add a tool' het tabblad MCP en selecteer vervolgens een server.

  5. Bekijk op de detailpagina van de server de beschrijving en, indien beschikbaar, de Docs-link voor informatie over wat de server doet. Kies Toevoegen.

  6. Wat er daarna gebeurt, hangt af van de server:

    • Sommige servers (bijvoorbeeld first-party Microsoft 365-servers zoals Mail) verbinden automatisch met je ingelogde identiteit, en de server wordt direct toegevoegd.
    • Andere servers vragen je om een verbinding aan te maken, met velden die specifiek zijn voor die server (bijvoorbeeld een weergavenaam en authenticatietype, of een endpoint-URL en API-sleutel). Geef de gevraagde waarden en kies Aanmaken.

    Deze waarden zijn specifiek voor elke server. Gebruik de Docs-link van de server, indien beschikbaar, voor installatiedetails.

Omdat elke server verschillende verbindingswaarden kan vereisen en onafhankelijk van Copilot Studio kan veranderen, somt dit artikel niet de velden voor elke server op. Vertrouw op de beschrijving in het product en de documentatielink voor de server die je toevoegt.

Voeg een aangepaste MCP-server toe via URL

Gebruik dit pad om een MCP-server te verbinden die nog niet in de galerij is gepubliceerd.

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. Zie voor meer informatie Een nieuwe Model Context Protocol (MCP)-server maken
  • Alle inloggegevens die door de server vereist zijn, zoals een API-sleutel of een client-ID en clientgeheim 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 de tool niet aanroept wanneer je verwacht, verfijn dan de servernaam, de serverbeschrijving of de instructies van de agent. De individuele toolnamen en beschrijvingen komen rechtstreeks van de MCP-server. Als die moeten worden aangepast, vraag dan de MCP-servermaker om ze bij te werken. Lees meer in 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. Lees meer in Beheer en verwijder tools in een agent (GitHub Copilot).

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 draait, is begrensd. 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.
  • Laatst bijgewerkt om