Von der Einrichtung
bis zur ersten Verbindung.

01 / VS-Code-Erweiterung installieren

Im VS Code Marketplace suchen nach Claude Code Config Helper; als Herausgeber muss angegeben sein: liliangshan. Die veröffentlichte Version steht dort; lokale Testbuilds können abweichen.

Auch per VSIX installierbar

Bei lokaler VSIX in VS Code Erweiterungen → … → Aus VSIX installieren wählen. Fenster bei Gelegenheit neu laden; laufende CLI-Aufgaben werden dabei unterbrochen.

02 / Drei Einrichtungsschritte abschließen

1. Sprache wählen und CLI vorbereitenCLI über die Einrichtung herunterladen und prüfen oder vorhandene Datei wählen. Offizielle Quelle ist Standard, China-Mirror nur nach expliziter Auswahl.
2. Anbieter und Modelle hinzufügenDienstadresse, Anmeldung und API-Schlüssel einrichten, Modelle abrufen oder manuell ergänzen. Keine kostenpflichtige Testnachricht für die Einrichtung nötig.
3. Arbeitsbereichsmodelle wählen und Chat öffnenStandardmodell, optionale Taskflow-/Komprimierungsmodelle und Denkstufe festlegen. Hauptsitzung rechts; die Parallelsitzung öffnet sich unabhängig links.

03 / Werkzeug wählen und Konfiguration kopieren

Nur lokale Beispiele: keine Serververbindungen, Passworterfassung oder Paketinstallation. Beispieladressen und Pfade ersetzen, Zugangsdaten lokal im Client einrichten.

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@liangshanli/mcp-server-mysql"
      ],
      "env": {
        "MYSQL_HOST": "db.example.com",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "ai_reader",
        "MYSQL_PASSWORD": "${MYSQL_PASSWORD}",
        "MYSQL_DATABASE": "app_db",
        "MYSQL_SSL": "true",
        "READONLY": "true",
        "ALLOW_DDL": "false",
        "ALLOW_DROP": "false",
        "ALLOW_DELETE": "false"
      }
    }
  }
}

Das MySQL-Beispiel aktiviert Lesezugriff und TLS. Konto mit Leserechten verwenden und Hostnamen auf Übereinstimmung mit dem Zertifikat prüfen.

Variablen und Konfigurationsformate

• Claude Code：Verwendet mcpServers, im Projektstamm in .mcp.json. Variablen wie ${MYSQL_PASSWORD} hängen von den beim Clientstart verfügbaren Umgebungsvariablen ab. Die Regeln des Clients beachten.
• Natives VS Code MCP:Verwendet servers, gespeichert in .vscode/mcp.json. Das Passwort wird über die VS-Code-Eingabe abgefragt, nicht über diese Website.
• Cursor：Speichern in .cursor/mcp.json, mit mcpServers. Variablenauflösung hängt von der Clientversion ab. Nicht aufgelöste Platzhalter sind keine echten Passwörter.
• Diese Erweiterung:Native .mcp.json wird von der CLI erkannt;--strict-mcp-config beschränkt Quellen. VS-Code-Konfiguration lesen ist nicht dasselbe wie native Eingabevariablen auflösen. Hier das Claude-Code-Format bevorzugen.

Bei vorhandener Konfiguration nur benötigte Servereinträge ergänzen, nicht alles überschreiben. Falls npx unter Windows nicht startet, absoluten Node.js-Pfad und Paketeinstieg gemäß npm-Dokumentation nutzen.

04 / Funktion der Werkzeuge prüfen

1. Lokale Umgebung prüfenUnterstütztes Node.js installieren; SSH verlangt 20+. Andere Anforderungen siehe npm. Der Client muss node / npx finden.
2. MCP neu verbinden oder betreffende CLI neu startenWerkzeuge nach dem Speichern neu laden. Hier genügt der Neustart der betreffenden CLI; vorher wichtige laufende Aufgaben prüfen.
3. Mit wenig eingreifenden Aktionen beginnenZuerst Werkzeuge auflisten und Verbindung testen, dann Schemata ansehen, Redis-Testschlüssel lesen oder eigene APIs per GET abrufen.

Beispiel für eine Aufgabenbeschreibung:

Prüfe, ob die MCP-Werkzeuge verfügbar sind.
Lies nur das Schema der Testdatenbank und erläutere Tabellenbeziehungen.
Keine Daten oder Strukturen ändern; fehlende Verbindung oder Rechte zuerst melden.

05 / Erst Grenzen setzen, dann Funktionen ergänzen

06 / MCP-Werkzeuge fehlen?

• Dateiname, Verzeichnis und oberste Felder auf den Client abstimmen.
• JSON, Paketnamen und Auffindbarkeit des Startbefehls prüfen.
• Arbeitsbereichsvertrauen, MCP-Freigabe, strikten CLI-Modus und Werkzeugschalter prüfen.
• Datenbank-/SSH-/API-Adressen, Netzwerk, Zugangsdaten und Serverrechte prüfen.
• Betreffende CLI neu starten und Protokolle ansehen. Keine Konfiguration mit Schlüsseln öffentlich einfügen.