Schnellstart: REST-API lesen und MCP-Server verbinden
Die REST-API, die zwei MCP-Server und ein eigener Schlüssel.
Zuletzt aktualisiert:
| REST-API | Athaus für Anbieter | Athaus Immobiliensuche | |
|---|---|---|---|
| Adresse | https://api.athaus.ai/v1 | https://anbieter.mcp.athaus.ai/mcp | https://suche.mcp.athaus.ai/mcp |
| Für | Systeme, die Inserate, Kontakte und Anfragen eines Büros lesen und schreiben | Agenten, die für ein Büro arbeiten | Agenten, die für einen Suchenden arbeiten |
| Anmeldung | ein ath_live_-Schlüssel | OAuth 2.1 oder ein ath_-Schlüssel | OAuth 2.1 |
| Beschrieben in | Referenz | Werkzeuge | Werkzeuge |
Die Inserate deines Büros lesen
curl "https://api.athaus.ai/v1/listings?limit=5" \
-H "Authorization: Bearer ath_live_..."Die Antwort ist eine Seite (externalListingIds, nextPageToken, siehe Blättern); ein Inserat holt GET /v1/listings/{externalListingId} (Inserate). Den Schlüssel legst du unter Einstellungen, API-Keys an, alle Wege stehen in der Referenz.
Einen MCP-Server verbinden
Mit Claude Code ist es eine Zeile je Server; die Anmeldung läuft danach im Browser:
claude mcp add --transport http athaus-makler https://anbieter.mcp.athaus.ai/mcpclaude mcp add --transport http athaus-suche https://suche.mcp.athaus.ai/mcpFür Claude, ChatGPT, Cursor und VS Code siehe Installation, dazu Beispiel-Prompts und Fehlerbehebung.
Ein eigener Agent mit Schlüssel
Ohne Browser legst du unter Einstellungen, API-Keys einen Schlüssel an (Pläne Pro und Scale) und schickst ihn als Bearer mit. Er gilt nur bei Athaus für Anbieter:
claude mcp add --transport http athaus-makler https://anbieter.mcp.athaus.ai/mcp \
--header "Authorization: Bearer ath_..."Ein neuer Schlüssel darf nur lesen (Schlüssel, Rechte).
Diese Doku für Agenten
/llms.txt ist das Inhaltsverzeichnis, /llms-full.txt die ganze deutsche Doku. Jede Seite gibt es als Markdown (Adresse mit .md dahinter). Der Doku-MCP-Server liegt unter https://docs.athaus.ai/api/mcp, ohne Anmeldung.
Weiter lesen
REST-API: der erste Aufruf
Die REST-API liest und schreibt Inserate, Kontakte, Anfragen, Besichtigungen und Dateien deines Büros. Ein Key, ein Aufruf, JSON zurück.
Beispiel-Prompts für die MCP-Server
Fertige Sätze für Claude und ChatGPT, mit dem Werkzeug, das Athaus dafür ruft, und dem Klick, den du danach machst.
MCP-Server installieren: Claude, ChatGPT, Cursor, VS Code
Die zwei MCP-Server von Athaus in Claude, Claude Code, Cursor, VS Code, ChatGPT und einem eigenen Agenten.
API-Key anlegen und Scopes wählen
Ein API-Key für die REST-API, eigene Agenten und Dienste, mit genau den Scopes, die du ihm gibst.