Tools - Projekte

Tools zum Auflisten, Abrufen, Erstellen und Aktualisieren von Projekten.

---

list_projects

Listet alle Projekte mit optionaler Paginierung auf. Wenn in der MCP-Sitzung ein projectId konfiguriert ist, wird nur dieses Projekt zurückgegeben.

Parameter:

Name	Typ	Erforderlich	Beschreibung
page	number	Nein	Seitennummer (Standard: 1)
limit	number	Nein	Elemente pro Seite (Standard: 50, max.: 100)

Beispiel:

{
  "page": 1,
  "limit": 10
}

Antwort:

{
  "projects": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Mi Proyecto",
      "description": "Descripcion del proyecto",
      "status": "active",
      "createdAt": "2025-01-15T10:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 1,
    "totalPages": 1
  }
}

---

get_project

Ruft ein Projekt anhand seiner ID ab, einschließlich Boards, Dokumentlinks und zugehöriger Notizen.

Parameter:

Name	Typ	Erforderlich	Beschreibung
id	string (UUID)	Ja	ID des Projekts

Beispiel:

{
  "id": "550e8400-e29b-41d4-a716-446655440000"
}

Antwort:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Mi Proyecto",
  "description": "Plataforma de gestion de proyectos",
  "status": "active",
  "boards": [],
  "docLinks": [],
  "notes": [],
  "createdAt": "2025-01-15T10:00:00.000Z",
  "updatedAt": "2025-01-20T14:30:00.000Z"
}

---

create_project

Erstellt ein neues Projekt. Der Name ist erforderlich.

Parameter:

Name	Typ	Erforderlich	Beschreibung
name	string	Ja	Name des Projekts
description	string	Nein	Beschreibung des Projekts
status	string	Nein	Projektstatus: active, archived, on_hold

Beispiel:

{
  "name": "Nuevo Proyecto",
  "description": "App de gestion interna",
  "status": "active"
}

Antwort:

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Nuevo Proyecto",
  "description": "App de gestion interna",
  "status": "active",
  "createdAt": "2025-02-01T09:00:00.000Z"
}

---

update_project

Aktualisiert die Felder eines bestehenden Projekts. Nur bereitgestellte Felder werden aktualisiert.

Parameter:

Name	Typ	Erforderlich	Beschreibung
id	string (UUID)	Ja	ID des zu aktualisierenden Projekts
name	string	Nein	Neuer Name
description	string	Nein	Neue Beschreibung
status	string	Nein	Neuer Status: active, archived, on_hold

Beispiel:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "archived"
}

Antwort:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Mi Proyecto",
  "description": "Plataforma de gestion de proyectos",
  "status": "archived",
  "updatedAt": "2025-02-10T16:00:00.000Z"
}

---

get_project_roadmap

Ruft die Roadmap des Projekts mit hierarchischer Struktur (Epics, Features, Stories/Tasks) und aus der Aktivität der Work Items berechneten Daten ab.

Die Daten werden aus Ereignissen zum Verschieben zwischen Board-Spalten berechnet:

• startDate: wenn ein Element erstmals in eine aktive Spalte verschoben wurde
• endDate: wenn es in eine Spalte vom Typ „done“ verschoben wurde
• Übergeordnete Elemente fassen die Daten ihrer untergeordneten Elemente zusammen

Parameter:

Name	Typ	Erforderlich	Beschreibung
projectId	string (UUID)	Ja	ID des Projekts (verwendet die der MCP-Sitzung als Fallback)

Beispiel:

{
  "projectId": "550e8400-e29b-41d4-a716-446655440000"
}

Antwort:

{
  "projectId": "550e8400-e29b-41d4-a716-446655440000",
  "items": [
    {
      "id": "...",
      "taskId": "A-E-1",
      "title": "Epic: Autenticacion",
      "type": "epic",
      "startDate": "2025-01-20T10:00:00.000Z",
      "endDate": null,
      "children": [
        {
          "id": "...",
          "taskId": "A-F-3",
          "title": "Feature: Login con Google",
          "type": "feature",
          "startDate": "2025-01-20T10:00:00.000Z",
          "endDate": "2025-01-25T18:00:00.000Z",
          "children": []
        }
      ]
    }
  ]
}

Empfohlene Verwendung

get_project_roadmap eignet sich ideal für KI-Agenten, um vor der Planung neuer Arbeit einen Überblick über den Projektstatus zu erhalten.