Servidor MCP do zaDojo: Claude, Cursor e Codex

O zaDojo tem um servidor MCP remoto ao qual qualquer cliente com suporte a MCP remoto pode se conectar. MCP (Model Context Protocol) é o padrão que os apps de IA usam para chamar ferramentas externas. Por ele, seu agente pode pesquisar palavras-chave, ler resultados do Google ao vivo, ver posições e backlinks de qualquer domínio, rodar auditorias de site, rastrear posições e respostas de IA e ler seus próprios dados do Search Console e do Google Analytics.

O endereço do servidor:

https://app.zadojo.com/mcp

Na primeira vez que um cliente se conecta, ele abre o login do zaDojo no seu navegador e pede que você aprove o acesso. Depois disso, o cliente pode usar as ferramentas nos projetos que você vê. Para jobs de CI e servidores sem navegador, use uma chave de API.

Quem usa Claude Code e Codex aproveita mais o plugin, que adiciona esta conexão e as doze skills do zaDojo em uma instalação só. Use os passos desta página quando quiser apenas a conexão MCP, ou quando o seu cliente não tiver plugin. O guia de configuração do agente tem um prompt que escolhe o caminho certo para você.

O que você precisa

• Uma conta no zaDojo. Cadastre-se para ganhar 0,10 € em créditos de teste, sem cartão.
• Um cliente com suporte a servidores MCP remotos via HTTP: Claude Code, Claude Desktop, Cursor, Codex CLI, Codex no app desktop do ChatGPT, ChatGPT com uma conexão personalizada, VS Code com Copilot, Windsurf (Devin Desktop), Gemini CLI, Zed ou similares.
• Um navegador para o login, ou uma chave de API para uso sem interface.

A página Agent setup dentro do app mostra o mesmo endereço com um botão de copiar. Quer testar os dados do zaDojo antes de se cadastrar? As ferramentas de SEO grátis não precisam de conta.

Conecte seu cliente

Claude Code

O plugin do Claude Code é a melhor escolha para a maioria das pessoas. Para só a conexão, rode isto em um terminal:

claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcp

--scope user deixa o zaDojo disponível em todos os projetos da sua máquina. Use --scope local para limitar ao repositório atual. O Claude Code então pede que você entre no zaDojo. Se o aviso não aparecer, rode /mcp, selecione zaDojo e conclua o login por lá.

Claude Desktop

Em um plano pago do Claude, o plugin do zaDojo adiciona a conexão e as skills juntas. No plano Free, ou para só a conexão, adicione um conector personalizado:

1. Abra Customize > Connectors.
2. Clique em Add ou + e escolha Add custom connector.
3. Cole https://app.zadojo.com/mcp.
4. Entre no zaDojo e aprove o acesso.

Conectores personalizados funcionam no Claude Free, Pro, Max, Team e Enterprise. O plano Free permite um conector personalizado.

Cursor

1. Abra Customize e vá até os servidores MCP, ou edite ~/.cursor/mcp.json diretamente.
2. Adicione a entrada do zaDojo:

{
  "mcpServers": {
    "zadojo": {
      "url": "https://app.zadojo.com/mcp"
    }
  }
}

3. Salve o arquivo e aprove o login no zaDojo quando o Cursor pedir.

O guia do Cursor tem um link de instalação com um clique e a instalação das skills.

Codex CLI

O plugin do Codex adiciona a conexão e as skills juntas. Para só a conexão:

codex mcp add zadojo --url https://app.zadojo.com/mcp

Aprove o login no zaDojo quando ele abrir. Se não abrir, rode codex mcp login zadojo.

Codex no app desktop do ChatGPT

O plugin do Codex também inclui as skills. Para só a conexão:

1. Abra o Codex e vá em Settings > MCP servers > Add server.
2. Informe o nome zadojo, escolha Streamable HTTP e cole https://app.zadojo.com/mcp.
3. Salve e clique em Restart quando o Codex pedir.
4. Clique em Authenticate ao lado do zaDojo e aprove o login.
5. Abra um novo chat do Codex e faça a verificação da conexão.

Esta conexão vale só para o Codex. O ChatGPT na web precisa da sua própria. A referência da OpenAI é a documentação de MCP do Codex.

ChatGPT

Adicione o zaDojo como uma conexão MCP personalizada com OAuth. Funciona no ChatGPT Free e nos planos pagos, mas administradores de workspace podem bloquear conexões personalizadas. O guia do ChatGPT mostra cada tela.

VS Code, Windsurf e Gemini CLI

Cada um tem sua própria página com a configuração exata, a configuração com chave de API e a instalação das skills:

• VS Code com GitHub Copilot
• Windsurf (Devin Desktop)
• Gemini CLI e Antigravity CLI

Outros clientes MCP

Qualquer cliente que alcance um servidor MCP remoto via streamable HTTP e tenha suporte a login OAuth pode usar o endereço acima. Se o cliente não faz OAuth, envie uma chave de API em um cabeçalho, como descrito a seguir.

Todos eles abrem o login do zaDojo no navegador na primeira conexão.

Conecte com uma chave de API

Uma chave de API substitui o login pelo navegador. Use para pipelines de CI, servidores remotos, agentes como o Hermes em que o fluxo de login não funciona, ou qualquer cliente sem suporte a OAuth.

A chave é pessoal. Tudo o que um agente faz com ela roda como a sua conta no seu workspace, então guarde como segredo e nunca faça commit dela em um repositório.

Para criar uma, abra Settings no app do zaDojo, encontre API keys e clique em Create API key. Copie a chave na hora, porque o zaDojo mostra ela uma única vez. As chaves começam com zadojo_.

Claude Code:

claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcp --header "Authorization: Bearer zadojo_YOUR_KEY"

Cursor: adicione um bloco headers à entrada do zaDojo no mcp.json:

{
  "mcpServers": {
    "zadojo": {
      "url": "https://app.zadojo.com/mcp",
      "headers": {
        "Authorization": "Bearer zadojo_YOUR_KEY"
      }
    }
  }
}

Codex CLI: mantenha a chave em uma variável de ambiente e aponte o Codex para ela:

export ZADOJO_API_KEY=zadojo_YOUR_KEY
codex mcp add zadojo --url https://app.zadojo.com/mcp --bearer-token-env-var ZADOJO_API_KEY

Qualquer outro cliente: envie Authorization: Bearer zadojo_YOUR_KEY ou x-api-key: zadojo_YOUR_KEY em cada requisição.

Para revogar uma chave, abra a mesma seção API keys e remova a chave.

Confira a conexão

Abra um novo chat ou sessão e envie:

Use o zaDojo para verificar minha conexão e listar meus projetos.

O agente deve chamar whoami e list_projects. Você recebe sua conta, o saldo de créditos restante e seus projetos, ou uma lista vazia se ainda não tiver nenhum. As duas ferramentas são grátis. Se o agente explicar o que é MCP em vez de chamar uma ferramenta, o servidor não está carregado nesta sessão: recarregue o cliente ou comece um novo chat.

Ferramentas disponíveis

O servidor tem mais de 80 ferramentas. A tabela agrupa por tarefa. Os nomes das ferramentas são os que o seu agente vê.

Alguns comportamentos que vale conhecer:

• O contexto do projeto é a memória compartilhada de um projeto: visão geral do negócio, objetivo atual, posicionamento, preferências de escrita, concorrentes, páginas principais e um registro de pesquisas. Os agentes leem esse contexto antes de começar, e o app e outros agentes veem as mesmas entradas.
• Os relatórios salvos por um agente aparecem no projeto para todo o seu time ler, imprimir ou exportar. Relatórios novos são privados. Um link público só é criado quando você pede ao agente para chamar set_report_sharing com public: true, e public: false revoga o link. get_report retorna report.shareUrl quando existe um link público, ou null quando não existe.
• As ferramentas do Search Console e do Google Analytics leem a propriedade já conectada ao projeto. O acesso é só de leitura.
• Estimativas vêm primeiro para tudo o que é recorrente. O rastreamento de posições e o rastreamento de IA têm ferramentas de estimativa, então o agente pode mostrar o custo antes de programar verificações.

O que usa créditos

Os créditos saem do seu saldo no zaDojo. 1.000 créditos equivalem a 1 €, e o plano de 10 € por mês inclui 10 € de uso. Preços típicos:

Grátis: verificações de conta, contexto do projeto, palavras-chave salvas, relatórios, Search Console, Google Analytics, auditorias de site simples e leitura de resultados de rastreamento de posições, auditoria ou visibilidade em IA que você já coletou. Os agentes conectados ao zaDojo são instruídos a perguntar antes de um lote planejado acima de 2.000 créditos (cerca de 2 €). Quando o saldo chega a zero, as ferramentas pagas param até você recarregar. Veja o estimador em preços.

Depois de conectar

A conexão dá dados ao seu agente. As skills dizem o que fazer com esses dados, passo a passo. Se você usou o MCP sem plugin, instale as skills em seguida.

Dê ao agente uma tarefa específica em vez de pedir para ele "fazer SEO":

• SEO Project Setup: salve seu objetivo, posicionamento, concorrentes e páginas principais para que toda tarefa seguinte parta deles.
• SEO Coach: receba um próximo passo recomendado se você é novo em SEO.
• SEO Audit: encontre as poucas mudanças com mais chance de aumentar o tráfego.
• Keyword Research e Keyword Clustering: encontre termos de busca que valem a pena e agrupe em páginas.
• Competitive Landscape e Competitor Analysis: mapeie um mercado ou estude um concorrente a fundo.
• Link Prospecting: encontre sites que podem linkar para uma página e redija a abordagem.
• AI Prompt Research e AI Visibility Audit: veja o que as ferramentas de IA dizem sobre seu mercado e por que os concorrentes são mencionados.

O guia de visibilidade em IA cobre mecanismos, cobertura e custos do rastreamento de respostas de IA.

Solução de problemas

O cliente não consegue conectar. Confira se o endereço é exatamente https://app.zadojo.com/mcp, com https:// e sem espaços no fim.

O Codex mostra Authorization server response missing required issuer: expected https://app.zadojo.com. As versões 0.143 a 0.146 do Codex perdem o issuer durante o OAuth. Atualize o Codex CLI ou o app desktop do Codex para a 0.147.0 ou mais recente, ou use uma chave de API.

O login falha ou expira toda hora. Remova o servidor do zaDojo do seu cliente, adicione de novo e repita o login.

O agente não encontra um projeto. Peça para ele chamar list_projects primeiro e reutilizar o ID de projeto retornado nas chamadas seguintes. Se você não tem projetos, peça para ele criar um para o seu domínio com create_project, que é grátis.

Uma ferramenta paga diz que seus créditos acabaram. No plano pago, compre uma recarga na área de cobrança do app ou espere seus créditos mensais renovarem. No teste, assine para continuar usando as ferramentas pagas.

Ainda com problema? Mande um e-mail para hello@zadojo.com com o nome e a versão do seu cliente e o erro exato. Nunca inclua chaves de API.