Outils - Projets

Outils permettant de lister, consulter, créer et mettre à jour des projets.

---

list_projects

Liste tous les projets avec pagination facultative. Si un projectId est configuré dans la session MCP, ne renvoie que ce projet.

Paramètres :

Nom	Type	Obligatoire	Description
page	number	Non	Numéro de page (par défaut : 1)
limit	number	Non	Éléments par page (par défaut : 50, max. : 100)

Exemple :

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

Réponse :

{
  "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

Obtient un projet par son ID, y compris les boards, les liens de documents et les notes associés.

Paramètres :

Nom	Type	Obligatoire	Description
id	string (UUID)	Oui	ID du projet

Exemple :

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

Réponse :

{
  "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

Crée un nouveau projet. Le nom est obligatoire.

Paramètres :

Nom	Type	Obligatoire	Description
name	string	Oui	Nom du projet
description	string	Non	Description du projet
status	string	Non	Statut du projet : active, archived, on_hold

Exemple :

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

Réponse :

{
  "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

Met à jour les champs d'un projet existant. Seuls les champs fournis sont mis à jour.

Paramètres :

Nom	Type	Obligatoire	Description
id	string (UUID)	Oui	ID du projet à mettre à jour
name	string	Non	Nouveau nom
description	string	Non	Nouvelle description
status	string	Non	Nouveau statut : active, archived, on_hold

Exemple :

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

Réponse :

{
  "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

Obtient la feuille de route du projet avec une structure hiérarchique (epics, features, stories/tasks) et des dates calculées à partir de l'activité des work items.

Les dates sont calculées à partir des événements de déplacement entre les colonnes du board :

• startDate : lorsqu'un item a été déplacé pour la première fois vers une colonne active
• endDate : lorsqu'il a été déplacé vers une colonne de type "done"
• Les items parents agrègent les dates de leurs enfants

Paramètres :

Nom	Type	Obligatoire	Description
projectId	string (UUID)	Oui	ID du projet (utilise celui de la session MCP comme solution de repli)

Exemple :

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

Réponse :

{
  "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": []
        }
      ]
    }
  ]
}

Utilisation recommandée

get_project_roadmap est idéal pour que les agents IA obtiennent une vue d'ensemble de l'état du projet avant de planifier de nouveaux travaux.