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

1. Ouvrez Réglages (icône engrenage, en bas de la barre latérale).
2. Cliquez sur l'onglet Accès MCP.
3. Donnez un nom à votre token dans le champ « Nom du token » — par exemple Claude — Mon Mac.
4. Cliquez sur Créer un token.
5. 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. Il couvre la gestion de projet (tâches, projets, épopées, cycles, labels), les réglages (entreprise, marques, membres), les domaines/DNS, vos dashsites, la trésorerie en lecture et vos certifications.

É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.

Tâches

Projets, épopées, cycles, labels

Entreprise & marques

Sites, domaines & finance (lecture)

Conformité (module Certifications, plan Pro)

Produits, stock & commandes (module Boutique)

Un produit doit être rattaché à une marque pour avoir un stock. La vente au comptoir, qui rattache une sortie à une commande, reste réservée au scan depuis l'application collaborateur.

Multi-entreprises : update_org et update_business_unit acceptent un org_id optionnel — vous pouvez modifier une autre entreprise dont vous êtes owner/admin (vérifié à chaque appel). Sinon l'action s'applique à l'entreprise du token.

🔜 Bientôt via MCP : le CRM (clients, contacts, affaires), la facturation (devis, factures) et la base de connaissances Cortex seront prochainement pilotables depuis votre client MCP — aujourd'hui ils restent accessibles depuis l'assistant intégré à Tracky.

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 une épopée "Refonte site" dans le projet Web et ajoute-lui 5 tâches »
• « Restreins Marie à la marque Studio »
• « Quels produits sont sous leur seuil d'alerte ? »
• « J'ai reçu 12 bougies parfumées, mets le stock à jour »
• « Quelles commandes sont payées mais pas encore expédiées ? »

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.