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

[Denne artikkelen er forhåndsutgitt dokumentasjon og kan endres.]

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, blir alle verktøy serveren eksponerer tilgjengelig for agenten å bruke under en samtale.

Merknad

Funksjonene i denne artikkelen brukes av agenter eller arbeidsflyter drevet av GitHub Copilot-verktøyet.

Bruksbasert fakturering gjelder for bruk, bygging, testing og evaluering av agenter. Disse handlingene kan bruke opp Copilot-kreditter. Lær mer i Administrer kostnader for agenter drevet av GitHub Copilot-verktøyene.

Bruk denne veiledningen når du vil legge til en MCP-server til en agent i den nye opplevelsen. For en oversikt over verktøytyper i den nye opplevelsen, se Tilgjengelige verktøy for agenter.

Forutsetninger

  • En agent skapt i den nye opplevelsen. Se Opprett en agent.
  • URL-en til en MCP-server som er tilgjengelig fra Copilot Studio. Hvis du ikke har en ennå, se Create a new Model Context Protocol (MCP)-server.
  • Alle legitimasjoner som kreves av serveren (for eksempel 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 aktiverer verktøyet når du forventer, kan du forbedre verktøynavnet, verktøybeskrivelsen eller agentens instruksjoner. Se 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. Se Administrer og slett verktøy i en agent.

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 kan kjøre 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.
  • Last updated on