Lägg till en Model Context Protocol (MCP)-server till din agent som ett verktyg (GitHub Copilot) (förhandsvisning)

[Denna artikel är en förhandsversion av dokumentationen och kan komma att ändras.]

Model Context Protocol (MCP) är en standard för att exponera verktyg för en agent. När du lägger till en MCP-server till din agent kan agenten använda alla verktyg som servern exponerar under en konversation.

Använd denna guide när du vill lägga till en MCP-server till en agent som drivs av GitHub Copilot-harnessen. För en översikt över verktygstyper, se Tillgängliga verktyg för agenter (GitHub Copilot).

Fliken MCP i dialogen Lägg till verktyg listar MCP-servrar som redan är publicerade för din organisation, såsom Microsoft 365-tjänster, Foundry IQ och Fabric IQ.

  1. Logga in på Copilot Studio och öppna din agent.

  2. I agentens navigationsfält, välj fliken Bygg.

  3. I komponentpanelen till höger, välj Verktyg och sedan Lägg till verktyg.

  4. I dialogen Lägg till ett verktyg, välj fliken MCP och välj sedan en server.

  5. På serverns detaljsida, granska dess beskrivning och, om den finns, Docs-länken för information om vad servern gör. Välj Lägg till.

  6. Vad som händer härnäst beror på servern:

    • Vissa servrar (till exempel Microsofts egna Microsoft 365-servrar som Mail) ansluter automatiskt med din inloggade identitet, och servern läggs till direkt.
    • Andra servrar ber dig skapa en anslutning, med fält specifika för den servern (till exempel ett visningsnamn och autentiseringstyp, eller en slutpunkts-URL och API-nyckel). Ange de begärda värdena och välj Skapa.

    Dessa värden är specifika för varje server. Använd serverns Docs-länk, om den finns tillgänglig, för installationsinformation.

Eftersom varje server kan kräva olika anslutningsvärden och ändras oberoende av Copilot Studio, räknar denna artikel inte upp fälten för varje server. Använd produktbeskrivningen och dokumentationslänken för servern du lägger till.

Lägg till en anpassad MCP-server via URL

Använd denna sökväg för att ansluta en MCP-server som inte redan är publicerad i galleriet.

Prerequisites

  • En agent som har skapats i den nya upplevelsen. Se Skapa en agent.
  • URL:en till en MCP-server som är nåbar från Copilot Studio. Läs mer i Skapa en ny MCP-server (Model Context Protocol).
  • Eventuella autentiseringsuppgifter som krävs av servern, såsom en API-nyckel eller ett klient-ID och hemlighet för ett autentiseringsschema som stöds.

Lägg till en MCP-server från fliken Bygg

  1. Logga in på Copilot Studio och öppna din agent.

  2. I agentens navigationsfält, välj fliken Bygg.

  3. I komponentpanelen till höger, välj Verktyg.

  4. I dialogen Lägg till ett verktyg, välj Lägg till bredvid sökfältet och välj sedan Model Context Protocol (MCP).

  5. På sidan Lägg till MCP-server , ange följande uppgifter:

    • Namn: ett kort, beskrivande namn som hjälper agenten att avgöra när serverns verktyg ska användas. Det är det namnet agenten ser.
    • Beskrivning: en en- eller tvåmeningssammanfattning av vad servern gör och när agenten bör använda den.
    • Server-URL: HTTPS-slutpunkten för MCP-servern.
    • Autentisering: välj den autentiseringsmetod som servern kräver och ange de uppgifter eller konfigurationsvärden som metoden behöver.

  6. Välj Lägg till för att ansluta.

    Copilot Studio kontaktar MCP-servern, förhandlar om protokollhandskakningen och listar sedan de verktyg som servern tillhandahåller.

  7. Gå igenom listan över verktyg som visas.

    För varje verktyg, kontrollera namnet och beskrivningen. Om ett verktyg inte har en tydlig beskrivning är agenternas svar som involverar verktyget mindre pålitliga. Be MCP-serverns författare att förbättra beskrivningen innan du förlitar dig på verktyget i produktion.

  8. Välj Spara för att slutföra tillägget av servern.

Servern visas i agentens verktygslista under fliken Bygg.

Testa servern

Efter att du lagt till servern, testa den innan du publicerar agenten.

  1. Välj fliken Förhandsgranskning .

  2. Ställ agenten en fråga som kräver ett av serverns verktyg.

  3. Granska agentens svar. Öppna aktivitetsspårningen för att verifiera vilket verktyg som anropades, vilka argument som passades och vad verktyget returnerade. Se Använd aktivitetsspårningen för att felsöka din agent.

Om agenten inte anropar verktyget när du förväntar dig, förfina servernamnet, serverbeskrivningen eller agentens instruktioner. De individuella verktygsnamnen och beskrivningarna kommer från MCP-servern själv. Om de behöver ändras, be MCP-serverns författare att uppdatera dem. Läs mer i Konfigurera agentdetaljer och instruktioner.

Hantera servern efter att du lagt till den

För att ta bort en MCP-server eller stänga av en tillfälligt, använd det standardiserade verktygshanteringsflödet. Lär dig mer i Hantera och ta bort verktyg i en agent (GitHub Copilot).

Om en servers URL, autentisering eller exponerade verktyg ändras efter att du lagt till den, redigera serverposten i samma Tools-dialog för att uppdatera anslutningen och läs verktygslistan igen.

Limits

  • Varje agent kan ansluta till flera MCP-servrar, men det totala antalet MCP-serverinstanser som körs samtidigt i en enskild konversation är begränsat. Om du ansluter fler MCP-servrar än vad gränsen tillåter och agenten försöker använda dem alla i samma omgång, hoppas de extra servrarna över och deras verktyg är inte tillgängliga i den omgången.
  • Håll antalet MCP-servrar kopplade till en enskild agent litet och ta bort servrar du inte längre använder, så att agenten har utrymme att anropa de servrar du bryr dig om.
  • Varje MCP-server räknas mot det totala antalet verktyg en agent kan hosta.
  • Uppdaterades senast