Verbinden Sie sich mit Copilot Studio MCP mit Visual Studio Code und GitHub Copilot CLI

Fügen Sie Copilot Studio MCP zu Visual Studio Code oder GitHub Copilot CLI hinzu, indem Sie das von Microsoft veröffentlichte npm-Paket verwenden. Dein Client startet den Server mit npx und kommuniziert mit ihm über STDIO. Melden Sie sich an und wählen Sie eine Umgebung aus, um auf die Tools des verbundenen Dienstes zuzugreifen.

Prerequisites

  • Führen Sie die Konfiguration des Zugriffs auf Copilot Studio MCP durch, einschließlich Node.js, npm und npx der Verfügbarkeit an dem Ort, an dem der Server läuft.
  • Für Visual Studio Code installieren Sie eine unterstützte Version mit GitHub Copilot-Chat und MCP-Zugriff.
  • Installieren Sie für GitHub Copilot CLI eine unterstützte Version von GitHub Copilot CLI.
  • Stellen Sie sicher, dass Ihr Unternehmen das @microsoft/copilot-studio-mcp Paket zulässt.

Du musst das öffentliche Dokumentations-Repository nicht klonen oder eine entfernte MCP-URL konfigurieren.

Visual Studio Code

Aus der Registrierung installieren

  1. Öffnen Sie die Extensions-Ansicht und suchen Sie nach @mcp copilot-studio.

  2. Wählen Sie den Microsoft Copilot Studio MCP-Eintrag aus und überprüfen Sie dessen Publisher-, Paket- und Installationsanforderungen.

  3. Wählen Sie Install oder verwenden Sie Install in Workspace, wenn Sie eine arbeitsbereichsbezogene Konfiguration benötigen.

  4. Überprüfen Sie die Konfiguration und die Abfrage zur Server-Vertrauenswürdigkeit, bevor Sie den Server starten.

Du kannst den Server auch in der GitHub MCP Registry finden und die Visual Studio Code-Installationsoption nutzen, wenn verfügbar. Das README des öffentlichen Repositoriums stellt die Serverdokumentation bereit. NPM liefert das lauffähige Paket.

Konfigurieren Sie den Server manuell

Als Alternative zur Installation über die Registrierung fügen Sie diese Konfiguration zu .vscode/mcp.json hinzu:

{
  "servers": {
    "copilot-studio-mcp": {
      "command": "npx",
      "args": ["-y", "@microsoft/copilot-studio-mcp@latest"]
    }
  }
}

Führen Sie den Eintrag in ein bestehendes servers-Objekt zusammen, anstatt nicht zugehörige Server zu überschreiben. Um stattdessen den Bereich „Benutzerprofil“ zu verwenden, führen Sie MCP: Benutzerkonfiguration öffnen aus.

Starte den Server mit den MCP-Steuerungen von Visual Studio Code und überprüfe die Vertrauensaufforderung. npx ruft das Paket ab und startet es. Es gewährt Copilot Studio keine Berechtigungen und autorisiert keine Geschäftstätigkeiten. Die Option -y akzeptiert die Eingabeaufforderung von npm zum Abrufen von Paketen, jedoch keine Vertrauensbestätigungen für Clients, keine Einwilligungen zur Authentifizierung und keine Genehmigungen für Tool-Aktionen. @latest verwendet die aktuell neueste Version von npm. Verwenden Sie eine genehmigte, feste Version, wenn Ihre Organisation eine Versionsfixierung verlangt.

Visual Studio Code unterstützt zudem eine portable Konfiguration mit einem mcpServers-Objekt auf oberster Ebene, einschließlich einer .mcp.json-Arbeitsbereichsdatei. Verwenden Sie das Schema für Ihr Ziel. GitHub Copilot CLI liest die Visual Studio Code-spezifische .vscode/mcp.json Datei nicht.

Erfahren Sie mehr unter Hinzufügen und Verwalten von MCP-Servern in VS Code.

Nutze die Tools im Chat

  1. Öffnen Sie einen Chatmodus, der Tools unterstützt, und aktivieren Sie die MCP-Tools von Copilot Studio.

  2. Beginnen Sie mit dieser Anfrage:

    Mit Copilot Studio MCP verbinden und meine verfügbaren Umgebungen anzeigen, damit ich eine auswählen kann. Erstelle, veröffentliche, führe aus oder repariere nichts.

  3. Melden Sie sich im Browser an und wählen Sie die gewünschte Umgebung aus.

  4. Nachdem Sie sich verbunden haben, aktualisieren Sie die verfügbaren Werkzeuge, wenn Sie aufgefordert werden, und versuchen Sie dann diese Anfrage:

    Zeigen Sie die in dieser Verbindung verfügbaren MCP-Fähigkeiten des Copilot Studio und bestätigen Sie die Zielumgebung. Nehmen Sie keine Änderungen vor.

GitHub Copilot-CLI

Den Server interaktiv hinzufügen

  1. Starte GitHub Copilot CLI.

  2. Geben Sie /mcp add ein.

  3. Setze den Servernamen auf copilot-studio-mcp.

  4. Setzen Sie Servertyp auf STDIO oder Local. Diese Optionen starten einen Prozess, im Gegensatz zur HTTP-Option.

  5. Setze Command auf npx -y @microsoft/copilot-studio-mcp@latest.

  6. Prüfen Sie, welche Tools Sie aktivieren möchten, gemäß den Richtlinien Ihrer Organisation. Die Bereitstellung von Tools ersetzt nicht die Genehmigung für Maßnahmen mit weitreichenden Folgen.

  7. Drücken Sie STRG+S , um zu speichern.

Auf diese Weise hinzugefügte Server sind verfügbar, ohne die CLI neu starten zu müssen. Schließen Sie die Anmeldung und Umgebungsauswahl ab, bevor Sie die Tools des verbundenen Dienstes nutzen.

Fügen Sie den Server vom Terminal aus hinzu

Als Alternative zur interaktiven Form registrieren Sie den lokalen Server vom Terminal aus:

copilot mcp add copilot-studio-mcp -- npx -y @microsoft/copilot-studio-mcp@latest

Dieser Befehl fügt den Server zu deiner Benutzerkonfiguration hinzu. Es gewährt keine Service-Berechtigungen, stellt keine Connectorverbindung her und autorisiert keine Bereitstellung.

Konfigurieren Sie den Server manuell

Für die Benutzerkonfiguration unter Windows bearbeiten Sie %USERPROFILE%\.copilot\mcp-config.json im Standardkonfigurationsort:

{
  "mcpServers": {
    "copilot-studio-mcp": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "@microsoft/copilot-studio-mcp@latest"],
      "tools": ["*"]
    }
  }
}

Mit bestehenden Einträgen zusammenführen. Wenn du ein benutzerdefiniertes Konfigurationsverzeichnis verwendest, nutze stattdessen dieses Verzeichnis. Die Einstellung tools stellt die beworbenen Tools dem Kunden zur Verfügung. Es billigt nicht jede Handlung, die sie ausführen können.

Bei projektbezogenen Einstellungen sind die vom Kunden dokumentierten Konfigurations- und Workspace-Trust-Anforderungen zu beachten. Erfahren Sie mehr in Hinzufügen von MCP-Servern für GitHub Copilot CLI.

Bestätigen der Verbindung

Verwenden Sie /mcp, um den registrierten Server zu überprüfen. Überprüfen Sie den Zustand und die verfügbaren Werkzeuge und verwenden Sie dann die Verbindungsanfrage im Abschnitt „Die Werkzeuge im Chat verwenden“, um sich anzumelden und eine Umgebung auszuwählen. Verwenden Sie eine bereits verfügbare Verbindung erneut, anstatt sich erneut anzumelden.

Für umfassendere Aufgaben siehe Use Copilot Studio MCP und die Beispielanfragen.

Fehlerbehebung der Client-Verbindung

Symptom Action
npx wurde nicht gefunden Überprüfen Sie, ob Node.js und npm installiert und auf dem vom MCP-Client verwendeten PATH verfügbar sind. Überprüfen Sie in der Fernentwicklung die Maschine oder den Container, der den Server betreibt.
NPM kann das Paket nicht abrufen Bestätigen Sie den genauen Microsoft-Paketnamen sowie den genehmigten npm- und Netzwerkzugriff.
Der Server befindet sich nicht in der Registrierung Bestätigen Sie, dass der Eintrag in der konfigurierten Registry Ihres Kunden verfügbar ist. Nutze manuelle Konfiguration, falls das NPM-Paket erlaubt ist.
Die Konfiguration wird nicht erkannt Überprüfen Sie den Dateistandort und das oberste Objekt: servers für Visual Studio Code-spezifische Konfiguration, mcpServers für das portable und das CLI-Format.
Der Server ist deaktiviert oder blockiert Überprüfen Sie das Clientvertrauen, aktivierte Tools und die Serverrichtlinien der Organisation. Umgehen Sie die Richtlinien nicht, um eine Verbindung herzustellen.
Authentifizierung kann nicht abgeschlossen werden Überprüfen Sie die Anforderungen für Konto, Einwilligung und Anmeldung im Browser. Füge keinen Token als Workaround in den Chat ein.
Es erscheinen nur Verbindungstools Schließen Sie die Anmeldung und die Auswahl der Umgebung ab und aktualisieren Sie anschließend die Tool-Erkennung mithilfe der vom Client unterstützten Steuerelemente.
Der Antworttyp ist unterbrochen Überprüfen Sie den zuletzt bekannten Status des Vorgangs, bevor Sie es erneut versuchen. Eine Client-Unterbrechung bricht die serverseitige Arbeit möglicherweise nicht ab.

Nutzen Sie die Serververwaltungssteuerungen des Clients, um die Registrierung bei Bedarf zu stoppen, zu deaktivieren oder zu entfernen. Diese Aktion löscht keine Artefakte von Copilot Studio und macht keine vorherigen Änderungen rückgängig.

  • Zuletzt aktualisiert um