KI-Anbindung per MCP

Eckdaten des Servers

1. Codex CLI

codex mcp add rentinger --url https://mcp.rentinger.de/mcp
codex mcp login rentinger

codex mcp login öffnet den Browser für den OAuth-Flow (DCR + Google-Login). Nach erfolgreichem Login sind die Tools in Codex nutzbar.

Alternativ direkt in ~/.codex/config.toml (bzw. .codex/config.toml für ein vertrauenswürdiges Projekt):

[mcp_servers.rentinger]
url = "https://mcp.rentinger.de/mcp"
auth = "oauth"

Danach codex mcp login rentinger ausführen. Status prüfen mit codex mcp list.

2. Claude Code CLI

claude mcp add --transport http rentinger https://mcp.rentinger.de/mcp

Danach in Claude Code:

1. /mcp eingeben → Claude Code zeigt einen Browser-Link zur Autorisierung.
2. Link öffnen → Google-Login über den Mietvertrag-Generator-Flow.
3. Nach erfolgreichem Login sind die Tools nutzbar.

Die DCR registriert den Client automatisch (RFC 7591) – keine manuelle Client-ID/Secret nötig.

Falls beim Autorisieren eine Fehlerseite („Whitelabel Error Page / 400 Bad Request") erscheint: siehe Fehlerbehebung – meist steckt eine veraltete, gecachte Client-Registrierung dahinter.

3. ChatGPT (Web)

Voraussetzung: Plan mit Custom-Connector-Unterstützung (Plus, Pro, Business, Enterprise oder Edu) und aktivierter Developer Mode.

1. Settings → Connectors (bzw. Settings → Security → Developer mode aktivieren).
2. Bei den Connectors auf Add / „+" klicken und einen Custom-Connector im Developer-Mode anlegen.
3. Server-URL eintragen: https://mcp.rentinger.de/mcp (muss HTTPS sein).
4. Speichern/„Create". Wird OAuth verlangt, Authenticate wählen → Google-Login.
5. Nach dem Login erscheinen die Rentinger-Tools als aufrufbare Aktionen.

4. Claude (Web, claude.ai)

1. Settings → Connectors → Add custom connector.
2. Name vergeben (Kleinbuchstaben, Ziffern, Bindestriche – z. B. rentinger).
3. Typ Remote wählen und die Server-URL eintragen: https://mcp.rentinger.de/mcp.
4. Optional unter Advanced settings den Transport auf Streamable HTTP stellen (OAuth-Client-ID/Secret leer lassen – DCR übernimmt das automatisch).
5. Add klicken. Beim ersten Nutzen zum Google-Login weiterleiten lassen.

Hinweis: Claude verbindet sich aus Anthropics Cloud-Infrastruktur mit dem Server – mcp.rentinger.de muss also öffentlich aus dem Internet erreichbar sein (ist es).

5. Claude Desktop

Identisch zum Web-Client (gleiche Custom-Connector-Infrastruktur):

1. Settings → Connectors → Add custom connector.
2. Name: z. B. rentinger.
3. Remote, Server-URL: https://mcp.rentinger.de/mcp.
4. Optional Advanced settings → Transport Streamable HTTP; OAuth-Felder leer lassen.
5. Add → beim ersten Aufruf Google-Login durchlaufen.

Hinweis: Für Remote-MCP mit OAuth ist kein Eintrag in der lokalen claude_desktop_config.json nötig – das dortige mcpServers-Format ist für lokale stdio-Server gedacht. Für Rentinger den Custom-Connector-Dialog verwenden.

6. Mistral (Web, Le Chat)

1. In Le Chat die Connectors öffnen → + Add Connector.
2. Auf den Tab Custom MCP Connector wechseln.
3. Connector name: eindeutiger Name ohne Leer-/Sonderzeichen, z. B. rentinger.
4. Server URL: https://mcp.rentinger.de/mcp.
5. Connect klicken. Le Chat erkennt die Auth-Methode automatisch (OAuth 2.1 mit DCR) und startet den Login-Flow → Google-Login.
6. Nach erfolgreicher Autorisierung sind die Tools verfügbar.

Verfügbare Tools (Überblick)

• Lesend: list/get_rental_contracts, list/get_renters, list/get_properties, list/get_property_groups, list/get_bank_accounts, list/get_correspondences, validate_rent_increase_date, list/get_utility_bills, list/get_object_costs.
• Schreibend: create/update_renter, create/update_bank_account.
• Destruktiv (erfordern confirm='CONFIRM'): delete_renter, delete_bank_account, finalize/terminate/delete_rental_contract, send/finalize_correspondence.

Mandanten-, UserGroup- und Mieter-Regeln erzwingt ausschließlich das Mietvertrag-Generator-Backend (ein 403 wird transparent durchgereicht). Sie sehen über die KI-Anbindung also nur die Daten, auf die Ihr Konto auch in der Anwendung Zugriff hat.

Fehlerbehebung

„Whitelabel Error Page … 400 Bad Request" beim Autorisieren

Ursache ist fast immer eine veraltete, lokal gecachte OAuth-Client-Registrierung: Der Client schickt eine client_id, die der Server nicht (mehr) kennt (z. B. nach einem Server-Neustart, bei dem die frühere Registrierung verloren ging). Der Authorization Server kann bei unbekanntem Client nicht sicher zurückleiten und zeigt daher die Fehlerseite.

Lösung: Den gecachten OAuth-Status für den Server löschen, damit eine frische DCR ausgelöst wird:

• Claude Code CLI: /mcp → Server wählen → Clear authentication / neu authentifizieren. Falls nötig, Server entfernen und neu hinzufügen:

  claude mcp remove rentinger
  claude mcp add --transport http rentinger https://mcp.rentinger.de/mcp

  Notfalls den OAuth-Eintrag zu mcp.rentinger.de in ~/.claude.json bzw. ~/.claude/.credentials.json entfernen.
• Codex CLI: codex mcp login rentinger erneut ausführen; falls weiterhin fehlerhaft, den Server-Eintrag entfernen (codex mcp remove rentinger) und neu anlegen.
• Web-/Desktop-Clients (ChatGPT, Claude, Mistral): Den Connector entfernen und neu hinzufügen, dann erneut authentifizieren.

401 Unauthorized bei Tool-Aufrufen

Token abgelaufen oder Login abgebrochen – den Login-Flow (Google) erneut durchlaufen.