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.

Wenn Ihre Organisation oder Ihr Unternehmen eine Registrierungs-URL und Zulassungslistenrichtlinie konfiguriert hat, gelten diese Einstellungen für Copilot CLI. Die konfigurierte Registrierungs-URL wird als Erkennungsquelle angezeigt, und es können nur Server ausgeführt werden, die gemäß der Zulassungslisten-Richtlinie zugelassen sind.

Sie können MCP-Server auf folgende Weise hinzufügen:

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.

Verwenden des Unterbefehls copilot mcp add

Sie können MCP-Server im Terminal mit dem Unterbefehl copilot mcp add hinzufügen, ohne in den interaktiven Modus zu wechseln. Der Server wird der Benutzerkonfiguration hinzugefügt unter ~/.copilot/mcp-config.json.

Geben Sie für lokale Server (stdio) den Befehl nach -- an:

Shell
copilot mcp add SERVER-NAME -- COMMAND [ARGS...]

Geben Sie für Remoteserver (HTTP/SSE) den Transport an, und geben Sie die URL an:

Shell
copilot mcp add --transport http SERVER-NAME URL

Sie können auch zusätzliche Optionen übergeben:

  • --env KEY=VALUE: Festlegen von Umgebungsvariablen für den Server. Wiederholen Sie den Vorgang für mehrere Variablen.
  • --header "HEADER: VALUE": Legen Sie HTTP-Header für Remoteserver fest. Wiederholen Sie dies für mehrere Header.
  • --transport TRANSPORT: Legen Sie den Transporttyp (stdio, httpoder ) fest sse. Der Standardwert lautet stdio.
  • --tools TOOLS: Geben Sie an, welche Tools aktiviert werden sollen. Verwenden Sie * für alle Tools (Standard), eine durch Kommas getrennte Liste oder "" für keines davon.
  • --timeout MS: Festlegen eines Timeouts in Millisekunden.

Beispiele

Hinzufügen eines lokalen Stdioservers:

Shell
copilot mcp add context7 -- npx -y @upstash/context7-mcp

Hinzufügen eines lokalen Servers mit Umgebungsvariablen:

Shell
copilot mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=YOUR_GITHUB_PAT -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

Hinzufügen eines Remote-HTTP-Servers:

Shell
copilot mcp add --transport http notion \
  https://mcp.notion.com/mcp

Hinzufügen eines Remoteservers mit einem Autorisierungsheader:

Shell
copilot mcp add --transport http \
  --header "Authorization: Bearer YOUR-TOKEN" \
  stripe https://mcp.stripe.com

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 Konfigurieren von MCP-Servern für Ihr Repository.

Hinzufügen von MCP-Servern pro Repository

Sie können MCP-Server für ein bestimmtes Projekt konfigurieren, indem Sie dem Repository eine JSON-Datei hinzufügen. Dies ist nützlich, wenn Server nur verfügbar sein sollen, wenn Sie in diesem Projekt arbeiten, oder wenn Sie ein MCP-Setup für Mitarbeiter freigeben möchten, indem Sie es für das Repository übernehmen.

Copilot CLI Sucht in den folgenden Speicherorten nach konfiguration auf Projektebene:

PfadEmpfohlene Verwendung
.mcp.json (in einem beliebigen Verzeichnis zwischen Ihrem Arbeitsverzeichnis und dem Stammverzeichnis des Repositorys)Lokale Konfiguration oder Konfiguration pro Auscheckvorgang; häufig im Projektstamm platziert
.github/mcp.jsonFreigegebene Konfiguration, die an das Repository committet wurde

Wenn Sie Copilot CLI innerhalb eines Git-Repositorys starten, durchläuft die CLI ausgehend von Ihrem aktuellen Arbeitsverzeichnis die Verzeichnisse bis hinauf zum Wurzelverzeichnis des Repositorys und lädt dabei MCP-Konfigurationsdateien. Wenn sowohl .mcp.json als auch .github/mcp.json im selben Verzeichnis vorhanden sind, hat .mcp.json Vorrang. Wenn Servernamen konflikten, haben Definitionen in Dateien, die sich näher am Arbeitsverzeichnis befinden, Vorrang. Project-Ebenendefinitionen haben auch Vorrang vor denen in ~/.copilot/mcp-config.json. Weitere Informationen zur relativen Vertrauensstellung finden Sie unter GitHub Copilot CLI-Befehlsreferenz.

Dateien auf Projektebene können entweder das in ~/.copilot/mcp-config.json gezeigte oberste Objekt mcpServers verwenden oder das einfache Top-Level-Format, bei dem jeder Schlüssel der Name eines MCP-Servers ist. Diese Konfiguration verwendet z. B. das mcpServers Objekt:

JSON
{
  "mcpServers": {
    "playwright": {
      "type": "local",
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}

Derselbe Server kann auch im einfachen Top-Level-Format konfiguriert werden:

JSON
{
  "playwright": {
    "type": "local",
    "command": "npx",
    "args": ["@playwright/mcp@latest"]
  }
}

Hinweis

MCP-Server auf Projektebene werden erst geladen, nachdem Sie beim ersten Start dem Vertrauen des Ordners zugestimmt haben. Sie werden in nicht vertrauenswürdigen Verzeichnissen stillschweigend übersprungen. Weitere Informationen zur Ordnervertrauensstellung finden Sie unter Informationen zu GitHub Copilot CLI.

Im Prompt-Modus (copilot -p) werden MCP-Server auf Projektebene automatisch geladen, wenn das aktuelle Verzeichnis bereits als vertrauenswürdig eingestuft ist. Wenn das Verzeichnis nicht vertrauenswürdig ist, werden MCP-Server auf Projektebene standardmäßig übersprungen. Um sie trotzdem zu laden, setzen Sie die Umgebungsvariable GITHUB_COPILOT_PROMPT_MODE_WORKSPACE_MCP auf true, da der Eingabeaufforderungsmodus keine interaktive Vertrauensabfrage anzeigen kann. Weitere Informationen findest du unter GitHub Copilot CLI-Befehlsreferenz.

Die .vscode/mcp.json Datei für VS Code wird nicht gelesen von Copilot CLI. Er verwendet den nicht unterstützten Schlüssel serversder obersten Ebene. Um ein vorhandenes .vscode/mcp.json in ein Format zu migrieren, das die CLI akzeptiert, siehe GitHub Copilot CLI-Befehlsreferenz.

Suchen und Installieren aus der Registrierung

Hinweis

Der /mcp search Befehl ist derzeit ein experimentelles Feature. Um sie zu verwenden, beginnen Sie Copilot CLI mit der --experimental Befehlszeilenoption, oder geben Sie /experimental on während einer Sitzung ein.

Sie können MCP-Server mithilfe des GitHub Befehls im interaktiven Modus direkt aus der ermitteln und installieren. Auf diese Weise können Sie verfügbare Server durchsuchen, deren Details anzeigen und installieren, ohne das Konfigurationsformular manuell auszufüllen.

Wenn Ihre Organisation eine benutzerdefinierte MCP-Registrierungs-URL konfiguriert hat, stellt /mcp search anstelle der standardmäßigen GitHub-Registrierung eine Verbindung mit dieser Registrierung her.

  1. Geben Sie im interaktiven Modus /mcp search ein, um die Top-Server nach Sternen zu durchsuchen, oder /mcp search QUERY, um nach einem bestimmten Server zu suchen. Beispiel:

    /mcp search context7

  2. Es wird eine tastaturnavigationsfähige Liste der übereinstimmenden Server angezeigt. Verwenden Sie die Pfeiltasten, um die Ergebnisse zu durchsuchen.

  3. Wählen Sie einen Server aus, um das Konfigurationsformular zu öffnen. Das Formular wird vorab mit der Serverkonfiguration aus der Registrierung ausgefüllt. Füllen Sie alle erforderlichen Felder aus, z. B. API-Schlüssel oder Token.

  4. Drücken Sie STRG+S , um sie zu speichern. Der Server wird Ihrem mcp-config.json Server hinzugefügt und sofort gestartet.

Verwalten von MCP-Servern

Sie können Ihre konfigurierten MCP-Server mit den /mcp Befehlen im interaktiven Modus oder den copilot mcp Unterbefehlen über das Terminal verwalten.

Verwenden von /mcp Befehlen im interaktiven Modus

  • 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.

Verwendung von copilot mcp Unterbefehlen im Terminal

Sie können MCP-Server auch über das Terminal verwalten, ohne in den interaktiven Modus zu wechseln.

  • Alle konfigurierten Server auflisten:

    Shell
    copilot mcp list

    Listet Server aus allen Konfigurationsquellen auf (Benutzer, Arbeitsbereich und Plug-In). Fügen Sie --json für die JSON-Ausgabe hinzu.

  • Serverdetails anzeigen:

    Shell
    copilot mcp get SERVER-NAME

    Zeigt den Typ, den Status und die verfügbaren Tools eines Servers an. Fügen Sie --json für die JSON-Ausgabe hinzu.

  • Entfernen eines Servers:

    Shell
    copilot mcp remove SERVER-NAME

    Entfernt den Server aus der Benutzerkonfiguration.

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