Tilføj en Model Context Protocol (MCP)-server til din agent som et værktøj (GitHub Copilot) (forhåndsvisning)

[Denne artikel er dokumentation til en foreløbig version og er med forbehold for ændringer.]

Model Context Protocol (MCP) er en standard til at eksponere værktøjer for en agent. Når du tilføjer en MCP-server til din agent, kan agenten bruge alle de værktøjer, som serveren eksponerer under en samtale.

Brug denne vejledning, når du vil tilføje en MCP-server til en agent drevet af GitHub Copilot-harnesset. For et overblik over værktøjstyper, se Tilgængelige værktøjer til agenter (GitHub Copilot).

MCP-fanen i dialogen 'Tilføj et værktøj' viser MCP-servere, der allerede er udgivet for din organisation, såsom Microsoft 365-tjenester, Foundry IQ og Fabric IQ.

  1. Log ind på Copilot Studio og åbn din agent.

  2. I agentens navigationslinje skal du vælge fanen Byg.

  3. I komponentpanelet til højre vælger du Værktøjer, og derefter Tilføj værktøj.

  4. I dialogen Tilføj et værktøj vælg fanen MCP, og vælg derefter en server.

  5. På serverens detaljeside kan du gennemgå beskrivelsen og, hvis tilgængeligt, Docs-linket for information om, hvad serveren laver. Vælg Tilføj.

  6. Hvad der sker herefter, afhænger af serveren:

    • Nogle servere (for eksempel førsteparts Microsoft 365-servere som Mail) forbinder automatisk med din indloggede identitet, og serveren tilføjes direkte.
    • Andre servere beder dig om at oprette en forbindelse med felter, der er specifikke for den server (for eksempel et visningsnavn og autentificeringstype, eller en endpoint-URL og API-nøgle). Angiv de ønskede værdier og vælg Create.

    Disse værdier er specifikke for hver server. Brug serverens Docs-link , hvis det er tilgængeligt, for opsætningsdetaljer.

Da hver server kan kræve forskellige forbindelsesværdier og ændre sig uafhængigt af Copilot Studio, opregner denne artikel ikke felterne for hver server. Brug beskrivelsen i produktet og dokumentlinket til den server, du tilføjer.

Tilføj en brugerdefineret MCP-server via URL

Brug denne sti til at forbinde en MCP-server, der ikke allerede er offentliggjort i galleriet.

Forudsætninger

  • En agent skabt i den nye oplevelse. Se Opret en agent.
  • URL'en til en MCP-server, som kan nås fra Copilot Studio. Få flere oplysninger i Opret en ny Model Context Protocol-server (MCP).
  • Alle legitimationsoplysninger, der kræves af serveren, såsom en API-nøgle eller et klient-ID og hemmelighed for en understøttet autentificeringsordning.

Tilføj en MCP-server fra fanen Byg.

  1. Log ind på Copilot Studio og åbn din agent.

  2. I agentens navigationslinje skal du vælge fanen Byg.

  3. I komponentpanelet til højre skal du vælge Værktøjer.

  4. I dialogen Tilføj et værktøj vælger du Tilføj ved siden af søgefeltet, og vælg derefter Model Context Protocol (MCP).

  5. På siden Tilføj MCP-server indtast følgende oplysninger:

    • Navn: et kort, beskrivende navn, der hjælper agenten med at beslutte, hvornår serverens værktøjer skal bruges. Dette er det navn, agenten ser.
    • Beskrivelse: et ét- eller to-sætnings resumé af, hvad serveren gør, og hvornår agenten bør bruge det.
    • Server-URL: HTTPS-endepunktet for MCP-serveren.
    • Autentificering: vælg den autentificeringsmetode, serveren kræver, og indtast de legitimationsoplysninger eller konfigurationsværdier, som metoden kræver.

  6. Vælg Tilføj for at forbinde.

    Copilot Studio kontakter MCP-serveren, forhandler protokollens håndtryk og lister derefter de værktøjer, serveren eksponerer.

  7. Gennemgå listen over værktøjer, der dukker op.

    For hvert værktøj skal du tjekke navn og beskrivelse. Hvis et værktøj ikke har en klar beskrivelse, er agentens svar, der involverer værktøjet, mindre pålidelige. Bed MCP-serverens forfatter om at forbedre beskrivelsen, før du stoler på værktøjet i produktion.

  8. Vælg Save for at færdiggøre tilføjelsen af serveren.

Serveren vises i agentens værktøjsliste under fanen Byg.

Test serveren

Når du har tilføjet serveren, skal du teste den, før du offentliggør agenten.

  1. Vælg fanen Forhåndsvisning .

  2. Stil agenten et spørgsmål, der kræver et af serverens værktøjer.

  3. Gennemgå agentens svar. Åbn aktivitetssporet for at verificere, hvilket værktøj der blev kaldt, hvilke argumenter der blev sendt, og hvad værktøjet returnerede. Se Brug aktivitetssporet til at fejlfinde din agent.

Hvis agenten ikke aktiverer værktøjet, som du forventer, så forfin servernavnet, serverbeskrivelsen eller agentens instruktioner. De enkelte værktøjsnavne og beskrivelser kommer fra MCP-serveren selv. Hvis de skal ændres, så bed MCP-serverens forfatter om at opdatere dem. Lær mere i Konfigurér agentdetaljer og instruktioner.

Administrer serveren efter tilføjelse

For at fjerne en MCP-server eller midlertidigt slukke en, brug det standard værktøjsstyringsflow. Lær mere i Administrer og slet værktøjer i en agent (GitHub Copilot).

Hvis en servers URL, autentificering eller eksponerede værktøjer ændres efter tilføjelsen, skal du redigere serverposten i samme Tools-dialog for at opdatere forbindelsen og læse værktøjslisten igen.

Grænser

  • Hver agent kan forbinde til flere MCP-servere, men det samlede antal MCP-serverinstanser, der kører samtidig i en enkelt samtale, er begrænset. Hvis du tilknytter flere MCP-servere end cap'en tillader, og agenten prøver at bruge dem alle i samme tur, springer de ekstra servere over, og deres værktøjer er ikke tilgængelige i den tur.
  • Hold antallet af MCP-servere tilknyttet en enkelt agent lille, og fjern servere, du ikke længere bruger, så agenten har plads til at aktivere de servere, du går op i.
  • Hver MCP-server tæller med i det samlede antal værktøjer, en agent kan hoste.
  • Sidst opdateret den