Comment connecter des agents IA à Stellary via MCP

Le Model Context Protocol (MCP) est le pont entre vos agents IA et votre workspace Stellary. Dans ce guide, nous allons parcourir la configuration complète — de la génération de votre token API jusqu'à ce que votre premier agent propose des actions sur votre board.

Qu'est-ce que MCP ?

MCP est un protocole ouvert qui permet aux modèles d'IA d'interagir avec des outils et sources de données externes de manière standardisée. Pensez-y comme un adaptateur universel : tout agent compatible MCP peut se connecter à tout outil compatible MCP sans code d'intégration personnalisé.

Stellary implémente MCP nativement, ce qui signifie que votre workspace devient une source de contexte riche que les agents peuvent lire et sur laquelle ils peuvent agir.

Prérequis

Avant de commencer, assurez-vous d'avoir :

• Un workspace Stellary avec au moins un projet
• Un token API (généré depuis Paramètres > Tokens API)
• Un agent IA compatible MCP (Claude, GPT, ou tout agent personnalisé)

Étape 1 : Générer votre token API

Naviguez vers les paramètres de votre workspace et créez un nouveau token API. Donnez-lui un nom descriptif — vous voudrez savoir quel agent utilise quel token.

# Vous pouvez aussi créer des tokens via l'API
curl -X POST https://api.stellary.co/v1/api-tokens \
  -H "Authorization: Bearer VOTRE_TOKEN_SESSION" \
  -d '{"name": "Mon Agent Claude", "scopes": ["read", "write"]}'

La réponse inclura votre token. Stockez-le en sécurité — il ne sera plus affiché.

Étape 2 : Configurer votre agent

Pointez la configuration MCP de votre agent vers votre workspace Stellary. La configuration exacte dépend de votre agent, mais le cœur ressemble à ceci :

{
  "mcpServers": {
    "stellary": {
      "url": "https://api.stellary.co/v1/mcp",
      "headers": {
        "Authorization": "Bearer VOTRE_TOKEN_API"
      }
    }
  }
}

Étape 3 : Vérifier la connexion

Une fois configuré, votre agent devrait pouvoir lister les outils disponibles. Vous verrez des outils pour lire votre board, créer des cartes, mettre à jour les priorités, et plus encore.

Outils MCP disponibles

Stellary expose un ensemble complet d'outils via MCP :

• Outils Board — lister les colonnes, créer/modifier/déplacer des cartes, gérer les labels
• Outils Docs — lire et créer des documents, déclencher des workflows de revue
• Outils Cockpit — lire les missions, consigner les décisions, proposer des actions
• Outils Projet — lister les projets, lire les paramètres, gérer les membres

Bonnes pratiques

Voici quelques conseils pour tirer le meilleur parti de l'intégration MCP :

• Commencez avec des scopes en lecture seule — laissez votre agent observer avant d'agir
• Utilisez le cockpit pour les propositions — les agents doivent proposer des actions, pas les exécuter directement
• Surveillez l'activité des agents — consultez les traces d'automatisation pour voir ce que font vos agents
• Mettez en place des workflows d'approbation — exigez l'approbation humaine pour les actions destructives

Et ensuite

Maintenant que votre agent est connecté, explorez notre guide sur la mise en place d'automatisations pour permettre à votre agent de travailler de manière autonome dans des limites sûres.