Skip to main content

​
Prérequis

Vous avez besoin de l’un de ces outils IA installé :

​
Obtenir votre token API

ColisMove MCP utilise un portail self-service pour gérer les tokens API personnels : https://mcp-portal.colismove.com.
1

Demander un accès

Envoyez votre adresse email professionnelle à votre tech lead afin qu’un workspace soit créé pour vous. Vous recevrez un email d’invitation depuis noreply@mail.app.supabase.io.
2

Configurer votre compte

Cliquez sur le lien dans l’email d’invitation, définissez un mot de passe : vous serez redirigé vers votre tableau de bord à mcp-portal.colismove.com/dashboard.
3

Générer un token

Ouvrez la page Tokens, cliquez sur Create a token, donnez-lui un nom (par exemple MacBook Pro — Claude Code) et copiez le token affiché à l’écran.Le token est au format cmcp_<64 hex chars>.
Le token complet est affiché une seule fois. Si vous le perdez, révoquez-le depuis le tableau de bord et générez-en un nouveau.
4

Limites de tokens

Vous pouvez avoir jusqu’à 3 tokens actifs simultanément. Révoquez les tokens inutilisés depuis le tableau de bord avant d’en créer un nouveau.Bonne pratique : un token par machine ou par outil IA (Claude Code, Cursor, etc.).

​
Configuration

Remplacez YOUR_API_TOKEN ci-dessous par la valeur cmcp_... générée sur le portail.

​
Option 1 : commande CLI (la plus rapide)

claude mcp add colismove-mcp \
  --transport http \
  --url https://colismove-mcp.onrender.com/mcp \
  --header "Authorization: Bearer YOUR_API_TOKEN"
Ajoutez --scope user pour rendre le serveur accessible depuis n’importe quel répertoire de projet.

​
Option 2 : fichier de config au niveau projet

Créez .mcp.json à la racine de votre projet :
{
  "mcpServers": {
    "colismove-mcp": {
      "type": "http",
      "url": "https://colismove-mcp.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

​
Option 3 : global (tous les projets)

Créez ~/.claude/.mcp.json :
{
  "mcpServers": {
    "colismove-mcp": {
      "type": "http",
      "url": "https://colismove-mcp.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}
Utilisez l’option globale si vous voulez disposer du contexte ColisMove depuis n’importe quel répertoire de projet.

​
Utiliser des variables d’environnement (recommandé)

Pour éviter de coder en dur votre token, utilisez une variable d’environnement : 
{
  "mcpServers": {
    "colismove-mcp": {
      "type": "http",
      "url": "https://colismove-mcp.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer ${COLISMOVE_MCP_TOKEN}"
      }
    }
  }
}
Définissez ensuite la variable dans votre profil shell (~/.zshrc ou ~/.bashrc) : 
export COLISMOVE_MCP_TOKEN="cmcp_your_token_here"

​
Vérifier la connexion

Après la configuration, redémarrez votre outil IA et vérifiez :
Tapez /mcp dans Claude Code. Vous devriez voir colismove-mcp avec un statut vert.Essayez ensuite :
What endpoints exist for bookings?

​
Gérer vos tokens

Rendez-vous à tout moment sur mcp-portal.colismove.com/dashboard/tokens pour :
  • Voir vos tokens actifs (nom, préfixe cmcp_xxxxxxxxxxxx, date de dernière utilisation)
  • Révoquer un token instantanément (recommandé en cas de fuite ou de perte de machine)
  • Créer un nouveau token (jusqu’à 3 tokens actifs)
La révocation prend jusqu’à 60 secondes pour se propager (cache côté serveur). Au-delà, toute requête utilisant le token révoqué renverra 403 Invalid or revoked token.

​
Dépannage

  • Vérifiez que l’URL est exactement https://colismove-mcp.onrender.com/mcp (sans slash final)
  • Vérifiez que votre token commence par cmcp_ et n’a pas été tronqué à la copie
  • Le serveur peut mettre ~30 secondes à démarrer à la première requête (offre Render gratuite)
  • Redémarrez votre outil IA après avoir ajouté la configuration
  • Dans Claude Code, exécutez /mcp pour vérifier le statut du serveur
  • Assurez-vous que le fichier .mcp.json est à la racine du projet ou dans ~/.claude/
  • 401 Missing Authorization → l’en-tête Authorization: Bearer ... est manquant ou vide
  • 403 Invalid or revoked token → le token n’existe pas, a été révoqué ou a expiré. Générez-en un nouveau sur le portail.
  • Vérifiez que le format de l’en-tête est Bearer YOUR_TOKEN (avec une espace après Bearer)
  • Si vous avez committé votre token par erreur dans git, révoquez-le immédiatement depuis le portail
Les tokens sont hachés côté serveur et ne peuvent pas être récupérés. Rendez-vous sur le portail, révoquez celui qui est perdu, puis générez un nouveau token.
  • Assurez-vous d’utiliser l’adresse email fournie lors de votre demande d’accès
  • Utilisez le lien Forgot password sur la page de connexion
  • Si vous n’avez jamais reçu l’email d’invitation, vérifiez vos spams puis demandez à votre tech lead de le renvoyer
Le serveur MCP tourne sur l’offre gratuite de Render. La première requête après une période d’inactivité peut prendre 30 à 60 secondes le temps que le serveur démarre. Les requêtes suivantes sont rapides.