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.
Si votre entreprise utilise une instance Klaro Cards dédiée, merci de :
- Vérifier auprès de votre interlocuteur commercial que le serveur MCP est déployé
- Utiliser
https://ai.${domaine-de-deploiement-de-votre-entreprise}/mcpà la place
Se connecter via OAuth (recommandé)
La manière la plus simple de se connecter est via OAuth — pas besoin de copier-coller de token.
Dans Claude Desktop
- Ouvrez Claude → Settings → Connectors → Add custom connector
- Renseignez :
- Name :
Klaro Cards - Remote MCP server URL :
https://ai.klaro.cards/mcp
- Name :
- Cliquez sur Add
Claude ouvre alors une fenêtre du navigateur et vous redirige vers la page de consentement Klaro :
Sur cette page, vous choisissez :
- Portée — laissez vide pour autoriser l'accès à tous vos projets, ou sélectionnez un projet dans la liste déroulante. Quand un projet est choisi, vous pouvez restreindre encore davantage à certains espaces de travail.
- Permission level :
- Contributor — créer et modifier uniquement des cartes
- Modeler — cartes + dimensions + tableaux
- Full access — toutes les ressources (à utiliser avec précaution)
Cliquez sur Autoriser. Vous êtes redirigé vers Claude, et les outils Klaro apparaissent dans le panneau du connecteur.
Dans d'autres agents
La configuration OAuth fonctionne de la même manière dans tout client MCP qui supporte Streamable HTTP avec découverte OAuth (VS Code Copilot, Cursor, Windsurf, etc.) : ajoutez un serveur MCP distant avec l'URL https://ai.klaro.cards/mcp et suivez le flux de consentement dans le navigateur.
Alternative : token Bearer manuel
Certains agents (ou des versions plus anciennes) ne supportent pas encore OAuth. Dans ce cas, utilisez un token Bearer statique :
- Connectez-vous à Klaro Cards dans votre navigateur
- Ouvrez les Outils de développement (F12) → onglet Network, effectuez une action
- Copiez l'en-tête
Authorizationd'une requête API (la partie aprèsBearer) - Dans la configuration MCP de votre agent, définissez l'URL du serveur sur
https://ai.klaro.cards/mcpavec un en-têteAuthorization: Bearer <token>
Ce token hérite des permissions de votre compte utilisateur — consultez Utiliser Klaro Cards avec des agents IA pour les bonnes pratiques sur l'utilisation d'un compte dédié pour l'agent.
Outils disponibles
Une fois connecté, votre agent a accès aux outils suivants.
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 sur un tableau |
| update-card | Mettre à jour le titre, la description ou les dimensions d'une carte |
| delete-card | Supprimer une carte |
| link-cards / unlink-cards | Créer ou supprimer des relations parent/enfant |
| pin-cards / unpin-cards | Épingler ou désépingler des cartes pour l'utilisateur courant |
| add-card-attachment | Télécharger et attacher un fichier à une carte |
| bulk-create-board-cards | Créer plusieurs cartes sur un tableau en une seule requête |
| bulk-update-board-cards | Mettre à jour plusieurs cartes d'un coup |
| bulk-archive-cards / bulk-delete-cards | Archiver ou supprimer plusieurs cartes |
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 |
| update-dimension | Mettre à jour la configuration d'une dimension |
| create-dimension-value | Ajouter une valeur unique à une dimension |
| add-dimension-values | Ajouter plusieurs valeurs en une seule requête |
| update-dimension-value | Mettre à jour une valeur existante |
Tableaux
| Outil | Ce qu'il fait |
|---|---|
| list-boards | Lister les tableaux d'un projet |
| create-board | Créer un nouveau tableau |
| update-board | Mettre à jour la configuration d'un tableau |
| delete-board | Supprimer un tableau |
Utilisateurs
| Outil | Ce qu'il fait |
|---|---|
| search-users | Rechercher des utilisateurs par nom ou email |
Projets 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 | Obtenir les détails d'un tableau spécifique |
| 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-workspaces | Lister les espaces de travail d'un projet |
| get-dimensions-installers | Lister les templates de dimensions disponibles |
Résolution de problèmes
| Problème | Solution |
|---|---|
| Erreur « Unauthorized » | Votre session OAuth ou votre token a peut-être expiré. Reconnectez le connecteur, ou renouvelez votre token manuel. |
| « Project not found » | Vérifiez le sous-domaine du projet. Demandez d'abord à l'agent de lister vos projets. |
| « Permission denied » | Le niveau de permission accordé est peut-être trop restrictif. Déconnectez et ré-autorisez avec un niveau plus élevé, ou vérifiez vos rôles d'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. |
| La redirection OAuth échoue | Assurez-vous que les pop-ups ne sont pas bloquées pour ai.klaro.cards, et que vous êtes connecté à Klaro dans le même navigateur. |