MCP einrichten

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:

  1. Öffnen Sie die confBuild-Plugin-Installationsseite.
  2. Fügen Sie den confBuild-Marketplace hinzu und installieren Sie confBuild mit den Befehlen für Ihren Client.
  3. Melden Sie sich einmal über die geöffnete confBuild-OAuth-Seite an und erlauben Sie den Zugriff.
  4. Starten Sie in Codex eine neue Aufgabe beziehungsweise laden Sie in Claude Code die Plugins neu.
  5. Prüfen Sie in Codex mit /skills den Eintrag confBuild MCP Agent und rufen Sie $confbuild-mcp-agent auf. In Claude Code lautet der Skill /confbuild:confbuild-mcp-agent.

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.

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 aktuell 20 Tools, 28 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 sollte zuerst confbuild_start_design_session aufrufen und dadurch die aktuelle Master-Prompt plus Domänenregeln laden.

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

Für Screenshots öffnen Sie den zurückgegebenen Projektlink parallel in einem angemeldeten Browser und lassen den Tab geöffnet. Wenn der Client einen Renderjob startet, übernimmt die confBuild-Web-App im passenden Projekt-Tab die Aufnahme und spielt private PNGs über den MCP zurück.

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 geöffnet haben;
  • vollständig geladen und während des Renderjobs geöffnet bleiben.

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. 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