Connecter Claude via MCP

TskVlo intègre un serveur MCP (Model Context Protocol) qui permet à des assistants IA comme Claude de lire et de modifier vos données de projet en temps réel. Ce guide couvre toute la configuration et montre comment gérer vos tâches en langage naturel.

Qu’est-ce que MCP ?

MCP est un standard ouvert créé par Anthropic pour relier les modèles de langage à des outils et sources de données externes. Le client IA (Claude) se connecte à un serveur MCP (TskVlo), qui expose un ensemble d’outils nommés. Quand vous demandez à l’IA une action sur vos tâches, elle appelle les outils adaptés et les résultats reviennent dans la conversation.

L’avantage par rapport aux intégrations classiques : l’IA dispose d’un accès structuré et en direct à vos données, pas seulement d’un texte copié. Elle peut consulter l’état actuel, effectuer des modifications et enchaîner plusieurs opérations à partir d’une seule instruction.

Prérequis

Un compte TskVlo avec le rôle Propriétaire ou Administrateur dans l’espace de travail à connecter : eux seuls peuvent autoriser un client IA ou créer des clés API
Un client IA compatible MCP : Claude (claude.ai, Claude Desktop, Claude Code), Cursor ou tout autre client qui prend en charge les serveurs MCP distants

L’URL du serveur MCP

Quelle que soit la méthode de connexion, le serveur MCP de TskVlo se trouve à l’adresse :

https://dash.tskvlo.app/api/mcp

Vous la retrouvez aussi dans TskVlo sous Paramètres de l’espace de travail → Clés API, dans la section Serveur MCP.

Deux façons de se connecter

	OAuth (recommandé)	Clé API de l’espace de travail
Configuration	Saisir l’URL, se connecter, approuver	Créer une clé, la coller dans la configuration du client
Agit en tant que	Vous : commentaires et fichiers portent votre nom	Aucun utilisateur : le contenu apparaît comme publié par « MCP User »
Outils de notification	✅	❌ (une clé n’a pas d’utilisateur, donc pas de boîte de réception)
Lecture seule	Cocher Grant read-only access sur l’écran de consentement	Choisir Lecture seule à la création de la clé
Idéal pour	Connecteurs personnalisés de Claude et autres clients compatibles OAuth	Scripts et clients sans prise en charge d’OAuth

Option A : connexion via OAuth (recommandée)

Si votre client prend en charge OAuth pour les serveurs MCP distants, comme les connecteurs personnalisés de Claude, vous n’avez aucune clé à gérer.

Dans Claude, ouvrez Paramètres → Connecteurs et choisissez Ajouter un connecteur personnalisé
Nommez-le TskVlo et saisissez l’URL https://dash.tskvlo.app/api/mcp
Cliquez sur Connecter : une page TskVlo s’ouvre dans votre navigateur. Connectez-vous si ce n’est pas déjà fait (l’authentification à deux facteurs fonctionne comme d’habitude)
Sur l’écran Authorize MCP access, choisissez dans Workspace l’espace de travail que la connexion doit utiliser. Seuls les espaces où vous êtes propriétaire ou administrateur sont proposés
Vérifiez les autorisations demandées. Pour que l’IA puisse lire sans jamais rien modifier, cochez Grant read-only access
Cliquez sur Authorize : vous revenez dans Claude et les outils TskVlo sont disponibles

Remarque : l’écran de consentement est pour l’instant disponible uniquement en anglais.

En arrière-plan, le client s’enregistre automatiquement auprès de TskVlo et se connecte avec PKCE. Les jetons d’accès ont une durée de vie courte et sont renouvelés automatiquement : tant que vous utilisez la connexion, vous n’avez pas à vous reconnecter.

Les autres clients compatibles OAuth fonctionnent de la même façon : ajoutez https://dash.tskvlo.app/api/mcp comme serveur MCP distant (HTTP), et le client lance la connexion à la première utilisation. Dans Claude Code, par exemple :

claude mcp add --transport http tskvlo https://dash.tskvlo.app/api/mcp

Lancez ensuite /mcp dans Claude Code pour vous authentifier.

Mettre fin à une connexion OAuth

Supprimez ou déconnectez le connecteur dans votre client IA pour qu’il cesse d’utiliser TskVlo.
Une connexion cesse de fonctionner dès que vous perdez le rôle de propriétaire ou d’administrateur dans cet espace de travail, ou que vous en êtes retiré.
Les connexions inutilisées pendant 30 jours expirent d’elles-mêmes ; il vous sera simplement demandé d’autoriser à nouveau l’accès.

Option B : connexion avec une clé API de l’espace de travail

Pour les clients sans prise en charge d’OAuth, ou pour vos propres scripts :

Étape 1 : créer une clé API

Ouvrez Paramètres de l’espace de travail → Clés API (propriétaires et administrateurs uniquement)
Cliquez sur Créer une clé et donnez-lui un nom, par exemple « Cursor »
Choisissez l’Accès :
- Lecture et écriture : peut lire et modifier les tableaux, les éléments et les pages wiki
- Lecture seule : peut uniquement lire ; les requêtes d’écriture sont rejetées et les outils d’écriture MCP sont masqués
Cliquez sur Créer une clé et copiez-la immédiatement : elle ne sera plus affichée

Les clés API sont limitées à l’espace de travail dans lequel elles ont été créées. La même page indique quand chaque clé a été utilisée pour la dernière fois et permet de la révoquer à tout moment.

Étape 2 : ajouter le serveur à votre client

Les clients configurés en JSON avec une URL et des en-têtes, comme le mcp.json de Cursor, ressemblent à ceci :

{
  "mcpServers": {
    "tskvlo": {
      "url": "https://dash.tskvlo.app/api/mcp",
      "headers": {
        "Authorization": "Bearer VOTRE_CLE_API"
      }
    }
  }
}

Remplacez VOTRE_CLE_API par la clé copiée. Au lieu de l’en-tête Authorization, vous pouvez aussi envoyer la clé via x-api-key: VOTRE_CLE_API.

Dans Claude Code :

claude mcp add --transport http tskvlo https://dash.tskvlo.app/api/mcp \
  --header "Authorization: Bearer VOTRE_CLE_API"

Redémarrez ou rechargez votre client après avoir modifié sa configuration.

Vérifier la connexion

Ouvrez une nouvelle conversation et tapez :

Liste les tableaux de mon espace de travail TskVlo.

Si la connexion fonctionne, l’IA appelle l’outil list_boards et renvoie vos tableaux. En cas d’erreur, consultez la section de dépannage ci-dessous.

Outils disponibles

Une fois connectée, l’IA a accès à environ 40 outils TskVlo :

Catégorie	Outils
Membres	lister
Tableaux	lister, créer, modifier, supprimer
Groupes	lister, créer, modifier, supprimer
Éléments	lister, consulter, créer, modifier (y compris déplacer vers un autre tableau), supprimer, archiver, désarchiver
Champs	lister, créer, modifier, supprimer
Valeurs de champs	définir, définir plusieurs, effacer
Pièces jointes	lister, téléverser, supprimer
Commentaires	lister, créer
Notifications	lister, marquer comme lues (OAuth uniquement)
Règles d’automatisation	lister, consulter, créer, modifier, supprimer, exécuter
Pages wiki	lister, consulter, créer, modifier, déplacer, supprimer

Les connexions en lecture seule ne voient que les outils de lecture. Les modifications faites via MCP (nouveaux éléments, règles d’automatisation modifiées, notifications lues) apparaissent dans l’application TskVlo ouverte sans rechargement.

Exemples de prompts

Voici des prompts qui fonctionnent bien une fois connecté :

Consulter les données :

« Quels tableaux contient cet espace de travail ? »
« Montre-moi tous les éléments qui me sont assignés et arrivent à échéance cette semaine. »
« Que contient la page wiki “Onboarding” ? »

Créer et modifier :

« Crée un nouveau tableau appelé “Roadmap T3”. »
« Ajoute un rapport de bug : titre “Bouton de connexion inactif sous Safari”, assigne-le à Emma, priorité Haute. »
« Déplace la tâche “Export des factures” du tableau Support vers le groupe Backlog du tableau Développement. »

Notifications (OAuth) :

« Quelles sont mes notifications non lues ? Regroupe-les par tableau. »
« Marque comme lues toutes les notifications concernant le tableau Marketing. »

Automatisations :

« Liste les règles d’automatisation du tableau Support et explique ce que fait chacune. »
« Crée une règle sur le tableau Ventes : quand un élément est créé dans “Nouveaux leads”, assigne-le à la personne qui l’a créé. »

D’autres idées dans le guide des prompts IA.

Conseils pour de meilleurs résultats

Soyez précis sur les noms de tableaux et de groupes. « Le groupe Backlog du tableau Marketing » ne laisse aucune ambiguïté.

Utilisez-le pour le travail en lot. Là où l’interface devient fastidieuse (créer dix éléments similaires, changer des statuts en masse, appliquer une même valeur à un groupe de tâches), l’IA s’en charge en une seule instruction.

Demandez une confirmation avant les opérations destructrices. Avant une suppression ou un déplacement en masse, demandez à l’IA de lister d’abord ce qu’elle va modifier.

Commencez en lecture seule. Si vous voulez seulement des réponses et des rapports, connectez-vous en lecture seule. Vous pourrez toujours autoriser plus tard une seconde connexion en lecture et écriture.

Profitez du contexte. L’IA se souvient de la conversation : après avoir listé des éléments, vous pouvez dire « Crée maintenant trois sous-tâches sous le premier élément ».

Dépannage

L’écran de consentement n’affiche aucun espace de travail : il faut le rôle de propriétaire ou d’administrateur dans au moins un espace de travail pour autoriser un client MCP. Demandez à un propriétaire de modifier votre rôle ou de configurer la connexion pour vous.

Erreur « Unauthorized » : la clé API a peut-être été révoquée, ou la connexion OAuth a expiré ou perdu ses droits. Créez une nouvelle clé ou reconnectez le connecteur.

L’IA ne peut rien créer ni modifier : la connexion est en lecture seule. Créez une clé Lecture et écriture, ou reconnectez-vous via OAuth sans cocher Grant read-only access.

Les outils de notification sont absents ou échouent : ils nécessitent une connexion OAuth. Les clés API n’appartiennent à aucun utilisateur et n’ont pas de boîte de réception.

L’IA ne semble pas utiliser les outils TskVlo : redémarrez complètement votre client. Avec une configuration JSON, vérifiez qu’elle est valide (pas de virgule en trop, accolades correctes).

Les changements n’apparaissent pas : les données TskVlo sont en direct. Si vous voyez des données périmées, demandez à l’IA de les recharger.