Aide/Assistant IA

Connecter Claude ou Cursor à votre backlog Tracky (MCP)

Tracky expose un serveur MCP distant (Model Context Protocol) que vous pouvez brancher directement dans Claude Desktop, Claude Code, Cursor ou tout autre client compatible. Une fois connecté, votre assistant IA peut lire et mettre à jour vos tâches, projets et backlog — en langage naturel, sans quitter votre outil de travail.

Cette fonctionnalité est réservée aux propriétaires et administrateurs de l'entreprise.

Étape 1 — Créer un token d'accès dans Tracky

Ouvrez Réglages (icône engrenage, en bas de la barre latérale).
Cliquez sur l'onglet Accès MCP.
Donnez un nom à votre token dans le champ « Nom du token » — par exemple Claude — Mon Mac.
Cliquez sur Créer un token.
Copiez immédiatement le token affiché (trk_…) : il ne sera plus jamais montré. Stockez-le dans un gestionnaire de mots de passe.

Chaque token est scopé à votre entreprise : il ne donne accès qu'à vos données, et uniquement sur le domaine tâches. Clients, factures et devis restent en lecture seule.

Étape 2 — Configurer votre client MCP

Claude Desktop

Ouvrez le fichier de configuration de Claude Desktop (accessible via Fichier > Modifier la configuration ou ~/Library/Application Support/Claude/claude_desktop_config.json sur Mac) et ajoutez le serveur :

{
  "mcpServers": {
    "tracky": {
      "type": "http",
      "url": "https://kxrbnbfuwhmqnnywjsnq.supabase.co/functions/v1/mcp",
      "headers": {
        "Authorization": "Bearer trk_VOTRE_TOKEN"
      }
    }
  }
}

Remplacez trk_VOTRE_TOKEN par le token copié à l'étape 1. Relancez Claude Desktop pour que la configuration soit prise en compte.

Claude Code (extension VS Code / CLI)

Dans .mcp.json à la racine de votre projet :

{
  "mcpServers": {
    "tracky": {
      "type": "http",
      "url": "https://kxrbnbfuwhmqnnywjsnq.supabase.co/functions/v1/mcp",
      "headers": {
        "Authorization": "Bearer trk_VOTRE_TOKEN"
      }
    }
  }
}

Cursor

Dans Settings › Tools & Integrations › MCP, ajoutez un nouveau serveur avec l'URL et le header ci-dessus.

Autres clients (n'importe quel client Streamable HTTP MCP)

L'URL du serveur MCP est visible directement dans Tracky, dans Réglages › Accès MCP. Tout client supportant le transport HTTP avec header Authorization: Bearer peut s'y connecter.

Ce que votre assistant peut faire via MCP

Une fois connecté, l'assistant accède aux outils suivants :

Outil	Description
`list_backlog`	Lister les tâches (avec filtres : statut, projet, assigné…)
`create_task`	Créer une tâche (titre, statut, priorité, projet, description…)
`update_task`	Modifier une tâche existante
`delete_task`	Supprimer une tâche (irréversible)
`bulk_update_tasks`	Mise à jour groupée (grooming de sprint)
`create_project`	Créer un projet
`update_project`	Modifier un projet
`delete_project`	Supprimer un projet
`update_org`	Modifier les réglages de l'entreprise (nom, URL de réservation Cal.com)
`update_business_unit`	Modifier tous les réglages d'une marque (nom, couleur, logo, infos légales : raison sociale, SIRET, TVA, IBAN/BIC, conditions de paiement, mentions, forme juridique, médiateur, pénalités, objectif de CA)
`list_members`	Lister les membres (user_id, email, rôle)
`update_member_role`	Changer le rôle d'un membre (admin / member / commercial / comptable / lecteur)
`set_member_marques`	Restreindre un membre à certaines marques (portée par marque)
`query_table`	Lire n'importe quelle table (lecture seule)
`org_overview`	Vue d'ensemble de l'entreprise
`list_orgs`	Lister les entreprises accessibles
`tracky_catalog`	Décrire le schéma disponible

Cortex (base de connaissances)

L'assistant peut aussi lire et écrire dans votre base de connaissances Cortex (documents, versions, liens, rattachements) :

Outil	Description
`cortex_list_docs`	Lister les documents (arborescence ; archivés optionnels)
`cortex_get_doc`	Lire un document, contenu inclus
`cortex_search`	Recherche plein-texte (français) dans les documents
`cortex_list_versions`	Lister l'historique des versions d'un document
`cortex_get_backlinks`	Lister les documents qui mentionnent une fiche (rétroliens)
`cortex_list_attachments`	Lister les documents rattachés à une fiche
`cortex_create_doc`	Créer un document (titre, icône, parent, contenu)
`cortex_update_doc`	Renommer un document ou changer son icône
`cortex_save_content`	Écrire le contenu d'un document (liens et version mis à jour)
`cortex_move_doc`	Déplacer/imbriquer un document dans l'arbo
`cortex_archive_doc`	Archiver un document (réversible)
`cortex_restore_doc`	Désarchiver un document
`cortex_restore_version`	Restaurer une version antérieure
`cortex_attach_doc`	Rattacher un document à une fiche (client, projet, facture, devis, tâche)
`cortex_detach_doc`	Détacher un document d'une fiche

Multi-entreprises : update_org et update_business_unit acceptent un org_id optionnel. Vous pouvez ainsi modifier les réglages d'une autre entreprise que celle de la connexion — à condition d'en être owner ou admin (vérifié à chaque appel). Sinon, l'action s'applique à l'entreprise de votre token.

Exemples de phrases que vous pouvez taper dans Claude une fois connecté :

« Montre-moi les tâches en cours dans le projet site web »
« Crée une tâche "Préparer la démo client" priorité haute dans le projet Commercial »
« Quelles tâches n'ont pas été touchées depuis une semaine ? »
« Marque la tâche SITE-42 comme terminée »
« Change la couleur de la marque … en #2bd673 et mets à jour son SIRET »
« Crée dans Cortex une fiche méthode pour l'onboarding et rattache-la au client Dupont SA »

Sécurité

Le token est stocké hashé côté Tracky (SHA-256) : même en cas de compromission de la base, le secret n'est pas récupérable.
Chaque appel est journalisé dans l'audit MCP, visible par les admins.
Si un token est perdu ou compromis : révoquez-le immédiatement dans Réglages › Accès MCP (bouton « Révoquer » sur la ligne correspondante), puis créez-en un nouveau.
Un token révoqué est immédiatement inopérant : toute requête en cours ou future avec ce token sera rejetée.
Ne partagez jamais un token entre plusieurs machines : créez un token par poste de travail pour pouvoir révoquer précisément.

Résoudre les problèmes courants

L'assistant dit « non autorisé » ou « 401 » Vérifiez que le token commence bien par trk_ et que vous l'avez copié en entier. Le header doit être exactement Authorization: Bearer trk_… (avec l'espace après Bearer).

L'assistant ne voit pas mes tâches Assurez-vous d'être connecté en tant qu'owner ou admin. Vérifiez que le token n'est pas révoqué dans Réglages › Accès MCP.

Je ne trouve pas l'onglet Accès MCP Cet onglet n'est visible que si vous êtes propriétaire ou administrateur de l'entreprise. Demandez à un admin de créer le token pour vous.

Besoin d'aide ? Contactez le support.

Cet article vous a aidé ? Pour toute autre question : support@dashspace.space.