# Fairwalter MCP Server

> Verbinden Sie KI-Assistenten wie Claude, ChatGPT oder Perplexity mit Fairwalter, damit sie Fragen zu Ihren Liegenschaften, Mietern und Verträgen beantworten.

Über die MCP-Schnittstelle (Model Context Protocol) können Sie externe KI-Assistenten wie Claude Desktop, Claude Code, ChatGPT oder Perplexity direkt mit Ihren Daten in Fairwalter verbinden. Dadurch kann die KI Fragen zu Liegenschaften, Mietern, Verträgen, Rechnungen und Schäden lesen und beantworten.

:::note
Der MCP Server ist ab dem Abonnement Professional verfügbar.
:::

### Abo-Voraussetzungen der KI-Anbieter

-   **ChatGPT (OpenAI):** Die Einbindung steht allen Nutzern zur Verfügung (kostenloser Free-Plan sowie Plus, Team, Enterprise).
-   **Claude (Anthropic):** Die Einbindung steht allen Nutzern zur Verfügung (inklusive der kostenlosen Version), **setzt jedoch zwingend die Nutzung der Claude Desktop-App voraus** (die Web-Version im Browser wird nicht unterstützt).
-   **Perplexity:** Für benutzerdefinierte Connectors wird ein kostenpflichtiges Perplexity Pro-Abo benötigt.

> :::caution
> **Datenschutzhinweis:**\
> Wenn Sie einen KI-Assistenten über MCP mit Fairwalter verbinden, werden Daten an den externen Dienst weitergegeben, einschliesslich sensibler Personendaten Ihrer Mieter. Der Anbieter verarbeitet diese Daten sehr wahrscheinlich ausserhalb der Schweiz oder der EU.
> :::

## MCP-Server-URL abrufen

Bevor Sie die MCP-Server-URL kopieren können, muss das Modul einmalig in den Integrationen aktiviert werden. Das kann nur der Kontoinhaber; danach verbinden sich alle Benutzer mit ihrem eigenen Fairwalter-Login.

1.  Klicken Sie in Fairwalter oben rechts auf Ihren Profilnamen (z. B. **Hallo, \[Ihr Name\]**).
2.  Wählen Sie im Menü den Punkt **Integrationen**.
3.  Klicken Sie in der Übersicht beim Punkt **MCP Server** auf **Integration verwalten**.
4.  Klicken Sie auf **Aktivieren**.
5.  Unter dem Abschnitt **MCP-Server-URL** finden Sie die Server-Adresse. Sie ist für alle Kunden gleich.
6.  Klicken Sie auf den Button **URL kopieren**.

[Bild: Seite «MCP Server» in Fairwalter mit markierter MCP-Server-URL, «URL kopieren» und «Deaktivieren»]

***

## Anbindung am Beispiel von Claude Desktop

**Schritt 1: Einstellungen in Claude öffnen**

Öffnen Sie Claude Desktop, klicken Sie unten links auf Ihr Profil und wählen Sie **Einstellungen**.

[Bild: Claude Desktop mit geöffnetem Benutzermenü unten links und markiertem Eintrag «Einstellungen»]

**Schritt 2: Connector suchen & verbinden**

Navigieren Sie links zu den **Konnektoren**, suchen Sie nach **Fairwalter** und klicken Sie beim entsprechenden Community Connector auf **Verbinden**.

**[Bild: Claude-Einstellungen «Konnektoren» mit Suche nach «fairw» und markiertem Fairwalter-Connector mit «Verbinden»]**

**Schritt 3: Zugriff im Browser erlauben & verbinden**

-   Es öffnet sich automatisch ein Browserfenster von Fairwalter.

-   Bestätigen Sie die Zugriffsrechte mit einem Klick auf den blauen Button **Erlauben**.

-   Sie werden zur Meldung **Verbunden** weitergeleitet und können das Browserfenster schliessen.

[Bild: Fairwalter-Seite «Claude möchte auf Fairwalter zugreifen» mit markiertem «Assistenten-Zugriff (MCP)» und «Erlauben»]

**Schritt 4: Daten in Claude abfragen**

Nach erfolgreicher Verknüpfung greift Claude bei Fragen automatisch auf Ihre Fairwalter-Daten zu und beantwortet komplexe Abfragen (z. B. überfällige Mietzinszahlungen oder Mieterübersichten).

[Bild: Claude-Chat beantwortet eine Frage zu überfälligen Mietzinsrechnungen mit einer Tabelle aus Fairwalter-Daten]

***

## Für Entwickler & Terminal-Clients (Claude Code)

💡 **Terminal-Integration (Claude Code):**

Entwickler können den Server via CLI einbinden:

`claude mcp add --transport http fairwalter https://my.fairwalter.ch/mcp/v1`

_(Sollte ein API-Token benötigt werden, kann dieses weiter unten auf der MCP-Seite generiert werden)._

***

## Anbindung am Beispiel von ChatGPT

 Das Fairwalter-Plugin steht **allen ChatGPT-Nutzern (einschliesslich des Free-Plans)** zur Verfügung. Die Einrichtung erfolgt direkt über die Plugin-Suche:

**Schritt 1: Fairwalter-Plugin in ChatGPT suchen**

Öffnen Sie ChatGPT im Browser, klicken Sie in der linken Seitenleiste auf **Plugins** und geben Sie oben rechts im Suchfeld **Fairwalter** ein.  [Bild: ChatGPT-Seite «Plugins» mit markiertem Menüpunkt, Suche nach «Fairwalter» und Plus-Symbol beim Suchergebnis]

 **Schritt 2: Plugin hinzufügen**

Klicken Sie beim Suchergebnis _Fairwalter_  auf das **Plus-Symbol (+)** und wählen Sie im aufpoppenden Fenster den Button **Mit Fairwalter anmelden**

[Bild: ChatGPT-Dialog «Fairwalter zu ChatGPT hinzufügen» mit markierter Schaltfläche «Mit Fairwalter anmelden»]

**Schritt 3: Zugriff im Browser erlauben & verbinden**

-   Es öffnet sich automatisch das Autorisierungsfenster von Fairwalter.
-   Bestätigen Sie die Zugriffsrechte mit einem Klick auf den blauen Button **Erlauben**.
-   Sie werden automatisch zurück zu ChatGPT geleitet und die Verbindung ist aktiv.

[Bild: Fairwalter-Seite «ChatGPT möchte auf Fairwalter zugreifen» mit markiertem «Assistenten-Zugriff (MCP)» und «Erlauben»]

**Schritt 4: Daten in ChatGPT abfragen**

Starten Sie einen neuen Chat, klicken Sie im Eingabefeld auf das **Plus-Symbol (+)** und wählen Sie **Fairwalter** aus. ChatGPT greift bei Fragen nun automatisch auf Ihre Fairwalter-Daten zu und beantwortet komplexe Abfragen (z. B. überfällige Mietzinszahlungen oder Vertragslaufzeiten) \
[Bild: ChatGPT-Eingabefeld mit geöffnetem Plus-Menü und markiertem Eintrag «Fairwalter»]\
[Bild: ChatGPT beantwortet über das Fairwalter-Plugin eine Frage zur Mietdauer eines Mieters]