MCP einrichten

Schnellstart

Führen Sie die folgenden Befehle im Stammverzeichnis des confBuild-Repositories aus:

nvm use
npm run mcp:confbuild:install
npm run mcp:confbuild:test

Damit werden nur die Abhängigkeiten des lokalen MCP-Pakets installiert und dessen Prompt-, Unit- und Protokollprüfungen ausgeführt. Der confBuild-Webclient muss dafür nicht neu gebaut werden.

1. Voraussetzungen prüfen

Der Server läuft lokal als Node-Prozess. Er benötigt keinen eigenen API-Key für ein Sprachmodell.

2. confBuild-Anmeldung einrichten

Empfohlen ist der vorhandene macOS-Schlüsselbund. Prüfen Sie zuerst, ob die Anmeldung bereits funktioniert:

npm run playwright:confbuild:check-login

Falls das gespeicherte Kennwort fehlt oder abgelaufen ist, aktualisieren Sie es:

CONFBUILD_EMAIL='ihr-konto@example.com' \
CONFBUILD_PASSWORD='…' \
npm run playwright:confbuild:save-password

Der MCP-Server verwendet die Anmeldedaten in dieser Reihenfolge:

1. CONFBUILD_FIREBASE_CUSTOM_TOKEN
2. CONFBUILD_EMAIL und CONFBUILD_PASSWORD
3. macOS-Schlüsselbunddienst codex-confbuild-playwright

Anmeldedaten werden nicht an den MCP-Client zurückgegeben. confbuild_auth_status meldet nur Benutzer-ID, E-Mail und die verwendete Quelle.

3. Codex verbinden

Das Repository enthält bereits eine projektbezogene .codex/config.toml:

[mcp_servers.confbuild]
command = "node"
args = ["tools/confbuild-mcp/server.mjs"]
startup_timeout_sec = 20
tool_timeout_sec = 60
enabled = true

Öffnen Sie Codex im Repository-Stammverzeichnis beziehungsweise laden Sie das Projekt neu. Danach sollte der Server confbuild mit seinen Tools, Ressourcen und dem Prompt confbuild-design verfügbar sein.

Für den vollständigen agentischen Ablauf liegt außerdem die projektbezogene Skill-Anleitung $confbuild-mcp-agent bei. Eine natürliche Anfrage wie „Erzeuge ein Haus über den confBuild MCP“ genügt, damit ein kompatibler Codex-Client den Workflow auswählen kann.

4. Claude Code verbinden

Claude Code liest die mitgelieferte .mcp.json:

{
  "mcpServers": {
    "confbuild": {
      "command": "node",
      "args": ["tools/confbuild-mcp/server.mjs"],
      "env": {}
    }
  }
}

Öffnen Sie Claude Code im Repository-Stammverzeichnis, bestätigen Sie den projektbezogenen MCP-Server, wenn der Client danach fragt, und starten beziehungsweise laden Sie die Sitzung anschließend neu.

5. Anderen MCP-Client verbinden

Ein anderer lokaler Client benötigt eine STDIO-Serverdefinition mit:

• Command: node
• Arguments: tools/confbuild-mcp/server.mjs
• Working directory: Stammverzeichnis des confBuild-Repositories
• Environment: nur notwendige confBuild- oder Browservariablen

Verwenden Sie einen absoluten Pfad zum Server, wenn Ihr Client das Arbeitsverzeichnis nicht zuverlässig setzt.

{
  "command": "node",
  "args": ["/ABSOLUTER/PFAD/sheetbuild2/tools/confbuild-mcp/server.mjs"]
}

6. Browsermodus wählen

Ohne weitere Konfiguration verwendet browserMode: auto zunächst einen ausdrücklich angebundenen Browser, falls CONFBUILD_MCP_CDP_URL gesetzt ist. Ansonsten startet der Server einen sichtbaren persistenten Chromium-Browser und fällt bei einem Startfehler auf Headless zurück.

Ein normal geöffneter Chrome-Tab kann aus Sicherheitsgründen nicht still übernommen werden. Der Modus attached funktioniert nur mit einem bewusst freigegebenen CDP-Endpunkt. Mehr dazu im Browser- und Screenshot-Loop.

7. Verbindung testen

Bitten Sie den Client zunächst um eine reine Statusprüfung:

Prüfe über den confBuild MCP den Authentifizierungsstatus und die verfügbaren
Browsermodi. Verändere kein Projekt.

Danach können Sie einen kleinen privaten Test starten:

Erstelle über den confBuild MCP ein privates Projekt mit einem roten Würfel
von 100 mm Kantenlänge. Validiere, rendere und prüfe das Ergebnis visuell.

Der Client sollte mit confbuild_start_design_session beginnen, am Ende einen bearbeitbaren Projektlink nennen und keine ungespeicherten Änderungen zurücklassen.

Aktualisieren nach Prompt-Änderungen

Wenn die Master-Prompts im Prompt-Editor geändert wurden, werden die reproduzierbaren MCP-Artefakte so aktualisiert und geprüft:

npm run mcp:confbuild:prompts
npm run mcp:confbuild:test

Die Prompt-Hashes verhindern, dass ein Client unbemerkt mit veralteten Exporten arbeitet.

Nächster Schritt

Fahren Sie mit dem agentischen Projekt-Workflow fort. Bei Anmelde-, Browser- oder Revisionsfehlern hilft Sicherheit & Fehlerbehebung.