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

[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 blir varje verktyg som servern exponerar tillgängligt för agenten att anropa under en konversation.

Använd denna guide när du vill lägga till en MCP-server till en agent i den nya upplevelsen. För en översikt av verktygstyper i den nya upplevelsen, se Tillgängliga verktyg för agenter.

Förutsättningar

• 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. Om du inte har en än, se Create a new Model Context Protocol (MCP)-server.
• Alla inloggningsuppgifter som krävs av servern (till exempel en API-nyckel eller ett klient-ID och en hemlighet för ett stödd autentiseringssystem).

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 verktygsnamnet, verktygsbeskrivningen eller agentens instruktioner. Se 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. Se Hantera och ta bort verktyg i en agent.

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 kan köras 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.

Relaterad information

• Verktygsöversikt för agenter
• Tillgängliga verktyg för agenter
• Lägg till ett verktyg till en agent
• Hantera och ta bort verktyg i en agent
• Skapa en ny Model Context Protocol (MCP)-server
• Model Context Protocol (MCP) i Copilot Studio översikt