Fehlercodes
MCP-Errors (Proxy)#
| Code | Bedeutung | Was tun |
|---|---|---|
-32003 | Von einer Policy geblockt (Deny-Regel oder Hold-Limit im Free-Plan) | 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 (Free-Plan) |
403 | Origin nicht auf der Allowlist (Widget-Token) |
404 | Unbekannte Referenz (oder fremde Organisation) |
409 | Konflikt — z. B. Aktion bereits entschieden oder doppelte Freigabe desselben Nutzers |
422 | Validierung fehlgeschlagen — detail nennt das erste betroffene Feld, issues listet alle |
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.