So behebst du Probleme mit der MCP-Verbindung
Was ein Fehler beim Verbinden oder Aufrufen von Athaus für Anbieter und Athaus Immobiliensuche bedeutet und was du dagegen tust.
Zuletzt aktualisiert:
Such das Zeichen, das du siehst. Die Verbindung gehört zu einem der zwei MCP-Server.
Anmeldung und Zugang
Die Anmeldung öffnet sich nicht oder startet immer wieder neu
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 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
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 einen neuen an.
Das Konto hat keinen Zugang zum Server
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). 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
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 (So wechselst du den Plan und bezahlst).
Rechte und Karten
Ein Werkzeug sagt, dass ein Recht fehlt
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). Welches Recht wofür gilt: MCP-Rechte.
Die Karte wartet, aber nichts ist hinausgegangen
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).
ChatGPT führt ein schreibendes Werkzeug nicht aus
Volles MCP mit Schreibaktionen gibt es laut OpenAI nur in Business, Enterprise und Edu (Installation). Nutze Claude oder erledige den Schritt in der App.
Drossel und Größe
Der Server antwortet mit 429
Mehr als 30 Aufrufe auf einmal, danach mehr als einer je Sekunde, je Konto; bei send_inquiry gelten weitere Grenzen (Grenzen). 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
413mitpayload_too_large: Der Rumpf war größer als 512 KB (Grenzen).403bei einem Aufruf aus dem Browser: Ein Aufruf mit dem KopfOrigineiner fremden Seite wird abgewiesen; Assistenten rufen ohne diesen Kopf.
Ein Abo von Events kommt nicht zustande
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). Beantworte die Bestätigung mit dem challenge und abonniere über OAuth statt mit einem Schlüssel.
Weiter
Die allgemeine Fehlerbehebung und die Fehlercodes.
Weiter lesen
MCP-Anmeldung: OAuth, Zustimmung und Schlüssel
OAuth 2.1 für Apps wie Claude und ChatGPT, ein Schlüssel für eigene Agenten. Jeder Aufruf verlangt eine Anmeldung, und die Zustimmung gilt je Server.
MCP-Rechte: was ein Agent darf
Je Server drei Rechte, unabhängig voneinander, und die Regel, wann ein Klick nötig ist. Im OAuth-Protokoll sind die Rechte die Scopes, unter demselben Namen.
MCP-Grenzen: Drossel und Größen
Wie viel die zwei MCP-Server auf einmal annehmen, wie groß ein Aufruf, eine Liste, ein Text oder eine Datei sein darf, und was kein Werkzeug ohne Klick tut.
Fehlerbehebung für die häufigsten Probleme
Anmeldung, Anfragen, Antworten, Inserate, MCP und Funktionen, die im Plan fehlen: Ursache und nächster Schritt bei jedem Problem.
Grenzen
Wie viel die zwei MCP-Server auf einmal annehmen, wie groß ein Aufruf, eine Liste, ein Text oder eine Datei sein darf, und was kein Werkzeug ohne Klick tut.
Überblick
Die REST-API liest und schreibt Inserate, Kontakte, Anfragen, Besichtigungen und Dateien deines Büros. Ein Key, ein Aufruf, JSON zurück.