Qu'est-ce que le serveur MCP ?
Klaro Cards expose son API via le Model Context Protocol (MCP) — un standard ouvert qui permet aux agents IA d'interagir avec des outils externes. Le serveur MCP s'appelle Sia et est disponible à l'adresse https://ai.klaro.cards/mcp.
Outils disponibles
Une fois connecté, votre agent a accès à ces outils :
Cartes
| Outil | Ce qu'il fait |
|---|---|
| search-cards | Rechercher des cartes par mots-clés et filtres de dimensions |
| create-card | Créer une nouvelle carte (optionnellement sur un tableau spécifique) |
| update-card | Mettre à jour le titre, la description ou les dimensions d'une carte |
| link-cards | Créer des relations parent/enfant entre cartes |
| add-card-attachment | Télécharger et attacher un fichier à une carte |
Dimensions
| Outil | Ce qu'il fait |
|---|---|
| get-klaro-dimensions | Lister toutes les dimensions et leurs valeurs |
| get-klaro-dimension | Obtenir les détails d'une dimension spécifique |
| create-dimension | Créer une nouvelle dimension |
| create-dimension-value | Ajouter une valeur à une dimension |
Projet et navigation
| Outil | Ce qu'il fait |
|---|---|
| get-my-projects | Lister vos projets accessibles |
| get-project-information | Obtenir les détails d'un projet |
| get-my-boards | Lister les tableaux d'un projet |
| get-board-stories | Obtenir toutes les cartes d'un tableau |
| get-card | Obtenir les détails complets d'une carte |
| get-my-pinned-cards | Obtenir vos cartes épinglées |
| get-my-user-profile | Obtenir votre profil utilisateur |
| get-dimensions-installers | Lister les templates de dimensions disponibles |
Obtenir un token
Pour vous authentifier, vous avez besoin d'un token API Klaro :
- Connectez-vous à Klaro Cards dans votre navigateur
- Ouvrez les Outils de développement (F12) → onglet Network
- Effectuez n'importe quelle action dans Klaro Cards
- Trouvez une requête API et copiez la valeur de l'en-tête
Authorization(la partie après « Bearer »)
Ce token donne à l'agent les mêmes permissions que votre compte utilisateur — consultez Utiliser Klaro Cards avec des agents IA pour les bonnes pratiques sur la création d'un utilisateur dédié pour l'agent.
Configuration avec Claude Desktop
- Ouvrez Claude Desktop → Settings → MCP Servers
- Ajoutez un nouveau serveur :
- Name : Klaro Cards
- Transport type : Streamable HTTP
- URL :
https://ai.klaro.cards/mcp - Authentication : Bearer token
- Token : Votre token API Klaro
- Cliquez sur Connect
Vous devriez voir les outils Klaro listés dans le panneau d'outils de Claude.
Configuration avec d'autres agents
La configuration est similaire pour tout agent compatible MCP (VS Code Copilot, Cursor, Windsurf, etc.) :
- Trouvez la configuration des serveurs MCP dans les paramètres de votre agent
- Ajoutez un nouveau serveur :
- Transport : Streamable HTTP
- URL :
https://ai.klaro.cards/mcp - Authorization header :
Bearer VOTRE_TOKEN
- Sauvegardez et vérifiez la connexion
Résolution de problèmes
| Problème | Solution |
|---|---|
| Erreur « Unauthorized » | Votre token a peut-être expiré. Obtenez-en un nouveau depuis le navigateur. |
| « Project not found » | Vérifiez le sous-domaine du projet. Demandez d'abord à l'agent de lister vos projets. |
| « Permission denied » | Votre utilisateur n'a peut-être pas les droits d'écriture. Vérifiez les rôles de l'espace de travail. |
| L'agent ne trouve pas les outils | Vérifiez que l'URL est https://ai.klaro.cards/mcp et que le transport est Streamable HTTP. |