Configurar o agente

Conecte o Claude Code, o Codex ou o Cursor ao aplicativo: endereço, senha, as 33 ferramentas, os 6 modelos de tarefa e quais deles gastam a cota do Google.

Ao fim desta página, o seu assistente de IA estará conectado ao aplicativo e terá executado o primeiro comando. Depois de conectado, você pode dizer "audite o site e escreva um relatório". O assistente lê os dados do Search Console, executa a auditoria e salva o relatório na tela Raporlar (Relatórios). Essa conexão se chama conexão do assistente (MCP). Ela permite que o assistente chame as ferramentas do aplicativo (por exemplo, list_projects). Conectar é opcional. Se você pular esta etapa, o aplicativo continua completo.

O que você precisa

• Um aplicativo em execução e um projeto conectado ao Search Console.
• Um destes: Claude Code, Codex, Cursor, VS Code Copilot ou Gemini CLI. O aplicativo fornece textos de configuração prontos para os três primeiros.
• A tela Ajan kurulumu (Configuração do agente) do aplicativo. Ela fica no menu da esquerda, no grupo Ajan (Agente).

Passos

1. Abra a tela Ajan kurulumu. O selo no alto diz Henüz bağlanmadı (Ainda não conectado) ou Bağlandı (Conectado). Se estiver conectado, mostra também um texto como "Claude Code, última chamada há 2 min". Abaixo você vê o endereço de conexão e um botão de copiar: http://127.0.0.1:3001/mcp (localhost no Docker).
2. Encontre a senha. O aplicativo protege a conexão contra chamadas não autorizadas com uma senha e não a mostra na tela. No pacote Windows, a senha está no arquivo mcp-token da pasta de dados. No menu da barra de tarefas, escolha Veri klasörünü aç (Abrir a pasta de dados). No Docker, execute este comando: docker compose exec -T seotracker cat /app/.wrangler/mcp-token (no Git Bash, coloque MSYS_NO_PATHCONV=1 na frente).
3. Siga a seção do seu assistente.

Claude Code

No terminal (a janela de comandos), execute o seguinte. Troque <parola> pela sua própria senha:

claude mcp add --transport http --scope user seotracker http://127.0.0.1:3001/mcp --header "Authorization: Bearer <parola>"

Depois digite /mcp dentro do Claude Code e escolha Reconnect. Você chama os modelos de tarefa prontos com uma barra, como /seo-audit.

Codex

Execute este comando:

codex mcp add seotracker --url http://127.0.0.1:3001/mcp --bearer-token-env-var SEOTRACKER_MCP_AUTH

Depois coloque a senha em uma variável de ambiente (uma configuração que o seu computador memoriza) chamada SEOTRACKER_MCP_AUTH. No Windows, com o PowerShell: [Environment]::SetEnvironmentVariable('SEOTRACKER_MCP_AUTH', '<parola>', 'User'). Você chama os modelos como $seo-audit.

Cursor

Escreva isto no arquivo .cursor/mcp.json do seu projeto:

{
  "mcpServers": {
    "seotracker": {
      "url": "http://127.0.0.1:3001/mcp",
      "headers": { "Authorization": "Bearer ${env:SEOTRACKER_MCP_AUTH}" }
    }
  }
}

Defina a variável de ambiente do mesmo modo que no Codex. Esta configuração ainda não foi testada em uma instalação do Cursor. Se a sua versão do Cursor pedir um campo diferente, consulte a documentação do Cursor.

Texto de configuração pronto

Este é o caminho mais fácil:

1. Clique no botão Ajan kurulum istemini kopyala (Copiar o prompt de configuração do agente) na tela. Há um botão separado para o Codex.
2. Cole o texto no seu assistente. O assistente configura a conexão, a testa com "whoami" e "list_projects" e instala os modelos.

O Kurulum istemi (sıfırdan kurulum) (Prompt de instalação, instalação completa) faz o assistente executar toda a configuração por você, desde colocar o aplicativo para funcionar até a conexão com o Google. Ele conhece tanto o pacote Windows quanto a instalação Docker.

Instalar os modelos de tarefa prontos

A aba Beceriler (Skills) descreve os seis modelos de tarefa prontos. Diga ao assistente "instale as skills do seotracker". O texto de configuração sabe onde copiá-las. Para atualizar, clique no botão Güncelleme istemini kopyala (Copiar o prompt de atualização).

Ferramentas

São 33 ferramentas no total. A coluna "Grava" mostra as ferramentas que alteram dados no aplicativo. A coluna "Cota" mostra as ferramentas que gastam a cota diária do Google. As ferramentas que gravam não devem ser chamadas sem a sua aprovação. Modelos bem construídos perguntam antes, mas o aplicativo não.

As ferramentas do Analytics usam a cota de relatórios do Google Analytics (200.000 unidades por dia em uma propriedade padrão). Você pode acompanhar essa cota no aplicativo, na seção Sınırlar (Limites) da tela Ayarlar (Configurações).

Modelos de tarefa prontos (skills)

Verificação

• Diga ao assistente "chame a ferramenta whoami". Ele deve informar o ID da instalação.
• O selo na tela Ajan kurulumu deve dizer Bağlandı (Conectado), e a hora da última chamada deve aparecer.
• "list_projects" deve listar os seus projetos.

Perguntas frequentes

O assistente envia os meus dados para fora? Seus dados vão para o modelo que o assistente usa. Isso depende dos termos de privacidade do próprio assistente. O aplicativo apenas responde à conexão no seu computador.

Funciona sem senha? No Docker, funciona com MCP_TOKEN=off. No pacote Windows, a senha está sempre ligada. Em uma conexão sem senha, qualquer programa no mesmo computador pode chamar as 33 ferramentas.

O assistente pode esgotar a minha cota do Google? inspect_urls e run_site_audit a usam. Os modelos consultam no máximo 20 endereços por tarefa. Eles só iniciam uma auditoria quando você pede. Aplique o mesmo limite ao seu assistente.

Qual assistente é melhor? Não faz diferença, as ferramentas são as mesmas. O texto de configuração está pronto para o Claude Code, o Codex e o Cursor. Outros assistentes funcionam com o mesmo endereço e a mesma senha, se oferecerem suporte a MCP.

Se algo der errado

• O assistente recebe um erro 401. A senha está errada ou não está sendo enviada. Copie o valor do arquivo de novo. Confira que não sobrou um caractere de quebra de linha no fim.
• A conexão é recusada. O aplicativo não está em execução. Veja o ícone da barra de tarefas ou a saída de docker compose ps.
• O assistente diz "tool not found". Recarregue a conexão. No Claude Code, digite /mcp e escolha Reconnect.
• Os modelos não aparecem. Cole o texto de configuração de novo. Os modelos são copiados para a pasta do próprio assistente ($HOME/.agents/skills no Codex).

Última atualização: 23 de outubro de 2026. Viu algum erro? Relate no GitHub.