SanPilot — Connector-Dokumentation

Was ist SanPilot?

SanPilot ist eine Energieberatungsplattform, die als MCP-Server (Model Context Protocol) nutzbar ist. Ein KI-Agent (z. B. Claude oder ChatGPT) kann darüber ein Gebäude anlegen, die energetische Bilanz nach DIN V 18599 rechnen lassen und einen individuellen Sanierungsfahrplan (iSFP) nach dena-Methodik bis zur iSFP-Projektdatei vorbereiten. Die Anbindung an die dena-Druckapplikation läuft im Herstellerverfahren von BAFA und dena (Freigabe ausstehend).

Golden Rule: Der Rechenkern rechnet, die KI schreibt — nie umgekehrt. Alle energetischen Kennwerte (U-Werte, Heizlast, Endenergie, Effizienzklassen) stammen aus dem deterministischen Rechenkern; die KI formuliert nur Berichtstexte, und jeder Abschnitt wird vom verantwortlichen Energieberater freigegeben.

Connector verbinden

Der Connector spricht Streamable-HTTP unter https://sanpilot.an-c.de/mcp mit OAuth 2.0 (PKCE). Maschinenlesbare Discovery: /.well-known/mcp.json · /llms.txt.

Claude (Custom Connector)

  1. In Claude (Web/Desktop) Settings → Connectors öffnen.
  2. Add custom connector wählen.
  3. Als Remote-MCP-Server-URL https://sanpilot.an-c.de/mcp eintragen.
  4. Den OAuth-Dialog bestätigen — Claude führt den PKCE-Flow automatisch aus; beim Login wird das Berater-Secret abgefragt.
  5. Danach stehen die SanPilot-Tools in jeder Unterhaltung über das Connector-Menü zur Verfügung.

ChatGPT (Developer Mode)

  1. In ChatGPT Settings → Apps & Connectors → Advanced → Developer mode aktivieren.
  2. Create connector wählen und als MCP-Server-URL https://sanpilot.an-c.de/mcp eintragen.
  3. Authentifizierung OAuth wählen und den Flow bestätigen (Berater-Secret erforderlich).
  4. Den Connector in einer neuen Unterhaltung über das Plus-/Tools-Menü aktivieren.

Zugang & Authentifizierung (invite-only)

Die Discovery- und Doku-Seiten sind öffentlich; jeder Tool-Aufruf verlangt ein OAuth-Bearer-Token. Die Token-Ausgabe ist invite-only: Der Token-Endpoint stellt nur dann ein Token aus, wenn das Shared-Secret eines onboardeten Energieberaters mitgegeben wird. Ohne dieses Secret endet der OAuth-Flow in einem 401 — das ist beabsichtigt und kein Konfigurationsfehler. Onboarding (Secret-Vergabe per Mail) läuft über die ANC GmbH: alexander.niemeyer@an-c.de.

Tool-Übersicht nach Gruppen

Beispiel-Prompts

Diese Prompts sind gegen den Live-Server getestet (Quelle: die Use-cases der Directory-Submission) und decken den Kern-Workflow ab:

  1. Lege ein Einfamilienhaus Baujahr 1962 mit 145 m² Wohnfläche in 31737 Rinteln an: Vollziegelwand 24 cm, ungedämmtes Satteldach, Gaskessel von 1994.
    → legt das Gebäude an und liefert die Projekt-ID samt Klimaregion (sanpilot_building_create).
  2. Berechne die Energiebilanz für Gebäude <id> und nenne Heizwärmebedarf und Effizienzklasse.
    → rechnet die DIN-V-18599-Bilanz deterministisch im Rechenkern (sanpilot_calculation_trigger).
  3. Plane eine Sanierungsvariante mit 24 cm Dachdämmung WLG 035 und zeige Endenergie-Einsparung, Kosten und BEG-Förderung.
    → erstellt die Variante inkl. Kosten- und Förderrechnung (sanpilot_variant_create).
  4. Was fehlt noch bis zum iSFP-Export?
    → liefert den gestaffelten Export-Preflight mit konkreten Blockern (sanpilot_isfp_export).

Zugriff widerrufen

Die Verbindung ist jederzeit widerrufbar: im KI-Client trennen (z. B. Claude: Settings → Connectors → SanPilot → Remove; ChatGPT analog unter Apps & Connectors). Bereits ausgestellte Tokens lassen sich zusätzlich serverseitig über POST https://sanpilot.an-c.de/oauth/revoke (RFC 7009) widerrufen.

Grenzen (ehrlich)

Trust / Belege

Energieeffizienz-Expertenliste: Eintragung in die Energieeffizienz-Expertenliste (Kategorie Wohngebäude) beantragt, Bearbeitung läuft · Normbasis: DIN V 18599:2018-09 · Druckapplikation: Anbindung an die iSFP-Druckapplikation im Herstellerverfahren (BAFA/dena), Freigabe ausstehend

Support

Fragen, Onboarding, Fehlerberichte: alexander.niemeyer@an-c.de (ANC GmbH).