Board-Details per MCP abrufen: Spalten, Zustände und Nutzung

Entwicklerreferenz für das MCP-Tool get_board. So rufen Sie vollständige Details eines bestimmten Boards inkl. Spalten, Zuständen, Aufgabenzahlen und Workflow-Konfiguration ab. Inkl. Beispiel-Tool-Aufrufe, natürliche Sprache, Grenzfälle und Fehlerbehebung.

Tool-Überblick

Zweck

Das Tool get_board ruft die vollständigen Details eines bestimmten Boards anhand seiner ID ab. Nutzen Sie es, wenn Sie vor der Analyse von Engpässen oder dem Erzeugen von Berichten den vollen Kontext zu einem Board benötigen – inkl. Spalten, Zustände, Aufgabenverteilung und Workflow-Konfiguration.

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

Eingabeparameter

Das Tool benötigt eine Board-ID, um die Board-Details abzurufen.

Ausgabeformat

Das Tool liefert ein vollständiges Board-Objekt mit allen verfügbaren Feldern:

{
  "id": 789,
  "name": "Sprint Board",
  "project_id": 456,
  "project_name": "Q1 Product Launch",
  "created_at": "2026-01-01T10:00:00Z",
  "updated_at": "2026-03-10T14:30:00Z",
  "columns": [
    {
      "id": 1,
      "name": "To Do",
      "position": 0,
      "task_count": 5
    },
    {
      "id": 2,
      "name": "In Progress",
      "position": 1,
      "task_count": 8
    },
    {
      "id": 3,
      "name": "Review",
      "position": 2,
      "task_count": 2
    },
    {
      "id": 4,
      "name": "Done",
      "position": 3,
      "task_count": 0
    }
  ],
  "states": ["open", "in_progress", "review", "done"],
  "task_count": 15,
  "total_tasks": 15
}

Antwortfelder

• id: Eindeutige Board-Kennung
• name: Boardname
• project_id: ID des Projekts, zu dem das Board gehört
• project_name: Name des Projekts (zur Orientierung)
• created_at: Zeitstempel der Erstellung
• updated_at: Zeitstempel der letzten Aktualisierung
• columns: Array von Spaltenobjekten mit id, name, position und task_count
• states: Array von Zustands-Strings, die Aufgabenstatus zugeordnet sind
• task_count: Gesamtzahl der Aufgaben auf diesem Board
• total_tasks: Wie task_count (zur Konsistenz)

Spalten-Objektfelder

• id: Eindeutige Spaltenkennung
• name: Spaltenname (z. B. "To Do", "In Progress")
• position: Spaltenreihenfolge (0-basierter Index)
• task_count: Anzahl der Aufgaben derzeit in dieser Spalte

Beispiel-Tool-Aufrufe

Beispiel 1: Board anhand ID abrufen

Tool-Aufruf (JSON):

{
  "tool": "get_board",
  "arguments": {
    "board_id": 789
  }
}

Rückgabe: Vollständiges Board-Objekt mit allen Feldern inkl. Spalten und Zuständen

Beispiele für natürliche Sprache

Claude Desktop / Allgemeine KI

Nutzeraufforderung:

"Zeig mir die Struktur des Sprint-Boards"

KI-Verhalten:

1. KI ruft list_boards mit Suche: "Sprint" auf
2. KI findet die Board-ID (789)
3. KI ruft get_board mit board_id: 789 auf
4. KI erhält das vollständige Board-Objekt mit Spalten
5. KI formatiert und präsentiert die Board-Struktur dem Nutzer

Board-Engpässe analysieren

Nutzeraufforderung:

"Wo bleiben die Aufgaben auf dem Sprint-Board hängen?"

KI-Verhalten:

1. KI findet das Board mit list_boards
2. KI ruft get_board auf, um Spaltenstruktur und Aufgabenzahlen zu erhalten
3. KI analysiert die Aufgabenverteilung über die Spalten
4. KI identifiziert Spalten mit hohen Aufgabenzahlen (Engpässe)
5. KI präsentiert die Analyse: "Die meisten Aufgaben (8) sind in der Spalte 'In Progress'..."

Workflow verstehen

Nutzeraufforderung:

"Welche Workflow-Zustände hat das Sprint-Board?"

KI-Verhalten:

1. KI ruft get_board auf, um die Board-Details zu erhalten
2. KI extrahiert das states-Array aus der Antwort
3. KI präsentiert den Workflow: "Das Sprint-Board hat diese Zustände: open, in_progress, review, done"

Typische Anwendungsfälle

• Board-Engpässe – Spalten-Aufgabenzahlen analysieren, um Workflow-Engpässe zu finden
• Aufgabenverwaltung – Board-Struktur verstehen, bevor Aufgaben verwaltet werden
• Projekt-Kickoff – Board-Konfiguration prüfen, bevor Aufgaben angelegt werden
• Board zuerst finden – list_boards nutzen, um die ID zu finden, bevor get_board aufgerufen wird

Grenzfälle

Board nicht gefunden (404)

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

Antwort:

{
  "error": "not_found",
  "message": "Board with ID 789 not found"
}

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

Berechtigung verweigert (403)

Situation: Das Board existiert, aber Sie haben keinen Zugriff

Antwort:

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

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

403-Fehlerbehebungsanleitung →

Ungültige Board-ID

Situation: Board-ID ist keine gültige Ganzzahl

Antwort:

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

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

Fehlerbehebung

Ungültige Board-ID

Symptom: 400-Validierungsfehler oder 404 Not Found

Ursachen:

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

Lösung:

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

Zugriff verweigert (403)

Symptom: 403 Forbidden

Ursachen:

• Board gehört einem anderen Arbeitsbereich
• Board 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
• Board-Berechtigungen in Corcava prüfen
• Prüfen, ob der API-Schlüssel Zugriff auf den Arbeitsbereich hat

403-Fehlerbehebungsanleitung →

Best Practices

get_board effektiv nutzen

• ✅ Wenn Sie nur den Namen kennen, zuerst list_boards aufrufen, um die Board-ID zu finden
• ✅ Spalten-Aufgabenzahlen nutzen, um Engpässe im Workflow zu identifizieren
• ✅ states-Array prüfen, um gültige Aufgabenstatus-Übergänge zu verstehen
• ✅ Board-Details nutzen, um den Workflow zu verstehen, bevor Aufgaben angelegt werden
• ✅ Mit list_tasks gefiltert nach board_id für detaillierte Analysen kombinieren

Verwandte Tools

Oft zusammen verwendet mit:

• list_boards – Board-IDs finden, bevor get_board aufgerufen wird
• list_tasks – Aufgaben auf einem Board mit board_id abrufen
• list_projects – Projektdetails für das Projekt des Boards finden