Fehlerbehandlung in MCP: Robuste Tool-Workflows gestalten
MCP-Workflows so gestalten, dass Fehler abgefangen werden. Diese Anleitung erklärt häufige Fehlerkategorien (Authentifizierung, Validierung, Netzwerk, Rate Limits) und zeigt, wie Sie Prompts mit wiederverwendbaren Recovery-Vorlagen designen.
Fehlerkategorien
Authentifizierungsfehler (401, 403)
Auth-Fehler-Wiederherstellung
"Bei 401- oder 403-Fehler beim Aufruf von Corcava-Tools: 1. Mich informieren, dass ein Authentifizierungsproblem vorliegt 2. Prüfung des API-Keys in der Konfiguration vorschlagen 3. Den Vorgang nicht automatisch wiederholen 4. Warten, bis ich das Auth-Problem behoben habe"
Häufige Ursachen:
- Ungültiger oder abgelaufener API-Key
- Fehlender Authorization-Header
- Unzureichende Berechtigungen
Validierungsfehler (400)
Validierungsfehler-Wiederherstellung
"Bei Validierungsfehler (400) beim Aufruf von Corcava-Tools: 1. Fehlermeldung klar anzeigen 2. Angeben, welches Feld ungültig ist 3. Das korrekte Format vorschlagen 4. Fragen, ob ich mit korrigierten Daten erneut versuchen will"
Häufige Ursachen:
- Fehlende Pflichtfelder
- Ungültiges Feldformat (Daten, IDs)
- Ungültige Feldwerte
Netzwerkfehler
Netzwerkfehler-Wiederherstellung
"Bei Netzwerkfehler (Verbindung fehlgeschlagen, Timeout) beim Aufruf von Corcava-Tools: 1. Mich informieren, dass ein Netzwerkproblem vorliegt 2. Kurz warten, dann einmal wiederholen 3. Schlägt der erneute Versuch fehl: Netzwerkverbindung prüfen vorschlagen 4. Nicht mehr als einmal automatisch wiederholen"
Häufige Ursachen:
- Netzwerkverbindungsprobleme
- Server-Timeout
- DNS-Auflösungsprobleme
Rate Limiting (429)
Rate-Limit-Wiederherstellung
"Wenn beim Aufruf der Corcava-Tools ein 429-Rate-Limit-Fehler auftritt: 1. Mich informieren, dass die Anfrage gedrosselt wurde 2. Einige Sekunden warten, bevor erneut versucht wird 3. Die Anzahl der Tool-Aufrufe verringern (Stapeloperationen) 4. Bei weiterer Drosselung vorschlagen, die Operation in kleinere Schritte aufzuteilen"
Häufige Ursachen:
- Zu viele Anfragen in kurzer Zeit
- Große Stapeloperationen
- Tool-Aufruf-Schleifen
Recovery-Prompt-Vorlagen
Vorlage 1: Sanftes Scheitern
Fehlerbehandlungs-Muster
"Beim Aufruf von Corcava-Tools bei Fehlern: 1. Fehlermeldung klar anzeigen 2. In einfacher Sprache erklären, was der Fehler bedeutet 3. Vorschlag zur Behebung machen 4. Fragen, ob ich erneut versuchen oder einen anderen Ansatz wählen will 5. Nicht automatisch mehr als einmal wiederholen"
Dieses Muster: Fängt Fehler ab, gibt Anleitung, fragt nach Vorgehen
Vorlage 2: Retry mit Backoff
Retry-Muster
"Schlägt ein Tool-Aufruf mit Netzwerkfehler oder Timeout fehl: 1. 2 Sekunden warten 2. Den Vorgang einmal wiederholen 3. Schlägt es erneut fehl: mich informieren und Netzwerk prüfen vorschlagen 4. Nicht mehr als einmal wiederholen"
Dieses Muster: Behandelt temporäre Fehler, verhindert Endlosschleifen
Vorlage 3: Fallback-Strategie
Fallback-Muster
"Schlägt das Auflisten aller Aufgaben fehl: 1. Stattdessen Aufgaben eines bestimmten Projekts auflisten 2. Wenn das funktioniert, diese Aufgaben anzeigen 3. Mitteilen, dass bei Bedarf weitere Projekte einbezogen werden können 4. Darauf hinweisen, dass das Problem bei der Gesamtlisten-Abfrage liegen könnte"
Dieses Muster: Nutzt Alternativen, wenn die Hauptmethode scheitert
Vollständige Beispiele
Beispiel 1: Robuste Aufgabenliste
Fehlerrobuster Prompt
"Liste meine diese Woche fälligen Aufgaben aus Corcava. Wenn Fehler auftreten: - Bei Auth-Fehlern (401/403): mich bitten, den API-Key zu prüfen, nicht automatisch wiederholen - Bei Netzwerkfehlern: 2 Sekunden warten und einmal wiederholen - Bei Rate Limits (429): 5 Sekunden warten und einmal wiederholen - Bei Validierungsfehlern (400): Fehler anzeigen und Korrektur anfragen - Wenn alle Wiederholungsversuche fehlschlagen, Fehler beschreiben und nächste Schritte vorschlagen"
Dieses Muster: Behandelt alle Fehlertypen mit passender Wiederherstellung
Beispiel 2: Sichere Stapeloperation
Fehlerrobustes Stapel-Update
"5 Aufgaben auf Status 'in_progress' setzen. Wenn ein Update fehlschlägt: - Anzeigen, welche Aufgaben erfolgreich waren und welche nicht - Bei fehlgeschlagenen Aufgaben die Fehlermeldung anzeigen - Fragen, ob fehlgeschlagene wiederholt werden sollen - Nicht automatisch wiederholen – auf meine Entscheidung warten"
Dieses Muster: Teilweise Erfolge sichtbar, nutzergesteuerte Wiederholungen
Bewährte Praktiken
Fehlerbehandlung – Best Practices
- Fehler klar anzeigen: Fehlermeldungen immer dem Nutzer anzeigen
- Verständlich erklären: Technische Fehler in verständliche Begriffe übersetzen
- Lösungen vorschlagen: Konkrete Schritte zur Behebung nennen
- Wiederholungen begrenzen: Nicht endlos wiederholen – sinnvolle Limits setzen
- Teilerfolge behandeln: Bei Stapeloperationen anzeigen, was geklappt/fehlgeschlagen ist
- Vor erneutem Versuch fragen: Bei kritischen Aktionen vor Retry um Erlaubnis bitten
Weitere Ressourcen
Fehlerbehebungs-Übersicht
Vollständige Anleitung zur Fehlerbehebung
Fehlgeschlagene Tool-Aufrufe
Tool-Aufruf-Probleme debuggen
Ratenlimit (429)
Ratenlimits handhaben
Batching-Anleitung
Tool-Aufrufe reduzieren
Robuste MCP-Workflows aufbauen
Fehlerbehandlungs-Muster nutzen, um robuste Prompts zu erstellen, die sich sauber erholen