# Schnellstart: REST-API lesen und MCP-Server verbinden

Adresse: https://docs.athaus.ai/schnellstart/entwickler

> Die REST-API, die zwei MCP-Server und ein eigener Schlüssel.

Typ: Schnellstart
Zuletzt aktualisiert: 2026-11-12

|                | 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](/api/v1/referenz)                                                 | [Werkzeuge](/mcp/werkzeuge/anbieter) | [Werkzeuge](/mcp/werkzeuge/suche)         |

## Die Inserate deines Büros lesen [#die-inserate-deines-büros-lesen]

```bash
curl "https://api.athaus.ai/v1/listings?limit=5" \
  -H "Authorization: Bearer ath_live_..."
```

Die Antwort ist eine Seite (`externalListingIds`, `nextPageToken`, siehe [Blättern](/api/v1/blaettern)); ein Inserat holt `GET /v1/listings/{externalListingId}` ([Inserate](/api/v1/inserate)). Den Schlüssel legst du unter [Einstellungen, API-Keys](https://app.athaus.ai/einstellungen/api-keys) an, alle Wege stehen in der [Referenz](/api/v1/referenz).

## Einen MCP-Server verbinden [#einen-mcp-server-verbinden]

Mit Claude Code ist es eine Zeile je Server; die Anmeldung läuft danach im Browser:

```bash title="Athaus für Anbieter"
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
```

Für Claude, ChatGPT, Cursor und VS Code siehe [Installation](/mcp/installation), dazu [Beispiel-Prompts](/mcp/beispiele) und [Fehlerbehebung](/mcp/fehlerbehebung).

## Ein eigener Agent mit Schlüssel [#ein-eigener-agent-mit-schlüssel]

Ohne Browser legst du unter [Einstellungen, API-Keys](https://app.athaus.ai/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:

```bash
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](/api/schluessel), [Rechte](/mcp/rechte)).

## Diese Doku für Agenten [#diese-doku-für-agenten]

[/llms.txt](/llms.txt) ist das Inhaltsverzeichnis, [/llms-full.txt](/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.
