Projektdetails per MCP abrufen: Metadaten, Mitglieder und Einstellungen

Entwicklerreferenz für das MCP-Tool get_project. So rufen Sie vollständige Details eines bestimmten Projekts inkl. Metadaten, Mitgliedern, Einstellungen und Statistiken ab. Inkl. Beispiel-Tool-Aufrufe, natürliche Sprache, Grenzfälle und Fehlerbehebung.

Tool-Überblick

Zweck

Das Tool get_project ruft die vollständigen Details eines bestimmten Projekts anhand seiner ID ab. Nutzen Sie es, wenn Sie vor dem Erzeugen von Berichten oder der Planung von Workflows den vollen Kontext zu einem Projekt benötigen – inkl. Mitglieder, Einstellungen, Aufgabenzahlen und Metadaten.

Nur-Lesen-Operation: Dieses Tool liest nur Daten – es ändert keine Projekte.

Eingabeparameter

Das Tool benötigt eine Projekt-ID, um die Projektdetails abzurufen.

Ausgabeformat

Das Tool liefert ein vollständiges Projektobjekt mit allen verfügbaren Feldern:

{
  "id": 456,
  "name": "Q1 Product Launch",
  "description": "Launch new product features for Q1 2026",
  "created_at": "2026-01-01T10:00:00Z",
  "updated_at": "2026-03-10T14:30:00Z",
  "created_by_id": 99,
  "members": [
    {
      "id": 101,
      "name": "John Doe",
      "email": "[email protected]",
      "role": "owner"
    }
  ],
  "settings": {
    "default_board_id": 789,
    "notifications_enabled": true
  },
  "task_count": 42,
  "board_count": 3,
  "member_count": 5
}

Antwortfelder

• id: Eindeutige Projektkennung
• name: Projektname
• description: Vollständige Projektbeschreibung (kann null sein)
• created_at: Zeitstempel der Erstellung
• updated_at: Zeitstempel der letzten Aktualisierung
• created_by_id: ID des Benutzers, der das Projekt erstellt hat
• members: Array von Mitgliederobjekten mit id, name, email und role
• settings: Projekt-Einstellungsobjekt (default_board_id, notifications_enabled usw.)
• task_count: Gesamtzahl der Aufgaben im Projekt
• board_count: Anzahl der Boards im Projekt
• member_count: Anzahl der Mitglieder im Projekt

Beispiel-Tool-Aufrufe

Beispiel 1: Projekt anhand ID abrufen

Tool-Aufruf (JSON):

{
  "tool": "get_project",
  "arguments": {
    "project_id": 456
  }
}

Rückgabe: Vollständiges Projektobjekt mit allen Feldern

Beispiele für natürliche Sprache

Claude Desktop / Allgemeine KI

Nutzeraufforderung:

"Zeig mir die Details für das Projekt Q1 Product Launch"

KI-Verhalten:

1. KI ruft list_projects mit Suche: "Q1 Product Launch" auf
2. KI findet die Projekt-ID (456)
3. KI ruft get_project mit project_id: 456 auf
4. KI erhält das vollständige Projektobjekt
5. KI formatiert und präsentiert die Projektdetails dem Nutzer

Projektmitglieder prüfen

Nutzeraufforderung:

"Wer ist im Q1-Launch-Projekt?"

KI-Verhalten:

1. KI findet das Projekt mit list_projects
2. KI ruft get_project auf, um die Mitgliederliste zu erhalten
3. KI extrahiert und präsentiert Mitgliedernamen und -rollen

Statusberichte vorbereiten

Nutzeraufforderung:

"Gib mir eine Übersicht des Q1-Projekts für einen Statusbericht"

KI-Verhalten:

1. KI ruft get_project auf, um die Projekt-Metadaten zu erhalten
2. KI nutzt Projektdetails (name, description, task_count) für den Berichtskontext
3. KI kann zusätzlich list_tasks gefiltert nach project_id für Aufgabendetails aufrufen
4. KI erzeugt den Statusbericht mit Projektkontext

Typische Anwendungsfälle

• Projekt-Kickoff – Projektdetails und Mitglieder prüfen, bevor die Arbeit beginnt
• Statusberichte – Projekt-Metadaten für Status-Updates erhalten
• Kunden-Fortschrittsberichte – Projektdetails und Mitgliederinfos in Berichte einbeziehen
• Projekt zuerst finden – list_projects nutzen, um die ID zu finden, bevor get_project aufgerufen wird

Grenzfälle

Projekt nicht gefunden (404)

Situation: Projekt-ID existiert nicht oder das Projekt wurde gelöscht

Antwort:

{
  "error": "not_found",
  "message": "Project with ID 456 not found"
}

Umgang: Prüfen, ob die Projekt-ID korrekt ist oder das Projekt gelöscht wurde

Berechtigung verweigert (403)

Situation: Das Projekt existiert, aber Sie haben keinen Zugriff

Antwort:

{
  "error": "forbidden",
  "message": "You don't have permission to access this project"
}

Umgang: Prüfen, ob Sie im richtigen Arbeitsbereich sind oder das Projekt privat ist

403-Fehlerbehebungsanleitung →

Ungültige Projekt-ID

Situation: Projekt-ID ist keine gültige Ganzzahl

Antwort:

{
  "error": "validation_error",
  "message": "Invalid project_id format",
  "field": "project_id"
}

Umgang: Sicherstellen, dass project_id eine gültige Ganzzahl ist

Fehlerbehebung

Ungültige Projekt-ID

Symptom: 400-Validierungsfehler oder 404 Not Found

Ursachen:

• Projekt-ID ist keine Zahl
• Projekt-ID existiert nicht
• Projekt wurde gelöscht

Lösung:

• Prüfen, ob die Projekt-ID eine gültige Ganzzahl ist
• Mit list_projects die richtige Projekt-ID finden
• Prüfen, ob das Projekt in Corcava noch existiert

Zugriff verweigert (403)

Symptom: 403 Forbidden

Ursachen:

• Projekt gehört einem anderen Arbeitsbereich
• Projekt ist privat und Sie sind kein Mitglied
• API-Schlüssel hat keinen Zugriff auf den Arbeitsbereich

Lösung:

• Prüfen, ob Sie den richtigen Arbeitsbereich nutzen
• Projektberechtigungen in Corcava prüfen
• Prüfen, ob der API-Schlüssel Zugriff auf den Arbeitsbereich hat

403-Fehlerbehebungsanleitung →

Best Practices

get_project effektiv nutzen

• ✅ Wenn Sie nur den Namen kennen, zuerst list_projects aufrufen, um die Projekt-ID zu finden
• ✅ Projektdetails nutzen, um den Kontext vor dem Erzeugen von Berichten zu verstehen
• ✅ Mitgliederliste prüfen, um die Projektteam-Zusammensetzung zu verstehen
• ✅ task_count und board_count für Projekt-Gesundheitsmetriken nutzen
• ✅ Projekteinstellungen prüfen, um Standardkonfigurationen zu verstehen

Verwandte Tools

Oft zusammen verwendet mit:

• list_projects – Projekt-IDs finden, bevor get_project aufgerufen wird
• list_tasks – Aufgaben in einem Projekt mit project_id abrufen
• list_boards – Boards in einem Projekt finden