Fehler
API und MCP-Server melden Fehler mit denselben Codes. Der Code ist für Ihr Programm, die Nachricht für Menschen.
{
"error": {
"code": "blocked_host",
"message": "Interne oder private Adressen werden nicht geprüft."
}
}Die Nachricht ist auf Deutsch geschrieben und kann sich ändern. Der Code bleibt gleich. Welcher HTTP-Status zu welchem Code gehört, steht in der Tabelle.
Der MCP-Server antwortet bei einem fehlgeschlagenen Check mit einem Tool-Ergebnis, in dem isError auf true steht. Der Text beginnt mit dem Code, danach folgt die Nachricht, etwa timeout: Die Seite hat nicht rechtzeitig geantwortet. Der Endpunkt der Startseite GET /api/scan schickt Code und Nachricht als zwei einfache Felder, also { "error": "timeout", "message": "…" }. Mehr dazu in der API-Referenz.
| Code | Status | Bedeutung | Neuer Versuch |
|---|---|---|---|
no_url | 400 | Bitte eine URL angeben. | Nein |
bad_url | 400 | Das ist keine gültige Adresse. | Nein |
bad_scheme | 400 | Nur http:// und https:// werden unterstützt. | Nein |
blocked_host | 400 | Interne oder private Adressen werden nicht geprüft. | Nein |
dns_failed | 400 | Die Adresse konnte nicht aufgelöst werden. | Erst wenn der DNS-Eintrag steht |
unauthorized | 401 | API-Schlüssel fehlt oder ist ungültig. | Nein |
rate_limited | 429 | Zu viele Anfragen. Bitte kurz warten. | Ja, nach X-RateLimit-Reset |
server_error | 500 | Unerwarteter Fehler. | Ja, einmal |
fetch_failed | 502 | Die Seite war nicht erreichbar. | Ja, nach kurzer Pause |
tls_invalid | 502 | Das HTTPS-Zertifikat der Seite ist ungültig. Browser zeigen eine Warnung. | Erst wenn das Zertifikat gültig ist |
too_many_redirects | 502 | Zu viele Weiterleitungen. | Nein |
not_configured | 503 | Diese Funktion ist noch nicht eingerichtet. | Nein |
timeout | 504 | Die Seite hat nicht rechtzeitig geantwortet. | Ja, nach kurzer Pause |
Fehler mit Status 400 liegen an der Eingabe. Ein neuer Versuch mit derselben Adresse bringt meist dasselbe Ergebnis. Fehler ab 502 liegen meist an der geprüften Seite oder am Netz. Dann hilft oft ein zweiter Versuch nach ein paar Sekunden. Bei tls_invalid liegt der Fehler bei der geprüften Seite. Browser zeigen dort ebenfalls eine Warnung. Wie man das behebt, steht im Hilfe-Artikel HTTPS und Zertifikat.