confBuild MCP installieren und einrichten

Schnellster Weg

Ein Link. Ihre KI übernimmt die Einrichtung.

Fügen Sie die URL dieser Seite in Claude Code oder Codex ein und senden Sie:

„Richte confBuild MCP anhand dieser Seite für mich ein: https://confbuild.com/de/docs/confbuild-mcp-setup/“

Die KI folgt der aktuellen Anleitung und sagt Ihnen, wann Sie OAuth freigeben müssen. Repository, Node.js, API-Token und manuelles Skill-Kopieren entfallen.

Vollständige Installationsanleitung anzeigen Plugin-Befehle, OAuth, manuelles MCP-Setup, Browser-Loop, Updates und Entwicklermodus

Ein-Klick-Paket: MCP und Skill gemeinsam

Der empfohlene Kundenweg ist das confBuild-Plugin. Dieses eine Installationspaket richtet alle zusammengehörigen Bestandteile ein:

  • die OAuth-geschützte Remote-MCP-Verbindung zu https://app.confbuild.com/mcp;
  • den Agent-Skill confbuild-mcp-agent mit dem vollständigen Modellierungs- und Screenshot-Workflow;
  • die erforderlichen Metadaten für Codex/ChatGPT und Claude Code.

Das öffentliche Beta-Paket ist ab sofort über den selbst gehosteten confBuild-Marketplace verfügbar. Wählen Sie Ihren Client und führen Sie dessen zwei Befehle aus.

Claude Code

claude plugin marketplace add doczoidberg/confbuild-plugins
claude plugin install confbuild@confbuild

Führen Sie /reload-plugins aus, öffnen Sie /mcp und bestätigen Sie bei Bedarf confBuild OAuth. Rufen Sie danach /confbuild:confbuild-mcp-agent auf.

ChatGPT und Codex

codex plugin marketplace add doczoidberg/confbuild-plugins
codex plugin add confbuild@confbuild

Starten Sie einen bereits geöffneten Client neu, prüfen Sie unter /skills den Eintrag confBuild MCP Agent und rufen Sie $confbuild-mcp-agent auf.

Das Paket enthält einen Codex-SessionStart-Hook, der den selbst gehosteten confBuild-Marketplace höchstens einmal innerhalb von 24 Stunden prüft. Prüfen und vertrauen Sie den Hook einmalig, wenn Codex danach fragt. Anschließend werden neue Marketplace-Versionen automatisch geladen. Meldet Codex ein gefundenes Update, starten Sie eine neue Aufgabe, damit Skill und MCP-Paket garantiert aus der neuen Version stammen.

Installationen, die älter als dieser Auto-Updater sind, benötigen ein letztes manuelles Update mit codex plugin marketplace upgrade confbuild, um den Hook zu erhalten. Derselbe Befehl bleibt der manuelle Fallback, falls der automatische Check nicht ausgeführt werden kann.

Paketquelle, Manifeste, Skill und MCP-Endpunkt können im öffentlichen confBuild-Plugin-Repository auf GitHub vorab geprüft werden.

Damit entfallen Repository-Checkout, Node.js/npm, API-Token und das manuelle Kopieren eines Skills. Die Plugin-Installation bringt MCP-Verbindung und Arbeitsanleitung gemeinsam in den Client.

Distributionsstatus: Das Plugin ist als selbst gehosteter öffentlicher Beta-Marketplace verfügbar. Die getrennten Prüfungen für das universelle OpenAI-Plugin-Verzeichnis und den Anthropic Community Marketplace stehen noch aus. Der folgende manuelle MCP-only-Weg bleibt für Clients ohne Plugin-Unterstützung verfügbar.

Claude-Code-Plugin aktualisieren

Claude Code legt Marketplace-Plugins versionsweise im Cache ab. Aktualisieren Sie zuerst den Marketplace und danach das Plugin in dem Scope, in dem es installiert ist:

claude plugin list --json
claude plugin marketplace update confbuild
claude plugin update confbuild@confbuild --scope user

Die normale Kundeninstallation verwendet den Scope user. Meldet claude plugin list --json stattdessen project oder local, verwenden Sie diesen Scope. Führen Sie nach Installation oder Update in einer geöffneten Claude-Code-Sitzung /reload-plugins aus; eine neue Sitzung ist nicht erforderlich. Prüfen Sie anschließend unter /mcp, ob der gehostete Server verbunden ist, und schließen Sie bei Bedarf OAuth ab.

Das Plugin registriert https://app.confbuild.com/mcp bereits selbst. Fügen Sie dieselbe gehostete Verbindung nicht zusätzlich manuell hinzu. Claude bevorzugt lokale und projektbezogene MCP-Konfigurationen vor User- und Plugin-Servern. Meldet claude mcp list kollidierende Scopes, entfernen Sie einen veralteten manuellen Eintrag oder benennen Sie einen reinen Repository-STDIO-Server eindeutig in beispielsweise confbuild-local um. Führen Sie danach erneut /reload-plugins aus.

Manueller MCP-only-Fallback

Für den aktuellen manuellen Testweg verwenden Sie in Ihrem MCP-Client diese Adresse:

https://app.confbuild.com/mcp

Das ist ein gehosteter Streamable-HTTP-MCP. Kunden benötigen dafür:

  • ein normales confBuild-Konto;
  • Codex, Claude oder einen anderen Client mit Remote-MCP- und OAuth-Unterstützung;
  • einen Browser für Anmeldung, Freigabe und den Screenshot-Loop.

Eine lokale Repository-Kopie, Node.js, npm, NuGet, ein confBuild-API-Key oder ein eigener MCP-Server sind nicht erforderlich.

1. Remote MCP manuell im Client hinzufügen

Öffnen Sie in Ihrem MCP-Client die Einstellungen für MCP-Server beziehungsweise Connectors und fügen Sie einen Remote-/HTTP-Server hinzu:

Feld Wert
Name confBuild
URL https://app.confbuild.com/mcp
Transport Streamable HTTP / Remote MCP
Authentifizierung OAuth, automatisch über den Client

Die genaue Bezeichnung der Menüpunkte hängt vom Client ab. Verwenden Sie keinen lokalen node-Befehl und tragen Sie kein Passwort oder API-Token in die MCP-Konfiguration ein.

2. Zugriff über confBuild freigeben

Beim ersten Verbindungsversuch erkennt der Client die OAuth-Endpunkte automatisch und öffnet die confBuild-Freigabeseite.

  1. Melden Sie sich auf app.confbuild.com mit dem gewünschten confBuild-Konto an.
  2. Prüfen Sie den angezeigten MCP-Client.
  3. Wählen Sie Zugriff erlauben.
  4. Kehren Sie zum MCP-Client zurück.

Die Freigabe bindet alle privaten Projekt-, Session- und Renderzugriffe an die Firebase-Benutzer-ID dieses Kontos. confBuild erhält dadurch keinen Zugriff auf Ihr Codex- oder Claude-Konto.

3. Skill und MCP-Prompt unterscheiden

Eine direkt eingetragene MCP-URL installiert keinen Skill in Codex oder Claude Code. Die Tools und der MCP-Prompt funktionieren dann, $confbuild-mcp-agent erscheint aber nicht automatisch unter /skills.

Der vollständige Kunden-Setup ist deshalb das oben beschriebene Installationspaket. Die manuell eingetragene MCP-URL ist ein MCP-only-Kompatibilitätsweg. Verwenden Sie dort den dynamisch gelieferten MCP-Prompt confbuild-design. In Claude Code erscheint ein MCP-Prompt als Slash-Befehl im Format /mcp__SERVERNAME__PROMPTNAME.

Nach Installation des Plugins starten Sie eine neue Aufgabe beziehungsweise laden in Claude Code die Plugins neu. Prüfen Sie dann in Codex mit /skills den Eintrag confBuild MCP Agent und starten Sie einen Test mit $confbuild-mcp-agent; in Claude Code lautet der Plugin-Skill /confbuild:confbuild-mcp-agent. Fehlt der Skill trotz installiertem Plugin, prüfen Sie die Plugin-Aktivierung – bloßes Trennen und erneutes Verbinden der MCP-URL installiert ihn nicht.

4. Verbindung prüfen

Bitten Sie den Client zunächst um einen rein lesenden Test:

Prüfe über den confBuild MCP den Authentifizierungsstatus, die verfügbaren
Prompts und die Browser-Renderfähigkeit. Verändere kein Projekt.

Bei erfolgreicher direkter Verbindung stehen mit v0.17 35 Tools, 49 Ressourcen, der Prompt confbuild-design und ein serverseitiger Skill-Katalogeintrag für Plugin-Import-Scans bereit. Der installierbare Skill selbst kommt aus dem Plugin. Der Client ruft zuerst confbuild_start_design_session auf, lädt den benötigten Kontext und plant anschließend mit confbuild_plan_sheet_topology ausdrücklich Main Part und funktionale Subsheets, bevor ein Projekt verändert wird.

5. Erstes Projekt erzeugen

Mit installiertem Plugin:

Nutze $confbuild-mcp-agent und erstelle über den confBuild MCP ein privates
Projekt mit einem roten Würfel von 100 mm Kantenlänge. Validiere, speichere,
rendere und prüfe das Projekt visuell.

Mit der direkten MCP-only-Verbindung verwenden Sie denselben Auftrag über den MCP-Prompt confbuild-design.

Der Client sollte am Ende einen Link der Form https://app.confbuild.com/e/PROJEKT_ID zurückgeben.

6. Screenshot-Loop aktivieren

Die Browser-Verbindung ist Voraussetzung für Erzeugen, Klonen, Bearbeiten, Commit/Restore, Render und Export. Bevor ein neues Projekt existiert, ruft der Client confbuild_prepare_browser mit der Design-Session auf: Jeder angemeldete confBuild-Tab genügt, oder bei keinem offenen Tab wird das Dashboard geöffnet. Sobald das Projekt existiert, wiederholt der Client den Aufruf mit waitMs, bis connected: true die exakte Revision bestätigt. Ein exakter Tab wird wiederverwendet, ein sauberer veralteter Tab neu geladen und ein Dashboard zum Ziel navigiert. Bei einem anderen Projekt/einer anderen Konfiguration oder ungespeicherten lokalen Änderungen wird ein neuer Tab geöffnet. Bestehende Arbeit wird nie überschrieben.

Es ist keine Browser-Erweiterung und kein Remote-Debugging nötig. Der Tab muss jedoch:

  • mit demselben confBuild-Konto angemeldet sein;
  • genau das angeforderte Projekt und die bestätigte Revision geöffnet haben;
  • vollständig geladen und während des Renderjobs geöffnet bleiben.

Der Browser-Tab ist der Standard-Renderer. Server-Rendering wird nur verwendet, wenn Sie es ausdrücklich verlangen; dann sendet der Client rendererMode: server-headless und serverRenderingExplicitlyRequested: true. Auch in diesem Fall bleibt die exakte Browser-Verbindung Pflicht.

Details stehen im Browser- und Screenshot-Loop.

Vorhandenes Projekt weiterbearbeiten

Sie können eine private Projekt-ID oder einen vollständigen confBuild-Link direkt in Ihrer Anfrage angeben:

Bearbeite https://app.confbuild.com/e/PROJEKT_ID weiter.
Ändere nur das Dach und lasse Fenster sowie Geschosse unverändert.
Speichere, rendere und prüfe das Ergebnis visuell.

Eigene private Projekte werden direkt bearbeitet. Öffentliche beziehungsweise schreibgeschützte Projekte werden zuerst in das eigene Konto geklont.

Lokaler Entwicklermodus

Der lokale STDIO-Server bleibt für confBuild-Entwickler und Repository-Automation verfügbar. Nur dafür werden Repository und Node.js 22.22.3 benötigt:

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

Lokale Codex-/Claude-Projektkonfigurationen können tools/confbuild-mcp/server.mjs starten. Benennen Sie einen Claude-Entwicklereintrag confbuild-local und nicht confbuild, damit er das gehostete Kunden-Plugin nicht überschattet. Dieser Entwicklungsweg ist nicht der Installationsweg für Kunden.

Nächster Schritt

Fahren Sie mit dem agentischen Projekt-Workflow fort. Bei OAuth-, Projekt- oder Renderfehlern hilft Sicherheit & Fehlerbehebung.

Zurück zur Dokumentation