Connecter CrunchJunkie à VS Code (GitHub Copilot)

VS Code avec ses fonctions d'IA activées (conversation GitHub Copilot) et un compte CrunchJunkie avec un forfait payant actif. La documentation de VS Code n'indique aucun forfait requis pour les serveurs MCP, mais précise que votre organisation peut restreindre les serveurs disponibles. 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. Ouvrez la palette de commandes et exécutez « MCP: Add Server ». 2. Choisissez « HTTP (HTTP or Server-Sent Events) ». 3. Saisissez l'URL du connecteur comme point d'accès MCP. 4. Saisissez un identifiant de serveur qui n'est pas déjà utilisé, par exemple crunchjunkie. 5. Choisissez où l'enregistrer. Pour une configuration personnelle, prenez « Global », puis le choix suivant que propose VS Code (c'était « Copilot Global » à la lecture de la page). Pour la partager avec une équipe, VS Code décrit un fichier .mcp.json à la racine de l'espace de travail, qui est expérimental et se trouve derrière le réglage chat.mcp.workspaceRootConfig.enabled. VS Code écrit le serveur dans le fichier de configuration que vous avez choisi. Sa documentation renvoie à sa référence de configuration MCP pour le format exact du fichier.

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. La documentation de VS Code dit seulement de suivre les instructions de connexion de l'éditeur si un serveur demande une authentification : l'invite exacte peut donc différer de ce qui est décrit ici.

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. Posez-la dans une session d'agent d'une conversation Copilot, et vérifiez que l'appel d'outil indique le serveur CrunchJunkie comme source.

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 « MCP: Add Server » est absent, vérifiez que les fonctions d'IA sont activées et que vous avez ouvert un dossier de projet. Si votre organisation restreint les serveurs MCP, un administrateur doit autoriser cette URL. Les autres assistants sont couverts dans la documentation du connecteur.