ZITA mit Claude verbinden

Der ZITA-Connector verbindet den KI-Assistenten Claude mit Ihrer ZITA-Organisation. Sie beschreiben in eigenen Worten, was zu tun ist, und Claude liest oder pflegt Kunden, Objekte, Projekte, Raumbuch, Kalkulation, Revierplanung und Anfragen direkt in ZITA. Jede Person meldet sich mit ihrem eigenen ZITA-Konto an und hat genau die Rechte ihrer Rolle.

ZITA ist als offizieller Connector im Claude-Verzeichnis gelistet. Technisch ist der Connector ein Server nach dem Model Context Protocol (MCP), Endpunkt: https://www.hellozita.app/api/mcp

1. Voraussetzungen

• Ein ZITA-Konto in einer Organisation, deren Rolle den KI-Zugang erlaubt. Voreinstellung: Inhaber und Administratoren lesen und schreiben, Kalkulatoren lesen, Objektleiter haben keinen Zugang. Die Administration ändert das unter Einstellungen → „API, Webhooks & MCP“.
• Ein Claude-Plan mit Connectors. In einer Claude-Team- oder Enterprise-Organisation fügt die Administration den Connector für alle hinzu, jede Person verbindet danach ihr eigenes ZITA-Konto.

2. Verbinden

1. Den ZITA-Eintrag im Claude-Verzeichnis öffnen und auf „Verbinden“ klicken. In einer Claude-Team- oder Enterprise-Organisation fügt zuerst die Administration den Connector für alle hinzu.
2. Claude leitet zur ZITA-Anmeldeseite. Wer in ZITA bereits angemeldet ist, wird direkt weitergeleitet. Beim ersten Verbinden bestätigen Sie einmal, dass Claude auf Ihr Konto zugreifen darf.
3. Der Connector ist einsatzbereit. Es wird kein Schlüssel kopiert und kein Passwort in Claude gespeichert.

Die Anmeldung läuft über OAuth 2.1. Claude erneuert die Berechtigung im Hintergrund, Sie melden sich also nicht bei jeder Unterhaltung neu an. Nach dem Trennen fragt das nächste Verbinden wieder nach der ZITA-Anmeldung, sofern Sie in ZITA gerade nicht angemeldet sind.

Ohne Verzeichnis geht es auch: In Claude unter „Connectors“ einen eigenen Connector mit dem Endpunkt https://www.hellozita.app/api/mcp hinzufügen. Anmeldung und Rechte sind dieselben.

Ohne Anmeldung: API-Schlüssel

Werkzeuge, die eigene Kopfzeilen setzen können (Claude Code, Claude Desktop, eigene Skripte), erreichen denselben Endpunkt mit einem API-Schlüssel der Organisation: Authorization: Bearer zita_live_…. Schlüssel gibt die Administration unter Einstellungen → „API, Webhooks & MCP“ aus, wahlweise nur lesend oder lesend und schreibend. Ein Schlüssel gilt für die ganze Organisation; Änderungen werden dem Schlüssel zugeschrieben, nicht einer Person.

3. Was der Assistent kann

Claude arbeitet mit einem festen Satz von Werkzeugen. Vor jeder Änderung an Ihren Daten holt Claude Ihre Freigabe ein; reine Leseschritte laufen ohne Rückfrage.

Bewusst nicht möglich: Kunden, Objekte oder Projekte löschen, Angebote freigeben oder versenden, Dokumente erzeugen, Einstellungen der Organisation ändern. Diese Schritte bleiben der Anwendung vorbehalten.

Der Assistent erfindet keine Fachwerte. Raumgruppen, Bodenbeläge, Aufwandsstufen und Lohngruppen müssen aus den Listen Ihres Projekts stammen; ein unbekannter Wert wird mit der erlaubten Liste abgewiesen, statt die Kalkulation zu verfälschen.

Beispiele

• „Lege für die Muster GmbH das Objekt Bürohaus Nord an, Adresse aus dieser Mail.“
• „Trag die Räume aus dieser Tabelle ins Raumbuch von Projekt PR-1042 ein, Intervall 5× wöchentlich, Bodenbelag wie angegeben.“
• „Verteile die Räume von PR-1042 auf zwei Reviere nach Gebäude und Etage, zeig mir erst die Vorschau mit den Stunden je Revier.“
• „Welche Anfragen liegen seit mehr als zehn Tagen ohne Rückmeldung?“

4. Rechte und Nachvollziehbarkeit

• Die Rolle in ZITA entscheidet. Wer in ZITA nur lesen darf, kann über Claude nichts ändern. Objektleiter sind in ZITA auf ihre Objekte beschränkt; da der Connector diese Einschränkung nicht abbilden kann, bleibt ihnen der Zugang verschlossen.
• Jede Änderung steht im Projektverlauf unter dem Namen der angemeldeten Person, bei API-Schlüsseln unter dem Namen des Schlüssels.
• Gesperrte und archivierte Projekte bleiben auch über den Connector unveränderbar.
• Zugriffe werden protokolliert und in der Häufigkeit begrenzt, um Missbrauch zu erkennen.

5. Datenschutz

Sobald Sie verbinden, ruft der von Ihnen gewählte KI-Anbieter auf Ihre Anweisung Daten aus ZITA ab: Kunden, Objekte, Projekte sowie Namen und Kontaktdaten von Ansprechpartnern. Die Verarbeitung findet auf den Servern des Anbieters statt, auch außerhalb der EU, nach dessen Bedingungen. ZITA sendet von sich aus nichts; die Verbindung entsteht nur, wenn Ihre Organisation sie einrichtet und freigibt. Einzelheiten stehen in unserer Datenschutzerklärung, Ziffer 15.

6. Verbindung trennen

• In Claude: den Connector in den Einstellungen entfernen.
• In ZITA: die Rolle unter „API, Webhooks & MCP“ auf „kein Zugang“ setzen oder den API-Schlüssel widerrufen. Die Sperre greift spätestens beim nächsten Aufruf.

7. Hilfe

Fragen zur Einrichtung beantworten wir unter [email protected]. Entwickler finden die Beschreibung der zugrunde liegenden REST-Schnittstelle in der Anwendung unter Einstellungen → „API, Webhooks & MCP“.