Freigeben über


Verwenden von MCP-Servern

Model Context Protocol (MCP) ist ein offener Standard, mit dem KI-Modelle über eine einheitliche Schnittstelle mit externen Tools und Diensten interagieren können. In Visual Studio verbessert die MCP-Unterstützung den GitHub Copilot-Agentmodus, indem Sie alle MCP-kompatiblen Server mit Ihrem agentischen Codierungsworkflow verbinden können.

Dieser Artikel führt Sie durch das Einrichten von MCP-Servern und die Verwendung von Tools mit dem Agentmodus in Visual Studio.

Voraussetzungen

Visual Studio 2026 Oder Visual Studio 2022 , Version 17.14 (mit der neuesten Wartungsversion, die für die meisten up-to-date MCP-Features empfohlen wird)

So erweitern MCP und Visual Studio den GitHub Copilot-Agent

MCP-Unterstützung in Visual Studio funktioniert wie folgt:

  • MCP-Clients, z. B. Visual Studio, stellen eine Verbindung mit MCP-Servern her und fordern Aktionen im Auftrag des KI-Modells an.
  • MCP-Server bieten ein oder mehrere Tools, die bestimmte Funktionen über eine gut definierte Schnittstelle verfügbar machen.
  • Das Protokoll definiert das Nachrichtenformat für die Kommunikation zwischen Clients und Servern, einschließlich Toolermittlung, Aufruf und Antwortbehandlung.

Beispielsweise kann ein MCP-Server für ein Dateisystem Tools zum Lesen, Schreiben oder Durchsuchen von Dateien und Verzeichnissen bereitstellen. Der offizielle GitHub MCP-Server bietet Tools zum Auflisten von Repositorys, zum Erstellen von Pullanforderungen oder zum Verwalten von Problemen. MCP-Server können lokal auf Ihrem Computer ausgeführt oder remote gehostet werden. Visual Studio unterstützt beide Konfigurationen.

Durch die Standardisierung dieser Interaktion beseitigt MCP die Notwendigkeit benutzerdefinierter Integrationen zwischen jedem KI-Modell und jedem Tool. Anschließend können Sie die Funktionen Ihres KI-Assistenten erweitern, indem Sie einfach neue MCP-Server zu Ihrem Arbeitsbereich hinzufügen. Erfahren Sie mehr über die MCP-Spezifikation.

Unterstützte MCP-Funktionen

Visual Studio unterstützt die folgenden MCP-Funktionen:

  • Die Optionen für den MCP-Servertransport sind lokale Standardeingabe/Ausgabe (stdio), servergesendete Ereignisse (sse) und streambares HTTP (http).
  • Von den Features (Tools, Eingabeaufforderungen, Ressourcen, Sampling) unterstützt Visual Studio jetzt:
    • Tools: Ausführen von Aktionen und Vorgängen über den Copilot-Agentmodus
    • Eingabeaufforderungen: Wiederverwendbare Eingabeaufforderungsvorlagen, die Sie mit Parametern aufrufen können
    • Ressourcen: Zugreifen auf externe Daten und Kontext über URI-basierte Ressourcen
    • Sampling: Verbesserte KI-Modellinteraktionen mit Ihren Tools und Diensten
  • Visual Studio stattet Server mit den aktuellen Lösungsordnern aus, indem es roots (Spezifikation) verwendet.
  • Für die MCP-Autorisierung unterstützt Visual Studio die Authentifizierung für Remoteserver mit jedem OAuth-Anbieter.

Suchen nach MCP-Servern

Das offizielle MCP-Server-Repository ist ein großartiger Ausgangspunkt für Referenz-, offizielle und Community-beteiligte Server, die die Vielseitigkeit von MCP zeigen. Sie können Server nach verschiedenen Funktionen durchsuchen, z. B. Dateisystemvorgänge, Datenbankinteraktionen und Webdienste.

MCP ist ein relativ neuer Standard, und das Ökosystem entwickelt sich schnell weiter. Wenn mehr Entwickler MCP einführen, können Sie davon ausgehen, dass immer mehr Server und Tools für die Integration in Ihre Projekte verfügbar sind.

Beispiel-MCP-Server

Probieren Sie einige andere beliebte MCP-Server in Visual Studio mit einem Klick aus:

  • Installieren Sie Awesome MCP in Visual Studio – Entdecken und installieren Sie benutzerdefinierte Eingabeaufforderungen und Anweisungen für GitHub Copilot.
  • Installieren Sie MarkItDown MCP in Visual Studio – Konvertieren Sie verschiedene Dateiformate (PDF, Word, Excel, Bilder, Audio) in Markdown.
  • Installieren Sie DuckDB Server in Visual Studio – Abfragen und Analysieren von Daten in DuckDB-Datenbanken lokal und in der Cloud.
  • Installieren Sie MongoDB MCP in Visual Studio – Datenbankvorgänge und -verwaltung. Führen Sie Abfragen aus, verwalten Sie Sammlungen, Aggregationspipelinen und Dokumentvorgänge.
  • Installieren Sie HuggingFace MCP in Visual Studio – Access-Modelle, Datasets und Spaces auf dem Hugging Face Hub.

Optionen zum Hinzufügen eines MCP-Servers

Sie haben mehrere Optionen, um einen MCP-Server in Visual Studio hinzuzufügen.

Installieren aus dem Web

Ab der neuesten Wartungsversion von Version 17.14 unterstützt Visual Studio die direkte Installation von MCP-Servern. Wählen Sie die Schaltfläche " Installieren " auf einem MCP-Server aus, um sie automatisch zu Ihrer Visual Studio-Instanz hinzuzufügen.

Hinzufügen eines MCP-Servers aus dem Chat

So fügen Sie einen MCP-Server aus der Chatansicht hinzu:

  1. Wählen Sie in der Toolauswahl im Chatfenster die grüne Plusschaltfläche (+) aus.

    Screenshot der Plusschaltfläche in der Toolauswahl von Visual Studio-Chat zum Hinzufügen des MCP-Servers.

  2. Geben Sie den Servernamen und Verbindungsdetails an, z. B. die URL für HTTP-Server oder den Befehl und die Argumente für Stdioserver.

    Screenshot, der das Hinzufügen eines MCP-Servers aus der Chatansicht zeigt.

Hinzufügen eines MCP-Servers aus der GitHub MCP-Serverregistrierung

Sie können einen MCP-Server direkt über die GitHub MCP-Serverregistrierung über Erweiterungen in Visual Studio installieren.

  1. Wählen Sie im Visual Studio-Menü "Erweiterungen > MCP-Regsitries" aus , um den MCP-Server-Manager zu öffnen.

    Screenshot des Menüs

  2. Wählen Sie den gewünschten Server und dann die Installation für Ihre Visual Studio-Instanz aus.

    Screenshot, der das Hinzufügen eines MCP-Servers aus dem MCP-Server-Manager zeigt.

Hinzufügen eines MCP-Servers zur .mcp.json Datei

Die folgenden Schritte führen Sie durch ein Konfigurationsbeispiel mit dem GitHub MCP-Server:

  1. Erstellen Sie eine neue Datei: <SOLUTIONDIR>\.mcp.json oder %USERPROFILE%\.mcp.json. Verwenden Sie Visual Studio, um diese Datei so zu bearbeiten, dass das JSON-Schema automatisch angewendet wird.

  2. Fügen Sie den folgenden Inhalt in die .mcp.json Datei ein:

    {
      "servers": {
        "github": {
          "url": "https://api.githubcopilot.com/mcp/"
        }
      }
    }
    
  3. Speichern Sie die Datei.

  4. Wählen Sie in der Datei die Authentifizierung erforderlich aus den CodeLens aus, die angezeigt wird, um sich über ein GitHub-Konto beim Server zu authentifizieren. Wählen Sie im Popupdialogfeld "Authentifizieren" aus, um sich mit Ihrem GitHub-Konto zu authentifizieren.

    Screenshot der CodeLens-Authentifizierung.

    Wenn codeLens nicht angezeigt wird, stellen Sie sicher, dass sie in den Tools>Options>Text Editor>CodeLens aktiviert ist.

  5. Wähle unten im Chatpanel in der Dropdownliste den Modus Agent aus.

    Screenshot, der den Auswahlmodus für den Copilot-Agenten zeigt.

  6. Wählen Sie die Tools aus, die Sie verwenden möchten, z. B. Probleme auflisten.

    Screenshot der MCP-GitHub-Tools.

    Probieren Sie eine Beispielaufforderung aus: Auf GitHub zugewiesene Probleme auflisten.

  7. Copilot fordert die Berechtigung zur Verwendung eines Tools an, das der MCP-Server dafür zur Verfügung gestellt hat. Wählen Sie "Zulassen" mit dem Bereich aus, mit dem Sie fortfahren möchten.

    Screenshot, der Bestätigungsoptionen für Agenttools zeigt.

Erstellen einer Datei zum Verwalten der Konfiguration von MCP-Servern

Wenn Sie noch keine Datei haben mcp.json , erstellen Sie eine an einem der unterstützten Speicherorte basierend auf Ihren Repository-, Benutzer- oder Editoranforderungen.

Um einen MCP-Server hinzuzufügen, suchen Sie die JSON-Konfiguration des Servers online. Suchen Sie es beispielsweise im GitHub-Repository für MCP-Server. Fügen Sie sie dann in Ihre mcp.json Datei ein.

Dateispeicherorte für die automatische Ermittlung der MCP-Konfiguration

Visual Studio sucht auch nach MCP-Konfigurationen, die andere Entwicklungsumgebungen eingerichtet haben. Er liest MCP-Serverkonfigurationen aus den folgenden Verzeichnissen in der folgenden Reihenfolge:

  1. %USERPROFILE%\.mcp.json
    Dient als globale MCP-Serverkonfiguration für einen bestimmten Benutzer. Wenn Sie hier einen MCP-Server hinzufügen, wird er für alle Visual Studio-Lösungen geladen.
  2. <SOLUTIONDIR>\.vs\mcp.json
    Spezifisch für Visual Studio und lädt die angegebenen MCP-Server nur für einen bestimmten Benutzer, für die angegebene Lösung.
  3. <SOLUTIONDIR>\.mcp.json
    Funktioniert gut, wenn Sie nach einer MCP-Konfiguration suchen, die Sie in der Quellcodeverwaltung für ein Repository nachverfolgen können.
  4. <SOLUTIONDIR>\.vscode\mcp.json
    Bereich des Repositorys/der Lösung und in der Regel nicht von der Quelle gesteuert.
  5. <SOLUTIONDIR>\.cursor\mcp.json
    Bereich des Repositorys/der Lösung und in der Regel nicht von der Quelle gesteuert.

Einige dieser Standorte erfordern .mcp.json, während andere mcp.json erfordern.

MCP-Konfigurationsformat

Sie können Sowohl Remoteserver (URL als auch Anmeldeinformationen) und lokale Server (Befehlszeilenaufrufe) definieren.

Es ist üblich, Tools über Paketmanager aufzurufen; z. B npx -y @azure/mcp@latest . oder docker run ... mcp/github. Visual Studio respektiert den von Ihnen angegebenen Befehl, sodass Sie Versionen anheften oder kennzeichnungen nach Bedarf übergeben können.

Das Format muss der MCP-Spezifikation entsprechen. Sie muss z. B. ein Array von Serverobjekten enthalten, jeweils mit name, command oder url, und transport.

Bearbeiten der MCP-Konfiguration

Wenn Sie eine vorhandene mcp.json Datei haben und die Datei in Ihr Versionssteuerungssystem einchecken, fügen Sie den Dateispeicherort zu Lösungsbestandteile im Projektmappen-Explorer hinzu.

Wenn Sie die Datei mit gültiger Syntax speichern, startet der GitHub Copilot-Agent neu und lädt die konfigurierten Server neu.

Screenshot, der das Hinzufügen des MCP-Konfigurationsdateispeicherorts zu den Solution Items zeigt.

Toollebenszyklus

Sobald Visual Studio einen Server erkennt oder hinzufügt:

  • Er initialisiert den Server, indem er einen Handshake ausführt und die Toolliste abfragt.
  • Es abonniert das MCP-Ereignis notifications/tools/list_changed.
  • Wenn dieses Ereignis ausgelöst wird, setzt Visual Studio alle vorherigen Akzeptanzen oder Berechtigungen für Tools zurück (um Rug-Pull-Angriffe zu verhindern), ruft die Toolliste ab und aktualisiert die Anzahl und die Benutzeroberfläche sofort.
  • Wenn Visual Studio den Server erfolgreich aktiviert, stellt der Agent die Tools zur Verfügung. Die Tools sind standardmäßig deaktiviert, und Sie müssen sie manuell aktivieren.
  • Wenn Sie einen Server entfernen, stoppt Visual Studio den Prozess sofort und zieht alle zugehörigen Tools aus der Benutzeroberfläche zurück.
  • Wenn Sie eine Serverdefinition bearbeiten, beendet und startet Visual Studio sie neu, und fragt sie dann erneut ab.

Verwaltung von Toolgenehmigungen

Wenn Sie ein Tool aufrufen, bittet Copilot um Bestätigung, das Tool auszuführen. Der Grund dafür ist, dass Tools möglicherweise lokal auf Ihrem Computer ausgeführt werden und Aktionen ausführen, die Dateien oder Daten ändern.

Verwenden Sie nach einem Toolaufruf im Chatbereich die Dropdownoptionen "Zulassen ". Sie können das spezifische Tool für die aktuelle Sitzung, die aktuelle Lösung oder alle zukünftigen Aufrufe automatisch bestätigen.

Screenshot, der die Verwaltung von Agent-Tool-Genehmigungen zeigt.

Sie können die Tool-Bestätigungseinstellungen im Bereich Tools>Optionen im Abschnitt Alle Einstellungen>GitHub>Copilot>Tools zurücksetzen.

Screenshot der Toolkonfigurationseinstellungen für GitHub Copilot.

Sie können die Bestätigungsauswahlen der Werkzeuge im Dialogfeld "Werkzeuge" unter "Optionen" im Abschnitt "GitHub Copilot" in der Gruppe "Werkzeuge" zurücksetzen.

Screenshot der Toolkonfigurationseinstellungen.

Verwalten der Autorisierung

Visual Studio unterstützt jetzt die Authentifizierung für Remoteserver mithilfe eines beliebigen OAuth-Anbieters gemäß der MCP-Autorisierungsspezifikation. Die Unterstützung erfolgt zusätzlich zur Integration mit dem Visual Studio Keychain.

So verwalten Sie die Authentifizierung für einen MCP-Server:

  1. Wählen Sie in der .mcp.json Datei " Authentifizierung für diesen Server verwalten" aus "CodeLens" aus.

  2. Geben Sie Anmeldeinformationen für den erforderlichen OAuth-Anbieter für diesen Server im Popupdialogfeld des Browsers an.

MCP-Eingabeaufforderungen und Eingabeaufforderungsvorlagen

MCP-Server können wiederverwendbare Eingabeaufforderungsvorlagen bereitstellen, mit denen Sie effektiver mit Sprachmodellen interagieren können. Diese Eingabeaufforderungen sind auf bestimmte Aufgaben zugeschnitten und können anpassbare Argumente enthalten.

Verwenden Sie MCP-Eingabeaufforderungen

So verweisen Sie auf Eingabeaufforderungen von einem MCP-Server:

  1. Wählen Sie im Chat die Option +Verweis hinzufügen aus.
  2. Wählen Sie Eingabeaufforderungen>MCP-Eingabeaufforderungen aus.
  3. Wählen Sie eine Eingabeaufforderung aus, und wählen Sie "Eingabeaufforderung einfügen" aus.

Einige Eingabeaufforderungen enthalten Argumente, die Sie anpassen können, bevor Sie sie in den Chat einfügen. Diese Eingabeaufforderungen werden als Aufforderungsvorlagen bezeichnet.

Beispiel: Der GitHub MCP-Server bietet Aufforderungen zum Analysieren von Pullanforderungen, generieren Commit-Nachrichten und Überprüfen von Codeänderungen.

Installieren von GitHub MCP in Visual Studio

MCP-Ressourcen und Ressourcenvorlagen

MCP-Ressourcen bieten Kontext zu Sprachmodellen, z. B. Dateien, Datenbankschemas oder anwendungsspezifische Daten. Jede Ressource verfügt über einen eindeutigen URI, auf den Sie im Chat verweisen können.

Verwenden von MCP-Ressourcen

Verweisen Sie auf MCP-Ressourcen im Copilot-Chat mithilfe eines Hashtags (#) gefolgt von dem Ressourcen-URI.

Für Ressourcen mit Argumenten (Ressourcenvorlagen):

  1. Wählen Sie im Chat "Verweis hinzufügen" aus .
  2. Wählen Sie MCP-Ressourcen aus.
  3. Wählen Sie Ihre Ressource aus, geben Sie alle erforderlichen Argumente ein, und wählen Sie "Ressource hinzufügen" aus.

Beispiel: Der Azure DevOps MCP-Server macht Arbeitsaufgabenressourcen, Sprintinformationen und Teamkapazitätsdaten für Projektplanungsaufgaben verfügbar.

Installieren in Azure DevOps MCP Visual Studio

Beispiel: Der Figma MCP-Server bietet Zugriff auf Entwurfskomponentenressourcen, Stilführungslinien und Entwurfsspezifikationen.

Installieren von Figma MCP in Visual Studio

MCP-Sampling

Mithilfe von Samplings können MCP-Server LLM-Aufrufe für Sie tätigen und komplexere, mehrstufige Vorgänge ermöglichen. Visual Studio unterstützt das Sampling automatisch, wenn Ihr MCP-Server es bereitstellt.

Wenn Copilot einen Samplinganruf tätigen muss, wird ein Bestätigungsdialogfeld angezeigt. Überprüfen Sie die Details, und genehmigen Sie sie, bevor die Aktion fortgesetzt wird, und stellen Sie sicher, dass Sie die Kontrolle über automatisierte Vorgänge behalten.

Beispiel: Der Playwright MCP-Server verwendet Samplings, um Testszenarien basierend auf der DOM-Struktur und den Benutzerflüssen Ihrer Anwendung zu generieren.

Installieren von Playwright MCP in Visual Studio

Häufig gestellte Fragen

Wie kann ich als Administrator die Verwendung von MCP-Servern im Agentmodus für Visual Studio-Benutzer steuern?

Die GitHub-Richtlinieneinstellungen im GitHub Copilot-Dashboard für Administratoren steuern den Agentmodus und die MCP-Verwendung in Visual Studio. Wenn der Administrator diese Einstellung deaktiviert, können Benutzer unter diesem Abonnement den Agentmodus nicht verwenden oder eine Verbindung mit MCP-Servern in Visual Studio herstellen.

Weitere Informationen finden Sie unter Verwalten von Richtlinien und Features für GitHub Copilot in Ihrem Unternehmen.