Connecter CrunchJunkie à Claude Code

Claude Code installé et connecté, et un compte CrunchJunkie avec un forfait payant actif. L'URL du connecteur est https://app.crunchjunkie.io/api/mcp/mcp. Elle est aussi affichée sous Paramètres → Connecter des assistants IA (MCP) dans CrunchJunkie.

Exécutez ceci dans votre terminal : claude mcp add --transport http crunchjunkie https://app.crunchjunkie.io/api/mcp/mcp Le nom (crunchjunkie) est libre. Par défaut, le serveur est enregistré pour vous et pour le projet en cours uniquement. Ajoutez --scope user pour le rendre disponible dans tous vos projets, ou --scope project pour l'écrire dans le fichier .mcp.json du projet, afin que votre équipe le partage (Claude Code demande à chaque personne d'approuver un serveur de projet avant de l'utiliser).

Dans Claude Code, exécutez /mcp et suivez les étapes dans votre navigateur. Depuis un shell, vous pouvez exécuter claude mcp login crunchjunkie à la place. Par SSH, où aucun navigateur local n'est disponible (connectez-vous avec ssh -t pour que l'étape de collage fonctionne), la commande affiche l'URL d'autorisation : ouvrez-la sur votre propre machine, puis collez l'URL de redirection complète, prise dans la barre d'adresse du navigateur, à l'invite. Ajoutez --no-browser pour forcer ce mode. Quand l'assistant utilise le connecteur pour la première fois, il vous envoie vers une page de connexion CrunchJunkie. Vous vous connectez avec votre compte CrunchJunkie, de la même façon qu'à l'application (e-mail et mot de passe, Google ou le SSO de votre entreprise), et vous approuvez l'accès. Il n'y a aucune clé d'API à copier ni à stocker. La connexion est de l'OAuth 2.1 via WorkOS AuthKit, et l'assistant s'enregistre lui-même par enregistrement dynamique de client ou par un Client ID Metadata Document : vous ne saisissez donc ni client ID ni secret. La connexion agit en votre nom et ne voit que ce que votre compte peut voir, dans un seul espace de travail à la fois. Tant que vous n'avez pas choisi, c'est l'espace de travail que vous avez rejoint en premier. Pour en changer, ouvrez Paramètres → Connecter des assistants IA (MCP), ou demandez à l'assistant de lister vos espaces de travail et d'en changer. Si votre entreprise exige le SSO, connectez-vous après vous être connecté avec le SSO. Claude Code stocke les jetons et les renouvelle automatiquement. Pour vous déconnecter, utilisez « Clear authentication » dans le menu /mcp ou exécutez claude mcp logout crunchjunkie.

Démarrez une nouvelle conversation avec le connecteur activé et demandez : « Liste mes clients. » Vous devriez récupérer vos clients CrunchJunkie. Essayez ensuite une vraie question : « Quelle était la visibilité de <brand> dans les réponses IA sur les 30 derniers jours, avec les tailles d'échantillon ? » Remplacez <brand> par l'un de vos clients. La réponse vient de vos données en direct et indique sur combien de réponses IA repose chaque pourcentage. Si l'assistant répond à partir de ses connaissances générales au lieu d'appeler un outil CrunchJunkie, dites-lui d'utiliser le connecteur CrunchJunkie. Exécutez /mcp pour voir si le serveur apparaît comme connecté.

La lecture ne change jamais rien. Les actions d'écriture (créer un rapport, ajouter un widget, suivre un prompt et ce genre d'opérations) sont désactivées tant qu'un propriétaire ou un administrateur de l'espace de travail n'active pas « Autoriser les actions d'écriture » sous Paramètres → Connecter des assistants IA (MCP). Même alors, chaque outil d'écriture renvoie d'abord un aperçu et ne change rien tant que vous ne confirmez pas, et un membre avec le rôle Lecture seule ne peut faire aucune modification. Les règles complètes figurent dans la documentation du connecteur.

La page de connexion CrunchJunkie ne s'ouvre jamais, ou l'assistant dit qu'il n'est pas connecté : retirez le connecteur et ajoutez-le de nouveau, et vérifiez que l'URL est exactement https://app.crunchjunkie.io/api/mcp/mcp. Un outil répond « missing scope » ou « forbidden » : le compte avec lequel vous vous êtes connecté n'a pas de forfait payant actif, ou n'est pas membre de l'espace de travail propriétaire des données. Connectez-vous avec un compte qui y a accès. Si votre compte appartient à plusieurs espaces de travail, l'assistant travaille peut-être dans un autre ; demandez-lui de lister vos espaces de travail. Les outils d'écriture sont refusés : les actions d'écriture sont désactivées par défaut. Un propriétaire ou un administrateur de l'espace de travail les active sous Paramètres → Connecter des assistants IA (MCP). Si le navigateur ne s'ouvre pas, copiez l'URL affichée dans le terminal et ouvrez-la vous-même. Si la redirection échoue avec une erreur de connexion après votre connexion, collez l'URL de rappel complète, prise dans la barre d'adresse, à l'invite de Claude Code. Les exécutions en mode non interactif (claude -p) et celles du Agent SDK ne peuvent pas terminer la connexion : connectez-vous d'abord depuis une session interactive. Pour repartir de zéro, exécutez claude mcp remove crunchjunkie, qui supprime aussi les jetons stockés et l'enregistrement du client, puis ajoutez de nouveau le serveur. Les autres assistants sont couverts dans la documentation du connecteur.