Connecter CrunchJunkie à Claude (web, bureau et mobile)

Un compte Claude et un compte CrunchJunkie avec un forfait payant actif. Selon Anthropic, les connecteurs personnalisés sont disponibles avec les forfaits Free, Pro, Max, Team et Enterprise ; Free est limité à un seul connecteur personnalisé. Avec Team et Enterprise, un Owner de l'organisation (avec Enterprise, aussi une personne ayant un rôle personnalisé qui inclut Manage access to Libraries) ajoute le connecteur une fois, puis chaque membre se connecte individuellement. 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.

1. Dans Claude, allez dans Customize → Connectors. 2. Cliquez sur "+ Add", puis sur "Add custom connector". 3. Saisissez un nom (par exemple CrunchJunkie) et collez l'URL du connecteur, puis cliquez sur "Continue". 4. Vérifiez les réglages d'authentification détectés et cliquez de nouveau sur "Continue". Choisissez l'une des options de connexion (pas "No sign in") et, si une option de client OAuth est proposée, gardez celle que Claude marque comme recommandée. 5. Cliquez sur "Add". L'application de bureau Claude utilise les connecteurs de votre compte Claude : il n'y a donc rien à configurer à part là-bas. L'article d'Anthropic ne documente aucune configuration séparée pour les applications mobiles ; ajoutez le connecteur sur le web ou dans l'application de bureau.

Un Owner va dans Organization settings → Connectors, clique sur "Add", survole "Custom", sélectionne "Web" et renseigne le nom et l'URL comme ci-dessus. Les membres ouvrent ensuite Customize → Connectors, trouvent le connecteur (généralement libellé "Custom") et cliquent sur "Connect". Chaque membre se connecte avec son propre compte CrunchJunkie : Claude n'atteint donc que ce que cette personne peut voir.

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.

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. Dans une conversation, vous pouvez activer ou désactiver le connecteur avec le bouton "+" puis "Connectors".

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). Claude se connecte depuis les serveurs d'Anthropic, pas depuis votre ordinateur : l'URL du connecteur doit donc être joignable depuis Internet. Celle de CrunchJunkie l'est. Avec Team et Enterprise, si vous ne trouvez pas le connecteur sous Customize → Connectors, demandez à un Owner s'il a été ajouté pour votre organisation. Les autres assistants sont couverts dans la documentation du connecteur.