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/....

MCP pour les agences

Fonctionnalité prévue. Le MCP pour les agences n'est pas encore implémenté. Le point d'accès proposé est https://mcp.mencionai.com/agency/mcp. Il ne s'agit pas d'une instruction de connexion opérationnelle. Aucun nom d'outil, scope ou exemple de configuration pour les agences n'est encore publié.

La proposition de plateforme pour les agences fournit une connexion autorisée pour les clients permis de l'agence. Le point d'accès client actuel, https://mcp.mencionai.com/mcp, reste limité à une organisation. Indiquer un autre workspace ne permet pas à ces identifiants d'accéder à l'organisation d'un autre client.

Connexion et permissions prévues

Le MCP pour les agences utilise un consentement OAuth distinct pour l'agence, les clients permis et les droits de lecture ou d'écriture. Chaque opération sélectionne explicitement l'organisation cliente et le workspace. Le serveur vérifie l'appartenance actuelle, la relation entre agence et client, l'accès au workspace, les permissions de l'opération et les limites du forfait client.

La suppression d'une relation avec l'agence ou d'une appartenance doit bloquer les opérations suivantes, même sur une connexion MCP déjà ouverte. Les identifiants d'agence sont distincts des identifiants client et administrateur de la plateforme. Un domaine de portail en marque blanche ne donne pas accès au MCP et ne change pas son point d'accès canonique.

Les exemples de configuration ci-dessous concernent le MCP client existant, pas le service prévu pour les agences. Ne remplacez pas leur URL par le point d'accès proposé avant la publication de l'authentification et des outils pour les agences.

Opérations prévues

Domaine	Couverture prévue
Clients et accès	Lister et créer des clients autorisés, sélectionner des workspaces et gérer les invitations permises.
Forfaits et facturation	Consulter le forfait et la facturation de chaque client, demander une capacité commerciale et lancer uniquement des actions de facturation explicitement approuvées.
Visibilité	Réutiliser les outils clients pour les prompts, scans, concurrents, sources, plans d'action, rapports, audits de sites et trafic.
Blogs et contenu	Créer et configurer les blogs clients, importer ou exporter du contenu, consulter le calendrier, modifier les brouillons et suivre les tâches de contenu.
MAIagent	Lancer les workflows d'agent disponibles pour le client sélectionné, suivre les tâches asynchrones et conserver les contrôles de crédits et quotas de ce client.
Marque blanche	Consulter et gérer les opérations permises d'inscription et de vérification des domaines du portail lorsque ces API sont disponibles.

Il s'agit de la couverture prévue, pas d'un catalogue exécutable. Le catalogue publié doit préciser les opérations implémentées et les exclusions. Le MCP d'agence réutilise les services clients. Il ne se connecte pas récursivement aux MCP des clients et n'utilise pas l'usurpation d'un administrateur de la plateforme.

Workflow attendu et protections

Le workflow prévu découvre les clients permis, sélectionne un client et un workspace, exécute l'opération autorisée et suit tout identifiant de tâche renvoyé. Créer un brouillon de blog ou une tâche MAIagent ne revient pas à publier un article.

Les scans et les opérations d'agent utilisent les crédits et quotas du client sélectionné, jamais le solde d'un autre client ni le compte Starter gratuit de l'agence. Les appels qui consomment des crédits doivent annoncer leur coût. La publication, les changements de facturation, la suppression de membres et les opérations destructives exigent une approbation explicite. Une nouvelle tentative après un résultat incertain doit conserver la clé d'idempotence originale.

Jusqu'à la publication, les identifiants existants mcp et whitelabel de get_doc contiennent ces sections prévues. Les identifiants de documentation agencies et mcp-agency n'existent pas encore.

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` / `edit_action_plan_step` / `complete_action_plan_step`	Actions MAI (les nouvelles étapes viennent uniquement du chat MAI)
`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
`list_content_hosts`	Apex, www, blog, blog plateforme, hôtes liés depuis l'accueil, et labels docs/content/help qui publient un sitemap
`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.