KI-Apps (MCP)
Fehler & Limits
Wie ein fehlgeschlagenes Tool aussieht, was jeder Verbindungsfehler bedeutet und innerhalb welcher Limits jede KI-App arbeitet.
Tool-Fehler
Wenn ein Befehl fehlschlägt (Domain nicht gefunden, keine Credits, ungültige Adresse…), liefert das Tool ein normales Ergebnis mit isError: true. Der Text lautet CODE: message, mit denselben Codes wie die API, damit die App die Argumente korrigieren und es erneut versuchen kann.
{
"content": [{ "type": "text", "text": "DOMAIN_NOT_FOUND: Domain not found or does not belong to this account." }],
"structuredContent": { "code": "DOMAIN_NOT_FOUND", "message": "Domain not found or does not belong to this account." },
"isError": true
}Verbindungsfehler
| Status | Code | Was zu tun ist |
|---|---|---|
| 401 | MISSING_AUTH_HEADER | Kein Token. OAuth-Apps starten hier die Anmeldung; mit einem Key senden Sie Authorization: Bearer. |
| 401 | INVALID_TOKEN | Das Access Token ist abgelaufen oder wurde widerrufen. Die App erneuert es selbst oder bittet Sie, sich erneut zu verbinden. |
| 401 | INVALID_API_KEY | Der Key ist falsch, gelöscht oder abgelaufen. Erstellen Sie einen neuen. |
| 401 | WRONG_CREDENTIAL_TYPE | Ein Postfach-Token auf dem Konto-Server (oder umgekehrt). Verwenden Sie die richtige URL. |
| 403 | ACCOUNT_BLOCKED | Das Konto ist gesperrt. Wenden Sie sich an den Support. |
| 403 | IP_NOT_ALLOWED | Der Key ist auf andere IPs beschränkt. Fügen Sie die IP hinzu oder nutzen Sie OAuth. |
| 429 | RATE_LIMITED | Zu viele Requests auf einmal. Warten Sie die Retry-After-Sekunden ab und versuchen Sie es erneut. |
Limits
Dieselben Rate Limits wie die API
Jede Verbindung zählt gegen dieselben Limits pro Key oder pro Postfach wie Ihre API-Aufrufe.
1 MB pro Aufruf
Argumente sind auf 1 MB pro Aufruf begrenzt, daher müssen über eine KI-App gesendete Anhänge klein sein.
Credits und Tageslimit
Jede gesendete E-Mail verbraucht Ihre Credits (einen pro Empfänger) und zählt zu Ihrem Tageslimit.
Bestätigung vor dem Handeln
Tools, die E-Mails senden oder Daten löschen, sind als destruktiv markiert, daher fragt die App Sie, bevor sie sie ausführt.
Der E-Mail-Versand folgt denselben Regeln wie die Send-Email-API. Zurück zur MCP-Übersicht.