Wenn der Assistent keine Verbindung bekommt oder ein Werkzeug scheitert
Fehler beim Verbinden, Fehler der Werkzeuge und die Grenzen für Ergebnisse und Laufzeit.
- Für wen
- Alle, deren Assistent Szenera nicht erreicht oder einen Fehler aus einem Werkzeug meldet
- Voraussetzung
- keine
Auf dieser Seite
Fehler beim Verbinden zeigen sich, bevor ein Gespräch beginnt, Fehler eines Werkzeugs mittendrin. Diese Seite nennt beide nach dem, was Sie sehen, und die Grenzen, die der Server für Ergebnisse und Laufzeit setzt.
Die Verbindung scheitert
Der Server prüft Ihren Ausweis zu Beginn einer Sitzung und bei jeder weiteren Anfrage gegen die Plattform. Die Kennung der Sitzung allein öffnet nichts.
| Was Sie sehen | Bedeutung | Lösung |
|---|---|---|
401 mit error="invalid_request" |
Die Anfrage trägt keinen Ausweis. | Über OAuth anmelden oder Authorization: Bearer ak_… mitschicken. |
401 mit error="invalid_token" |
Die Plattform hat den Ausweis abgelehnt: abgelaufen, widerrufen oder vertippt. | Neu anmelden oder einen gültigen Schlüssel verwenden. Ein Zugriffstoken oat_… gilt eine Stunde. |
404 mit {"error": "no_session"} |
Die Sitzung ist abgelaufen. Sie lebt 24 Stunden, und jeder Aufruf verlängert sie. | Nichts zu tun: Der Client beginnt von selbst eine neue Sitzung. Tut er es nicht, neu verbinden. |
400 mit {"error": "no_session_id"} |
Die Kopfzeile Mcp-Session-Id fehlt oder ist falsch geformt. |
Einen Client verwenden, der der MCP-Spezifikation folgt. |
| Die Anmeldung scheitert sofort | Der Client hat die Rechte (scope), die der Server nennt, nicht weitergereicht, und der Autorisierungsserver weist eine Anfrage ohne sie ab. |
Den Client aktualisieren. Die Rechte stehen in der Ressourcen-Beschreibung und in der Antwort 401. |
Eine Antwort 401 trägt immer die Kopfzeile WWW-Authenticate mit der Adresse der Ressourcen-Beschreibung, damit ein Client, der OAuth kann, weiß, wo er sich anmeldet.
Ein Werkzeug scheitert
Ein gescheitertes Werkzeug antwortet mit drei Feldern: error, hint (ein Satz auf Englisch) und correlationId, mit der das Betriebsteam den Aufruf wiederfindet.
error |
Bedeutung | Lösung |
|---|---|---|
unauthenticated |
Die Plattform hat den Ausweis abgelehnt (401). |
Neu anmelden. |
permission_denied |
Dem Ausweis fehlt das Recht (403). Der Hinweis nennt den Bereich. |
Den Bereich neu erlauben oder einen Schlüssel mit dem Recht verwenden, siehe Rechte und Einwilligung. |
not_found |
Zu dieser Kennung gibt es in Ihrer Organisation nichts (404). |
Die Kennung aus einer Liste nehmen, die mit demselben Ausweis geholt wurde. |
conflict |
Der Gegenstand hat sich seit dem Lesen geändert (409). |
Neu lesen und neu entscheiden. |
invalid_input |
Die Plattform hat die Werte abgelehnt (422). |
Die Werte prüfen. Feldpfade aus der Antwort der Plattform bleiben erhalten. |
no_seat_available |
Alle gebuchten Plätze Ihrer Organisation sind belegt (402). |
Im Portal einen Platz dazubuchen oder ein Display löschen, das Sie nicht mehr brauchen. |
rate_limited |
Das Kontingent an Aufrufen ist erschöpft (429). |
Warten und erneut versuchen, siehe Drosselung und Rate-Limit-Kopfzeilen. |
platform_unreachable |
Die API antwortet nicht. | Später erneut versuchen. Ohne sie kann der Server nichts. |
timeout |
Die Zeit für den Aufruf ist abgelaufen. | Enger fragen, etwa mit einem Filter oder einer kürzeren Liste. |
canceled |
Der Aufruf wurde abgebrochen, etwa weil die Verbindung abriss. | Erneut aufrufen. |
unexpected |
Die Plattform hat so geantwortet, dass der Server es nicht einordnen kann. | Später erneut versuchen und die correlationId an den Support geben. |
Ein schreibendes Werkzeug tut nichts
Das ist die Vorschau. Ohne confirm: true liest ein schreibendes Werkzeug den Ist-Zustand und antwortet mit "status": "preview" und "executed": false. Der Assistent zeigt Ihnen die Wirkung und ruft das Werkzeug mit denselben Werten und confirm: true erneut auf. Erst dann antwortet es mit "status": "executed".
Grenzen
| Grenze | Vorgabe |
|---|---|
| Laufzeit eines Werkzeug-Aufrufs | 30 Sekunden |
| Laufzeit eines einzelnen Aufrufs an die API | 15 Sekunden |
| Länge eines Ergebnisses | 20.000 Zeichen, darüber sichtbar gekürzt |
| Einträge einer Liste | 50 je Antwort, was zugleich die angeforderte Seitengröße deckelt |
| Ruhende Sitzung | 24 Stunden, jeder Aufruf verlängert sie |
Der Betreiber Ihrer Umgebung kann diese Werte anders setzen.
Weiterführendes
War das hilfreich?