Skip to main content

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

Erweitere die Funktionalitäten von Copilot, indem du MCP-Server (Model Context Protocol) anbindest, um zusätzliche Tools und Kontext bereitzustellen.

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

Hinzufügen eines MCP-Servers

Hinweis

Der GitHub MCP-Server ist in Copilot CLI eingebaut und 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 unter GitHub MCP Registry.

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 Code, den Copilot Codierungsassistent 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. <!-- markdownlint-disable-line GHD046 -->
      
  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 Erweiterung des GitHub Copilot Codierungsagenten mit dem Model Context Protocol (MCP).

Verwalten von MCP-Servern

Du kannst deine konfigurierten MCP-Server mit den folgenden /mcp Befehlen in der Copilot CLI 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 zwar konfiguriert, wird aber von Copilot in der aktuellen Sitzung nicht verwendet.
    
  •         **Aktivieren eines zuvor deaktivierten Servers:** Verwenden Sie den Befehl `/mcp enable SERVER-NAME`.
    

Verwenden von MCP-Servern

Sobald du einen MCP-Server hinzugefügt hast, kann Copilot automatisch die bereitgestellten Tools nutzen, wenn sie für deinen 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

  •         [AUTOTITLE](/copilot/concepts/about-mcp)
    
  •         [AUTOTITLE](/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp)
    
  •         [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp)