Zum Inhalt springen

KI & MCP

Deine Miet­verwaltung in ChatGPT, Claude und Codex

Immokeks hat keine eigene KI. Du verbindest den Agenten, den du schon nutzt, und gibst ihm Aufgaben in normalen Sätzen. Was rechtlich wirkt, gibst du in Immokeks frei.

Was ist MCP?

MCP (Model Context Protocol) ist ein offener Standard, über den KI-Apps die Werkzeuge anderer Dienste aufrufen. Immokeks stellt über 100 Funktionen als MCP-Server bereit: von „Immobilie anlegen“ bis „Abrechnung berechnen“.

  1. Du
  2. Deine KI-App
  3. Immokeks (MCP)
  4. Deine Daten

Welche KI-Apps funktionieren

Stand 24.10.2026. Was in welchem Tarif geht, legt der KI-Anbieter fest; maßgeblich sind seine Seiten.

Unterstützte KI-Apps
AppWo einrichtenWas du brauchst
Claude (claude.ai, Claude Desktop)Connectors: eigenen Connector mit der Server-URL hinzufügenServer-URL; Anmeldung im Login-Fenster von Immokeks
ChatGPT Business, Enterprise, EduEntwicklermodus, den der Workspace-Admin freischaltetServer-URL; Anmeldung im Login-Fenster
ChatGPT Plus und Pronicht möglichDort gehen nur Apps aus dem Verzeichnis von OpenAI; Immokeks ist dort noch nicht gelistet
Claude Codeclaude mcp add …Login-Fenster oder Token
Codex~/.codex/config.tomlLogin-Fenster oder Token
Gemini CLI~/.gemini/settings.jsonLogin-Fenster oder Token (nicht die Gemini-App)
Cursor und andereMCP-Einstellungen der AppToken als API-Key im Header

Einrichten in drei Schritten

  1. 01

    Adresse kopieren

    Das ist die Adresse des MCP-Servers von Immokeks.
    https://immokeks.de/api/mcp
  2. 02

    In der KI-App eintragen

    Es öffnet sich das Login-Fenster von Immokeks: anmelden, Rechte und Datensparmodus wählen, erlauben. Die Verbindung gilt ein Jahr.
  3. 03

    Loslegen

    Zum Beispiel: „Richte mein Konto ein.“ Bei einem leeren Konto führt Immokeks deinen Agenten durch die Einrichtung.
Claude Code, mit Token
claude mcp add --transport http immokeks https://immokeks.de/api/mcp --header "Authorization: Bearer vos_…"
Codex, mit Token
# ~/.codex/config.toml (Token vorher als IMMOKEKS_TOKEN setzen)
[mcp_servers.immokeks]
url = "https://immokeks.de/api/mcp"
bearer_token_env_var = "IMMOKEKS_TOKEN"

Einen Token erstellst du in Immokeks unter „KI-Zugang (MCP)“. Er gilt 1 bis 365 Tage und wird nur einmal angezeigt. Alle Varianten stehen in der MCP-Doku.

Was du deinem Agenten sagen kannst

Neun Aufgaben aus dem Vermieter-Jahr und die Funktionen, die dein Agent dafür typischerweise aufruft.

  • „Richte mein Konto ein: Musterstraße 12, drei Wohnungen, die Mieter stehen in dieser Liste.“

    create_propertycreate_unitcreate_personcreate_lease

  • „Hier ist der Kontoauszug als CSV. Ordne die Mieten zu.“

    import_bank_filematch_bank_transaction

  • „Lies diese drei Rechnungen und buch sie auf die Musterstraße.“

    upload_invoicesubmit_invoice_readingset_invoice_allocations

  • „Wer ist mit der Miete im Rückstand, und welche Mahnung ist dran?“

    get_arrearsget_dunning_proposalscreate_letter

  • „Bereite die Nebenkostenabrechnung 2025 für die Musterstraße vor.“

    create_settlement_draftcalculate_settlementexplain_settlement_amount

  • „Übernimm die Heizkostenabrechnung vom Messdienst aus diesem PDF.“

    create_provider_statementsubmit_provider_reading

  • „Was trage ich 2025 in die Anlage V ein?“

    get_tax_overviewget_anlage_v

  • „Darf ich die Miete in Wohnung 2 erhöhen? Der Mietspiegel sagt 9,80 € je m².“

    check_rent_increasecreate_letter

  • „Schick Anna und Ben den Mietvertrag zum Unterschreiben.“

    prepare_signature_requestsend_signature_request

Was dein Agent darf

Beim Verbinden wählst du die Rechte. „Lesen“ und „Schreiben“ sind vorausgewählt, damit dein Agent das Konto einrichten kann; „Rechtlich wirksam“ wählst du nur bei Bedarf. Ein Zugang hat nie mehr Rechte als deine Rolle im Konto.

Lesen

Alles anzeigen und auslesen.

Schreiben

Anlegen, ändern, zuordnen, buchen, berechnen. Dazu Links zum Unterschreiben und zur Selbstauskunft mailen, nachdem du die Empfänger im Chat bestätigt hast.

Rechtlich wirksam

Abrechnungen abschließen, Schreiben versenden, Stornos, Archivieren und Löschen. Immokeks führt das erst aus, wenn du den Schritt in der Web-App freigibst (innerhalb von 30 Minuten).

  • Datensparmodus. Von Anfang an an: Personen erscheinen als Pseudonym, ohne Kontaktdaten. Echte Daten gibt Immokeks nur für einen genannten Zweck heraus, höchstens 30-mal pro Stunde je Zugang.
  • Grenzen. 120 Aufrufe pro Minute je Zugang, 5.000 pro Tag je Konto, 50 Mails pro Tag.
  • Protokoll. Jeder Aufruf wird mit Funktion, Zeitpunkt und Zugang protokolliert, ohne Inhalte.
  • Trennen. Verbindungen und Tokens beendest du unter „KI-Zugang (MCP)“.

Was dein KI-Anbieter sieht

Was dein Agent bei Immokeks abruft, geht an den Anbieter deiner KI-App und wird dort nach dessen Bedingungen verarbeitet. Diesen Anbieter wählst du; Immokeks hat mit ihm keinen Vertrag und schickt ihm von sich aus nichts.

  • Lass den Datensparmodus an: Dein Agent sieht Mieter dann als Pseudonym ohne Kontaktdaten, und in Dokumenttexten maskiert Immokeks bekannte Namen, IBANs, E-Mail-Adressen, Telefonnummern und Geburtsdaten. Adressen maskiert er nicht, Bilder von Dokumenten gibt er nur auf ausdrückliche Anforderung heraus.
  • Nutze einen Tarif oder eine Einstellung, bei der dein KI-Anbieter deine Unterhaltungen nicht zum Training verwendet.
  • Gib deinem Agenten nur die Rechte, die er für die Aufgabe braucht.
  • Immokeks kennzeichnet Text aus Dokumenten für deinen Agenten als Inhalt, nicht als Anweisung. Prüfe trotzdem, was er vorschlägt.

Warum Immokeks keine eigene KI hat

Eine eigene KI kostet je Anfrage Geld. Ohne sie bleibt Immokeks kostenlos, und du entscheidest, welches Modell deine Daten sieht. Immokeks übernimmt den Teil, der genau sein muss: Beträge in Cent, Umlageschlüssel, Fristen, Kappungsgrenze, Anlage-V-Zeilen. Dein Agent übernimmt das Lesen und Formulieren.

Für Entwickler

  • REST-API. Dieselben Funktionen, Rechte und Freigaben unter /api/v1, mit Bearer-Token. OpenAPI-Beschreibung
  • MCP-Doku. Jede Funktion mit Eingaben, Rechten und Wirkung. Zur Doku
  • llms.txt. Kurzfassung für Agenten, die Doku selbst lesen. llms.txt
  • Schreibende Aufrufe nehmen einen Idempotency-Key; rechtlich wirksame Schritte antworten mit einer Freigabe-Anfrage statt sofort zu handeln.
Überblick über ein Konto per REST
curl -X POST https://immokeks.de/api/v1/operations/get_overview \
  -H "Authorization: Bearer $IMMOKEKS_TOKEN" \
  -H "Content-Type: application/json" -d '{}'

Häufige Fragen

Was ist MCP?

MCP (Model Context Protocol) ist ein offener Standard, über den KI-Apps fremde Werkzeuge aufrufen. Immokeks stellt seine Funktionen als MCP-Server bereit; deine KI-App ruft sie auf, wenn du eine Aufgabe gibst.

Kann mein Agent ohne meine Zustimmung etwas versenden oder löschen?

Nein. Abrechnungen abschließen, Schreiben versenden, Stornos und Löschen brauchen deine Freigabe in der Web-App. Links zum Unterschreiben verschickt er erst, wenn du die Empfänger im Chat bestätigt hast, höchstens 10 am Tag, und du bekommst nach jedem Versand eine Hinweis-Mail.

Hat Immokeks eine eigene KI?

Nein. Immokeks rechnet nach festen Regeln; lesen, zusammenfassen und formulieren macht dein eigener Agent. Deshalb entstehen Immokeks keine KI-Kosten, und du wählst das Modell.

Geht das auch ohne ChatGPT Business?

Ja, mit claude.ai und Claude Desktop, Claude Code, Codex, der Gemini CLI oder Cursor. In ChatGPT Plus und Pro lassen sich keine eigenen MCP-Server eintragen. Die Web-App funktioniert ganz ohne KI.

Wie trenne ich die Verbindung?

In Immokeks unter „KI-Zugang (MCP)“. Danach muss die App neu um Erlaubnis fragen. Ein Token lässt sich dort ebenfalls widerrufen.

Konto anlegen, Agent verbinden.

Alle Verwaltungsfunktionen dauerhaft kostenlos. Kosten entstehen nur bei Dritten, etwa für dein KI-Abo.1

Kostenlos starten