Installation

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

Beim ersten Aufruf meldest du dich mit deinem Athaus-Konto an und bestätigst auf 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.

Claude (Web und Desktop)Link zu diesem Abschnitt kopieren

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 CodeLink zu diesem Abschnitt kopieren

claude mcp add --transport http athaus-makler https://anbieter.mcp.athaus.ai/mcp

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.

CursorLink zu diesem Abschnitt kopieren

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:

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

VS CodeLink zu diesem Abschnitt kopieren

Oder in .vscode/mcp.json im Projekt:

{
  "servers": {
    "athaus-makler": {
      "type": "http",
      "url": "https://anbieter.mcp.athaus.ai/mcp"
    },
    "athaus-suche": {
      "type": "http",
      "url": "https://suche.mcp.athaus.ai/mcp"
    }
  }
}

ChatGPTLink zu diesem Abschnitt kopieren

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.

ChatGPT ist bisher der einzige Client, der MCP Events abonniert.

Ein eigener AgentLink zu diesem Abschnitt kopieren

Ohne Browser meldet sich ein Agent mit einem API-Schlüssel 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 an und schickst ihn bei jedem Aufruf mit:

Authorization: Bearer ath_...

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

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 hastLink zu diesem Abschnitt kopieren

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.