Fehlercodes
MCP-Errors (Proxy)#
| Code | Bedeutung | Was tun |
|---|---|---|
-32003 | Von einer Policy geblockt (Deny-Regel; im Alt-Free-Plan auch Hold-Limit) | Die Message nennt die Regel. Regeln anpassen oder Plan upgraden. |
-32603 | Decision Engine im Enforce-Mode nicht erreichbar | Fail-closed by design. /readyz prüfen und erneut versuchen. |
HTTP-Statuscodes (Core-API)#
| Status | Bedeutung |
|---|---|
400 | Body ist kein gültiges JSON (invalid_json) |
401 | API-Key fehlt, unbekannt oder widerrufen |
402 | Monatliches Hold-Limit erreicht (nur Alt-Free-Plan; entfällt mit Pricing v2) |
403 | Origin nicht auf der Allowlist (Widget-Token) |
404 | Unbekannte Referenz (oder fremder Arbeitsbereich) |
409 | Konflikt - z. B. Aktion bereits entschieden oder doppelte Freigabe desselben Nutzers |
422 | Validierung fehlgeschlagen - detail nennt das erste betroffene Feld, issues listet alle |
429 | Rate Limit erschöpft (rate_limited) - Retry-After und die RateLimit-*-Header nennen die Wartezeit; siehe Rate Limits |
500 | Interner Fehler; die Antwort enthält eine referenceId für den Support |
Das Fehlerformat (inkl. issues[] bei Validierungsfehlern) ist unter Grundlagen & Auth beschrieben. Antworten enthalten nie Call-Payloads.
Häufige Fragen#
Warum wurde mein Call gehalten, obwohl Allow gesetzt ist? Die Tool-Definition hat sich upstream geändert (Zustand geändert) - im Rule Builder neu klassifizieren. Der Rug-Pull-Schutz ist Absicht.
Darf ich Fehlermeldungen loggen? Ja. Antworten enthalten nie Call-Payloads, nur Codes und Referenz-IDs.
Gibt es Rate Limits? Derzeit keine festen Request-Limits - Details unter Grundlagen & Auth.