API und MCP

Mit einem API-Schlüssel greifen eigene Programme auf hausverwalter.ai zu, etwa ein Export für die Buchhaltung oder ein KI-Assistent wie Claude. Der Schlüssel hat genau die Rechte der Person, der er gehört.

Schlüssel erstellen

Unter „Einstellungen“ › „API-Schlüssel & MCP“ klickst du auf „Erstellen“ und füllst aus:

• „Name“: woran du den Schlüssel später erkennst, etwa „Buchhaltung-Export“.
• „Besitzer“: dessen Rechte der Schlüssel bekommt.
• „Schnittstellen“: „REST-API“ für eigene Programme, „MCP“ für KI-Assistenten oder beides.

Der Schlüssel erscheint nur ein einziges Mal, kopier ihn also gleich. Wie du ihn mit Claude nutzt, steht unter MCP für Claude Code.

Für einen Kollegen stellst du einen Schlüssel nur aus, wenn du mindestens seine Rechte hast und alles siehst. Schlüssel verwaltet, wer das Recht „API-Schlüssel und Webhooks“ hat. In der Testphase gibt es keine API-Schlüssel.

Die REST-API

Mit „API-Dokumentation“ öffnest du die Beschreibung aller Schnittstellen, sie ist auf Englisch. Mit „API-Dokumentation teilen“ erzeugst du einen Link mit Ablaufdatum, etwa für euren Softwaredienstleister.

Programme melden sich mit dem Schlüssel an und erreichen die API unter https://api.hausverwalter.ai/api/v1.

Schlüssel löschen

In der Liste löschst du einen Schlüssel über „⋯“ › „Löschen“. Er funktioniert sofort nicht mehr, eine Rückfrage gibt es nicht.

Wird der Besitzer deaktiviert, hört auch sein Schlüssel auf zu funktionieren. Wird er gelöscht, löscht hausverwalter.ai auch den Schlüssel.