Klaro Cards

Se connecter au serveur MCP

Configuration pas à pas pour Claude Desktop, VS Code Copilot, Cursor et autres agents compatibles MCP

  1. Qu'est-ce que le serveur MCP ?
  2. Se connecter via OAuth (recommandé)
    1. Dans Claude Desktop
    2. Dans d'autres agents
    3. Revoir ce que vous avez accordé
  3. Alternative : token Bearer manuel
  4. Agir à travers un espace de travail
  5. Outils disponibles
    1. Cartes
    2. Liens entre cartes
    3. Commentaires
    4. Pièces jointes
    5. Dimensions
    6. Tableaux
    7. Espaces de travail
    8. Métriques
    9. Projets, personnes et guides
  6. Résolution de problèmes

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. Il est référencé dans le registre public MCP, de sorte que certains clients le trouvent par son nom plutôt que par son URL.

Si votre entreprise utilise une instance Klaro Cards dédiée, merci de :

  1. Vérifier auprès de votre interlocuteur commercial que le serveur MCP est déployé
  2. 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

  1. Ouvrez Claude → Settings → Connectors → Add custom connector
  2. Renseignez :
    • Name : Klaro Cards
    • Remote MCP server URL : https://ai.klaro.cards/mcp
  3. Cliquez sur Add

claude-add-custom-connector.png

Claude ouvre alors une fenêtre du navigateur et vous redirige vers la page de consentement Klaro :

klaro-oauth-consent-fr.png

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. Copilot s'enregistre lui-même quand vous le lui demandez, et c'est toute sa configuration.

Revoir ce que vous avez accordé

Une autorisation n'est pas sans retour. Paramètres du projet → Intégrations
liste chaque consentement que vous avez donné — quelle application, via quel
espace de travail, quand il a été donné et quand il a servi pour la dernière
fois — et permet de le révoquer. Reconsentir à la même application remplace
l'autorisation au lieu d'en empiler une seconde à côté.

Alternative : token Bearer manuel

Certains agents (ou des versions plus anciennes) ne supportent pas encore OAuth. Dans ce cas, utilisez un token Bearer statique :

  1. Connectez-vous à Klaro Cards dans votre navigateur
  2. Ouvrez les Outils de développement (F12) → onglet Network, effectuez une action
  3. Copiez l'en-tête Authorization d'une requête API (la partie après Bearer )
  4. Dans la configuration MCP de votre agent, définissez l'URL du serveur sur https://ai.klaro.cards/mcp avec un en-tête Authorization: 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.

Agir à travers un espace de travail

C'est l'idée qu'il vaut la peine de comprendre avant la liste des outils, car
elle explique des réponses qui autrement semblent fausses.

Un projet ne se présente pas de la même façon depuis chaque espace de travail :
quelles cartes existent, quelles dimensions elles portent et ce dont hérite une
nouvelle carte dépendent de l'espace par lequel vous regardez. La plupart des
outils prennent donc un espace de travail — son code, comme admins ou
developers.

  • Les codes sont définis par le projet et ne se devinent pas. Un agent devrait
    commencer par appeler get-my-workspaces.
  • Passer un espace auquel vous n'avez pas accès est refusé, et non élargi en
    silence.
  • Demander à un agent « les cartes du tableau pipeline » et en obtenir moins que
    prévu signifie en général qu'il a agi via un espace qui en masque une partie.

Chaque outil déclare aussi ce qu'il fait au projet — s'il se contente de lire,
s'il écrit, ou s'il détruit — pour qu'un client bien élevé puisse vous demander
confirmation avant les plus destructeurs.

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
get-card Obtenir les détails complets d'une carte
create-card / update-card / delete-card Créer, modifier ou supprimer une carte
bulk-create-board-cards / bulk-update-board-cards Créer ou mettre à jour plusieurs cartes en une requête
bulk-archive-cards / bulk-delete-cards Archiver ou supprimer plusieurs cartes d'un coup
pin-cards / unpin-cards / get-my-pinned-cards Vos propres cartes épinglées

Liens entre cartes

Outil Ce qu'il fait
get-card-links À quoi une carte est rattachée
link-cards / unlink-cards Créer ou supprimer une relation
set-link-description Dire ce que signifie un lien donné

Commentaires

Outil Ce qu'il fait
get-card-comments Lire la discussion d'une carte
add-card-comment / edit-card-comment Écrire ou corriger un commentaire

Pièces jointes

Outil Ce qu'il fait
get-card-attachments Lister les fichiers d'une carte
presign-upload Demander une URL de dépôt temporaire — les octets ne passent jamais par la conversation
attach-uploaded-file Attacher ce qui a été déposé, éventuellement comme couverture
delete-attachment Retirer un fichier d'une carte

Dimensions

Outil Ce qu'il fait
get-klaro-dimensions / get-klaro-dimension Lister les dimensions, ou en détailler une
create-dimension / update-dimension Créer ou reconfigurer une dimension
create-dimension-value / add-dimension-values / update-dimension-value Gérer les valeurs d'une dimension, une à une ou en lot
get-dimensions-installers Lister les dimensions prêtes à installer

Tableaux

Outil Ce qu'il fait
list-boards / get-my-boards Lister les tableaux d'un projet
get-board / get-board-stories La configuration d'un tableau, ou les cartes qu'il porte
create-board / update-board / delete-board Gérer un tableau
set-board-wip-limits Plafonner la quantité de travail qu'une colonne peut contenir

Espaces de travail

Outil Ce qu'il fait
get-my-workspaces Les espaces par lesquels vous pouvez agir — à appeler en premier
get-workspaces Tous les espaces de travail du projet
create-workspace / update-workspace Créer ou remodeler un espace de travail

Métriques

Outil Ce qu'il fait
list-kpi-catalog Le catalogue de cas d'usage des métriques prêtes à l'emploi
install-kpi / attach-kpi-to-workspace Créer une métrique, ou en afficher une existante sur un espace
get-workspace-kpis / get-kpi-dashboard Lire les métriques d'un espace et sa page de statistiques
write-kpi-dashboard-note Laisser une note écrite sur le tableau de bord, expliquant ce que disent les chiffres

Projets, personnes et guides

Outil Ce qu'il fait
get-my-projects / get-project-information Vos projets, et le détail de l'un d'eux
search-users Rechercher des utilisateurs par nom ou email
search-guides / get-guide Chercher dans ces guides et en lire un — un agent peut vérifier comment marche une fonctionnalité avant de l'utiliser

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.
Moins de cartes que prévu L'agent agit via un espace de travail qui ne les montre pas. Demandez-lui quel espace il a utilisé, ou nommez-en un explicitement.
« Workspace not found » Les codes d'espace de travail sont propres au projet. Faites appeler get-my-workspaces à l'agent plutôt que de deviner.
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.
Retour