Otimizador.AI
Documentação · MCP

Conectar Claude Desktop, Cursor e Claude Code

O uso principal do MCP é trazer o Otimizador.AI para dentro do seu agente — scans, Answer Boxes, llms.txt, Brand Pulse e mais — direto na conversa, sem abrir o app.

Disponível no plano Enterprise. Emita um token em Configurações → Integrações · MCP no app, substitua oai_mcp_SEU_TOKEN no JSON abaixo e reinicie o cliente.

Ver hub MCPIntegração WordPress (opcional)

01 · Pré-requisitos

Token e plano Enterprise

Cada workspace tem seu próprio token. O segredo só aparece uma vez no momento da emissão — copie e guarde em um gerenciador de senhas.

  1. Plano Enterprise ativo no workspace.
  2. Token emitido em Configurações → Integrações · MCP (escopo write para scans e gerações).
  3. Cliente MCP atualizado (Claude Desktop ≥ 0.7, Cursor ≥ 0.45 ou Claude Code recente).

02 · Claude Desktop

Configurar Claude Desktop

Edite claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json; Windows: %APPDATA%\\Claude\\claude_desktop_config.json), cole o bloco abaixo e reinicie o Claude.

json
{
  "mcpServers": {
    "otimizador-ai": {
      "url": "https://app.otimizador.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer oai_mcp_SEU_TOKEN"
      }
    }
  }
}

Validação: abra o Claude Desktop, vá no ícone de tools (🔌) e confirme que aparece otimizador-ai com tools como start_scan, generate_answer_box e get_brand_visibility_snapshot.

Erros comuns: 401 indica token revogado ou inválido — gere um novo. 402 Payment Required significa que o workspace saiu do plano Enterprise.

Digite / no chat para ver os slash commands do servidor (/start_geo_audit, /optimize_page, etc.).

03 · Cursor e Claude Code

Configurar Cursor / Claude Code

Cursor e Claude Code usam mcp.json com transport HTTP explícito. O mesmo token e endpoint do Claude Desktop.

json
{
  "mcpServers": {
    "otimizador-ai": {
      "transport": "http",
      "url": "https://app.otimizador.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer oai_mcp_SEU_TOKEN"
      }
    }
  }
}

No Cursor, o arquivo fica em ~/.cursor/mcp.json (ou em Configurações → MCP). No Claude Code, em ~/.config/claude-code/mcp.json (Linux/macOS) ou %APPDATA%\\Claude Code\\mcp.json (Windows). Reinicie o cliente após salvar.

Opcional

CMS e outros servidores MCP

Se você também usa WordPress, GitHub ou Google Drive via MCP, pode combinar vários servidores no mesmo cliente. O Otimizador.AI continua sendo o servidor de GEO/AEO — o CMS é só para publicar ou ler conteúdo.

Guia MCP + WordPress →