Guide · MCP pour développeurs
Suivez votre visibilité IA depuis Claude Code et Codex
Une commande terminal connecte votre agent de code à Howseen. Demandez-lui ensuite, en langage naturel, quelles questions d'acheteurs ChatGPT, Gemini, Perplexity et Google AI répondent en citant un concurrent à votre place, et que corriger en priorité.
Claude Code
Codex
Par Raphaël Aubry, fondateur de Howseen AI · Mis à jour le Réponse courte
Comment suivre ma visibilité IA depuis Claude Code ou Codex ?
Créez une clé API Howseen, ajoutez le serveur MCP Howseen avec une commande, puis demandez à votre agent quelles questions d'acheteurs citent un concurrent à votre place.
Le serveur MCP Howseen se trouve à l'adresse https://app.howseen.ai/api/mcp et utilise le protocole Streamable HTTP, donc les deux agents s'y connectent comme à n'importe quel serveur distant. Il donne à votre agent accès à 26 outils sur vos données Howseen : le même pourcentage de visibilité, les mêmes concurrents et sources citées que votre tableau de bord, pour vos propres marques uniquement. Les outils de lecture fonctionnent avec n'importe quelle clé ; les outils d'action ne s'exécutent qu'après un aperçu et votre confirmation.
« MCP (Model Context Protocol) est un standard open source pour connecter des applications d'IA à des systèmes externes. »
Pourquoi le terminal
Pourquoi développeurs et agences veulent ces données près de leur code
La personne capable de corriger un écart de visibilité (une page, un tableau comparatif, une section de documentation) travaille généralement dans le dépôt de code. Mettre l'écart dans le même terminal supprime l'aller-retour vers le tableau de bord.
- De l'écart à la pull request. Demandez quelle question vous perdez, puis demandez au même agent d'écrire ou de mettre à jour la page qui y répond, dans votre propre base de code.
- Agences, une clé pour chaque client. L'outil
list_brandsrenvoie toutes les marques de votre compte Howseen, vous pouvez donc passer en revue tous vos clients en une seule session. Voir GEO pour les agences. - Des données réelles, pas des suppositions. Votre agent lit les réponses réellement collectées par Howseen auprès de ChatGPT, Gemini, Perplexity, Google AI Overviews et Google AI Mode, au lieu de deviner ce que l'IA dit de vous.
Si la notion de visibilité IA est nouvelle pour vous, lisez d'abord ce qu'est le GEO (generative engine optimization) et comment l'IA choisit les marques à recommander.
Exemple concret
À quoi cela ressemble sur notre propre marque
Le 6 octobre 2026, nous avons interrogé Claude, connecté via le serveur MCP Howseen, sur Howseen lui-même, à partir de notre scan du 5 octobre. La réponse n'était pas flatteuse, et c'est bien là le but.
Questions d'acheteurs où un concurrent était cité et pas nous
90%
45 questions suivies sur 50
Visibilité Howseen
4%
Scan du 5 octobre 2026
Réponses perdues citant la page n°1
19
Un article « meilleur outil de visibilité IA » sur Zapier
La partie utile, c'est le dernier chiffre. La page la plus souvent citée dans les réponses que nous avons perdues était un article tiers de type liste, donc la première correction consiste à s'y faire lister, pas à réécrire notre page d'accueil. Les moteurs font confiance à des sources différentes : notre étude de 5 331 réponses IA a trouvé YouTube cité dans 45 % des Google AI Overviews et dans 0 des 1 164 réponses ChatGPT. Pour comparer les outils sur ce type de données, voir outils de visibilité IA.
Configuration 1
Connecter Claude Code
Une seule commande claude mcp add enregistre le serveur Howseen pour votre compte utilisateur, il est donc disponible dans tous vos projets. Tapez ensuite /mcp dans Claude Code pour vérifier qu'il est bien connecté.
- Créez une clé. Dans Howseen, ouvrez Paramètres > "API & assistants IA" (app.howseen.ai/settings?tab=api). La clé commence par
hs_live_et ne s'affiche qu'une seule fois, copiez-la donc immédiatement. - Exécutez ceci dans votre terminal, en remplaçant
hs_live_YOUR_KEYpar votre clé :
claude mcp add --scope user --transport http howseen https://app.howseen.ai/api/mcp \
--header "Authorization: Bearer hs_live_YOUR_KEY"- Vérifiez. Lancez Claude Code et tapez
/mcp. Le serveurhowseendoit s'afficher comme connecté. Nous avons exécuté exactement cette commande le 6 octobre 2026 et obtenu "Connected".
Pourquoi --scope user : la documentation d'Anthropic indique que cette portée stocke le serveur dans ~/.claude.json et le rend disponible dans tous vos projets tout en le gardant privé à votre compte utilisateur. La portée projet, elle, est conçue pour être partagée via le contrôle de version, ce qui n'est pas le bon endroit pour une clé. Source : Connect Claude Code to tools via MCP.
Configuration 2
Connecter Codex
Codex lit le jeton d'authentification depuis une variable d'environnement, ce qui garde votre clé hors du fichier de configuration de Codex. Exportez la clé, puis exécutez codex mcp add une seule fois.
export HOWSEEN_API_KEY=hs_live_YOUR_KEY
codex mcp add howseen --url https://app.howseen.ai/api/mcp --bearer-token-env-var HOWSEEN_API_KEYAjoutez la ligne export à votre profil shell (par exemple ~/.zshrc ou ~/.bashrc) pour que la clé reste disponible lors de votre prochaine session de terminal. Pour vérifier la configuration, exécutez codex mcp list, ou tapez /mcp dans Codex.
Vous préférez modifier le fichier directement ? Le même serveur dans ~/.codex/config.toml :
[mcp_servers.howseen]
url = "https://app.howseen.ai/api/mcp"
bearer_token_env_var = "HOWSEEN_API_KEY"Les options --url et --bearer-token-env-var ainsi que les clés url et bearer_token_env_var proviennent de la documentation Codex d'OpenAI : Model Context Protocol (MCP) for Codex.
Que demander
7 prompts qui fonctionnent
Pas besoin de connaître le nom des outils. Posez votre question simplement et votre agent choisit lui-même le bon outil Howseen. En voici sept qui fonctionnent bien.
| Vous demandez | Outil déclenché |
|---|---|
| "Quelles questions d'acheteurs citent un concurrent mais pas nous ?" | get_prompt_gaps |
| "Sur quels sites devrions-nous être référencés en priorité ?" | get_easiest_wins |
| "Qu'est-ce qui a changé depuis notre dernier scan, moteur par moteur ?" | get_changes |
| "Qui sont nos principaux concurrents dans les réponses IA en ce moment ?" | get_competitors |
| "Montrez-moi ce que ChatGPT dit exactement quand il cite un concurrent." | search_responses |
| "Rédigez l'article qui comble notre plus gros écart." | draft_article (clé avec actions, prévisualisé d'abord) |
| "Donnez-moi le bilan de la semaine." | prompt weekly_review |
Les agences peuvent aussi utiliser le prompt client_report (visibilité, concurrents et un lien de partage) pour chaque marque cliente. La liste complète des 26 outils se trouve sur la page MCP de Howseen.
Permissions
Lecture seule par défaut, actions uniquement après votre confirmation
Une clé standard ne fait que lire. Pour permettre à votre agent de modifier quelque chose, créez une clé avec les actions activées ; même dans ce cas, chaque modification est présentée en aperçu et n'a lieu qu'après votre confirmation.
| Clé | Ce que votre agent peut faire |
|---|---|
| Lecture seule (par défaut) | Visibilité, écarts, concurrents, sources citées, extraits réels des réponses, articles, utilisation, marques |
| Avec actions | Suivre ou archiver des questions, ajouter ou supprimer des concurrents, mettre à jour le plan d'action, rédiger un article, lancer un scan, créer un lien de rapport client, publier un article et demander son indexation, chacun prévisualisé puis confirmé |
Les limites de votre offre s'appliquent exactement comme dans l'application, et chaque modification appliquée est listée dans Paramètres sous « Actions effectuées par votre IA ».
Sécurité
Gardez votre clé hors de votre dépôt
Traitez une clé Howseen comme un mot de passe. Conservez-la dans une variable d'environnement ou votre configuration utilisateur, jamais dans un fichier versionné, et révoquez-la dans Paramètres dès qu'elle fuite.
- Ne la committez jamais. Ne collez pas la clé dans un fichier
.mcp.jsonde projet, un README ou un script envoyé sur Git. Avec Claude Code, utilisez--scope user; avec Codex, utilisez--bearer-token-env-var. - Faites attention à vos dotfiles. Si vous synchronisez
~/.zshrcou~/.claude.jsonvers un dépôt public, déplacez la clé dans un fichier qui n'est pas synchronisé. - Évitez la forme URL ici. L'option
?key=existe pour les clients qui ne peuvent pas envoyer d'en-têtes. Claude Code et Codex le peuvent tous les deux, utilisez donc l'en-tête ou la variable d'environnement. - Révoquez en un clic. Chaque clé peut être révoquée à tout moment dans Paramètres > "API & assistants IA". Howseen ne conserve qu'un hash de votre clé, jamais la clé elle-même.
- Limites de débit. 120 requêtes par minute et 5 000 par jour, par clé.
Automatisation
Utilisez-la en CI ou dans des scripts
Pour une tâche nocturne, une vérification CI ou un tableau de bord client, passez outre l'agent et appelez directement l'API REST en lecture seule, avec la même clé et les mêmes données.
L'API REST renvoie du JSON avec des filtres de plage de dates et de moteur, ainsi que de la pagination. Stockez la clé comme secret CI, jamais dans le fichier de workflow. Les endpoints et un exemple curl se trouvent dans la section API REST de la page MCP.
Tarifs
Ce que ça coûte
Le serveur MCP est inclus dans Pro (79 € par site et par mois) et Business, ainsi que pendant l'essai gratuit de 3 jours, voir tarifs par marque.
Pas encore prêt pour un essai ? Obtenez d'abord un rapport IA gratuit : sans carte, environ 2 minutes.
Questions, réponses
Puis-je utiliser le serveur MCP Howseen avec Claude Code et Codex ?+
Oui. Le serveur est un serveur MCP distant standard sur Streamable HTTP à l'adresse https://app.howseen.ai/api/mcp. Claude Code se connecte avec une commande claude mcp add et Codex avec une commande codex mcp add, et vous pouvez utiliser la même clé dans les deux.
Comment vérifier que Claude Code est connecté à Howseen ?+
Tapez /mcp dans Claude Code. Cela liste vos serveurs MCP configurés ainsi que leur statut de connexion, et le serveur howseen doit s'afficher comme connecté. Avec Codex, exécutez codex mcp list ou tapez /mcp dans Codex.
Où Codex stocke-t-il ma clé Howseen ?+
Nulle part, si vous suivez ce guide. La configuration ne fait que nommer la variable d'environnement (bearer_token_env_var = "HOWSEEN_API_KEY"), et Codex lit la clé depuis cette variable. Gardez la ligne export dans votre profil shell pour que la variable existe à chaque session.
Mon agent de code peut-il modifier mon compte Howseen ?+
Uniquement avec une clé dont les actions sont activées. Les clés sont en lecture seule par défaut. Avec les actions activées, chaque modification (suivi de questions, rédaction ou publication d'un article, lancement d'un scan) est d'abord présentée en aperçu et n'a lieu qu'après votre confirmation.
Que se passe-t-il si ma clé fuite ?+
Révoquez-la dans Paramètres Howseen > "API & assistants IA" et créez-en une nouvelle. Howseen ne stocke qu'un hash de votre clé, l'affiche une seule fois, et chaque clé ne voit que les marques du compte qui l'a créée.
Y a-t-il des limites de débit ?+
Oui : 120 requêtes par minute et 5 000 par jour, par clé. Un usage normal depuis un agent reste largement en dessous.
Les agences peuvent-elles suivre plusieurs marques clientes depuis un seul terminal ?+
Oui. L'outil list_brands renvoie toutes les marques suivies dans votre compte Howseen, une seule clé couvre donc tous vos clients, et le prompt client_report génère un rapport avec un lien de partage pour chaque marque. Vous pouvez aussi créer une clé limitée à une seule marque.
Quelles offres l'incluent ?+
Le serveur MCP et l'API REST sont inclus dans le forfait Pro (79 euros par site et par mois) et Business (à partir de 219 euros), ainsi que pendant l'essai gratuit de 3 jours. Pour un premier aperçu, le rapport IA gratuit ne nécessite aucune carte et prend environ 2 minutes.
Demandez à votre agent qui l'IA recommande à votre place
Lancez l'essai gratuit de 3 jours, créez votre clé, exécutez une commande, et posez votre première question dans Claude Code ou Codex. Toute la configuration prend quelques minutes.
