Portée par projet

Le serveur MCP d'Almirant prend en charge un paramètre optionnel projectId dans l'URL de connexion, qui limite automatiquement les opérations au projet indiqué. Cela est particulièrement utile lorsqu'un agent IA travaille dans le contexte d'un seul projet.

Fonctionnement

Lorsque projectId est configuré dans l'URL de connexion :

• list_projects ne renvoie que le projet configuré
• list_work_items filtre automatiquement par projet
• create_work_item utilise le projet comme valeur par défaut
• create_task, create_story, create_feature, create_epic exigent que projectId soit configuré dans la session
• list_idea_items filtre automatiquement par projet
• list_milestones filtre automatiquement par projet
• get_board_context renvoie les boards du projet configuré

Sans projectId, les tools opèrent sur tous les projets de l'organisation.

Configuration

Ajoutez le paramètre projectId comme chaîne de requête dans l'URL :

{
  "mcpServers": {
    "almirant": {
      "type": "http",
      "url": "https://api.almirant.ai/mcp?projectId=<tu-project-uuid>",
      "headers": {
        "Authorization": "Bearer <tu-api-key>"
      }
    }
  }
}

Obtenir le Project ID

Il existe deux façons de trouver votre Project ID :

Depuis l'interface d'Almirant

1. Accédez au projet souhaité dans Almirant
2. L'UUID apparaît dans l'URL du navigateur : https://app.almirant.ai/projects/<project-uuid>/...

Depuis MCP sans portée de projet

Exécutez le tool list_projects sans projectId configuré pour obtenir la liste complète des projets avec leurs IDs :

{
  "tool": "list_projects"
}

La réponse inclura l'id de chaque projet :

{
  "projects": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Mi Proyecto"
    }
  ]
}

Remplacement par paramètre

Les tools qui acceptent un paramètre projectId explicite ont toujours priorité sur la valeur configurée dans la session. Cela permet d'effectuer des opérations ponctuelles sur un autre projet sans modifier la configuration :

{
  "tool": "list_work_items",
  "params": {
    "projectId": "otro-project-uuid"
  }
}

Tools affectés par la portée de projet

Tool	Comportement avec projectId
list_projects	Ne renvoie que le projet configuré
list_work_items	Filtre automatiquement par projet
create_work_item	Utilise le projet par défaut si aucun projectId n'est fourni
create_task	Exige projectId dans la session (n'accepte pas de paramètre)
create_story	Exige projectId dans la session (n'accepte pas de paramètre)
create_feature	Exige projectId dans la session (n'accepte pas de paramètre)
create_epic	Exige projectId dans la session (n'accepte pas de paramètre)
get_board_context	Renvoie les boards du projet configuré
get_project_roadmap	Utilise le projet configuré comme solution de repli
list_idea_items	Filtre automatiquement par projet
list_milestones	Utilise le projet configuré comme solution de repli
create_milestone	Utilise le projet configuré comme solution de repli
get_implement_context	Utilise le projet configuré comme solution de repli
get_ideation_context	Utilise le projet configuré comme solution de repli
get_validate_context	Utilise le projet configuré comme solution de repli
resolve_work_items	Filtre les résultats par projet s'il est configuré

Recommandation

Pour les flux de travail avec des agents IA, il est recommandé de toujours configurer projectId dans l'URL de connexion. Cela évite les erreurs dues à un manque de contexte et garantit que toutes les opérations sont effectuées sur le bon projet.