VS Code MCP einrichten: mcp.json und erster Zugriff

Eine gültige JSON-Datei allein stellt noch keine Verbindung her. Für eine nachvollziehbare Einrichtung müssen Dateipfad, Format und der tatsächlich verwendete Arbeitsbereich zusammenpassen. Beginnen Sie mit genau einem Server und einem erwarteten Leseergebnis. So bleibt sichtbar, ob ein Problem beim Laden der Konfiguration, beim Verbindungsaufbau oder erst beim Werkzeugaufruf entsteht. Dieser Leitfaden zeigt dafür den öffentlichen tracevero-Endpunkt; Sie benötigen dafür keinen tracevero-Zugangsschlüssel.

Welche mcp.json gehört zu welchem Format?

VS Code dokumentiert .vscode/mcp.json mit dem Wurzelschlüssel servers und das portable Projektformat .mcp.json mit mcpServers. Für neue Server empfiehlt die Herstellerdokumentation das portable Format. Der tracevero-Baukasten für VS Code erzeugt weiterhin das ausdrücklich bezeichnete VS-Code-Format. Verschieben Sie dessen Inhalt deshalb nicht unverändert in die portable Datei.

Prüfen Sie vor dem Ändern, ob bereits eine Konfiguration vorhanden ist. Ergänzen Sie den Server innerhalb des vorhandenen Objekts und behalten Sie andere Einträge. Legen Sie für den ersten Versuch keine zweite Definition mit demselben Namen in einer anderen Datei an. Notieren Sie den vollständigen Dateipfad und das geöffnete Projekt, damit sich ein späterer Erfolg genau dieser Änderung zuordnen lässt.

tracevero über HTTP verbinden

Das folgende vollständige Beispiel gehört nach .vscode/mcp.json. Es verbindet die öffentliche MCP-Schnittstelle, deren Funktionen unter Entwicklerzugang beschrieben sind. Die Verzeichnisadresse https://tracevero.de/mcp/ ist dagegen eine Webseite und gehört nicht in das Feld url.

{
  "servers": {
    "tracevero": {
      "type": "http",
      "url": "https://api.tracevero.com/mcp"
    }
  }
}

Für die portable Datei .mcp.json verwenden Sie stattdessen diese Form. Wählen Sie für den Test eine der beiden Dateien. Die Beispiele enthalten keine lokalen Startbefehle und installieren kein Serverpaket; der Editor verbindet sich mit einem entfernten Dienst.

{
  "mcpServers": {
    "tracevero": {
      "url": "https://api.tracevero.com/mcp"
    }
  }
}

Den ersten Zugriff überprüfbar machen

1. Öffnen Sie die gewählte Datei im richtigen Arbeitsbereich und prüfen Sie die JSON-Syntax. Halten Sie vorhandene Einträge und Ihre Änderung getrennt nachvollziehbar.

2. Öffnen Sie MCP: List Servers und wählen Sie den eingerichteten Server. Prüfen Sie Startzustand und bei Problemen Show Output. Beachten Sie Freigaben Ihres Arbeitsbereichs und Ihrer Organisation.

3. Lassen Sie sich die verfügbaren Werkzeuge anzeigen. Beginnen Sie mit search, beispielsweise für den Begriff filesystem. Die Registersuche ist lesend.

4. Vergleichen Sie einen gefundenen Namen und seinen Beleglink mit der Websuche. Notieren Sie Datum und Suchbegriff. Eine übereinstimmende Antwort ist ein konkreter Befund; eine lediglich sichtbare Serverzeile ist es noch nicht.

Wenn der Server oder seine Werkzeuge fehlen

Kontrollieren Sie zuerst, ob Sie die Datei bearbeiten, die zum geöffneten Projekt gehört. Prüfen Sie danach Dateiwurzel, URL und die Freigabe des Servers. Ändern Sie jeweils nur eine Einstellung und wiederholen Sie denselben Lesetest. Ein fremder Server kann andere Anmeldeschritte benötigen; übernehmen Sie deshalb keine pauschalen Header aus einem anderen Beispiel.

Wenn der Dienst erreichbar ist, der Editor aber keine Werkzeuge anbietet, hilft der Leitfaden für fehlende Werkzeuge. Für einen unabhängigen Protokolltest nutzen Sie die Inspector-Anleitung. Dokumentieren Sie bei einem Fehler den letzten erfolgreichen Schritt und eine bereinigte Meldung. Ein Test mit dem Inspector ersetzt keinen abschließenden Test im tatsächlich eingesetzten Editor.

Kann ich mcpServers einfach in servers umbenennen?

Nur zusammen mit dem passenden Dateiformat. Prüfen Sie außerdem alle serverbezogenen Felder; ein einzelner umbenannter Schlüssel ist keine vollständige Konvertierung.

Warum ist die Konfiguration im anderen Projekt nicht sichtbar?

Eine Projektdatei gehört zu ihrem Arbeitsbereich. Wählen Sie eine Profilkonfiguration bewusst, wenn Sie dieselbe Verbindung projektübergreifend verwenden möchten.

Muss ich für dieses Beispiel Node installieren?

Der gezeigte HTTP-Eintrag startet keinen lokalen Node-Prozess. Ein anderer Server mit einem lokalen Startbefehl kann eine Laufzeit benötigen.

Ist damit jeder MCP-Server für VS Code bestätigt?

Nein. Der Ablauf prüft genau Ihre ausgewählte Verbindung und Operation. Die Clientübersicht und das Register enthalten keinen pauschalen Kompatibilitätsnachweis.

Herstellerquellen, abgerufen am 1. Oktober 2026. Die Testabläufe sind redaktionelle Vorschläge.

1. VS Code: MCP configuration and management
   Abrufbefehl anzeigen

   curl -s https://code.visualstudio.com/docs/agent-customization/mcp-servers

Alle Beiträge