Anbindung von AI-Clients (IDE-Integration)

Mit ServBay können Sie den integrierten MCP Server mit nur einem Klick in Ihre bevorzugten AI-Clients einbinden. Die passenden MCP-Konfigurationen werden dabei automatisch eingetragen, Sie müssen keine Konfigurationsdateien manuell bearbeiten. In diesem Leitfaden erfahren Sie, wie Sie AI-Clients anbinden, welche Clients unterstützt werden und wie die Anbindung im Detail funktioniert.

Voraussetzungen

• ServBay ist installiert und läuft.
• Der gewünschte AI-Client ist installiert (ServBay erkennt die Anbindungsmöglichkeit automatisch).

Ein-Klick-Integration

Öffnen Sie die ServBay-Einstellungen (Settings) → AI-Client-Integration (IDE Integrations), suchen Sie in der Liste den gewünschten Client und klicken Sie auf Integrieren (Integrate). ServBay führt dabei folgende Schritte aus:

1. Es wird die im Installationspaket enthaltene servbay-mcp-Executable lokalisiert (keine separate Installation erforderlich).
2. Die MCP-Konfiguration wird nach den Vorgaben des Ziel-Clients eingetragen (es wird nur der servbay-Node hinzugefügt oder aktualisiert; alle bestehenden MCP-Konfigurationen bleiben erhalten).
3. Der Integrationsstatus wird angezeigt.

Um die Integration rückgängig zu machen, klicken Sie einfach auf Entfernen (Remove).

Integrationsstatus

Der Status der Anbindung von jedem AI-Client im Verhältnis zur „ServBay-Instanz auf diesem Rechner“ wird angezeigt:

Status	Bedeutung
Integriert	Der Client verweist auf die lokale servbay-mcp-Instanz
Integriert (anderer Pfad)	Der Client hat zwar servbay eingerichtet, verweist aber auf einen anderen Pfad (z.B. andere ServBay-Installation)
Nicht integriert	Der Client wurde gefunden, ist aber noch nicht angebunden
Nicht gefunden	Der Client wurde auf diesem Rechner nicht gefunden

Unterstützte Clients & Integrationsarten

Client	Integrationsmethode	Konfigurations-Datei
Claude Code	Offizielles CLI: claude mcp add --scope user --transport stdio servbay -- <bin>	Claude Code Nutzer-MCP-Konfiguration
Codex	Offizielles CLI: codex mcp add (alternativ direkte Eintragung in ~/.codex/config.toml, falls CLI nicht verfügbar)	Codex-Konfiguration
Cursor	Eintrag in ~/.cursor/mcp.json (oberste Ebene mcpServers)	~/.cursor/mcp.json
VS Code / GitHub Copilot	Eintrag in der user-spezifischen mcp.json (oberste Ebene servers, type: stdio)	VS Code Nutzer-mcp.json
Claude Desktop	Eintrag in claude_desktop_config.json (oberste Ebene mcpServers)	claude_desktop_config.json

Unterschiede bei den Konfigurations-Schemas

Je nach Client unterscheiden sich die obersten Schlüssel in den MCP-Konfigurationsdateien: VS Code verwendet servers, Cursor / Claude Desktop verwenden mcpServers. ServBay berücksichtigt diese Unterschiede automatisch und trägt den richtigen Key nach Client-Vorgabe ein – Sie müssen sich darum nicht kümmern.

Integration überprüfen

Nach Anbindung sollten Sie im jeweiligen AI-Client eine umgebungsbezogene Anfrage stellen (z.B. „Liste die aktuell laufenden Dienste in ServBay auf“). Gibt der AI-Client die tatsächliche Service-Liste zurück, war die Anbindung erfolgreich.

Häufig gestellte Fragen (FAQ)

• F: Wird durch die Integration meine bestehende MCP-Konfiguration überschrieben?
  • A: Nein. ServBay fügt lediglich den servbay-Node hinzu oder aktualisiert ihn. Alle anderen MCP-Server-Einträge bleiben erhalten.
• F: Warum steht beim Client „Nicht gefunden“?
  • A: Der Client wurde auf diesem Rechner nicht gefunden. Installieren und starten Sie den betreffenden Client, bevor Sie die Integration versuchen.
• F: Warum schlägt der AI-Aufruf nach der Integration fehl?
  • A: Prüfen Sie, ob ServBay läuft. Für auf CLI basierende Integrationen (Claude Code / Codex): Vergewissern Sie sich, dass das jeweilige CLI verfügbar ist. Sie können die Integration ggf. entfernen und erneut durchführen.
• F: Was wird nach der Integration empfohlen?
  • A: Installieren Sie zusätzlich die AI-Regeln, um den AI-Clients eine optimale und korrekte Nutzung von ServBay MCP zu ermöglichen.

Zusammenfassung

Mit der „AI-Client-Integration“ können Sie ServBay MCP nahtlos und ohne manuelle Anpassungen an gängige AI-Tools anbinden – bestehende Einstellungen bleiben erhalten. Nach erfolgreicher Integration in Verbindung mit den AI-Regeln erhalten Sie die volle Kontrolle und ein reibungsloses Management Ihrer lokalen Entwicklungsumgebung durch AI.