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, 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 | | 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-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 / ARS : analyze_weekly_report / analyze_ars. Brouillons GEO : research_geo_practices (recherche web obligatoire) puis prepare_geo_content_brief. Scan : wait_for_visibility_scan.

N’appelez pas les tools fines (get_visibility_summary, get_visibility_mentions, get_visibility_competitors, get_visibility_coverage, get_visibility_citations, get_weekly_report, get_action_plan, get_ai_sources) sauf si la sortie composée ne suffit pas. get_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_visibility_scan | Enfiler + attendre un scan | | get_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 | | get_visibility_responses | Extraits de réponses | | list_prompts / get_prompt / analyze_prompt | Questions suivies | | analyze_weekly_report / get_weekly_report | Briefing hebdo | | analyze_action_plan / get_action_plan / update_action_plan | Checklist GEO | | analyze_ars / get_ars | ARS | | analyze_sources / get_ai_sources | Domaines cités | | get_brand_perception | Perception de marque | | analyze_site | Audit borné du domaine | | 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 | | get_visibility_coverage | Lecture fine de couverture | | enqueue_visibility_scan / get_job | Scan manuel | | start_onboarding_v2_scan / wait_for_onboarding_v2_report / get_onboarding_v2_report | Onboarding v2 |

Starter couvre Gemini et ChatGPT. Marché par défaut : Brésil (pt-br / br).

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

File: claude_desktop_config.json.

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

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.

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.