Nouveau · serveur MCP + API REST
Howseen MCP : découvrez où l'IA choisit votre concurrent plutôt que vous
Demandez à Claude, ChatGPT ou Cursor quelles questions d'acheteurs citent un concurrent plutôt que votre marque, puis corrigez-le depuis la même conversation. Nous l'avons d'abord testé sur notre propre marque : le 5 octobre 2026, 45 de nos 50 questions suivies citaient un concurrent et non nous.
Chaque modification vous est présentée avant d'être appliquée. Rien ne se passe tant que vous ne confirmez pas.
Claude & Claude Code
ChatGPT & Codex
Cursor
Par Raphaël Aubry, fondateur de Howseen AI · Mis à jour le Aperçu
Qu'est-ce que le serveur Howseen MCP ?
Le serveur Howseen MCP permet à Claude, ChatGPT ou Cursor de lire vos données de visibilité IA Howseen et, si vous l'autorisez, d'agir dessus. Les clés sont en lecture seule par défaut ; rien ne change tant que vous n'avez pas créé une clé avec les actions activées et confirmé chaque modification.
Howseen suit la façon dont ChatGPT, Gemini, Perplexity, Google AI Overviews et Google AI Mode répondent aux questions de vos acheteurs : citent-ils votre marque, quels concurrents citent-ils à la place, et quelles sources utilisent-ils. Si vous découvrez ce sujet, commencez par ce qu'est le GEO (generative engine optimization) et comment l'IA choisit les marques à recommander.
Jusqu'à présent, ces données vivaient dans le tableau de bord. Le serveur MCP les apporte directement dans l'assistant IA que vous utilisez déjà. Il parle le Model Context Protocol, le standard ouvert que les applications IA utilisent pour se connecter à des données externes :
« Pensez au MCP comme à un port USB-C pour les applications IA. »
Anthropic a rendu le protocole open source en novembre 2024 (annonce), et OpenAI documente comment ses modèles se connectent à des serveurs MCP distants (guide MCP d'OpenAI). Les chiffres que votre assistant obtient depuis Howseen sont les mêmes que ceux de votre tableau de bord, uniquement pour vos propres marques.
Cas d'usage
Repérez l'écart. Puis comblez-le.
Chaque question d'acheteur perdue est une recommandation offerte à quelqu'un d'autre. Votre assistant vous montre où ChatGPT, Gemini, Perplexity et Google AI citent vos concurrents à votre place, en quels sites ces réponses font confiance, et vous aide à reconquérir la question.
| Vous demandez | Ce qui se passe |
|---|---|
| « Quelles questions d'acheteurs citent mes concurrents et pas moi ? » | Il liste précisément les questions où vous perdez, moteur par moteur |
| « Sur quels sites devrais-je figurer en priorité ? » | Il classe les sites déjà cités par l'IA dans ces réponses, en commençant par les plus faciles à obtenir |
| « Qu'est-ce qui a changé depuis mon dernier scan ? » | Il vous indique ce qui a bougé et la raison probable |
| « Rédige l'article qui comble mon plus gros écart, puis publie-le. » | Il rédige l'article, vous le soumet, et ne le publie qu'après votre accord |
Nouveau ici ? Démarrez votre essai gratuit de 3 jours, le serveur MCP est inclus. Déjà client Howseen ? Créez votre clé dans Paramètres > API & assistants IA.
Preuve
La preuve, testée sur nous-mêmes
Le 5 octobre 2026, sur 50 vraies questions d'acheteurs, un concurrent était cité dans 45 d'entre elles et pas Howseen. Notre visibilité était de 4 %.
Nous n'avons pas encore d'étude de cas client à présenter, alors nous avons pointé Howseen sur Howseen. La même réponse ne s'est pas arrêtée au constat : elle a renvoyé une liste classée des sites tiers déjà cités dans ces réponses perdues, ceux sur lesquels travailler en priorité.
Pour la tendance plus large, notre étude publique de 5 331 réponses IA a révélé que YouTube était cité dans 45 % des Google AI Overviews et dans 0 des 1 164 réponses ChatGPT. Chaque moteur fait confiance à des sources différentes, c'est pourquoi vous devez les examiner une à une.
Référence
Les 26 outils
Les outils de lecture fonctionnent avec n'importe quelle clé. Les outils d'action nécessitent une clé avec les actions activées, et chaque modification vous est présentée avant confirmation. Votre assistant choisit lui-même le bon outil, selon la question que vous posez.
| Outil | Ce qu'il fait |
|---|---|
| Repérer l'écart (n'importe quelle clé) | |
get_changes | Ce qui a changé entre vos deux derniers scans, par moteur IA |
get_prompt_gaps | Questions où un concurrent est cité et pas vous |
get_easiest_wins | Les sites cités par l'IA dans ces réponses, classés, les plus faciles en premier |
get_action_plan | Vos meilleures prochaines actions |
get_visibility | Taux de visibilité, part de voix, position moyenne et tendance, par moteur |
get_competitors | Classement des concurrents par visibilité |
get_top_sources | Domaines et URLs les plus cités, par moteur |
search_responses | Extraits réels de réponses IA avec leurs citations |
list_prompts | Les questions d'acheteurs que vous suivez |
list_articles | Articles rédigés par Howseen pour la marque |
get_article_performance | La façon dont vos articles sont indexés sur Google et Bing |
suggest_prompts | De vraies questions d'acheteurs que vous ne suivez pas encore |
get_usage | Votre plan, vos quotas et ce que votre clé peut faire |
list_brands | Les marques suivies dans votre compte |
| Combler l'écart (clé avec actions activées, prévisualisation puis confirmation) | |
add_prompts, archive_prompts, remove_prompts | Choisir les questions que vous suivez |
add_competitor, remove_competitor | Choisir à qui vous vous comparez |
mark_action_done, dismiss_action | Tenir votre plan d'action à jour |
draft_article | Un brouillon qui répond à une question d'acheteur (jamais publié automatiquement) |
run_scan | Actualiser vos données, même limite que le bouton Lancer maintenant |
create_share_report | Un lien de rapport prêt à partager avec vos clients, à l'image de votre agence |
| Publier (prévisualisation puis confirmation) | |
publish_article | Publier un brouillon sur votre CMS connecté (WordPress, Shopify, Ghost, BigCommerce, webhook) ou sur votre blog hébergé par Howseen, immédiatement ou à une date programmée |
request_indexing | Demander à Google et Bing d'indexer la nouvelle page |
Prompts prêts à l'emploi : weekly_review (ce qui a changé, vos écarts, vos victoires les plus faciles, quoi faire cette semaine) et client_report (visibilité, concurrents et un lien de partage).
Configuration
Configurez-le en 2 minutes
Créez une clé API personnelle dans Howseen, collez la configuration prête à l'emploi pour votre application IA, puis posez votre première question. Aucun code à écrire.
- Créez une clé. Dans le tableau de bord Howseen, ouvrez Paramètres > « API & assistants IA » (app.howseen.ai/settings?tab=api). Votre clé commence par
hs_live_et ne s'affiche qu'une seule fois, copiez-la donc immédiatement. Elle est en lecture seule sauf si vous activez les actions. - Copiez la configuration de votre application. Les Paramètres proposent une configuration prête à coller pour Claude, Claude Code, ChatGPT, Codex, Cursor et REST, avec votre clé déjà incluse. Vous travaillez dans le terminal ? Consultez le guide Claude Code et Codex.
- Posez votre question. Essayez « Quelles questions des acheteurs citent mes concurrents mais pas moi ? » et votre assistant répond avec vos données Howseen.
| Application | Connexion |
|---|---|
| Claude | Un connecteur personnalisé avec l'URL du serveur, qui fonctionne ensuite sur claude.ai, dans l'application Claude Desktop et sur mobile |
| Claude Code | Une commande dans votre terminal (claude mcp add), disponible dans chaque projet |
| ChatGPT | Connecteur MCP, en mode développeur |
| Codex | Une commande dans votre terminal (codex mcp add), clé lue depuis une variable d'environnement |
| Cursor | Entrée mcp.json (générée automatiquement par les Paramètres) |
| Scripts | API REST avec curl ou tout client HTTP |
Le serveur se trouve à https://app.howseen.ai/api/mcp (Streamable HTTP). Il s'authentifie avec l'en-tête Authorization: Bearer <votre clé>. Pour les clients qui ne peuvent pas envoyer d'en-têtes, la clé est placée dans l'URL via ?key=. Certaines applications IA ne peuvent envoyer votre clé que dans l'URL du serveur : traitez cette URL comme un mot de passe, ne la partagez pas et ne l'affichez pas à l'écran, et révoquez la clé dans les Paramètres en cas de fuite.
Pour les développeurs et les agences
API REST pour développeurs et agences
Les mêmes données sont disponibles via une API REST JSON en lecture seule, avec filtres par plage de dates et par moteur, et pagination, pour vos scripts, rapports et tableaux de bord clients.
| Point de terminaison | Retourne |
|---|---|
GET /api/v1/brands | Vos marques |
GET /api/v1/brands/{id}/visibility | Visibilité, part de voix, position, tendance |
GET /api/v1/brands/{id}/prompts | Questions des acheteurs suivies |
GET /api/v1/brands/{id}/competitors | Classement des concurrents |
GET /api/v1/brands/{id}/sources | Domaines et URLs les plus cités |
GET /api/v1/brands/{id}/responses | Extraits de réponses IA et citations |
GET /api/v1/brands/{id}/actions | Prochaines actions recommandées |
GET /api/v1/brands/{id}/articles | Articles |
curl "https://app.howseen.ai/api/v1/brands/BRAND_ID/visibility?from=2026-09-01&to=2026-09-30&engine=chatgpt" \
-H "Authorization: Bearer hs_live_YOUR_KEY"- Filtres :
frometto(AAAA-MM-JJ),engine(chatgpt, gemini, perplexity, ai_overviews, ai_mode). - Pagination :
limitetoffset. - Limites de débit : 120 requêtes par minute et 5 000 par jour, par clé.
Les agences peuvent récupérer chaque marque client dans leur propre reporting. Consultez GEO pour les agences et les offres agences.
Confiance
Sécurité et confidentialité
Lecture seule par défaut. Une clé ne peut agir que si vous la créez avec les actions activées, et chaque modification nécessite votre confirmation. Chaque clé ne voit que vos propres marques, et Howseen ne stocke jamais votre clé elle-même, seulement son hash sha256.
- Lecture seule par défaut. Une clé ne peut agir que si vous la créez avec les actions activées, et chaque modification nécessite votre confirmation. L'API REST reste en lecture seule.
- Chaque modification est journalisée. Les modifications appliquées sont listées dans les Paramètres sous « Actions réalisées par votre IA », et les limites de votre offre s'appliquent exactement comme dans l'application.
- Vos données uniquement. Une clé est strictement limitée aux marques du compte qui l'a créée, ou à une seule marque si vous le choisissez.
- Clé affichée une seule fois. Howseen ne conserve qu'un hash sha256, personne ne peut donc relire votre clé, y compris nous.
- Révocable. Chaque clé peut être révoquée à tout moment dans les Paramètres.
Questions, réponses
Qu'est-ce qu'un serveur MCP ?+
Un serveur MCP expose des données et des outils via le Model Context Protocol, une norme ouverte pour connecter des applications IA à des systèmes externes. Le serveur MCP de Howseen expose 26 outils sur vos données de visibilité IA : des outils de lecture pour vos chiffres, et des outils d'action (suivre des questions, rédiger et publier des articles) qui ne s'exécutent qu'après votre confirmation.
Mon assistant peut-il modifier mon compte ?+
Seulement si vous l'autorisez. Les clés API sont en lecture seule par défaut. Pour permettre à votre assistant d'agir, créez une clé avec les actions activées. Même dans ce cas, chaque modification est d'abord présentée en aperçu (ce qui va changer et l'effet sur vos quotas) et ne s'applique qu'après votre confirmation. Les limites de votre offre s'appliquent exactement comme dans l'application, chaque modification appliquée est listée dans les Paramètres sous « Actions réalisées par votre IA », et vous pouvez révoquer une clé à tout moment.
Quelles applications sont prises en charge ?+
Tout assistant compatible avec les serveurs MCP distants. Les Paramètres vous donnent une configuration prête à copier pour Claude (claude.ai, l'application Claude Desktop et mobile, via un connecteur personnalisé), Claude Code (une commande terminal), ChatGPT (connecteurs en mode développeur), Codex (une commande terminal) et Cursor (mcp.json). Les développeurs peuvent aussi lire les mêmes données depuis l'API REST.
Mes données sont-elles en sécurité ?+
Chaque clé ne voit que les marques du compte qui l'a créée. Howseen ne stocke qu'un hash sha256 de votre clé, l'affiche une seule fois, et vous permet de la révoquer à tout moment. Certaines applications ne peuvent envoyer votre clé que dans l'URL du serveur : traitez cette URL comme un mot de passe.
Dois-je coder ?+
Non. Vous créez une clé dans les Paramètres, copiez la configuration pour votre application IA, la collez, et posez vos questions en langage naturel. Claude Code et Codex ne demandent qu'une commande dans votre terminal. L'API REST s'adresse aux développeurs qui souhaitent scripter.
Y a-t-il des limites ?+
Oui, pour que rien ne surcharge votre plan, et un usage normal reste bien en dessous : 120 requêtes par minute et 5 000 par jour et par clé. Les scans suivent la même règle Run now que l'application, et vos données se rafraîchissent automatiquement tous les 3 jours, ou chaque jour sur Business.
Quelles offres l'incluent ?+
Le serveur MCP et l'API REST sont inclus dans les forfaits Pro et Business, ainsi que pendant l'essai gratuit de 3 jours.
Les agences peuvent-elles l'utiliser pour plusieurs marques ?+
Oui. L'outil list_brands retourne chaque marque suivie dans votre compte Howseen, une seule clé couvre donc toutes les marques de vos clients, et create_share_report vous donne un lien de rapport prêt pour le client avec votre marque d'agence. Vous pouvez aussi créer une clé limitée à une seule marque pour un client.
Vous ne pouvez pas corriger un écart que vous n'avez pas mesuré
Connectez votre assistant pendant 3 jours, gratuitement, et demandez-lui qui est cité à votre place. Inclus dans Pro et Business, voir tarifs par marque.
