Connecter Claude Code à votre studio

De quoi s’agit-il

Claude Code est Claude, le modèle d’Anthropic qui s’exécute dans le terminal de votre ordinateur. Grâce au connecteur d’IA, il consulte les données de votre studio (ventes, clients, agenda, finances) lorsque vous lui posez une question, avec les autorisations de l’utilisateur associé à la clé. Il se contente de consulter les données : il ne modifie rien dans le système.

Quand l’utiliser

Vous utilisez déjà Claude Code sur votre ordinateur et souhaitez consulter l’activité de votre studio sans le quitter.
Vous souhaitez créer un récapitulatif ou un tableur avec les chiffres du système en formulant votre demande en langage naturel.

Avant de commencer

Munissez-vous de l’adresse du connecteur, copiée en suivant l’article Connecter votre IA. Claude Code doit être installé sur votre ordinateur. La connexion se fait avec le compte du système ; la clé API est facultative, si vous préférez ne pas utiliser votre compte (par exemple, sur un ordinateur sans navigateur).

Étape par étape

Étape 1 — Ajouter le connecteur

Dans le terminal, exécutez la commande ci-dessous en remplaçant l’adresse par celle que vous avez copiée avec Copier l’adresse :

claude mcp add --transport http heya https://seu-dominio/mcp

Dans Claude Code, saisissez /mcp, sélectionnez heya, puis choisissez l’option d’authentification. La page de connexion au système s’ouvre dans le navigateur. Connectez-vous, sélectionnez Entreprise et cliquez sur Autoriser.

Si vous préférez utiliser une clé API (créée avec Autoriser l’utilisation comme connecteur d’IA), ajoutez l’en-tête à la commande : --header "Authorization: Bearer hk_...".

Pour utiliser le connecteur dans tous les dossiers de votre ordinateur, et pas seulement dans le dossier actuel, ajoutez --scope user à la commande.

Étape 2 — Vérifier la connexion

Exécutez claude mcp list. Le connecteur heya doit apparaître comme connecté. Dans Claude Code, la commande /mcp affiche la même information.

Étape 3 — Poser une question

Ouvrez Claude Code et posez une question, par exemple : « Combien ai-je vendu hier au studio ? ». La première fois, Claude peut vous demander l’autorisation d’utiliser les outils du connecteur.

Et ensuite

Claude sélectionne la requête adaptée à votre question, l’exécute et vous répond avec les chiffres du système.
La clé apparaît dans l’onglet API Key, où Dernière utilisation est mis à jour.
Pour couper l’accès, révoquez la clé dans l’onglet API Key : Claude Code perdra l’accès sous 30 secondes.

Erreurs fréquentes et questions

Q: claude mcp list affiche « Failed to connect ». Que faire ? R: Vérifiez que l’adresse se termine par /mcp et que la clé a été copiée en entier, avec Bearer suivi d’une espace. La commande enregistre la configuration sans tester la clé : l’erreur n’apparaît que lorsque Claude tente de se connecter.

Q: Claude indique que la clé doit avoir l’option « Permitir uso como conector de IA ». Pourquoi ? R: La clé a été créée sans cette option. Modifiez-la dans l’onglet API Key et cochez Autoriser l’utilisation comme connecteur d’IA.

Q: Comment changer de clé ? R: Supprimez le connecteur avec claude mcp remove heya, puis ajoutez-le à nouveau avec la nouvelle clé.

Q: Puis-je partager la configuration avec mon équipe dans le dépôt ? R: Ne placez pas la clé dans un fichier partagé (--scope project l’enregistre dans .mcp.json). Chaque personne doit utiliser sa propre clé, avec les autorisations de son propre compte.

Q: Claude indique qu’il n’a pas trouvé une information que je vois dans le système. Pourquoi ? R: L’utilisateur associé à la clé n’a pas accès à cet écran, ou celui-ci est exclu du connecteur pour des raisons de sécurité (conversations WhatsApp, anamnèse, photos et compte numérique). Consultez l’article Connecteur d’IA.