MencionAI MCP

Utilisez le serveur MCP MencionAI pour lire la visibilité en recherche IA, enfiler des scans et briefer des brouillons GEO / social / blog depuis Cursor, Claude, ChatGPT, Codex, Antigravity, n8n ou tout client MCP.

Le serveur MCP est un adaptateur mince au-dessus de l’API publique v2. Il utilise votre clé API et les mêmes scopes que l’API HTTP. Les tools ne parlent pas à la base.

URLs faciles pour les agents (redirection vers ce site) :

Les pages canoniques restent sur www.mencionai.com/{locale}/docs/....

Clients

Client	Doc	id `get_doc`
Cursor	Cursor	`mcp-cursor`
Claude Desktop / Claude Code	Claude	`mcp-claude`
ChatGPT	ChatGPT	`mcp-chatgpt`
Codex	Codex	`mcp-codex`
Antigravity	Antigravity	`mcp-antigravity`
n8n	n8n	`mcp-n8n`

Settings → API Keys contient aussi des extraits à copier.

Flux préféré

Pour le setup : list_docs puis get_doc (api, sdk, whitelabel, ars, mcp, mcp-cursor, mcp-claude, mcp-chatgpt, mcp-codex, mcp-antigravity, mcp-n8n, llms).

Visibilité : list_workspaces → get_visibility_overview → explain_visibility_gaps / compare_competitors. Prompts : list_prompts → analyze_prompt. Plan : analyze_action_plan puis analyze_sources. Hebdo / score de recommandation IA : analyze_weekly_report / analyze_ai_recommendation_score. Brouillons GEO : research_geo_practices (recherche web obligatoire) puis prepare_geo_content_brief. Après un brouillon blog, appelez validate_geo_content. Scan : wait_for_ai_search_scan.

N’appelez pas les tools fines (visibility_summary, visibility_mentions, visibility_competitors, visibility_coverage, visibility_citations, get_weekly_report, get_action_plan, get_ai_sources) sauf si la sortie composée ne suffit pas. visibility_responses exige visibility:answers:read.

Tools

Tool	Rôle
`list_docs` / `get_doc`	Guides publics
`get_visibility_overview`	Snapshot composé
`compare_competitors`	Classement des rivaux
`explain_visibility_gaps`	Prompts avec rival sans marque
`wait_for_ai_search_scan`	Lance un scan de recherche IA et attend
`visibility_series`	Séries quotidiennes
`get_traffic_summary` / `get_traffic_series`	Visites de référencement IA
`get_organization` / `list_workspaces` / `get_workspace`	Org (`covered_providers`) et workspaces
`visibility_responses`	Extraits de réponses
`list_prompts` / `get_prompt` / `analyze_prompt` / `add_prompt` / `update_prompt`	Questions suivies. `add_prompt` crée. `update_prompt` modifie le texte ou active.
`submit_feedback`	Envoie une note produit à MencionAI. `anonymous` optionnel. Ne liste pas les notes.
`analyze_weekly_report` / `get_weekly_report`	Briefing hebdo
`analyze_action_plan` / `get_action_plan` / `add_action_plan_step` / `edit_action_plan_step` / `complete_action_plan_step`	Checklist GEO
`analyze_ai_recommendation_score` / `get_ai_recommendation_score`	Score de recommandation IA
`analyze_sources` / `get_ai_sources`	Domaines cités
`get_brand_perception`	Perception de marque
`analyze_site`	Audit borné du domaine
`identify_site_stack`	Détecte le CMS, l'hébergeur et le framework du domaine
`list_site_pages`	Toutes les URL du sitemap (blog, contenu, produit), y compris un blog de 100 pages
`site_check_llms_txt` / `site_check_ai_crawler_robots` / autres tools `site_check_*`	Un contrôle public de la page d'accueil sur n'importe quel domaine. Pas de workspace requis
`get_crawl_insights` / `ingest_crawl_insights_csv`	Hits crawler ; demander un CSV ou un Vercel Log Drain si vide
`get_project_settings`	Réglages du workspace
`research_geo_practices`	Tâche de recherche (web search)
`prepare_geo_content_brief`	Brief blog / LinkedIn / Instagram / X / Facebook
`validate_geo_content`	Vérifie un brouillon blog client contre le contrat de citation GEO/AEO/SEO/AIO
`start_content_job`	Démarre un job de brouillon pour une étape de contenu du plan d’action. Renvoie l’id et l’état. Ne publie pas.
`connect_blog_domain`	CNAME de `blog.{domain}`. Le client l’ajoute chez l’hébergeur du domaine. L’adresse de la boutique reste la même.
`connect_traffic_snippet`	Script public de suivi pour le `<head>` du site. Crée une clé seulement quand `create` est true.
`create_post_with_agent`	Lance l’agent de contenu pour une étape de contenu du plan d’action. Dépense 2 crédits et prend le prochain horaire quotidien libre.
`get_blog_health`	Contrôles du blog : domaine, SSL, publication, accès, articles, mots-clés, SEO, GEO, AIO, AEO, schema, thème, robots.txt, sitemap.xml et llms.txt.
`get_blog_settings`	Style, police, police importée, couleurs, logo, auteur, réseaux, pixels, trois CTA, pied de page, catégories, tags, horaires et politique de publication.
`update_blog_settings`	Change n’importe lequel de ces champs. Une police de la liste retire le fichier importé, sauf si `font_file_url` est envoyé en même temps. Ne publie pas.
`set_blog_appearance`	Change le modèle (magazine, editorial, index, gallery), le thème (ink, paper, signal, aurora) et la police. Ne publie pas. Un espace qui reflète le blog MencionAI y applique le même modèle, les mêmes couleurs et la même police. Le fond du site reste.
`import_blog_content`	Importe un fichier WordPress, Blogger ou RSS comme brouillons. La même source est ignorée à l’import suivant. Ne publie pas et ne dépense pas de crédits.
`export_blog_content`	Télécharge les articles de l’espace en WordPress, Blogger ou RSS. Le fichier correspond à l’import.
`upload_blog_font`	Importe un fichier woff2, woff, ttf ou otf (2 Mo max) et l’utilise sur le blog.
`upload_blog_logo`	Importe un logo png, jpeg ou webp (5 Mo max).
`get_content_calendar`	Articles planifiés et publiés, avec jour, heure, état et statut.
`get_content_job`	Un job : état, sujet, slug, horaire, sections, sources, liens, appels et l’image.
`update_content_post`	Modifie un post par section : texte, sources, appel et image. Une image par article. Ne publie pas.
`reschedule_content_job`	Déplace un brouillon non publié vers un autre jour et une autre heure. Un jour passé ou un créneau pris est refusé.
`retry_content_job`	Relance un job en échec ou bloqué. Ne débite pas de crédits à nouveau.
`get_blog_telemetry`	Trafic des articles publiés : impressions, direct, SEO, IA, clics CTA, total, CTR et quelles IA ont visité.
`visibility_coverage` / `visibility_citations` / `visibility_summary` / `visibility_mentions` / `visibility_competitors`	Lecture fine
`enqueue_visibility_scan` / `get_job`	Scan manuel
`start_onboarding_v2_scan` / `wait_for_onboarding_v2_report` / `get_onboarding_v2_report`	Lance, attend et lit le scan de recherche IA de l'onboarding

research_geo_practices renvoie des requêtes de recherche live et des docs officielles par modèle pour chaque moteur que MencionAI peut suivre (ChatGPT, Gemini, Google AI Studio, Claude, Grok, DeepSeek, Perplexity). Les brouillons client doivent ne nommer que les modèles du plan. Le LLM hôte doit chercher sur le web, récupérer must_fetch_urls et revoir le domaine du workspace plus les profils sociaux. Ensuite prepare_geo_content_brief assemble les gaps de visibilité, les étapes GEO ouvertes et le même contrat de citation que les pages first-party MencionAI (Sources, FAQ, À lire aussi sur le domaine de la marque). Après rédaction, validate_geo_content renvoie missing_obligations et échoue en mode fermé. Marché par défaut : Brésil (pt-br / br). N’inventez pas de tokens crawler pour Grok ou DeepSeek.

Starter couvre Gemini et ChatGPT dans la copie client.

Cursor

File: .cursor/mcp.json (or Cursor MCP settings).

Stdio

{
  "mcpServers": {
    "mencionai": {
      "command": "npx",
      "args": ["-y", "@mencionai/mcp"],
      "env": {
        "MENCIONAI_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Hosted

{
  "mcpServers": {
    "mencionai": {
      "url": "https://mcp.mencionai.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Vanity URL: docs.mencionai.com/mcp. Back to the MCP hub.

Claude

Claude Desktop

Ouvrez Settings → Connectors, ajoutez un connecteur personnalisé et collez :

https://mcp.mencionai.com/mcp

Claude lance OAuth 2.1 automatiquement. Pas besoin de clé API ni de claude_desktop_config.json.

Gérez les grants dans MencionAI sous Settings → Connected apps.

Claude Code

Project .mcp.json, or:

claude mcp add mencionai -- npx -y @mencionai/mcp

Set MENCIONAI_API_KEY in the MCP server environment. Hosted:

{
  "mcpServers": {
    "mencionai": {
      "url": "https://mcp.mencionai.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Vanity URL: docs.mencionai.com/mcp. Back to the MCP hub.

ChatGPT

Installez MencionAI depuis l'onglet Plugins. Laissez l'enregistrement en enregistrement dynamique.

Onglet Plugins

Ouvrez Plugins.
Cherchez MencionAI et installez-le.
Quand un outil s'exécute, connectez-vous sur www.mencionai.com et autorisez l'app.
Laissez l'enregistrement en enregistrement dynamique.

Tant que la fiche publique n'est pas disponible, installez la marketplace de ce dépôt. Le catalogue est .agents/plugins/marketplace.json et le paquet est plugins/mencionai. Redémarrez l'app desktop ChatGPT, ouvrez Plugins, choisissez cette marketplace et installez MencionAI.

Repli en mode développeur

Utilisez-le tant que la fiche n'est pas dans le répertoire.

Ouvrez Settings → Security and login et activez Developer mode.
Ouvrez Plugins, choisissez + et collez cette URL :

https://mcp.mencionai.com/mcp

Au premier outil, connectez-vous sur www.mencionai.com et autorisez l'app.
Laissez l'enregistrement en enregistrement dynamique.

Gérez les grants dans Settings → Connected apps.

URL courte : docs.mencionai.com/mcp/chatgpt. Retour au hub MCP.

Codex

File: ~/.codex/config.toml (or project .codex/config.toml on a trusted repo).

The table name is mcp_servers, not mcpServers.

Stdio

[mcp_servers.mencionai]
command = "npx"
args = ["-y", "@mencionai/mcp"]

[mcp_servers.mencionai.env]
MENCIONAI_API_KEY = "YOUR_API_KEY"

Hosted

[mcp_servers.mencionai]
url = "https://mcp.mencionai.com/mcp"
bearer_token_env_var = "MENCIONAI_API_KEY"

Verify with codex mcp list or /mcp in the TUI.

Vanity URL: docs.mencionai.com/mcp. Back to the MCP hub.

Antigravity

Global file: ~/.gemini/config/mcp_config.json. Workspace file: .agents/mcp_config.json.

Stdio

{
  "mcpServers": {
    "mencionai": {
      "command": "npx",
      "args": ["-y", "@mencionai/mcp"],
      "env": {
        "MENCIONAI_API_KEY": "${MENCIONAI_API_KEY}"
      }
    }
  }
}

Hosted

Antigravity remote servers use serverUrl, not url.

{
  "mcpServers": {
    "mencionai": {
      "serverUrl": "https://mcp.mencionai.com/mcp",
      "headers": {
        "Authorization": "Bearer ${MENCIONAI_API_KEY}"
      }
    }
  }
}

Gemini CLI leftover

Older Gemini CLI still reads mcpServers inside ~/.gemini/settings.json. Prefer the Antigravity mcp_config.json path above.

Vanity URL: docs.mencionai.com/mcp. Back to the MCP hub.

n8n

n8n is an HTTP MCP client. It does not spawn npx @mencionai/mcp. Do not use n8n’s MCP Server Trigger for MencionAI. That node exposes n8n as a server.

Use MCP Client Tool on an AI Agent, or the standalone MCP Client node.

Node fields (v1.2+)

Field	Value
Server Transport	HTTP Streamable (`httpStreamable`)
MCP Endpoint URL / Endpoint	`https://mcp.mencionai.com/mcp`
Authentication	Bearer Auth
Token	Settings API key (`mak_live_…` or `mak_test_…`)

Older node versions default to SSE. Hosted MencionAI MCP is Streamable HTTP. Pick HTTP Streamable.

Self-hosted n8n only needs outbound HTTPS to mcp.mencionai.com. Optional: MCP OAuth2 against the same URL (discovery via WWW-Authenticate).

Vanity URL: docs.mencionai.com/mcp. Back to the MCP hub.