Legg til en Model Context Protocol (MCP)-server til agenten din som et verktøy (GitHub Copilot) (forhåndsvisning)

[Denne artikkelen inneholder dokumentasjon for forhåndsversjonen og kan bli endret.]

Model Context Protocol (MCP) er en standard for å eksponere verktøy for en agent. Når du legger til en MCP-server i agenten din, kan agenten bruke alle verktøyene serveren eksponerer under en samtale.

Bruk denne veiledningen når du vil legge til en MCP-server til en agent drevet av GitHub Copilot-harnessen. For en oversikt over verktøytyper, se Tilgjengelige verktøy for agenter (GitHub Copilot).

MCP-fanen i dialogen Legg til et verktøy viser MCP-servere som allerede er publisert for organisasjonen din, som Microsoft 365-tjenester, Foundry IQ og Fabric IQ.

  1. Logg inn på Copilot Studio og åpne agenten din.

  2. Velg fanen Bygg i agentens navigasjonsfelt.

  3. I komponentpanelet til høyre, velg Verktøy, deretter Legg til verktøy.

  4. I dialogen Legg til et verktøy , velg MCP-fanen , og velg deretter en server.

  5. På serverens detaljside, se gjennom beskrivelsen og, hvis tilgjengelig, dokumentasjonslenken for informasjon om hva serveren gjør. Velg Legg til.

  6. Hva som skjer videre avhenger av serveren:

    • Noen servere (for eksempel førsteparts Microsoft 365-servere som Mail) kobler seg automatisk til med din innloggede identitet, og serveren legges til direkte.
    • Andre servere ber deg opprette en tilkobling, med felt spesifikke for den serveren (for eksempel et visningsnavn og autentiseringstype, eller en endepunkt-URL og API-nøkkel). Oppgi de forespurte verdiene og velg Opprett.

    Disse verdiene er spesifikke for hver server. Bruk serverens Docs-kobling, hvis tilgjengelig, for oppsettsdetaljer.

Siden hver server kan kreve forskjellige tilkoblingsverdier og endres uavhengig av Copilot Studio, lister ikke denne artikkelen opp feltene for hver server. Bruk produktbeskrivelsen og dokumentasjonslenken for serveren du legger til.

Legg til en egendefinert MCP-server via URL

Bruk denne stien for å koble til en MCP-server som ikke allerede er publisert i galleriet.

Prerequisites

  • En agent skapt i den nye opplevelsen. Se Opprett en agent.
  • URL-en til en MCP-server som er tilgjengelig fra Copilot Studio. Du finner mer informasjon i Opprett en ny Model Context Protocol (MCP)-server.
  • All påloggingsinformasjon som kreves av serveren, som en API-nøkkel eller en klient-ID og -hemmelighet for en støttet autentiseringsordning.

Legg til en MCP-server fra Bygg-fanen

  1. Logg inn på Copilot Studio og åpne agenten din.

  2. Velg fanen Bygg i agentens navigasjonsfelt.

  3. I komponentpanelet til høyre, velg Verktøy.

  4. I dialogen Legg til et verktøy, velg Legg til ved siden av søkefeltet, og velg deretter Model Context Protocol (MCP).

  5. På siden Legg til MCP-server , skriv inn følgende detaljer:

    • Navn: et kort, beskrivende navn som hjelper agenten med å avgjøre når de skal bruke denne serverens verktøy. Dette navnet er det agenten ser.
    • Beskrivelse: en én- eller to-setnings oppsummering av hva serveren gjør og når agenten bør bruke det.
    • Server-URL: HTTPS-endepunktet til MCP-serveren.
    • Autentisering: velg autentiseringsmetoden serveren krever, og skriv inn legitimasjonen eller konfigurasjonsverdiene den metoden trenger.

  6. Velg Legg til for å koble til.

    Copilot Studio kontakter MCP-serveren, forhandler protokollhåndtrykket, og lister deretter opp verktøyene serveren eksponerer.

  7. Gå gjennom listen over verktøy som dukker opp.

    For hvert verktøy, verifiser navnet og beskrivelsen. Hvis et verktøy ikke har en klar beskrivelse, er agentsvarene som involverer verktøyet mindre pålitelige. Be MCP-serverens forfatter om å forbedre beskrivelsen før du stoler på verktøyet i produksjon.

  8. Velg Save for å fullføre å legge til serveren.

Serveren vises i agentens verktøyliste under fanen Bygg .

Test serveren

Etter at du har lagt til serveren, test den før du publiserer agenten.

  1. Velg fanen Forhåndsvisning .

  2. Still agenten et spørsmål som krever et av serverens verktøy.

  3. Gå gjennom agentens svar. Åpne aktivitetssporet for å verifisere hvilket verktøy som ble påkalt, hvilke argumenter som ble sendt, og hva verktøyet returnerte. Se Bruk aktivitetssporet for å feilsøke agenten din.

Hvis agenten ikke kaller verktøyet når du forventer, juster servernavnet, serverbeskrivelsen eller agentens instruksjoner. De individuelle verktøynavnene og beskrivelsene kommer fra MCP-serveren selv. Hvis disse må endres, be MCP-serverens forfatter om å oppdatere dem. Les mer i Konfigurer agentdetaljer og instruksjoner.

Administrer serveren etter at du har lagt den til

For å fjerne en MCP-server eller slå av en midlertidig, bruk standard verktøyadministrasjonsflyt. Lær mer i Administrer og slett verktøy i en agent (GitHub Copilot).

Hvis en servers URL, autentisering eller eksponerte verktøy endres etter at du har lagt den til, rediger serveroppføringen i samme verktøy-dialog for å oppdatere tilkoblingen og les verktøylisten på nytt.

Grenser

  • Hver agent kan koble til flere MCP-servere, men det totale antallet MCP-serverinstanser som kjører samtidig i en enkelt samtale er begrenset. Hvis du kobler til flere MCP-servere enn taket tillater og agenten prøver å bruke dem alle i samme runde, hoppes de ekstra serverne over og verktøyene deres er ikke tilgjengelige for den runden.
  • Hold antallet MCP-servere knyttet til en enkelt agent lite, og fjern servere du ikke lenger bruker, slik at agenten har plass til å starte serverne du bryr deg om.
  • Hver MCP-server teller mot det totale antallet verktøy en agent kan hoste.
  • Sist oppdatert