MCP

MencionAI MCP

Conecte Cursor, Claude, Codex, Antigravity ou n8n. URL curta: docs.mencionai.com/mcp.

MencionAI MCP

Use o servidor MCP da MencionAI para ler visibilidade em buscas de IA, enfileirar scans e briefar rascunhos GEO / social / blog no Cursor, Claude, Codex, Antigravity, n8n ou qualquer cliente MCP.

O servidor MCP é um adaptador fino sobre a API pública v2. Usa a sua chave de API e os mesmos scopes da API HTTP. As tools nunca falam com o banco diretamente.

URLs fáceis para agentes (redirecionam para este site):

As páginas canônicas ficam em www.mencionai.com/{locale}/docs/....

Clientes

| Cliente | 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 | | VS Code / Copilot | nota abaixo | (apenas hub) |

Settings → API Keys também tem snippets para copiar.

Antes de começar

  1. Crie uma chave em Settings → API Keys (mak_live_… ou mak_test_…).
  2. Instale Node.js 20+ (stdio local). n8n não precisa disso: fala com o MCP hospedado via HTTP.
  3. Conceda os scopes necessários:
    • organization:read + workspaces:read — listar workspaces e ler visibilidade
    • jobs:read + workspaces:write — enfileirar / esperar scans
    • visibility:answers:read — trechos de resposta (incluso nas chaves do Settings)

Nunca passe a chave como argumento de tool. Coloque no ambiente do processo MCP (stdio) ou em Authorization: Bearer (hospedado).

Stdio local

pnpm add -g @mencionai/mcp
# or: npx -y @mencionai/mcp

MCP hospedado (preferido para agentes em produção)

URL: https://mcp.mencionai.com/mcp

Autentique com Authorization: Bearer YOUR_API_KEY. Stdio em máquinas do cliente não envia telemetria de produto.

Conector OAuth (sem chave de API)

Clientes OAuth 2.1 podem conectar sem colar a chave. Aponte para https://mcp.mencionai.com/mcp.

Gerencie grants em Settings → Connected apps.

Fluxo preferido das tools

Para dúvidas de setup, chame list_docs e depois get_doc (api, sdk, whitelabel, ars, mcp, mcp-cursor, mcp-claude, mcp-codex, mcp-antigravity, mcp-n8n, llms) antes de inventar respostas. Tools de docs não precisam de chave.

Para dados de visibilidade:

  1. list_workspaces
  2. get_visibility_overview
  3. explain_visibility_gaps / compare_competitors
  4. Prompts: list_prompts → analyze_prompt
  5. “O que fazer?”: analyze_action_plan depois analyze_sources
  6. Briefing semanal: analyze_weekly_report · ARS: analyze_ars
  7. Rascunhos GEO / social / blog: research_geo_practices (você deve buscar na web) depois prepare_geo_content_brief
  8. wait_for_visibility_scan quando precisar atualizar (usa cota do plano)

Não chame tools finas (get_visibility_summary, get_visibility_mentions, get_visibility_competitors, get_visibility_coverage, get_visibility_citations, get_weekly_report, get_action_plan, get_ai_sources) a menos que a saída composta seja insuficiente. get_visibility_responses exige visibility:answers:read.

Tools

| Tool | Propósito | |------|---------| | list_docs / get_doc | Guias públicos (API, SDK, whitelabel, ARS, MCP, setup de clientes, llms.txt) | | get_visibility_overview | Comece aqui — snapshot composto | | compare_competitors | Ranking de rivais vs marca | | explain_visibility_gaps | Prompts em que concorrentes aparecem e a marca não | | wait_for_visibility_scan | Enfileira + espera scan (consome cota) | | get_visibility_series | Scores diários incluindo ARS | | get_traffic_summary / get_traffic_series | Visitas de indicação de IA do snippet | | get_organization / list_workspaces / get_workspace | Org (inclui covered_providers) e workspaces | | get_visibility_responses | Trechos de resposta (visibility:answers:read) | | list_prompts / get_prompt / analyze_prompt | Perguntas rastreadas | | analyze_weekly_report / get_weekly_report | Briefing semanal | | analyze_action_plan / get_action_plan / update_action_plan | Checklist GEO do mês (escritas exigem descrição) | | analyze_ars / get_ars | Headline e componentes do ARS | | analyze_sources / get_ai_sources | Domínios citados e gaps | | get_brand_perception | Atributos da marca vs concorrentes | | analyze_site | Auditoria limitada do domínio do workspace | | get_crawl_insights / ingest_crawl_insights_csv | Agregados de crawler; peça CSV ou Vercel Log Drain se vazio | | get_project_settings | Nome da marca, domínio, concorrentes, tipo de negócio, localização | | research_geo_practices | Tarefa de pesquisa para o LLM host (precisa buscar na web) | | prepare_geo_content_brief | Brief de escrita para blog / LinkedIn / Instagram / X / Facebook | | get_visibility_coverage / citations / summary / mentions / competitors | Leituras finas | | enqueue_visibility_scan / get_job | Scan manual + poll | | start_onboarding_v2_scan / wait_for_onboarding_v2_report / get_onboarding_v2_report | Scan de onboarding v2 |

Briefs de conteúdo GEO

research_geo_practices devolve queries de busca nos modelos do plano (Starter = Gemini e ChatGPT). O LLM host deve buscar na web ao vivo e revisar o domínio do workspace e perfis sociais descobertos. Depois prepare_geo_content_brief monta gaps de visibilidade e passos GEO abertos para um canal. Mercado padrão: Brasil (pt-br / br).

VS Code / Copilot

.vscode/mcp.json usa servers (não mcpServers) e "type": "stdio". Não cole o JSON do Cursor sem adaptar.

Troubleshooting

| Sintoma | O que checar | |---------|----------------| | 401 / unauthorized | Chave ausente, revogada ou ambiente errado (mak_live_ vs mak_test_) | | Scope / forbidden | Falta workspaces:read (ou scopes de escrita de scan) | | get_visibility_responses retorna MISSING_SCOPE | Crie uma chave nova no Settings ou adicione visibility:answers:read | | Scan lento ou recusado | Cota do plano; prefira wait_for_visibility_scan com timeout ≤ 120s | | Agente pede a chave | MCP mal configurado — a chave fica em env / Bearer, nunca em args de tool |

Próximos passos

Cursor

Arquivo: .cursor/mcp.json (ou as configurações MCP do Cursor).

Stdio

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

Hospedado

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

URL curta: docs.mencionai.com/mcp. Voltar ao hub MCP.

Claude

Claude Desktop

Arquivo: claude_desktop_config.json.

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

Claude Code

.mcp.json do projeto, ou:

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

Defina MENCIONAI_API_KEY no ambiente do servidor MCP. Hospedado:

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

URL curta: docs.mencionai.com/mcp. Voltar ao hub MCP.

Codex

Arquivo: ~/.codex/config.toml (ou .codex/config.toml do projeto em um repo confiável).

O nome da tabela é mcp_servers, não mcpServers.

Stdio

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

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

Hospedado

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

Confira com codex mcp list ou /mcp no TUI.

URL curta: docs.mencionai.com/mcp. Voltar ao hub MCP.

Antigravity

Arquivo global: ~/.gemini/config/mcp_config.json. Arquivo do workspace: .agents/mcp_config.json.

Stdio

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

Hospedado

Servidores remotos no Antigravity usam serverUrl, não url.

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

Residual do Gemini CLI

O Gemini CLI antigo ainda lê mcpServers em ~/.gemini/settings.json. Prefira o mcp_config.json do Antigravity acima.

URL curta: docs.mencionai.com/mcp. Voltar ao hub MCP.

n8n

O n8n é um cliente MCP HTTP. Ele não executa npx @mencionai/mcp. Não use o MCP Server Trigger do n8n para a MencionAI. Esse node expõe o n8n como servidor.

Use MCP Client Tool em um AI Agent, ou o node MCP Client.

Campos do node (v1.2+)

| Campo | Valor | |-------|--------| | Server Transport | HTTP Streamable (httpStreamable) | | MCP Endpoint URL / Endpoint | https://mcp.mencionai.com/mcp | | Authentication | Bearer Auth | | Token | Chave do Settings (mak_live_… ou mak_test_…) |

Versões antigas do node usam SSE por padrão. O MCP hospedado da MencionAI é Streamable HTTP. Escolha HTTP Streamable.

n8n self-hosted só precisa de HTTPS de saída para mcp.mencionai.com. Opcional: OAuth2 MCP na mesma URL (discovery via WWW-Authenticate).

URL curta: docs.mencionai.com/mcp. Voltar ao hub MCP.