API und MCP
Interessenabwägung und UVP-Prüfung von aussen nutzen: als REST-Schnittstelle mit API-Schlüssel oder als Werkzeuge in Claude, ChatGPT und Microsoft Copilot. Der Schlüssel gehört zu Ihrem Konto, es gelten dieselben Limits wie im Web.
API-Schlüssel
Lade …
MCP-Server für KI-Assistenten
Der SPEKTRUM-MCP-Server stellt die Endpunkte als Werkzeuge bereit, sodass ein Assistent wie Claude, ChatGPT oder Microsoft Copilot ein Screening starten, gegenprüfen, exportieren und in der Rechtsprechung suchen kann — zusammen mit Bundesgeodaten, ÖREB-Auszügen, Bauzonenkapazität und Zürcher Fachdaten, 52 Werkzeuge unter einer Adresse. Für Konten von interessenabwaegung.ch bis 31. Dezember 2026 kostenlos.
- Oben einen Schlüssel mit der Bezeichnung «MCP-Aktion» erzeugen und kopieren.
- Unter mcp.spekt.ch/iaw-aktion den Schlüssel einfügen und ein Passwort wählen. Das Konto ist sofort aktiv.
- Im Assistenten den Connector
https://mcp.spekt.ch/mcphinzufügen und sich mit der E-Mail dieses Kontos und dem gewählten Passwort anmelden. Anleitung je Client: mcp.spekt.ch.
# Claude Code im Terminal; Claude, ChatGPT und Copilot: Adresse in den Connector-Einstellungen eintragen claude mcp add --transport http spektrum https://mcp.spekt.ch/mcp
Das Screening kostet KI-Budget und läuft synchron; die Werkzeuge sind so beschrieben, dass ein Assistent es nur auf ausdrücklichen Wunsch startet. Rechtsprechung und Standortbefund sind ohne KI-Budget nutzbar.
Limits und Datenschutz
- Ein Schlüssel hat dieselben Rechte und Monatslimits wie Ihr Konto im Web. Mehr Screenings gibt es mit dem Abo, siehe Abo und Konto.
- Per Schnittstelle angelegte Fälle erscheinen unter Projekte und in den offenen Prüfpunkten.
- Verarbeitung wie im Web: Geodaten von Bund und Kantonen, KI-Beurteilung durch Mistral (EU). Unterlagen werden nicht dauerhaft gespeichert.
Für Entwickler: REST-Schnittstelle v1
Nur nötig, wenn Sie die Prüfung aus eigener Software aufrufen. Für Claude, ChatGPT oder eine Büro-Plattform genügt der MCP-Server oben.
Basis-URL https://uvp.interessenabwaegung.ch/api/v1. Der Schlüssel geht im Header X-API-Key mit, alternativ als Authorization: Bearer. Antworten sind JSON; das Screening liefert zusätzlich eine web_url, die den Fall in dieser Oberfläche öffnet.
| Methode | Pfad | MCP-Werkzeug | Zweck |
|---|---|---|---|
| POST | /uvp/screening | uvp_screening_starten | Screening für Vorhabenstyp und LV95-Standort; synchron 30 bis 90 Sekunden, dieselben Limits wie im Web |
| GET | /uvp/{id} | uvp_screening_ergebnis | Fall vollständig: Matrix mit Herleitung, Quellenprotokoll, Massnahmen, Gegenprüfung |
| POST | /uvp/{id}/critique | uvp_gegenpruefung | Gegenprüfung aus Sicht der Umweltfachstelle (ein KI-Aufruf) |
| DELETE | /uvp/{id} | – | Fall löschen: Projektangaben und Ergebnisse weg, anonymisierter Eintrag bleibt fürs Monatskontingent |
| GET | /uvp/{id}/export?variante=screening|pruefliste|ausfuehrlich|voruntersuchung|umweltnotiz | uvp_screening_export | Word als Base64, mit &raw=1 als Datei |
| GET/POST | /uvp/rechtsprechung | uvp_rechtsprechung_suchen | UVP-Urteilssammlung mit Filtern, ohne KI-Budget |
| POST | /parzelle/geodaten | parzelle_geodaten | Standortbefund zu Adresse, Parzelle oder Koordinate (Bund, ÖREB, Kanton) |
Beispiel: Screening starten
curl -X POST https://uvp.interessenabwaegung.ch/api/v1/uvp/screening \
-H "X-API-Key: iaw_…" \
-H "Content-Type: application/json" \
-d '{
"projekt_titel": "Kiesabbau Musterfeld",
"vorhabenstyp": "kiesgrube",
"groesse": 450000,
"gemeinde": "Bülach",
"kanton": "ZH",
"koordinaten": { "x": 2682500, "y": 1264800 },
"beschreibung": "Trockenabbau, Etappierung über 12 Jahre"
}'Vorhabenstyp-Schlüssel: kiesgrube, deponie, parkhaus, einkaufszentrum, logistik, windpark, schiessanlage, sportanlage, industriegebiet, sonstiges. Koordinaten in LV95. Optional: polygon (Perimeter, mindestens drei Punkte), flaeche_ha, verfahrensstufe, dokumente (bis drei Volltexte), vorhaben (strukturierte Angaben: verkehr mit parkplaetze, fahrtenProTag, anlieferungenProTag; energie mit waermetraeger, waermebedarfMWh, strombedarfMWh; bauphase mit bauzeitMonate, baustellenflaecheM2, aushubM3, abstandLaermempfindlichM; aenderung mit bestehendeAnlage, bisherUvpPflichtig, wesentlich, schwelleNeuErreicht; dazu bauten, geschossflaecheM2, varianten, standortgebundenheit). Die Antwort enthält dann verkehr, klima, bauphase und aenderung als deterministische Analysen.