Voraussetzungen
- Claude Desktop / Cursor / VS Code ist installiert
- Der von dem zu installierenden Server benötigte Laufzeitumgebung (die meisten brauchen Node.js oder Python; manche erfordern zusätzliche Abhängigkeiten)
- Ihre API-Anmeldedaten bereithalten (z. B. das GitHub-Token) – Sie brauchen sie während der Konfiguration
Claude Desktop
Grafischer Ablauf:
- Öffnen Sie Claude Desktop → Settings
- Wechseln Sie zu Developer → klicken Sie auf Edit Config
- Fügen Sie Ihren Server im Abschnitt
mcpServersvonclaude_desktop_config.jsonhinzu:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ihr-token" }
}
}
}
Speichern Sie die Datei und starten Sie Claude Desktop neu. Ihr neues Tool erscheint in der Tool-Liste der linken Seitenleiste. Lesen Sie für Befehl und Argumente stets die README des Servers.
Cursor
- Öffnen Sie die Befehlspalette (
Ctrl+Shift+P/Cmd+Shift+P) - Suchen und wählen Sie Cursor Settings > MCP
- Klicken Sie auf Add New MCP Server, wählen Sie den Transporttyp (stdio oder SSE) und füllen Sie Befehl/Argumente aus
VS Code
- Installieren Sie die Erweiterung MCP Client (oder nutzen Sie Copilot / Erweiterungen mit eingebauter MCP-Unterstützung)
- Konfigurieren Sie
mcpServersin den Einstellungen der Erweiterung mit demselben JSON-Format wie bei Claude Desktop - Laden Sie das VS-Code-Fenster neu, damit die Änderungen greifen
Die Oberflächen können sich je nach Client-Version ändern – für die exakten Schritte konsultieren Sie stets die offizielle Dokumentation; die Struktur von Befehl/JSON folgt stets der README des Servers.
Behebung häufiger Fehler
| Fehler | Ursache | Lösung |
|---|---|---|
| command not found | Die Node/Python-Laufzeit ist nicht installiert oder nicht im PATH | Laufzeit installieren und den Client neu starten |
| 401 / 403 | Ungültige oder abgelaufene API-Anmeldedaten | Token neu erzeugen und die Umgebungskonfiguration doppelt prüfen |
| Connection refused | Falsche SSE-Server-Adresse oder der Dienst läuft nicht | URL + Port prüfen und bestätigen, dass der Server online ist |
| Tool not found | Konfigurationsänderungen wurden nicht geladen, weil der Client nicht neu gestartet wurde | Die Client-Anwendung nach dem Speichern der Konfiguration vollständig neu starten |
Sicherheitshinweise
- Tokens bleiben nur in Ihrer lokalen Konfigurationsdatei – schieben Sie die Datei niemals nach Git (denken Sie an
.gitignore) - Installieren Sie nur Server von verlässlichen, stark benannten Projekten – unverifizierte Server könnten Ihre Daten abziehen
- Gewähren Sie Hoch-Berechtigungs-Server nur, wenn es unbedingt nötig ist