Docs · MCP-Server (Pro)

MCP-Server (Pro)

Lebende Referenz. Wird bei jeder Tool-Änderung mitgepflegt. Das maschinenlesbare Tool-Manifest liegt als mcp-tools.json im Repo unter controlplane/public/docs/api/.

Der MCP-Server (Model Context Protocol) gibt einem KI-Assistenten (z. B. Claude Desktop) einen kuratierten, datensparsamen Werkzeugkasten für Ihren Mandanten. Er ist im Pro-Plan enthalten.

Datenschutz zuerst

Der MCP-Server ist bewusst PII-frei und read + safe-write ausgelegt:

  • Keine Klar-Personendaten in den Tool-Ergebnissen — keine Namen, Adressen, E-Mail-Adressen oder IBANs. Tools liefern Geocoding (öffentliches Adressregister), Leitungsnetz-Anlagen, Zählernummern/-stände und aggregierte Statistik.
  • Nur sichere Schreibvorgänge: Einziger Write ist Zählerstand erfassen (idempotent). Kein Mailversand, kein Rechnungslauf, kein Löschen, kein Massen-Import über MCP.

Wichtig: Sobald Sie einen MCP-Client verbinden, werden die abgefragten Daten an den von Ihnen gewählten KI-Anbieter übertragen (z. B. Anthropic/OpenAI). Sie als Verantwortliche/r wählen den Anbieter und tragen für diese Übermittlung die datenschutzrechtliche Verantwortung (Auftragsverarbeitung, ggf. Drittlandtransfer). quellstube stellt nur den Endpunkt bereit. Zählernummer + Verbrauch + Standort bleiben indirekt personenbeziehbar — gehen Sie sparsam damit um.

Freischalten

  1. In Verwaltung → API-Schlüssel einen Schlüssel anlegen (oder bestehenden nutzen) und „Für MCP-Server freischalten" aktivieren.
  2. Den Schlüssel im MCP-Client als Bearer-Token hinterlegen.

Ein Schlüssel ohne MCP-Freischaltung wird vom Server abgewiesen.

Verbinden

  • Endpunkt: https://mcp.quellstube.at/mcp (Streamable HTTP)
  • Auth: Authorization: Bearer qs_live_<slug>_<hex>

Der Server leitet Aufrufe intern an https://<slug>.quellstube.at/api/v1/… weiter; dort greifen Tenant-Isolation, Pro-Gating, Scopes und Audit.

Werkzeuge (Tools)

Tool Art PII Beschreibung
geocode_address read – Adresse → WGS84-Koordinate (BEV)
find_nearby_features read – Anlagen (z. B. Hydranten) im Umkreis einer Koordinate
list_network_features read – Anlagen des aktiven Leitungsplans
list_meters read gering Zähler (Nummer/Standort/Typ), ohne Namen
get_meter_readings read gering Ablesungen eines Zählers
submit_meter_reading safe-write gering Zählerstand erfassen (idempotent)
get_dashboard_stats read – Aggregierte Kennzahlen

Bewusst NICHT als Tool: alles mit Namen/Adressen/E-Mail/IBAN, Mailversand, Rechnungslauf, Löschen, Massen-Import — diese laufen ausschließlich über die REST-API (ohne KI im Pfad).

Beispiel-Anwendungsfälle

  • „Welche Hydranten liegen im Umkreis von 300 m um diese Adresse?" → geocode_address + find_nearby_features (ideal für die Feuerwehr).
  • „Trag für Zähler A-100 den Stand 1234 ein." → submit_meter_reading.
  • „Wie viele Ablesungen fehlen in der aktuellen Periode?" → get_dashboard_stats.

Changelog

v0.1 — 2026-06-30

  • added Erstveröffentlichung der sieben Tools (siehe Tabelle).