Ihre erste MCP-Sitzung: Ein wiederholbarer Smoke-Test
Prüfen Sie mit diesem Schritt-für-Schritt-Smoke-Test, ob Ihr MCP-Setup funktioniert. Die Anleitung führt Sie durch: Aufgaben auflisten, Aufgabendetails lesen, Kommentare hinzufügen und optional Zeiterfassung testen – inkl. erwarteter Ausgaben und Fehlerbehebung.
Inhalt dieser Anleitung
Dieser Smoke-Test prüft Ihre MCP-Integration End-to-End:
Testschritte
- Aufgaben auflisten: Lesezugriff auf Ihren Workspace prüfen
- Eine Aufgabe lesen: Abruf von Aufgabendetails testen
- Kommentar hinzufügen: Schreibrechte prüfen
- Zeiterfassung (optional): Timer Start/Stopp testen
Voraussetzungen
Vor dem Smoke-Test sollten Sie haben:
- Konfigurierten MCP-Client (Claude Desktop, Cursor, Windsurf oder Continue)
- Corcava-MCP-Server in der Client-Konfiguration
- API-Schlüssel mit Lese- und Schreibrechten
- Mindestens eine Aufgabe in Ihrem Corcava-Workspace
- Client nach Konfigurationsänderungen neu gestartet
Schritt-für-Schritt-Smoke-Test
Schritt 1: Aufgaben auflisten
Beginnen Sie mit einer einfachen Leseoperation zur Verbindungsprüfung:
Test-Prompt
Erwartete Ausgabe:
Was die KI tut:
- Ruft das MCP-Tool
list_tasksauf - Erhält die Aufgabenliste von Corcava
- Formatiert und zeigt die Ergebnisse an
⚠️ Bei Fehlern:
- API-Schlüssel prüfen (korrekt und aktiv)
- MCP-Server-Konfiguration prüfen
- Client nach Konfigurationsänderung neu starten
- Tools werden nicht angezeigt
Schritt 2: Eine Aufgabe lesen
Abruf von Aufgabendetails testen:
Test-Prompt
Erwartete Ausgabe:
Was die KI tut:
- Ruft
get_taskmit der Aufgaben-ID auf - Ruft die vollständigen Aufgabendetails ab
- Zeigt die formatierten Informationen an
⚠️ Bei Fehlern:
- Aufgaben-ID prüfen (aus Schritt 1 übernehmen)
- API-Schlüssel hat Leseberechtigung
- Aufgabe existiert im Workspace
Schritt 3: Kommentar hinzufügen
Schreibrechte testen, indem Sie einen Kommentar hinzufügen:
Test-Prompt
Erwartete Ausgabe:
Was die KI tut:
- Ruft
add_task_commentmit Aufgaben-ID und Kommentartext auf - Bestätigt, dass der Kommentar hinzugefügt wurde
- Prüft, dass Schreibrechte funktionieren
⚠️ Bei Fehlern:
- API-Schlüssel hat Schreibrechte
- Aufgaben-ID prüfen
- 401 Nicht autorisiert
- 403 Forbidden
Schritt 4: Zeiterfassung (optional)
Zeiterfassung mit Bestätigung testen:
Test-Prompt
Erwartete Ausgabe:
Timer stoppen – Prompt:
Was die KI tut:
- Ruft
get_taskauf, um Aufgabendetails anzuzeigen - Ruft
start_time_trackingauf, um den Timer zu starten - Später:
stop_time_trackingundadd_task_comment
⚠️ Bei Fehlern:
- API-Schlüssel hat Zeiterfassungs-Berechtigung
- Kein anderer Timer läuft bereits
- Tool-Aufruf-Fehler
Vollständiges Smoke-Test-Skript
Vollständige Abfolge zum Kopieren und Ausführen:
Komplette Testabfolge
1. Aufgaben auflisten
2. Aufgabe lesen
3. Kommentar hinzufügen
4. Zeiterfassung (optional)
Verifizierungs-Checkliste
Erfolgskriterien
- ✅ Aufgabenliste liefert Ergebnisse ohne Fehler
- ✅ Aufgabendetails wurden erfolgreich abgerufen
- ✅ Kommentar wurde hinzugefügt und ist in Corcava sichtbar
- ✅ Timer startet und stoppt ohne Fehler (falls getestet)
- ✅ Alle Operationen in angemessener Zeit (<5 Sekunden pro Schritt)
Fehlerbehebung beim ersten Lauf
Keine Tools verfügbar
Symptom: Die KI meldet, dass keine MCP-Tools verfügbar sind.
Lösung:
- MCP-Server in den Client-Einstellungen prüfen
- Konfigurationsdatei: gültiges JSON?
- Client vollständig neu starten (nicht nur Reload)
- Tools werden nicht angezeigt
Authentifizierungsfehler
Symptom: 401- oder 403-Fehler bei Tool-Aufrufen
Lösung:
- API-Schlüssel in der Konfiguration prüfen
- Authorization-Header: „Bearer IHR_SCHLUESSEL“
- API-Schlüssel ist in Corcava aktiv
- 401-Fehlerbehebung
Weitere Ressourcen
MCP Quickstart
5-Minuten-Setup-Anleitung
Fehlerbehebungs-Index
Vollständige Fehlerbehebungs-Anleitung
Wochenplanung
Erster Workflow zum Ausprobieren
Health Checks
Server-Status prüfen
Erste MCP-Sitzung abschließen
Führen Sie den Smoke-Test aus, um Ihr MCP-Setup zu prüfen