KI-Zugang (AI-Parität)
Ziel: Produktfunktionen sollen für Menschen, Automatisierungen und KI-Agenten ohne eigene fachliche Rechenlogik zugänglich sein. ADR-0018 beschreibt dieses Leitprinzip. Vollständige Parität aller UI-Funktionen über REST, MCP und Skill ist noch nicht erreicht.
Implementierte Zugänge (Code-Abgleich 08.10.2026)
| Funktion | UI / REST | MCP | Skill | Grenze |
|---|---|---|---|---|
| Nutzungspotenzial-Report | /report, /api/v1/report | drei Report-Tools | Report-Skill | dieselbe Reportlogik; Kurzfassung, Markdown und Web/PDF projizieren unterschiedliche Felder |
| Admin-Modell, Budget, Nutzung | /admin, /api/v1/admin/* | drei Admin-Tools | keiner | MCP/REST mit Admin-Key; UI mit Admin-Sitzung und TOTP |
| Standort-Check | /werkzeuge/standort-check, POST /api/tools/standort-check | keines | keiner | signierte Standort- und Regionsnachweise aus der Adressauswahl |
| PV-Ertragsrechner | /werkzeuge/pv-ertrag, POST /api/tools/pv-ertrag | keines | keiner | eigener Eingabevertrag und signierte Standortnachweise |
| Immobilienmarkt-Signal | /werkzeuge/immobilienmarkt, GET /api/tools/immobilienmarkt | keines | keiner | ohne Eingabe; quellengebundene Karten |
| Konto, Team, Gemeinde-Überblick, Standortvergleich | UI und jeweilige session-gebundene API | keines | keiner | bestehende Browser-Sitzung; kein API-Key-Ersatz, Vergleich zusätzlich Beta-Gates |
| Coverage-Matrix | GET /api/v1/data-sources/coverage-matrix | keines | keiner | öffentliches JSON ohne Standortabfrage |
Der MCP-Server bietet lokal per stdio und gehostet unter
POST /api/mcp dieselben sechs Tools. Der
Report-Skill deckt ausschließlich den Report-Anwendungsfall ab.
Die MCP-Tools und der Skill rufen die REST-API auf und rechnen keine neuen
Fachwerte. Daraus folgt keine identische Darstellung oder Autorisierung aller
Zugänge: Eine UI-Sitzung ist kein MCP-Key, und JSON, Kurzfassung sowie
Web-/PDF-Ansicht besitzen jeweils dokumentierte Ausgabegrenzen.
Heute nutzbar: die API
# Anonym (IP-Tageslimit)
curl "https://www.landnutzen.at/api/v1/report?address=Rathausplatz%201%2C%202230%20Gänserndorf"
# Mit API-Key (eigenes, höheres Limit + Audit)
curl -H "Authorization: Bearer ln_…" \
"https://www.landnutzen.at/api/v1/report?address=…"
Der Contract ist maschinenlesbar als OpenAPI 3.1 unter
/api/v1/openapi.json und interaktiv unter
/docs/api — eine KI kann die API also selbst
entdecken und aufrufen.
Was der Zugang abdeckt
- Report (Adresse → Nutzungspotenzial): UI, REST, MCP
(
generate_report,report_summary,export_report) und Skill. - Admin-Steuerung (Modell, Budget, Nutzung): UI, REST und MCP
(
get_usage,set_model,set_budget), jeweils mitadmin-Scope. - Standort-Check: UI und REST (
POST /api/tools/standort-check). Es gibt dafür kein MCP-Tool und keinen Skill; der Endpunkt verlangt signierte Nachweise aus der Adressauswahl. - Coverage-Matrix: REST (
GET /api/v1/data-sources/coverage-matrix), ohne MCP-Tool.
Nicht vorhanden
- Einzel-Lookup-Tools wie
lookup_widmung,lookup_altlastenoderlookup_parcel: Es gibt sie weder als MCP-Tool noch als eigene/api/v1-Route; die Daten stehen im Report-JSON. - Ein MCP-Tool für den Standort-Check (siehe oben).
Details zur API: API-Leitfaden.