# Installation

Adresse: https://docs.athaus.ai/mcp/installation

> Die zwei MCP-Server von Athaus in Claude, Claude Code, Cursor, VS Code, ChatGPT und einem eigenen Agenten.

Es gibt zwei Server, und du trägst den ein, der zu dir passt, oder beide:

| Server                 | Für wen                                         | Adresse                              |
| ---------------------- | ----------------------------------------------- | ------------------------------------ |
| Athaus für Makler      | Makler und alle, die bei Athaus anbieten        | `https://anbieter.mcp.athaus.ai/mcp` |
| Athaus Immobiliensuche | Menschen, die eine Wohnung oder ein Haus suchen | `https://suche.mcp.athaus.ai/mcp`    |

Beim ersten Aufruf meldest du dich mit deinem Athaus-Konto an und bestätigst auf [app.athaus.ai/verbinden](https://app.athaus.ai/verbinden), was die App darf. Welcher Server es ist, folgt aus der Adresse; eine Seite wählst du dort nicht. Wie es genau läuft, steht unter [Anmeldung](/mcp/anmeldung).

## Claude (Web und Desktop) [#claude-web-und-desktop]

- [In Claude hinzufügen: Athaus für Makler](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Athaus%20f%C3%BCr%20Makler&connectorUrl=https%3A%2F%2Fanbieter.mcp.athaus.ai%2Fmcp)
- [In Claude hinzufügen: Athaus Immobiliensuche](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Athaus%20Immobiliensuche&connectorUrl=https%3A%2F%2Fsuche.mcp.athaus.ai%2Fmcp)

Ein Knopf je Server. Er öffnet in claude.ai den Dialog für einen eigenen Connector, Name und Adresse sind ausgefüllt. Von Hand:

1. In Claude **Customize > Connectors** öffnen, dann **Add custom connector**.
2. Name und Adresse eintragen: `Athaus für Makler` mit `https://anbieter.mcp.athaus.ai/mcp`, oder `Athaus Immobiliensuche` mit `https://suche.mcp.athaus.ai/mcp`.
3. Die erkannte Anmeldung (OAuth) so lassen und **Add** wählen, dann **Connect**.
4. Im Chat über **+ > Connectors** einschalten.

In Team und Enterprise legt ein Owner den Connector unter **Organization settings > Connectors** an; danach verbindet sich jedes Mitglied selbst. Ein Connector, der in claude.ai angelegt ist, steht auch in Claude Desktop und den Apps bereit.

## Claude Code [#claude-code]

```bash title="Athaus für Makler"
claude mcp add --transport http athaus-makler https://anbieter.mcp.athaus.ai/mcp
```

```bash title="Athaus Immobiliensuche"
claude mcp add --transport http athaus-suche https://suche.mcp.athaus.ai/mcp
```

Danach in Claude Code `/mcp` aufrufen und die Anmeldung im Browser abschließen.

## Cursor [#cursor]

- [In Cursor installieren: Athaus für Makler](cursor://anysphere.cursor-deeplink/mcp/install?name=athaus-makler&config=eyJ1cmwiOiJodHRwczovL2FuYmlldGVyLm1jcC5hdGhhdXMuYWkvbWNwIn0=)
- [In Cursor installieren: Athaus Immobiliensuche](cursor://anysphere.cursor-deeplink/mcp/install?name=athaus-suche&config=eyJ1cmwiOiJodHRwczovL3N1Y2hlLm1jcC5hdGhhdXMuYWkvbWNwIn0=)

Der Knopf öffnet Cursor mit dem Eintrag zur Bestätigung. Von Hand in `~/.cursor/mcp.json` (oder `.cursor/mcp.json` im Projekt); wer nur einen Server braucht, lässt den anderen Eintrag weg:

```json title="mcp.json"
{
  "mcpServers": {
    "athaus-makler": {
      "url": "https://anbieter.mcp.athaus.ai/mcp"
    },
    "athaus-suche": {
      "url": "https://suche.mcp.athaus.ai/mcp"
    }
  }
}
```

## VS Code [#vs-code]

- [In VS Code installieren: Athaus für Makler](vscode:mcp/install?%7B%22name%22%3A%22athaus-makler%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fanbieter.mcp.athaus.ai%2Fmcp%22%7D)
- [In VS Code installieren: Athaus Immobiliensuche](vscode:mcp/install?%7B%22name%22%3A%22athaus-suche%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fsuche.mcp.athaus.ai%2Fmcp%22%7D)

Oder in `.vscode/mcp.json` im Projekt:

```json title=".vscode/mcp.json"
{
  "servers": {
    "athaus-makler": {
      "type": "http",
      "url": "https://anbieter.mcp.athaus.ai/mcp"
    },
    "athaus-suche": {
      "type": "http",
      "url": "https://suche.mcp.athaus.ai/mcp"
    }
  }
}
```

## ChatGPT [#chatgpt]

In ChatGPT heißt ein eigener MCP-Server eine App, und er läuft über den Developer Mode im Web. Jeder der zwei Server ist eine eigene App.

1. Developer Mode einschalten. Je nach Stand von ChatGPT liegt der Schalter unter **Settings > Apps > Advanced settings** oder unter **Settings > Security and login**.
2. Eine App anlegen (**Create app** oder **Create MCP App**), Anmeldung **OAuth**: Name `Athaus für Makler` mit der Adresse `https://anbieter.mcp.athaus.ai/mcp`, oder `Athaus Immobiliensuche` mit `https://suche.mcp.athaus.ai/mcp`.
3. Mit deinem Athaus-Konto anmelden und zustimmen.
4. Im Chat über **+ > Developer mode** die App für das Gespräch wählen.

<Callout type="warn" title="Schreibende Werkzeuge in ChatGPT">
  Volles MCP mit Schreibaktionen gibt es laut OpenAI nur in **Business, Enterprise und Edu**, dort schaltet ein Admin den Developer Mode frei. In Plus und Pro kann ChatGPT lesende Werkzeuge nutzen; ob ein schreibendes wie `send_inquiry` läuft, ist dort nicht zugesagt. Free hat keinen Developer Mode. Vor jeder Schreibaktion fragt ChatGPT nach.
</Callout>

ChatGPT ist bisher der einzige Client, der [MCP Events](/mcp/ereignisse) abonniert.

## Ein eigener Agent [#ein-eigener-agent]

Ohne Browser meldet sich ein Agent mit einem [API-Schlüssel](/api/schluessel) an. Ein Schlüssel gilt nur bei **Athaus für Makler**; für die Suche gibt es nur die Anmeldung über OAuth. Den Schlüssel legst du unter [Einstellungen, API-Schlüssel](https://app.athaus.ai/einstellungen/zugang) an und schickst ihn bei jedem Aufruf mit:

```http
Authorization: Bearer ath_...
```

Jede MCP-Bibliothek, die Streamable HTTP spricht, kann das; in Claude Code etwa:

```bash
claude mcp add --transport http athaus-makler https://anbieter.mcp.athaus.ai/mcp \
  --header "Authorization: Bearer ath_..."
```

Ein Schlüssel sieht in `tools/list` nur die Werkzeuge, die er nach seinen Rechten aufrufen darf. MCP Events abonniert nur eine Verbindung über OAuth, kein Schlüssel.

## Wenn du die alte Adresse eingetragen hast [#wenn-du-die-alte-adresse-eingetragen-hast]

`https://api.athaus.ai/mcp` antwortet mit `410` und nennt die zwei neuen Adressen. Entferne den alten Eintrag, trag die passende neue Adresse ein und verbinde neu.
