# SanPilot — agent-native iSFP-Vollstrecke

SanPilot ist eine Energieberatungsplattform, die als MCP-Server (Model Context
Protocol) nutzbar ist. Ein KI-Agent 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 nach DIN V 18599 / DIN EN ISO 6946, nicht aus dem
Sprachmodell. Die KI formuliert nur Berichtstexte; jeder Abschnitt wird vom
verantwortlichen Energieberater freigegeben (kein automatisiertes Entscheiden).

## Tool-Kategorien

- **Hülle/U-Wert** — thermische Hülle, Bauteil-Schichtaufbauten, U-Werte.
- **Klima/Heizlast** — Klimaregion, Norm-Heizlast (DIN EN 12831).
- **Farbskala** — Effizienzklassen / Energieausweis-Farbskala.
- **Sanierung/Förderung** — Maßnahmenpakete, Wirtschaftlichkeit, BEG-Förderung.
- **iSFP-Workflow** — Projekt anlegen, Abschnitte generieren/freigeben, Review.
- **Export** — iSFP-Projektdatei und Übergabepaket (Anbindung an die Druckapplikation nach Freigabe im Herstellerverfahren).

## Connector installieren

Der Connector spricht Streamable-HTTP unter `https://sanpilot.an-c.de/mcp` mit OAuth (PKCE).
Discovery: `https://sanpilot.an-c.de/.well-known/mcp.json` bzw. `https://sanpilot.an-c.de/.well-known/oauth-authorization-server`.

Beispiel-Snippets (Per-Client, Platzhalter — Details siehe jeweilige Client-Doku):

- **Claude Code / Desktop**: Custom Connector hinzufügen, URL `https://sanpilot.an-c.de/mcp`,
  Auth = OAuth. Der Client übernimmt den PKCE-Flow automatisch.
- **ChatGPT**: Connector/Custom-Tool mit MCP-URL `https://sanpilot.an-c.de/mcp`.
- **Cursor / VS Code**: MCP-Server-Eintrag mit `"url": "https://sanpilot.an-c.de/mcp"` und
  Transport `streamable-http`.

## Zugang & Authentifizierung

Die Discovery-Endpoints (diese Datei, `/.well-known/*`, `/privacy`, `/terms`,
`/impressum`, `/documentation`) sind öffentlich. Jeder Tool-Aufruf unter `https://sanpilot.an-c.de/mcp`
verlangt dagegen ein OAuth-Bearer-Token. Die Autorisierung läuft über einen
**Login-/Consent-Screen**: Bei `https://sanpilot.an-c.de/oauth/authorize` meldet sich der
Energieberater mit seinem Zugangsschlüssel an und bestätigt die angefragten
Berechtigungen — erst dann wird ein Auth-Code ausgestellt. Ohne gültigen
Zugangsschlüssel gibt es keinen Code (fail-closed); das ist beabsichtigt,
kein Konfigurationsfehler auf Client-Seite. Unauthentifizierte Aufrufe von
`https://sanpilot.an-c.de/mcp` beantwortet der Server mit **401** samt `WWW-Authenticate`-Header
(RFC 9728) — Clients starten darüber den OAuth-Flow. SanPilot ist derzeit
**invite-only**: Onboarding (Zugangsschlüssel-Vergabe) läuft über die
ANC GmbH: alexander.niemeyer@an-c.de.

OAuth-Endpoints und unterstützte Verfahren:

- Discovery: `https://sanpilot.an-c.de/.well-known/oauth-authorization-server`
- Registrierung (DCR): `https://sanpilot.an-c.de/oauth/register` · Autorisierung: `https://sanpilot.an-c.de/oauth/authorize`
  (Login + Consent) · Token: `https://sanpilot.an-c.de/oauth/token` · Revoke: `https://sanpilot.an-c.de/oauth/revoke`
- Grants: `authorization_code` + `refresh_token`, PKCE (`S256`);
  Client-Auth: `client_secret_basic`, `client_secret_post` oder `none`
  (Public Clients, insbesondere CIMD/SEP-991: die `client_id` ist eine
  https-URL auf das eigene Client-Metadata-Dokument); über den
  Consent-Screen autorisierte Codes sind ohne zusätzliches Secret einlösbar
  (die Zustimmung wurde bereits am Screen geprüft) — andere Codes verlangen
  weiterhin ein Secret. Maßgeblich ist
  `token_endpoint_auth_methods_supported` in der Discovery-Metadata.

## Trust / Belege

- Energieeffizienz-Expertenliste: Eintragung in die Energieeffizienz-Expertenliste (Kategorie Wohngebäude) beantragt, Bearbeitung läuft
- Normbasis: DIN V 18599:2018-09
- Methodik: dena-iSFP-Methodik (individueller Sanierungsfahrplan)
- Druckapplikation: Anbindung an die iSFP-Druckapplikation im Herstellerverfahren (BAFA/dena), Freigabe ausstehend
- Datenschutz: https://sanpilot.an-c.de/privacy · Impressum: https://sanpilot.an-c.de/impressum

## Grenzen (ehrlich)

- SanPilot erzeugt die iSFP-Projektdatei für die dena-Druckapplikation, KEIN
  fertiges, BAFA-einreichbares iSFP-PDF. Die Anbindung an die Druckapplikation
  läuft im Herstellerverfahren von BAFA und dena; bis zur Freigabe ist ein damit
  erzeugter iSFP nicht förderfähig. Das förderfähige Dokument entsteht in der
  Druckapplikation; die fachliche Verantwortung liegt beim Energieberater.
- Die energetische Bewertung ist eine Voranalyse/Fachunterstützung, kein Ersatz
  für die Prüfung durch den zugelassenen Energieeffizienz-Experten.
- Kein Marketing, keine Produkt-/Herstellerempfehlungen (BAFA-Neutralitätspflicht).