Dela via


Utöka din agent med Model Context Protocol

Ett annat sätt att utöka din agent med verktyg är via Model Context Protocol (MCP).

Vad är Modellkontextprotokoll?

MCP (Model Context Protocol, modellkontextprotokoll) gör det möjligt för användare att ansluta till befintliga kunskapsservrar och datakällor direkt inuti Copilot Studio. Om du ansluter till en MCP-server får du tillgång till:

  • Resurser: Filliknande data som klientprogram kan läsa (t.ex. API-svar eller filinnehåll)
  • Verktyg: Funktioner som en språkmodell kan anropa
  • Prompter: Fördefinierade promptmallar för att utföra specifika uppgifter

Obs

Copilot Studio stöder för närvarande endast verktyg.

Hur fungerar MCP?

Varje verktyg som publiceras av MCP-servern läggs automatiskt till som ett verktyg i Copilot Studio. Namn, beskrivning, indata och utdata ärvs från servern. När verktyg uppdateras eller tas bort på MCP-servern återspeglar Copilot Studio dessa ändringar dynamiskt, vilket säkerställer att användarna alltid har de senaste versionerna och att föråldrade verktyg tas bort. En enskild MCP-server kan integrera och hantera flera verktyg, var och en tillgänglig som ett verktyg i Copilot Studio.

När du ansluter till en produkt som inte kommer från Microsoft, inklusive en extern MCP-server, ansvarar du för de verktyg och data som du kommer åt från Copilot Studio.

Obs

Generativ orkestrering måste vara aktiverat för att använda MCP.

Vad är processen för att utöka en agent med MCP i Copilot Studio?

För att integrera MCP i Copilot Studio:

  1. Skapa en MCP-server.
  2. Skapa en anpassad MCP-anslutningsapp baserat på YAML-schemamallen som anges nedan.
  3. Använd via Copilot Studio genom att lägga till verktyg från en befintlig MCP-anslutningsprogram till en agent.
  4. (Valfritt) Publicera MCP-anslutningsappen så att anslutningsappen kan användas mellan klienter.

Skapa en MCP-server

Du kan använda MCP-programutvecklingspaket (SDK:er) för att konfigurera en MCP-server på något av de språk som stöds.

Skapa ett anpassat MCP-anslutningsprogram

Transporter som stöds

I MCP är , transporter grunden för klient-server-kommunikation. Transporter hanterar mekaniken för att skicka och ta emot meddelanden. Copilot Studio stöder för närvarande följande transporttyper:

  • Streamable – rekommenderas (allmänt tillgängligt)
  • Server-Sent Events (SSE) (offentlig förhandsversion)

Obs

Med tanke på att SSE-transporten är inaktuell förblir SSE-transportstödet i MCS i offentlig förhandsversion. Copilot Studio stöder inte längre SSE för MCP från och med augusti 2025.

Konfigurera en anpassad anslutning

När MCP-servern har konfigurerats måste du konfigurera ett anpassat anslutningsprogram (via Power Apps eller Power Automate) för MCP-servern. För att utföra den här proceduren behöver du en schemafil för MCP-servern. Schemafilen är en OpenAPI YAML-specifikationsfil som beskriver API:et för MCP-servern.

Information om hur specifikationsfilen ska se ut finns i några av de tillhandahållna MCP-serverschemaexemplen.

  1. Välj Agenter i vänster navigering.

  2. Välj din agent i listan över agenter.

  3. Gå till sidan Verktyg för din agent.

  4. Välj Lägg till ett verktyg.

  5. Välj Nytt verktyg.

  6. Välj Anpassad anslutning. Du förs till Power Apps för att skapa ett nytt anpassat anslutningsprogram.

  7. Välj Nytt anpassat anslutningsprogram.

  8. Välj Importera OpenAPI-fil.

  9. Navigera till schemafilen och välj Importera för att importera filen.

  10. Välj Fortsätt för att slutföra installationen i Power Apps. Du kan läsa mer om installationsprocessen i Power Apps-dokumentationen på . Importera OpenAPI-definitionen.

MCP-serverschemaexempel

Här är två exempel på OpenAPI-schemafiler för MCP-servrar med fiktiva data, i YAML-format. Exemplen visar var och en av de transporter som stöds. Du måste fylla i uppgifterna för din egen MCP-server.

Här är ett exempel på YAML för Streamable (rekommenderas):

swagger: '2.0'
info:
  title: Contoso
  description: MCP Test Specification, YAML for streamable MCP support in Copilot Studio
  version: 1.0.0
host: contoso.com
basePath: /
schemes:
  - https
paths:
  /mcp:
    post:
      summary: Contoso Lead Management Server
      x-ms-agentic-protocol: mcp-streamable-1.0
      operationId: InvokeMCP
      responses:
        '200':
          description: Success

Här är ett exempel på YAML för SSE:


swagger: '2.0'
info:
  title: Contoso
  description: MCP Test Specification, YAML for SSE MCP support in Copilot Studio
  version: 1.0.0
host: contoso.com
basePath: /
schemes:
  - https
paths:
  /mcp/sse:
    get:
      summary: Contoso Lead Management Server
      x-ms-agentic-protocol: mcp-sse-1.0
      operationId: InvokeMCP
      responses:
        '200':
          description: Success 

Microsoft MCP-anslutningar tillgängliga i Copilot Studio

Microsoft tillhandahåller ett antal färdigbyggda MCP-kontakter för att ansluta till Microsoft-tjänster i Copilot Studio. Följande är Microsoft MCP-kontakter som är tillgängliga i Copilot Studio:

  • Dataverse (på engelska)
  • Dynamics 365
    • Försäljning
    • Ekonomi
    • Leverantörskedja
    • Tjänster
  • Tyg

Lägga till verktyg från en befintlig MCP-anslutning till en agent

Du kan ansluta till befintliga MCP-servrar direkt inifrån Copilot Studio. Processen för att lägga till verktyg är densamma, oavsett om det gäller fördefinierade Microsoft MCP-anslutningsappar eller för MCP-anslutningsappar som du skapar själv.

Följ dessa steg för att lägga till en befintlig MCP-anslutning till en agent:

  1. Välj Agenter i vänster navigering.

  2. Välj din agent i listan.

  3. Gå till sidan Verktyg för din agent.

  4. Välj Lägg till ett verktyg.

  5. Välj Modellkontextprotokoll. En lista över MCP-kontakter visas.

  6. Välj önskat MCP-anslutningsprogram i listan.

  7. Auktorisera anslutningen genom att ange all information som behövs.

  8. När du är klar väljer du Lägg till i agenten eller Lägg till och konfigurerar för att fortsätta.

    Det första alternativet lägger helt enkelt till MCP-anslutningsappen och dess verktyg till agenten, medan det andra lägger till anslutningsappen och dess verktyg samtidigt som du kan konfigurera information för anslutningsappen.

MCP-verktyget läggs till i din agent under Verktyg.

Visa listan över verktyg som medföljer MCP-anslutningsappen

Så här visar du listan över verktyg som medföljer MCP-servern som lagts till i agenten:

  1. Gå till fliken Verktyg för din agent.

  2. Välj MCP-anslutningsappen i listan över verktyg.

    En inställningssida för MCP-anslutningsappen visas.

  3. Gå till avsnittet Verktyg för att se en lista över de verktyg som stöds av MCP-servern.

Kända problem och planerade förbättringar

Följande är identifierade problem som produktteamet är medvetet om och arbetar med:

Problem Lösning/nödlösning
För närvarande måste slutpunkten som returneras i anropet Öppna SSE-anslutning vara en fullständig URI. Inte tillämpligt