— KI & Schnittstellen

KI & Schnittstellen: ImmoGenio per REST anbinden oder per KI steuern.

ImmoGenio öffnet sich nach außen über zwei Wege: die Partner-API v1 als scope- und mandantengesicherte REST-Schnittstelle für Integrationen und der MCP-Server als Anbindung für KI-Clients wie Claude. 58 Tools decken Objekte, Einheiten, Mieter, Mietverträge, Eigentümer sowie Eigentümerversammlungen und Beschlüsse ab — Status und Ergebnis werden nicht als Felder gesetzt, sondern über echte GenioFlow-Workflows getrieben.

Die KI- und Schnittstellen-Schicht macht aus ImmoGenio eine offene, aber kontrollierte Plattform. Die Partner-API v1 (/api/v1/partner/*) ist die Maschinen-Tür: Jeder Zugriff läuft über ein Partner-API-Token, das Mandant und Scopes bestimmt — Authentifizierung, Berechtigungsprüfung, Row-Level-Security, Pagination und Audit erzwingt die API, nicht der Aufrufer. Personenbezogene Daten sind abgestuft: Der Basis-Scope liefert nur Identifikation, Kontaktdaten erfordern einen separaten ReadPII-Scope, Bank- und Steuerdaten werden grundsätzlich nie exponiert. Auf genau dieser API setzt der MCP-Server (Model Context Protocol) auf — ein dünner Adapter ohne eigene Geschäftslogik, der einem KI-Client 58 klar beschriebene Tools bereitstellt. Verwalter fragen Bestände damit in natürlicher Sprache ab und fahren Vorgänge wie Mietvertrags-Kündigung, WEG-Beschluss oder Eigentümerversammlung über dieselben GenioFlow-Übergänge durch, die auch das Portal nutzt — inklusive Guards, Side-Effects und unveränderlichem Audit-Trail. Die erste Version ist single-tenant: ein Token, ein Mandant.

Häufige Fragen

Was ist der Unterschied zwischen Partner-API und MCP-Server?

Die Partner-API v1 ist eine klassische REST-Schnittstelle für Integrationen und eigene Systeme. Der MCP-Server ist ein dünner Adapter ohne eigene Geschäftslogik, der genau diese API als Tools für KI-Clients wie Claude bereitstellt. Beide nutzen dasselbe Token-, Scope- und Audit-Modell.

Warum Workflow-Übergänge statt eines Status-Feldes?

Vorgänge wie Kündigung, Beschluss oder Eigentümerversammlung sind in ImmoGenio Zustandsmaschinen (GenioFlow). Die Tools setzen daher keinen Status, sondern fragen über *_workflow_status die erlaubten Aktionen ab und führen über *_workflow_transition genau einen geprüften Übergang aus — mit denselben Guards und Side-Effects wie im Portal.

Wie sind personenbezogene Daten und Mandanten geschützt?

Das Partner-API-Token bestimmt Mandant und Scopes. Der Basis-Scope liefert nur Identifikationsdaten; Kontaktdaten erfordern einen separaten ReadPII-Scope, Bank- und Steuerdaten werden nie exponiert. Die Mandantentrennung erzwingt PostgreSQL über Row-Level-Security, jede schreibende Aktion wird revisionssicher protokolliert.

Wie verbinde ich Claude Desktop oder Claude Code?

Ein Tenant-Administrator erzeugt ein Partner-API-Token mit den gewünschten Scopes. Anschließend wird der MCP-Server mit der API-URL und dem Token im Client registriert — in Claude Desktop per Konfigurationseintrag, in Claude Code mit einem einzelnen Befehl. Danach stehen die 58 Tools für Anfragen in natürlicher Sprache bereit.

Bereit für einfachere Immobilienverwaltung?

Starten Sie heute. 45 Tage volle Professional-Suite gratis — Tarif-Wahl erst nach dem Test.

Jetzt kostenlos testenDemo-Zugang

45 Tage volle Professional-Suite. Der Test läuft automatisch aus — keine Kündigung, keine Bankdaten. Nach dem Test wählen Sie Starter oder Professional, monatlich kündbar mit 14 Tagen Frist.