Connecter CrunchJunkie à ChatGPT

Un compte ChatGPT qui peut ajouter un serveur MCP personnalisé, et un compte CrunchJunkie avec un forfait payant actif. La documentation développeur d'OpenAI ne précise pas quels forfaits ChatGPT permettent d'en ajouter un ; elle dit seulement que les règles du compte et de l'espace de travail s'appliquent. Si l'option est absente, demandez à l'administrateur de votre espace de travail ChatGPT. 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. OpenAI a renommé cette zone de ChatGPT plus d'une fois (connecteurs, apps, mode développeur, et maintenant plugins). Ces étapes suivent la documentation développeur actuelle d'OpenAI ; si un libellé diffère sur votre écran, cherchez la même étape.

1. Allez dans ChatGPT Plugins (chatgpt.com/plugins). 2. Cliquez sur le bouton plus, puis sur « Add custom MCP server ». 3. Saisissez un nom et une description. 4. Sous « Connection », saisissez l'URL du connecteur (elle se termine par /mcp, comme OpenAI l'exige pour un point d'accès public). 5. Choisissez l'option OAuth pour l'authentification ; ne choisissez pas « No authentication ». 6. Lisez l'avertissement sur les risques et cliquez sur « I understand and want to continue ». 7. Cliquez sur « Create as a plugin » et passez en revue les outils que ChatGPT a trouvés sur le serveur. Le guide de démarrage d'OpenAI installe un plugin ainsi : ouvrez-le sur la page Plugins et cliquez sur le bouton plus, puis, sur la page d'accueil de ChatGPT, passez l'onglet du haut de Chat à Work, démarrez une nouvelle conversation, tapez @ dans la zone de saisie et sélectionnez le plugin. Nous n'avons pas testé ce parcours nous-mêmes.

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. Selon la documentation d'OpenAI, ChatGPT prend en charge les Client ID Metadata Documents et l'enregistrement dynamique de client pour les serveurs personnalisés, soit les deux méthodes que CrunchJunkie accepte.

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.

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. ChatGPT décide lui-même quels outils du connecteur il affiche, et la documentation d'OpenAI ne dit pas quels forfaits peuvent utiliser les outils d'écriture. Les règles du compte et de l'espace de travail s'appliquent à l'ajout et à l'utilisation de serveurs MCP personnalisés. Si ChatGPT ne liste que des outils de lecture, demandez à l'administrateur de votre espace de travail ChatGPT ; le connecteur propose les mêmes outils à tous les assistants.

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 ChatGPT n'arrive pas à se connecter, vérifiez que l'URL est exactement celle indiquée plus haut, /api/mcp/mcp comprise. Après l'ajout d'outils par CrunchJunkie, cliquez sur « Refresh » sur la connexion dans la page Plugins et démarrez une nouvelle conversation. Les espaces de travail Business et Enterprise peuvent restreindre les serveurs MCP personnalisés ; si l'ajout est bloqué, l'administrateur de l'espace de travail doit l'autoriser. Les autres assistants sont couverts dans la documentation du connecteur.