# So behebst du Probleme mit der MCP-Verbindung

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

> Was ein Fehler beim Verbinden oder Aufrufen von Athaus für Anbieter und Athaus Immobiliensuche bedeutet und was du dagegen tust.

Typ: Anleitung
Zuletzt aktualisiert: 2026-11-10

Such das Zeichen, das du siehst. Die Verbindung gehört zu einem der [zwei MCP-Server](/mcp).

## Anmeldung und Zugang [#anmeldung-und-zugang]

### Die Anmeldung öffnet sich nicht oder startet immer wieder neu [#anmeldung]

Ohne gültiges Token antwortet der Server mit `401` und `WWW-Authenticate`; das ist der normale Start. Melde dich bei Athaus an, stimme auf [app.athaus.ai/verbinden](https://app.athaus.ai/verbinden) zu und prüfe die Adresse: `https://anbieter.mcp.athaus.ai/mcp` für Anbieter, `https://suche.mcp.athaus.ai/mcp` für die Suche.

### Eine bestehende Verbindung gibt 401 mit `invalid_token` [#invalid-token]

Das Token gilt nicht mehr: abgelaufen (eine Stunde), vom anderen Server, die Verbindung ist getrennt oder ihr Grundrecht fehlt, der `ath_`-Schlüssel ist unbekannt oder widerrufen, oder ein Schlüssel wurde an Athaus Immobiliensuche benutzt (dort gibt es nur OAuth). Die Beschreibung im Fehler nennt den Grund. Entferne die Verbindung in deiner App und verbinde neu; für einen Schlüssel legst du in [Einstellungen, API-Keys](https://app.athaus.ai/einstellungen/api-keys) einen neuen an.

### Das Konto hat keinen Zugang zum Server [#produkt]

Athaus für Anbieter braucht ein Konto der Anbieterseite mit aktiver Mitgliedschaft in einem Büro, Athaus Immobiliensuche ein Konto der Suche. Sonst kommt `401` mit "Dieses Konto hat keinen Zugang zum Produkt dieses Servers ..."; auf den Wegen der API heißt der Code `seite_fehlt` (`403`, [Fehlercodes](/api/fehlercodes)). Melde dich mit dem Konto der richtigen Seite an und schließe seine Einrichtung ab; wer beides nutzt, verbindet jeden Server mit dem Konto seiner Seite.

### Der Plan enthält keine Verbindungen zu Assistenten [#plan]

Basic enthält weder Verbindungen zu Assistenten noch API-Schlüssel, Pro und Scale beliebig viele; ältere Verträge behalten sie. Athaus für Anbieter antwortet sonst mit `401` und "Verbindungen zu Assistenten und API-Schluessel gehoeren zum Tarif Pro oder Scale ..."; ein Schlüssel an einem anderen Weg der API bekommt `403` mit `tarif_zu_klein`. Wechsle den Plan unter [Abrechnung](https://app.athaus.ai/abrechnung) ([So wechselst du den Plan und bezahlst](/anleitungen/plan-und-bezahlung)).

## Rechte und Karten [#rechte-und-karten]

### Ein Werkzeug sagt, dass ein Recht fehlt [#recht]

Bei OAuth kommt `403` mit `insufficient_scope`, ChatGPT zeigt einen Werkzeugfehler "Dafür fehlt der Verbindung das Recht ...". Verbinde neu und schalte das Recht auf der Zustimmungsseite ein; das Recht an der Grenze (`freigeben`, `anfragen`) ist dort aus, bis du es einschaltest. Ein Schlüssel holt sich kein Recht nach: lege einen mit dem Recht an ([Schlüssel](/api/schluessel)). Welches Recht wofür gilt: [MCP-Rechte](/mcp/rechte).

### Die Karte wartet, aber nichts ist hinausgegangen [#klick]

Was hinausgeht, ersetzt oder löscht, wartet auf deinen Klick; eine Karte gilt 15 Minuten. Klicke, solange sie gilt, oder bitte den Assistenten, neu vorzubereiten. Zeigt sie **In Athaus freigeben**, fehlt der Verbindung das Recht an der Grenze: gib in der App frei. Steht die Art dort auf **Aus**, bereitet der Assistent nichts vor ([Freigabe-Stufen](/anleitungen/freigabe-stufen)).

### ChatGPT führt ein schreibendes Werkzeug nicht aus [#chatgpt]

Volles MCP mit Schreibaktionen gibt es laut OpenAI nur in Business, Enterprise und Edu ([Installation](/mcp/installation#chatgpt)). Nutze Claude oder erledige den Schritt in der App.

## Drossel und Größe [#drossel-und-größe]

### Der Server antwortet mit 429 [#drossel]

Mehr als 30 Aufrufe auf einmal, danach mehr als einer je Sekunde, je Konto; bei `send_inquiry` gelten weitere Grenzen ([Grenzen](/mcp/grenzen#anfragen-an-anbieter)). Warte so lange, wie `Retry-After` sagt, und ruf bei einem Abgleich alle 30 bis 60 Sekunden ab.

### Der Server antwortet mit 413 oder 403 ohne Recht-Hinweis [#groesse]

* **`413` mit `payload_too_large`:** Der Rumpf war größer als 512 KB ([Grenzen](/mcp/grenzen)).
* **`403` bei einem Aufruf aus dem Browser:** Ein Aufruf mit dem Kopf `Origin` einer fremden Seite wird abgewiesen; Assistenten rufen ohne diesen Kopf.

## Ein Abo von Events kommt nicht zustande [#events]

`events/subscribe` verlangt eine Verbindung über OAuth mit dem Recht des Ereignisses, eine `https`-Adresse mit öffentlicher IP ohne Umleitung und die Bestätigung innerhalb von 10 Sekunden; die Codes `-32012` bis `-32015` nennen den Grund ([Fehler](/mcp/ereignisse#fehler)). Beantworte die Bestätigung mit dem `challenge` und abonniere über OAuth statt mit einem Schlüssel.

## Weiter [#weiter]

Die allgemeine [Fehlerbehebung](/hilfe/fehlerbehebung) und die [Fehlercodes](/api/fehlercodes).
