Füge deinem Agenten einen Model Context Protocol (MCP)-Server als Tool hinzu (Vorschau).

[Dieser Artikel ist eine Vorabdokumentation und kann geändert werden.]

Das Model Context Protocol (MCP) ist ein Standard zur Bereitstellung von Tools gegenüber einem Agenten. Wenn du einen MCP-Server zu deinem Agenten hinzufügst, wird jedes vom Server bereitgestellte Tool für den Agenten während eines Gesprächs verfügbar.

Note

Die Funktionen in diesem Artikel werden vom GitHub Copilot-Harness unterstützt, das Copilot Credits für nutzungsbasierte Abrechnung verwendet. Erfahren Sie mehr über Copilot-Credits in Überblick über die Abrechnung von Agenten, die vom GitHub Copilot-Harness betrieben werden.

Nutzungsbasierte Abrechnung gilt für die Nutzung, den Bau, das Testen und die Bewertung von Agenten. Diese Aktionen könnten Copilot-Credits verbrauchen.

Nutze dieses Anleitungsbuch, wenn du einen MCP-Server zu einem Agenten in der neuen Erfahrung hinzufügen möchtest. Für einen Überblick über Tool-Typen in der neuen Erfahrung siehe Verfügbare Tools für Agenten.

Voraussetzungen

  • Ein Agent, der in der neuen Benutzeroberfläche erstellt wurde. Siehe Erstellen eines Agents.
  • Die URL eines MCP-Servers, der von Copilot Studio aus erreichbar ist. Falls du noch keinen hast, siehe Create a new Model Context Protocol (MCP) Server.
  • Alle vom Server benötigten Zugangsdaten (zum Beispiel ein API-Schlüssel oder eine Client-ID und ein Geheimnis für ein unterstütztes Authentifizierungsschema).

Fügen Sie einen MCP-Server über den Bau-Tab hinzu

  1. Melden Sie sich bei Copilot Studio an und eröffnen Sie Ihre Agentur.

  2. Wählen Sie in der Agenten-Navigationsleiste den Reiter "Bauen " aus.

  3. Im Komponentenpanel rechts wählen Sie Werkzeuge aus.

  4. Im Dialogfeld "Werkzeug hinzufügen" wählen Sie neben der Suchleiste "Hinzufügen" und wählen Sie dann Model Context Protocol (MCP).

  5. Auf der Seite " Add MCP Server" geben Sie die folgenden Angaben ein:

    • Name: Ein kurzer, beschreibender Name, der dem Agenten hilft zu entscheiden, wann er die Tools dieses Servers nutzen soll. Dieser Name ist das, was der Agent sieht.
    • Beschreibung: Eine ein- oder zwei-Satz-Zusammenfassung dessen, was der Server tut und wann der Agent es verwenden sollte.
    • Server-URL: das HTTPS-Endpunkt des MCP-Servers.
    • Authentifizierung: Wählen Sie die Authentifizierungsmethode, die der Server verlangt, und geben Sie die benötigten Zugangsdaten oder Konfigurationswerte ein.

  6. Wählen Sie Hinzufügen aus, um die Verbindung herzustellen.

    Copilot Studio kontaktiert den MCP-Server, verhandelt den Protokoll-Handshake und listet dann die Tools auf, die der Server bereitstellt.

  7. Überprüfen Sie die Liste der angezeigten Werkzeuge.

    Überprüfen Sie für jedes Werkzeug den Namen und die Beschreibung. Wenn ein Tool keine klare Beschreibung hat, sind Agentenantworten, die das Tool betreffen, weniger zuverlässig. Bitte den MCP-Server-Autor, die Beschreibung zu verbessern, bevor du dich in der Produktion auf das Tool verlässt.

  8. Wähle Save aus, um den Server fertigzustellen.

Der Server erscheint in der Tools-Liste des Agenten im Reiter "Bauen ".

Testen des Servers

Nachdem du den Server hinzugefügt hast, teste ihn, bevor du den Agenten veröffentlichst.

  1. Wählen Sie den Reiter Vorschau aus.

  2. Stellen Sie dem Agenten eine Frage, die eines der Tools des Servers benötigt.

  3. Überprüfen Sie die Antwort des Agents. Öffnen Sie den Aktivitätstrace, um zu überprüfen, welches Tool aufgerufen wurde, welche Argumente übergeben wurden und was das Tool zurückgegeben hat. Sieh " Aktivitätsverfolgung verwenden, um deinen Agenten zu debuggen".

Wenn der Agent das Tool nicht zu den erwarteten Zeiten aufruft, verfeinere den Tool-Namen, die Werkzeugbeschreibung oder die Anweisungen des Agenten. Siehe Agentendetails und Anweisungen konfigurieren.

Verwalte den Server nach dem Hinzufügen

Um einen MCP-Server zu entfernen oder vorübergehend auszuschalten, verwenden Sie den Standard-Tool-Management-Fluss. Siehe Werkzeuge verwalten und löschen in einem Agenten.

Wenn sich die URL eines Servers, die Authentifizierung oder die offengelegten Tools nach dem Hinzufügen ändern, bearbeite den Servereintrag im gleichen Tools-Dialog , um die Verbindung zu aktualisieren und die Werkzeugliste erneut zu lesen.

Limits

  • Jeder Agent kann sich mit mehreren MCP-Servern verbinden, aber die Gesamtzahl der MCP-Server-Instanzen, die gleichzeitig in einem einzigen Gespräch laufen können, ist begrenzt. Wenn du mehr MCP-Server anhängst, als das Cap erlaubt, und der Agent versucht, sie alle im selben Zug zu nutzen, werden die zusätzlichen Server übersprungen und ihre Werkzeuge sind für diese Runde nicht verfügbar.
  • Halte die Anzahl der MCP-Server, die an einen einzelnen Agenten angeschlossen sind, klein und entferne Server, die du nicht mehr nutzt, damit der Agent Platz hat, die Server zu aktivieren, die dir wichtig sind.
  • Jeder MCP-Server wird auf die Gesamtzahl der Tools angerechnet, die ein Agent bereitstellen kann.
  • Last updated on