Hinzufügen von MCP-Servern für GitHub Copilot-CLI

Erweitern Sie die Funktionen von Copilot, indem Sie MCP-Server (Model Context Protocol) verbinden, um zusätzliche Kontext- und Werkzeuge bereitzustellen.

In diesem Artikel

Bei Model Context Protocol (MCP) handelt es sich um einen offenen Standard, der definiert, wie Anwendungen Kontext mit großen Sprachmodellen (LLMs) teilen. Sie können GitHub Copilot-CLI MCP-Server mit Copilot verbinden, um Zugriff auf externe Tools, Datenquellen und Dienste zu gewähren. Eine Übersicht über MCP findest du unter Informationen zum Model Context Protocol (MCP).

Hinzufügen eines MCP-Servers

Hinweis

Der GitHub MCP-Server ist Copilot CLI integriert und ist bereits ohne zusätzliche Konfiguration verfügbar. Die folgenden Schritte dienen zum Hinzufügen anderer MCP-Server.

Sie können MCP-Server mithilfe des interaktiven /mcp add Befehls in der CLI hinzufügen oder die Konfigurationsdatei direkt bearbeiten.

Installationsanweisungen, verfügbare Tools und URLs für bestimmte MCP-Server finden Sie in der GitHub MCP-Registrierung.

Verwenden des /mcp add Befehls

  1. Geben Sie /mcp addim interaktiven Modus ein. Es wird ein Konfigurationsformular angezeigt. Verwenden Sie tab , um zwischen Feldern zu navigieren.

  2. Geben Sie neben dem Servernamen einen eindeutigen Namen für den MCP-Server ein. Dies ist der Name, den Sie verwenden, um auf den Server zu verweisen.

  3. Wählen Sie neben dem Servertyp einen Typ aus, indem Sie die entsprechende Nummer drücken. Die folgenden Typen sind verfügbar:

    • Lokal oder STDIO: Startet einen lokalen Prozess und kommuniziert über die Standardeingabe/Ausgabe (stdin/stdout). Beide Optionen funktionieren auf die gleiche Weise. STDIO ist der standardmäßige MCP-Protokolltypname. Wählen Sie daher diese Option aus, wenn Ihre Konfiguration mit VS Codeden Copilot-Cloud-AgentMCP- und anderen MCP-Clients kompatibel sein soll.
    • HTTP oder SSE: Stellt eine Verbindung mit einem MCP-Remoteserver bereit. HTTP verwendet den streambaren HTTP-Transport. SSE verwendet den legacy-HTTP-Code mit Server-Sent Ereignistransport, der in der MCP-Spezifikation veraltet ist, aber weiterhin aus Gründen der Abwärtskompatibilität unterstützt wird.

  4. Die verbleibenden Felder hängen vom ausgewählten Servertyp ab:

    • Wenn Sie "Lokal" oder "STDIO" ausgewählt haben:

      • Geben Sie neben "Befehl" den Befehl ein, um den Server zu starten, einschließlich aller Argumente. Beispiel: npx @playwright/mcp@latest. Dies entspricht sowohl den command- als auch den args-Eigenschaften in der JSON-Konfigurationsdatei.
      • Geben Sie neben Umgebungsvariablen optional Umgebungsvariablen an, die der Server benötigt, z. B. API-Schlüssel oder Token, als JSON-Schlüsselwertpaare. Beispiel: {"API_KEY": "YOUR-API-KEY"}. Die PATH Variable wird automatisch von Ihrer Umgebung geerbt. Alle anderen Umgebungsvariablen müssen hier konfiguriert werden.

    • Wenn Sie HTTP oder SSE ausgewählt haben:

      • Fügen Sie neben der URL die Remoteserver-URL ein. Beispiel: https://mcp.context7.com/mcp.
      • Neben HTTP-Headern können Sie optional HTTP-Header als JSON angeben. Beispiel: {"CONTEXT7_API_KEY": "YOUR-API-KEY"}.

  5. Geben Sie neben "Tools" an, welche Tools vom Server verfügbar sein sollen. Geben Sie die Eingabetaste * ein, um alle Tools einzuschließen, oder geben Sie eine durch Trennzeichen getrennte Liste von Toolnamen an (keine Anführungszeichen erforderlich). Der Standardwert lautet *.

  6. Drücken Sie STRG+S , um die Konfiguration zu speichern. Der MCP-Server wird hinzugefügt und sofort verfügbar, ohne die CLI neu zu starten.

Bearbeiten der Konfigurationsdatei

Sie können auch MCP-Server hinzufügen, indem Sie die Konfigurationsdatei unter ~/.copilot/mcp-config.json bearbeiten. Dies ist nützlich, wenn Sie Konfigurationen freigeben oder mehrere Server gleichzeitig hinzufügen möchten.

Das folgende Beispiel zeigt eine Konfigurationsdatei mit einem lokalen Server und einem Remote-HTTP-Server:

JSON
{
  "mcpServers": {
    "playwright": {
      "type": "local",
      "command": "npx",
      "args": ["@playwright/mcp@latest"],
      "env": {},
      "tools": ["*"]
    },
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR-API-KEY"
      },
      "tools": ["*"]
    }
  }
}

Weitere Informationen zur MCP-Serverkonfiguration finden Sie unter Verbinden von Agents mit externen Tools.

Verwalten von MCP-Servern

Sie können Ihre konfigurierten MCP-Server mit den folgenden /mcp Befehlen Copilot CLIin verwalten.

  • Konfigurierte MCP-Server auflisten: Verwenden Sie den Befehl /mcp show. Dadurch werden alle konfigurierten MCP-Server und deren aktueller Status angezeigt.

  • Details zu einem bestimmten Server anzeigen: Verwenden Sie den Befehl /mcp show SERVER-NAME. Dadurch wird der Status des angegebenen Servers und die Liste der bereitgestellten Tools angezeigt.

  • Bearbeiten der Konfiguration eines Servers: Verwenden Sie den Befehl /mcp edit SERVER-NAME.

  • Löschen eines Servers: Verwenden Sie den Befehl /mcp delete SERVER-NAME.

  • Deaktivieren eines Servers: Verwenden Sie den Befehl /mcp disable SERVER-NAME. Ein deaktivierter Server bleibt konfiguriert, wird jedoch nicht von Copilot für die aktuelle Sitzung verwendet.

  • Aktivieren eines zuvor deaktivierten Servers: Verwenden Sie den Befehl /mcp enable SERVER-NAME.

Verwenden von MCP-Servern

Nachdem Sie einen MCP-Server hinzugefügt haben, kann Copilot automatisch die von ihm bereitgestellten Tools verwenden, wenn sie für Ihren Prompt relevant sind. Sie können auch direkt auf einen MCP-Server und bestimmte Tools in einer Aufforderung verweisen, um sicherzustellen, dass sie verwendet werden.

Weiterführende Lektüre