Überblick

Bauhow-Projekte aus ChatGPT, Claude, Perplexity, OpenCode und Cursor bearbeiten.

Der Bauhow MCP-Server verbindet KI-Anwendungen mit Ihrem Bauhow-Workspace. Der Client kann damit Wärmeplanungsprojekte anlegen, Module untersuchen, Eingaben ändern und Berechnungen abrufen.

MCP steht für Model Context Protocol. Der offene Standard beschreibt, wie eine KI verfügbare Werkzeuge entdeckt und sicher aufruft. Bauhow stellt einen entfernten MCP-Server über Streamable HTTP bereit und schützt ihn mit OAuth 2.1.

Möglichkeiten

Verfügbare Werkzeuge, Grenzen und typische Abläufe.

Beispiel-Prompts

Formulierungen für häufige Aufgaben in Bauhow.

ChatGPT

Bauhow als App im Developer Mode hinzufügen.

Claude

Bauhow als benutzerdefinierten Connector oder in Claude Code verbinden.

Perplexity

Einen benutzerdefinierten Remote Connector einrichten.

OpenCode

Den Server in der OpenCode-Konfiguration hinterlegen.

Cursor

Bauhow über mcp.json in Cursor verwenden.

Server-URL

Alle Clients verwenden dieselbe URL:

https://mcp.bauhow.com/mcp

Sie finden die URL mit Kopierschaltfläche auch in Bauhow unter Einstellungen → Workspace → MCP-Server. Der Server nutzt Streamable HTTP. Einen SSE-Endpunkt oder einen lokalen stdio-Server gibt es nicht.

Voraussetzungen

Ein Workspace-Owner oder Admin aktiviert MCP-Server aktivieren unter Einstellungen → Workspace → MCP-Server.
Sie tragen die Server-URL in Ihrem KI-Client ein.
Beim Verbinden melden Sie sich bei Bauhow an und wählen auf der Seite Zugriff erlauben den Workspace aus.

Sie benötigen keinen API-Key und keine Client-ID oder kein Client-Secret. Der KI-Client registriert sich beim ersten Verbinden automatisch bei Bauhow.

Anmeldung und Workspace-Auswahl

Bauhow verwendet OAuth 2.1 mit PKCE. Wenn Sie den Client verbinden, öffnet sich ein Bauhow-Fenster. Sind Sie noch nicht angemeldet, melden Sie sich zuerst an. Danach zeigt die Seite Zugriff erlauben:

den Namen des KI-Clients
die angefragten Berechtigungen
eine Auswahl Ihrer Workspaces

Wählbar sind nur Workspaces, in denen der MCP-Server aktiviert ist. Die Verbindung gilt anschließend für genau diesen Workspace. Wenn Sie einen weiteren Workspace nutzen möchten, verbinden Sie den Client erneut, zum Beispiel indem Sie den Server ein zweites Mal hinzufügen.

Berechtigungen

Berechtigung	Bedeutung
`mcp:read`	Projekte und Projektmodule lesen
`mcp:write`	Wärmeplanungsprojekte anlegen und Projektmodule bearbeiten (schließt Lesen ein)
`offline_access`	Verbunden bleiben, ohne sich erneut anzumelden

Zugriffstokens sind 15 Minuten gültig. Der Client erneuert sie automatisch.

Zusätzlich gelten Ihre Rollenrechte im Workspace. Ein Werkzeugaufruf schlägt fehl, wenn Ihre Rolle die nötige Berechtigung nicht hat. Beispielsweise lassen sich ohne Bearbeitungsrecht für Projekte keine Module bearbeiten.

Cloud- und lokale Clients

ChatGPT, Claude (claude.ai und Claude Desktop) und Perplexity verbinden sich aus ihrer Cloud mit Bauhow. Claude Code, OpenCode und Cursor laufen lokal auf Ihrem Rechner. Alle Clients verwenden dieselbe öffentliche URL https://mcp.bauhow.com/mcp.

Zugriff beenden

Unter Einstellungen → Workspace → MCP-Server sehen Owner und Admins die Liste Verbundene Clients. Mit Zugriff widerrufen sperren Sie einen einzelnen Client sofort. Er muss danach neu autorisiert werden.

Außerdem gilt:

Wird der MCP-Server für den Workspace deaktiviert, sind alle Clients sofort gesperrt.
Wird ein Mitglied aus dem Workspace entfernt, sind auch seine Clients gesperrt.

Entfernen Sie die Verbindung zusätzlich im jeweiligen KI-Client.