Anwender MCP Assistent

MCP-Assistent

Mit dem MCP-Server kann eine KI-Anwendung nach deiner Anmeldung gezielt mit Daten deiner Organisation arbeiten. Die Anwendung sieht nur die Werkzeuge, für die dein Konto aktuell berechtigt ist.

GSL-Ressourcen

Bei aktivem GSL-Ressourcenmanagement kann der Assistent Ressourcen lesen, anlegen und aktualisieren, Führung setzen, Personal und Ausstattung pflegen, Journal-Einträge lesen/ergänzen sowie disponieren, Aufträge ändern oder zurückziehen. Die vollständige Liste und Rollen stehen unter MCP-Server.

Bei der Disposition kann Erkundung oder Abarbeitung angegeben werden. Fehlt die Angabe, wird sie aus der Phase abgeleitet: Eingegangen/Erkundung ergibt Erkundung, sonst Abarbeitung. Zugangstoken, Links, Token-Hashes und PINs gibt der Assistent nicht aus; QR-Zugänge kann er weder ausstellen noch anzeigen oder drucken.

Verbinden und anmelden

In claude.ai einen Custom Connector anlegen und als Server-URL https://<host>/mcp eintragen. Claude Desktop und Claude Code verwenden ebenfalls die vom Client vorgesehene MCP-Server-Konfiguration; als Streamable-HTTP-Adresse gilt dieselbe URL. Die konkrete Bedienung kann je Client abweichen.

Beim Verbinden öffnet sich die Einsatzcockpit-Anmeldung. Melde dich mit deinem Einsatzcockpit-Benutzernamen und Passwort an. Reine SSO-Konten können diesen Login nicht verwenden; Geräte-Benutzer ebenfalls nicht. Eine Verbindung kann im Einsatzcockpit unter Profil wieder getrennt werden.

Berechtigungen und Werkzeuge

Rolle	Werkzeuge
objekt_verwalter, org_admin, admin	Objekte, zentrale Kontakte und Objekt-Dokumente
kontakt_verwalter, org_admin, admin	Zentrale Kontakte
fahrtenbuch_admin, org_admin, admin	Fahrtenbuch-Auswertung
org_admin, admin	Wasserstellen
Alle Benutzer mit aktivem Straßensperren-Modul	Straßensperren lesen und Anfahrten prüfen
objekt_verwalter, org_admin, admin	Straßensperren anlegen und pflegen
fahrtenbuch_admin, org_admin, admin	Mitglieder lesen
org_admin, admin	Mitglieder pflegen, Benutzer lesen und verwalten
Alle Benutzer	mcp_whoami, meine_einheiten

Die verfügbaren Werkzeuge sind:

• ecp_suchen: sucht mit denselben Leserollen wie die zentrale Oberfläche in Objekten, Objektdokumenten und freigegebenen Katastrophenplänen sowie live in Einsätzen, Straßensperren und Wasserstellen. Mit kontext="gsl" und kontext_id werden auch Einsatzstellen, Meldungen und Einheiten dieser Lage durchsucht. Voraussetzung ist die aktivierte Suche für die Organisation und MCP. Kontakte und Personendaten fehlen bewusst; Fundstellen enthalten absolute Links und bei ausreichender Berechtigung das passende Detailwerkzeug samt Parametern.
• mcp_whoami: zeigt Benutzer, Organisation, Rollen, das verknüpfte Mitglied und die Einheiten, die man gerade als Gruppenkommandant führt.
• meine_einheiten: listet die Einheiten, die man über das verknüpfte Mitglied gerade führt, mit offenen Aufträgen und Link zur Einheitenansicht.
• mitglieder_suchen, mitglied_lesen und mitglieder_kataloge: suchen und lesen Mitglieder der eigenen Organisation (Telefon und E-Mail nur in mitglied_lesen), inklusive verknüpftem Benutzer und aktueller Gruppenkommandanten-Funktion, sowie Qualifikationen und Tags.
• mitglied_anlegen (mit Dublettenprüfung; dublette_ignorieren=true zum bewussten Anlegen), mitglied_aktualisieren, mitglied_aktivieren, mitglied_deaktivieren, mitglied_qualifikationen_setzen und mitglied_tags_setzen (nur Admins): pflegen Mitglieder. Tags werden nie implizit angelegt. Löschen ist per MCP nicht möglich.
• benutzer_suchen, benutzer_lesen und rollen_katalog (nur Admins): lesen Benutzer ohne Geräte-Konten und ohne Passwort- oder Token-Daten; der Rollenkatalog zeigt, welche Rollen man vergeben darf.
• benutzer_anlegen, benutzer_aktualisieren, benutzer_rollen_setzen, benutzer_aktivieren, benutzer_deaktivieren, benutzer_mitglied_verknuepfen und benutzer_passwort_reset_mail (nur Admins): verwalten Benutzer mit denselben Grenzen wie die Benutzerverwaltung. Passwörter werden nie zurückgegeben; neue Benutzer erhalten auf Wunsch eine Einladung zum Festlegen ihres Passworts. Die Antwort von benutzer_anlegen enthält dafür einladung_gesendet. system_admin wird nie vergeben, System-Admins und Geräte-Benutzer sind tabu, endgültiges Löschen gibt es nicht. Sich selbst deaktivieren oder die eigene Admin-Rolle entziehen ist gesperrt; Deaktivieren widerruft die MCP-Verbindungen des Benutzers.
• organisation_lesen: liefert Stammdaten der eigenen Organisation (Name, Kürzel, Kontakt, Adresse, Farben, Fußzeile) und das Logo direkt als Bild, damit Claude es z. B. für Briefköpfe oder Berichte verwenden kann. SVG-Logos kommen als Quelltext, ohne eigenes Logo das Standardlogo.
• fahrtenbuch_stammdaten, fahrtenbuch_fahrten, fahrtenbuch_fahrt und fahrtenbuch_auswertung: lesen Stammdaten, Fahrten, Korrekturkette und Auswertungen.
• objekt_kataloge, objekt_suchen, objekt_lesen und objekt_duplikate_pruefen: lesen Objektwerte und prüfen Dubletten. objekt_lesen liefert alle pflegbaren Felder: Stammdaten inkl. informationen (der allgemeine Hinweis-/Infotext zum Objekt) und anfahrtsweg, alle BMA-Angaben (SMS-/Mail-Empfänger nur als „gesetzt“), Gefahren mit Details, Merkmale mit Name und Hinweis, Zusatzadressen und Wohnanlage, jeweils mit den IDs für Änderungen; mit arbeitskopie=true liest es eine vorhandene Arbeitskopie. Das Feld arbeitskopie_hinweis ist nur ein technischer Hinweis auf eine offene Arbeitskopie, kein Objekttext.
• kontakt_suchen, kontakt_duplikate_pruefen, kontakt_lesen und kontakt_kategorien: suchen, prüfen und lesen zentrale Kontakte sowie Kategorien. kontakt_lesen enthält Telefone, E-Mail, Kategorien, Versionsnummer und Objektzuordnungen.
• kontakt_anlegen, kontakt_aktualisieren, kontakt_archivieren und kontakt_zusammenfuehren: pflegen zentrale Kontakte. Die Aktualisierung verlangt die aktuelle version; bei einem Konflikt Kontakt neu laden. Archivieren bei Objektzuordnungen und jedes Zusammenführen verlangen bestaetigt=true.
• objekt_anlegen und objekt_aktualisieren: legen Entwürfe an oder bearbeiten Entwürfe beziehungsweise Arbeitskopien. Sie können die Objekt-Stammdaten informationen, anfahrtsweg und revision_datum sowie optionale Wohnanlagen-Daten (wohneinheiten, geschosse, stiegen, hausverwaltung_kontakt_id, hinweise) pflegen. Mit kontakte_aendern ändern sie Art, Sortierung oder Erreichbarkeit einer Objektkontakt-Zuordnung. Den Hinweis an einem Merkmal ändert merkmale_aendern ([{id, hinweis}]); wird ein bereits zugeordnetes Merkmal über merkmale_hinzufuegen mit hinweis übergeben, wird der Hinweis übernommen. Gefahren-Details (un_nummer, stoffname, gefahrklasse, gefahrnummer, detail, links) ändert gefahren_aendern ([{id, …}], nur die übergebenen Felder).
• wasserstellen_suchen, wasserstelle_lesen, wasserstelle_anlegen, wasserstelle_aktualisieren und wasserstelle_deaktivieren (nur org_admin): suchen Wasserstellen (Text, Typ, Status, optional im Umkreis um lat/lng), legen sie mit Dublettenprüfung an (gleiche Bezeichnung oder gleicher Typ innerhalb 15 m; sonst duplikat_bestaetigt=true) und ändern einzelne Felder. Deaktivieren setzt den Status defekt – die Stelle erscheint dann nicht mehr auf Einsatzkarte und Einsatzinfo; ein optionaler Grund wird datiert an den Hinweis angehängt. Reaktivieren über wasserstelle_aktualisieren mit status: bereit. Löschen ist per MCP nicht möglich.
• strassensperren_liste, strassensperre_lesen, strassensperren_kataloge, strassensperren_suchen, strassensperren_im_gebiet, strassensperren_kennzahlen, einsatz_strassensperren, einsatz_anfahrtsroute_pruefen und strassensperren_entlang_route: lesen sichtbare Sperren und prüfen gespeicherte oder live berechnete Anfahrten. Die Liste kann Zeitraum, Bereich und Radius kombinieren; strassensperren_kataloge zeigt Enum-Werte, Labels und Aliase.
• strassensperre_anlegen, strassensperre_aktualisieren, strassensperre_deaktivieren, strassensperre_reaktivieren, strassensperre_beenden, strassensperre_teams_senden und strassensperre_freigabelink (Objektverwaltung): pflegen eigene Sperren, beenden sie vorzeitig, stellen Teams-Meldungen in die Warteschlange oder verwalten einen öffentlichen Detail-Link. Bei einer möglichen Verlängerung oder Änderung liefert das Anlegen possible_update mit Vorschlagsfeldern. Bestehende Sperre aktualisieren, mit ersetzt_road_closure_id als neue Verordnung ersetzen oder mit als_neu_bestaetigt=true bewusst zusätzlich anlegen; duplikat_bestaetigt=true bleibt als Alias erhalten. Die Antworten enthalten bei Anlage und Adressänderungen adressvalidierung aus der OSM-Prüfung. Löschen ist per MCP nicht möglich.

Englischer Wunschname	MCP-Werkzeug
road_closures_close	strassensperre_beenden
road_closures_publish	strassensperre_teams_senden
road_closures_share_link	strassensperre_freigabelink
road_closures_stats	strassensperren_kennzahlen

• strassensperre_geometrie_ermitteln (OSM-Abschnitt vorschlagen, optional übernehmen) und strassensperre_geometrie_bestaetigen (Freigabe für die Umfahrung, Objektverwaltung).
• strassensperre_entwurf_aus_pdf (liest eine Verordnung ohne zu speichern und schlägt Felder vor), strassensperre_dokument_upload_vorbereiten und strassensperre_dokument_uebergeben (PDF an die Sperre anhängen; Objektverwaltung). Typischer Ablauf: Entwurf aus PDF → prüfen → anlegen → PDF anhängen.
• objekt_dokument_upload_vorbereiten: erzeugt einen einmaligen Upload-Link (15 Minuten gültig) samt curl-Beispiel, damit große PDFs nicht als Base64 im Tool-Aufruf stehen müssen.
• objekt_dokument_uebergeben, objekt_dokumente_auflisten und objekt_dokument_seiten_klassifizieren: übergeben, listen und klassifizieren Objekt-PDFs. Übergabe entweder mit upload_id (nach dem curl-Upload) oder – für kleine Dateien – mit inhalt_base64. seiten hat das Format [{"nr":1,"dokumentart":"bma_datenblatt","titel":null}]; die Klassifizierung des Clients wird unverändert übernommen.
• objekt_dokument_herunterladen: holt das Original-PDF eines Objektdokuments (jede Version, optional mit seite nur eine Einzelseite). Liefert einen 15 Minuten gültigen Download-Link, den du auch im Browser öffnen kannst, samt curl-Beispiel; mit inline=true kommt eine kleine Datei (bis 8 MB) zusätzlich direkt als Base64. Die dokument_id liefert objekt_dokumente_auflisten (dort jetzt auch mit Dateigröße).

Bei aktivem Katastrophenplan-Modul lesen katplan_liste, katplan_lesen, katplan_elemente und katplan_element_lesen die freigegebene Fassung. katplan_suchen durchsucht Elemente und Quellseiten; katplan_orte_suchen findet Orte nach Entfernung. katplan_verknuepfungen zeigt Live-Links und Beziehungen, katplan_dokument_auszug Quelltexte oder mit download=true einen kurzlebigen PDF-Link. Elemente sind per UUID oder Kennung lesbar. Nur Planbearbeiter dürfen ausdrücklich fassung="arbeitsstand" wählen. Vertrauliche Inhalte und Telefonnummern folgen denselben Rechten wie die Oberfläche. Fehlende Angaben stehen als null mit Hinweis in warnings; diese Werkzeuge ändern keine Planinhalte und geben nichts frei. Adressen kommen als Text (address) und strukturiert (address_parts mit strasse, hausnummer, plz, ort).

Beispiele: „Welche Kontrollstellen gibt es im Hochwasserplan?“, „Was ist bei Stufe 2 zu tun?“, „Welche Problemstellen liegen im Umkreis von 500 m um die Kesselstraße?“, „Zeig mir Seite 6 der Quelle.“

Kontrollierter Ablauf

MCP kann nie ein Objekt oder Dokument freigeben. Neue Objekte bleiben Entwürfe; bei freigegebenen Objekten entsteht eine Arbeitskopie. Neue Dokumente an einem freigegebenen Objekt warten auf Freigabe im Einsatzcockpit. Prüfe und gib dort bewusst frei. Zentrale Kontakte können per MCP gepflegt werden; beim Aktualisieren schützt die Versionsnummer vor dem Überschreiben zwischenzeitlicher Änderungen. SMS- und Mail-Freigaben, SMS-Versand sowie Kontakt-Import und -Export bleiben dabei aus und stehen nur im Einsatzcockpit zur Verfügung.

Bei "fertig übergebenen" Plänen analysiert Claude das PDF vor der Übergabe: Volltext und Seitenklassifizierung werden mitgeliefert. Das Einsatzcockpit macht danach kein OCR und keine KI-Analyse, erzeugt aber weiterhin technisch die Seitenvorschauen.

Große PDFs laufen zweistufig: Claude ruft objekt_dokument_upload_vorbereiten auf, lädt die Datei mit dem gelieferten curl-Befehl von deinem Rechner hoch und übergibt sie danach mit upload_id und der fertigen Seitenklassifizierung. Voraussetzung ist, dass Claude auf deinem Rechner Befehle ausführen darf und dein Einsatzcockpit von dort erreichbar ist. Wenn du Kontakte zu einem Objekt hinzufügst, die schon fast identisch existieren, nennt die Fehlermeldung den neuen Kontakt und die Kandidaten mit Namen; dann entweder die vorhandene kontakt_id verwenden oder duplikat_bestaetigt=true setzen. Für objekt_aktualisieren genügt die ID des Objekts oder seiner Arbeitskopie.

Beispiele:

Analysiere diese Pläne, prüfe Objekt- und Kontakt-Dubletten, lege einen Objektentwurf an oder aktualisiere die Arbeitskopie und übergib die klassifizierten PDFs.

Suche den zentralen Kontakt der Hausverwaltung, lies ihn mit Version, ergänze die Erreichbarkeit und aktualisiere ihn nur, wenn keine andere Änderung dazwischenkam.

Prüfe die beiden Kontakte auf Dubletten. Zeige mir die Daten und Objektzuordnungen, bevor du sie mit bestaetigt=true zusammenführst.

Lies Objekt 123 einschließlich Arbeitskopie, hänge Kontakt 45 als Hausverwaltung an, ändere anschließend dessen Erreichbarkeit oder entferne die Zuordnung anhand ihrer zuordnung_id.

Lade das PDF ~/Downloads/bma-datenblatt.pdf über den Upload-Link ins Objekt 123, klassifiziere jede Seite und übergib es an die Arbeitskopie.

Werte alle aktiven, statistikrelevanten Fahrten 2026 pro Fahrzeug aus.

Trage morgen von 07:00 bis 18:00 eine Vollsperre der Bregenzer Straße zwischen Hausnummer 12 und 38 ein.

Gibt es für Einsatz 2026-471 Probleme bei der Anfahrt?

Grenzen und Datenschutz

PDFs werden entweder als Base64 im Tool-Aufruf (dekodiert bis 8 MB) oder über einen einmaligen Upload-Link (bis 50 MB, 15 Minuten gültig, an Benutzer und Objekt gebunden) übergeben; nicht übergebene Uploads werden nach 24 Stunden gelöscht. Kontakt-Import und -Export, SMS- und Mail-Freigaben je Objektkontakt sowie SMS-Versand sind keine MCP-Werkzeuge. Fahrtenbuchdaten enthalten Fahrernamen; Fahrtenbuch-Admins sehen diese und übermitteln sie bei einer Abfrage an die verwendete KI-Anwendung. Beachte deshalb die Datenschutz- und Freigaberegeln deiner Organisation.

Einsätze auslesen

Für sichtbare Einsätze stehen allen Einsatzrollen ab readonly zehn ausschließlich lesende Werkzeuge zur Verfügung:

Werkzeug	Zweck
einsaetze_liste	sichtbare Einsätze filtern und auflisten
einsatz_lesen	Stammdaten und Meldebild eines Einsatzes lesen
einsatz_einheiten	alarmierte und eingesetzte Einheiten lesen
einsatz_auftraege	Aufträge einschließlich Medien-Metadaten lesen
einsatz_meldungen	Meldungen einschließlich Medien-Metadaten lesen
einsatz_verlauf	Tagebuch und Funkjournal lesen
einsatz_objekte	verknüpfte Objekte und freigegebene Dokumente lesen
einsatz_lagebild	kompaktes Lagebild aus Einheiten, offenen Punkten, Objekten und Verlauf lesen
einsatz_objekt_dokument_herunterladen	kurzlebigen Link für ein freigegebenes Dokument eines verknüpften Objekts vorbereiten
einsatz_medium_herunterladen	kurzlebigen Link für ein Auftrags- oder Meldungsmedium vorbereiten

Beispiel-Fragen: „Welche Einsätze sind derzeit aktiv?“, „Welche offenen Aufträge hat Einsatz 42?“, „Fasse mir das Lagebild von Einsatz 42 zusammen.“ oder „Lade den Objektplan aus Einsatz 42 herunter.“

Aufträge und Meldungen anlegen

einsatz_auftrag_anlegen und einsatz_meldung_anlegen legen Karten direkt im Einsatzboard an. Sie stehen Einsatzleitern, Schriftführern und Admins zur Verfügung und funktionieren auch bei kollaborierenden Einsätzen. Abgeschlossene Einsätze sind dafür gesperrt. Neue Meldungen zeigen als Autor „Name (MCP)“.

Beispiel: „Lege bei Einsatz 42 den Auftrag ‚Wasserversorgung prüfen‘ für Einheit 7 an.“ oder „Erstelle eine Achtung für Einsatz 42, fällig in 15 Minuten.“

Bewusst nicht geliefert werden Inhalte und Medien aus der Personen-Spalte, Atemschutzdaten, Mannschaftsnamen, Anrufer, Autoren sowie Objekt-Kontakte. Die Download-Links gelten nur kurz und werden beim Abruf nochmals gegen die aktuellen Rechte geprüft.

Katastrophenpläne als Entwurf pflegen

Planverwalter und Planfreigeber können über den Assistenten den Arbeitsstand eines Katastrophenplans pflegen. Einreichen und Freigeben bleibt immer Menschen im Einsatzcockpit vorbehalten; freigegebene Versionen ändern sich nicht.

• katplan_element_entwurf_anlegen:
  • Pflichtangaben sind typ (info, massnahme, kontrollstelle, gefahrenbereich, ablauf, ressource, medien, zustaendigkeit, objektverweis) und titel.
  • Optional: beschreibung (Zeilen; Listenpunkte mit „•“ oder „-“), kapitel_id oder kapitel_titel (ein neues Kapitel wird bei Bedarf angelegt), phasen (Namen), prioritaet 1–3, daten (typspezifisch, z. B. schritte, kontrollhinweise, bedarf), tags, quelle_dokument_id/quelle_seiten.
  • Adresse: adresse als Objekt, z. B. {"strasse": "Eulentobel", "hausnummer": "7", "plz": "6922", "ort": "Wolfurt"}. Straße und Hausnummer bitte getrennt angeben, andere Schlüssel werden abgewiesen.
  • Ort: geometrie als GeoJSON, oder verorten=true. Damit wird die Adresse geokodiert; fehlt der Ort, gilt der Ort der Organisation. Fehlende PLZ und Ort werden aus dem Treffer ergänzt, und die Antwort nennt unter verortung den Treffer.
  • Per MCP gesetzte Orte sind immer ungeprüft.
• katplan_element_entwurf_aendern: ändert Felder eines Elements (UUID oder Kennung wie KS-03) mit der aktuellen version. Erlaubt sind die Felder oben sowie gueltig_bis und pruefen_am. Eine Teiladresse wie {"adresse": {"hausnummer": "9"}} ändert nur dieses Feld; verorten=true setzt den Punkt aus der Adresse neu. Herkunft, Vertraulichkeit und Ortsprüfung lassen sich nicht ändern.
• katplan_verknuepfung_setzen / katplan_verknuepfung_entfernen: Stammdatenziele (kontakt, kontakt_organisation, objekt, fahrzeug, wasserstelle) am Element oder, ohne element_id, am Plan verknüpfen. Kontakte vorher über kontakt_suchen bzw. kontakt_organisation_suchen finden. Telefonnummern über Kontakte pflegen und nicht in die Beschreibung kopieren; doppelte Telefonnummern meldet die Qualitätsprüfung. Gleiches Ziel mit gleicher Rolle wird wiederverwendet (bereits_vorhanden), ein übergebener abweichender Hinweis aktualisiert. Ohne Rolle entfernt das Entfernen alle Rollen für dieses Ziel.
• katplan_beziehung_setzen / katplan_beziehung_entfernen: Elemente verbinden; Kennungen gelten im selben Plan, UUIDs auch planübergreifend innerhalb der Organisation. Arten: siehe_auch, folgt_auf, abhaengig_von, eskaliert_zu. Ohne art werden beim Entfernen alle Beziehungen zum Ziel entfernt. Setzen ist idempotent.
• katplan_anlegen: felder benötigt titel und planart (alarm_einsatzplan, massnahmenplan, katastrophenplan); bei Katastrophenplänen zusätzlich gefahrenarten. Optional: beschreibung als Text, geltungsbereich, verantwortliche_stelle, verantwortlich_kontakt_id, wiedervorlage_am (YYYY-MM-DD), pruefintervall_monate (1..60) und pruef_verantwortlich_user_id. Kontakte und Prüfverantwortliche müssen aus der eigenen Organisation stammen. Ohne Intervall gilt der Standard der Planart, ohne Prüfverantwortlichen der aufrufende Benutzer. Die Antwort enthält plan_id, plan_version, plan, kapitel mit IDs, phasen und url. Elemente danach mit katplan_element_entwurf_anlegen und einer kapitel_id aus der Antwort ergänzen. Der Status ist immer Entwurf, die Freigabe bleibt beim Menschen. pruefen=true validiert mit Rollback (gespeichert=false); die zurückgegebenen IDs werden dabei nicht gespeichert.
• katplan_stammdaten_aendern: version aus katplan_lesen(fassung="arbeitsstand")["plan_version"] verwenden. felder darf titel, beschreibung (Text), gefahrenarten (Liste von Codes), geltungsbereich, verantwortliche_stelle, verantwortlich_kontakt_id und wiedervorlage_am (YYYY-MM-DD) enthalten. Nur übergebene Felder ändern sich; null oder "" leert optionale Felder. Titel und Gefahrenarten sind Pflicht; unbekannte Felder sind Fehler. Die Antwort enthält den Kopf als plan, die neue plan_version, geaendert, unveraendert, verworfen und gespeichert. Der Status wird automatisch zur Überarbeitung, die Freigabe bleibt beim Menschen. Verknüpfungen und Beziehungen setzen sowie Stammdaten ändern unterstützen pruefen=true als Trockenlauf mit Rollback; Stammdaten akzeptieren auch streng=true.
• katplan_quellseite_verknuepfen: Bis 50 Zuordnungen als zuordnungen mit element_id (UUID oder Kennung), dokument_id, seiten (z. B. "3-4,7") und optional version. ergebnisse meldet je Element geaendert, unveraendert oder fehler. Gültige Einträge werden gespeichert; streng=true bricht bei einem Fehler alles ab, pruefen=true prüft ohne Speicherung.
• katplan_quellseite_bilder: Für plan_id, dokument_id, seiten_nr die eingebetteten Bilder mit Index, Abmessungen, Format und Bytezahl ansehen. Mindestens 200 Pixel je Achse, maximal 20 Bilder; vorschau=true liefert bis acht Bilder mit maximal 512 Pixeln. seitenbild nennt die Größe des gerenderten Seitenbilds. Leser sehen nur freigegebene Quellen; Bearbeiter auch Arbeitsquellen. source_references.seiten_liste enthält bis 30 geschützte Seiten-URLs (thumb_url, seiten_url, text_url), bei Freigaben mit version_id; diese URLs benötigen eine Anmeldung.
• katplan_anhang_aus_quellseite: Quellseite direkt als Foto an Plan oder element_id übernehmen. modus="seite" nutzt das gerenderte Seitenbild, modus="bild" das zuvor gewählte bild_index, modus="ausschnitt" einen relativen rahmen=[x0,y0,x1,y1] zwischen 0 und 1 (mindestens 5 % je Achse). Standardbeschriftung: Quelle: <Dokumenttitel> v<Version>, S. <Seite>; beschriftung und vertraulich sind einstellbar. pruefen=true liefert die Vorschau des Ergebnisses und entfernt anschließend Datenbankänderungen sowie erzeugte Bilddateien. Die menschliche Freigabe bleibt nötig.
• katplan_anhang_upload_vorbereiten / katplan_anhang_uebergeben: Foto oder PDF an Plan oder Element. Kleine Dateien per inhalt_base64 oder als ChatGPT-Anhang (datei.download_url), größere über den Upload-Link.
• katplan_vorschlaege_aus_dokument:
  • Der Assistent liest eine Quellseite (katplan_dokument_auszug) und reicht bis zu 30 strukturierte Vorschläge ein (Felder wie oben, dazu kontakte und objekt).
  • Sie landen in der Import-Prüfung im Einsatzcockpit; erst ein Mensch übernimmt sie als Elemente.

Vor Änderungen das Element mit katplan_element_lesen(fassung="arbeitsstand") lesen und seinen Sperrzähler version übergeben. element_version_id bezeichnet ausschließlich eine Freigabezeile und dient nicht zum Schreiben. Ein Versionskonflikt nennt die aktuelle Version; danach neu lesen. katplan_lesen liefert im Arbeitsstand außerdem plan_version.

Beide Entwurfswerkzeuge liefern geaendert, verworfen (Pfad und Grund), gespeichert und element im Leseformat des Arbeitsstands; beim Ändern außerdem unveraendert. Zahlen in daten werden zu Text, etwa bedarf: [{"bezeichnung": "Sandsäcke", "menge": 500, "einheit": "Stk"}] mit gespeicherter Menge "500". Unbekannte Felder, falsche Typen und Begrenzungen werden unter verworfen gemeldet. streng=true verhindert bei solchen Verlusten die gesamte Speicherung. Mit pruefen=true wird alles validiert und das vorgeschlagene Element zurückgegeben, aber nichts gespeichert (gespeichert=false), auch keine neuen Kapitel/Phasen.

Beim Ändern leert adresse: null alle vier Adressfelder. Einzelne Werte wie {"hausnummer": null} oder {"ort": ""} leeren nur dieses Feld; fehlende Schlüssel bleiben. geometrie: null entfernt den Ort. quelle_dokument_id: null entfernt die Quelle und auch die Seiten, sofern quelle_seiten nicht mitgegeben wird. Seitenangaben wie "3-4,7" beziehen sich auf die angegebene quelle_dokument_id. gueltig_bis, pruefen_am und kapitel_id lassen sich mit null oder "" leeren.

Neue Elemente sind als „KI-Vorschlag“ gekennzeichnet; alle Änderungen erscheinen im Planprotokoll mit Herkunft mcp. Ein freigegebener Plan wechselt dabei auf „in Überarbeitung“.

Beispiel: „Lege im Hochwasserplan unter ‚Problemstellen‘ eine Kontrollstelle ‚Eulentobelbach – Durchlass‘ an, Adresse Eulentobel 7, verorten, Phase ‚Stufe 1‘, Kontrollhinweis: Rechen auf Verklausung prüfen.“

Kontrollstellen in Serie verorten

Mit katplan_elemente_verorten(plan_id=42) liefert der Assistent Ortskandidaten für bis zu 30 Elemente ohne Geometrie. Optional begrenzt element_ids die Auswahl auf UUIDs oder Kennungen; weitere nennt die übrigen Elemente. Vorschläge kommen zuerst aus verknüpften Objekten/Wasserstellen, dann aus Adresse und Titel (etwa Brücke oder Bach). Nahe Treffer werden zusammengefasst. Ohne auswahl wird nichts geändert.

Nach Prüfung setzt auswahl={"<element_id>": "<kandidat_id>"} den gewählten Punkt. Die Kandidaten werden erneut gesucht; unbekannte IDs ergeben einen Fehler je Element. pruefen=true zeigt das Ergebnis als Trockenlauf. Vorhandene Orte benötigen nur_ohne_ort=false, geprüfte Orte zusätzlich ueberschreiben_geprueft=true. Gesetzte Orte sind immer ungeprüft: Lage vor Ort prüfen und im Editor als geprüft markieren. Die gedrosselte Adresssuche kann bei vielen Elementen dauern.

Auch verorten=true beim Anlegen/Ändern gibt bei mehreren gleichwertigen, mehr als 200 Meter auseinanderliegenden Treffern Kandidaten zurück und setzt keinen neuen Punkt. Mit felder={"geometrie_von": {"wasserstelle_id": 7}} oder {"objekt_id": 7} beim Ändern lässt sich ein vorhandener Stammdatenpunkt der eigenen Organisation übernehmen; das geht nicht zusammen mit geometrie und verlangt verfügbare Stammdaten mit Koordinaten.

Import mit der Quelle abgleichen

Mit katplan_import_abgleichen(plan_id=42, dokument_id=7) prüft der Assistent den Arbeitsstand gegen genau diese Quelle. Das Werkzeug benötigt Bearbeitungsrechte und ändert keine Elemente. Es zeigt Seiten ohne verknüpftes Element mit Titel, Textauszug und geschützter Vorschau, Elemente ohne Quelle sowie Bezüge auf ältere Versionen derselben Quellgruppe. Alte Bezüge decken die Seiten der gewählten Version nicht ab.

Zusätzlich erscheinen mögliche Dubletten (gleicher Typ und ähnlicher Titel oder gleiche Adresse), offene Import-Vorschläge je Seite und bis zu 30 nächste Schritte. Dubletten werden nur gemeldet; prüfen und zusammenführen erfolgt in der Oberfläche. katplan_vorschlaege_aus_dokument liefert unter warnungen Hinweise auf ähnliche bestehende Elemente desselben Typs. Die Vorschläge landen trotzdem in der Review-Queue.