Fehler
MCP-Fehler
Anfragen mit einem ungültigen Schlüssel werden abgelehnt, bevor eine MCP-Verarbeitung stattfindet. Alle anderen Fehler werden als Tool-Ergebnisse mit Fehlerkennzeichnung zurückgegeben, damit dein Assistent sie lesen und erklären kann, wie das Problem zu beheben ist.
Vor der Verbindung
Dies sind HTTP-Antworten. Dein Client meldet sie als fehlgeschlagene Verbindung.
| Status | Wann |
|---|---|
401 | Es wurde kein Schlüssel gesendet, oder der Wert hat nicht die Form eines GunSpec-Schlüssels. |
404 | Die Anfrage ging nicht an den Endpunkt-Pfad. |
In einem Tool-Ergebnis
Der von der API genannte Grund, seine Bedeutung und die empfohlene Maßnahme. Bei einer Ablehnung erhält das Modell die Meldung der API. Bei einem serverseitigen Fehler erhält das Modell statt interner Details eine kurze Meldung mit Request-ID.
| Grund | Bedeutung | Was zu tun ist | Das Modell sieht |
|---|---|---|---|
KEY_INVALID 401 | The API key is not one we issued, or it has been deleted. | Check the key for a typo, or create a new one in your account. | Die Ablehnung |
KEY_DISABLED 401 | The key was switched off by the account that owns it. | Re-enable it in your account, or use another key. | Die Ablehnung |
KEY_EXPIRED 401 | The key has passed its expiry date. | Create a new key in your account. | Die Ablehnung |
ACCOUNT_SUSPENDED 403 | The account behind this credential has been suspended. | Contact support. Rotating the key will not help. | Die Ablehnung |
PLAN_REQUIRED 403 | The credential is valid and its plan is below what this endpoint needs. details.requiredTier names the plan. | Upgrade the plan. A new key on the same plan will get the same answer. | Die Ablehnung |
PAGINATION_DEPTH_EXCEEDED 403 | The plan does not page this deep into a list. | Narrow the list with filters, or upgrade for deeper paging. | Die Ablehnung |
INVALID_PARAMETER 400 | A path, query or body field failed validation. details names each field and what was wrong with it. | Correct the named fields and send the request again. | Die Ablehnung |
RESOURCE_NOT_FOUND 404 | The path is right and no record has that id. | Check the id. The list and search endpoints return valid ones. | Die Ablehnung |
RATE_LIMITED 429 | Too many requests this minute for the plan. | Wait for Retry-After seconds, then retry. | Die Ablehnung |
DAILY_CAP_EXCEEDED 429 | The plan's daily request allowance is used up. It resets at midnight UTC. | Wait for the reset, or upgrade for a larger allowance. | Die Ablehnung |
MCP_DAILY_CAP_EXCEEDED 429 | The plan's daily allowance for calls through the MCP server is used up. It resets at midnight UTC; direct API requests still count against the plan's own allowance. | Wait for the reset, call the API directly, or upgrade for a larger MCP allowance. | Die Ablehnung |
PAGINATION_BURST 429 | Too many sequential pages in a short time. | Slow the walk down, or use a larger per_page. | Die Ablehnung |
INTERNAL_ERROR 500 | Something failed on our side. It has been logged against request_id. | Retry with backoff. Quote request_id if it persists. | Einen Hinweis zum erneuten Versuch mit Request-ID |
DEPENDENCY_UNAVAILABLE 503 | A service this endpoint depends on is temporarily unavailable. | Retry after a short wait. | Einen Hinweis zum erneuten Versuch mit Request-ID |
MAINTENANCE 503 | The API is paused for maintenance. | Wait for Retry-After seconds, then retry. | Einen Hinweis zum erneuten Versuch mit Request-ID |