Connecter CrunchJunkie à Cursor

Cursor et un compte CrunchJunkie avec un forfait payant actif. La documentation de Cursor ne lie pas les serveurs MCP distants à un forfait Cursor particulier ; les équipes peuvent restreindre les serveurs avec une liste d'autorisation, il se peut donc qu'un administrateur doive approuver l'URL. 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.

Cursor lit les serveurs MCP dans un fichier mcp.json : ~/.cursor/mcp.json pour tous les projets, ou .cursor/mcp.json dans un projet. Ajoutez le serveur avec la clé url : { "mcpServers": { "crunchjunkie": { "url": "https://app.crunchjunkie.io/api/mcp/mcp" } } } N'ajoutez ni en-têtes ni bloc auth. CrunchJunkie prend en charge l'enregistrement dynamique de client, que Cursor utilise par défaut pour les serveurs qui demandent de l'OAuth. Vous pouvez aussi gérer les serveurs MCP depuis Customize dans la barre latérale de Cursor.

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 de Cursor, Cursor gère l'authentification des serveurs qui prennent en charge OAuth, mais elle ne décrit pas l'invite elle-même. Si aucune connexion ne démarre, ouvrez le serveur dans les réglages MCP de Cursor et cherchez un bouton pour vous connecter.

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. Utilisez la conversation avec l'agent, pas une modification en ligne.

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). Pour voir les erreurs de connexion, ouvrez le panneau Output (Cmd+Shift+U sur macOS) et sélectionnez « MCP Logs ». Vérifiez que le JSON est valide et que le fichier est au bon endroit. Les autres assistants sont couverts dans la documentation du connecteur.