That SEO Agent
Pare de dar briefing para a IA sobre seu próprio site.
Documentação
UM ÚNICO CAMINHO DE ENTRADA, E ELE ESTÁ NA SUA MÁQUINA.
O servidor roda na sua máquina e escuta em um endereço de loopback, então conectar um cliente é um único comando, sem chave para colar e sem conta para aprovar. Clone, inicie e aponte o Claude Code ou o Cursor para ele.
git clone --depth 1 https://github.com/thatseoagent/mcp.git
Node 24 ou mais recente · pnpm · nada para se cadastrar
Procurando pelo plugin, pelo conector do claude.ai ou por uma chave de API? Eles apontavam para um servidor hospedado que não existe mais. O que está abaixo substitui todos eles.
Três comandos, do início à conexão
Clone, compile, conecte. O servidor escuta no seu endereço de loopback, então o cliente aponta para a sua própria máquina e não para nós. Não há chave para colar nem permissão para aprovar.
- 01 · Clone
git clone --depth 1 https://github.com/thatseoagent/mcp.gitCopiar Um clone raso: você quer as ferramentas, não o histórico. Tudo o que o servidor precisa está no repositório. - 02 · Compile e inicie
pnpm install && pnpm build && pnpm startCopiar Ele escuta em http://127.0.0.1:3737/mcp, e, se essa porta estiver ocupada, ele se recusa a iniciar em vez de silenciosamente mudar de porta e deixar seu cliente apontando para nada. - 03 · Aponte um cliente para ele
claude mcp add --transport http thatseoagent http://127.0.0.1:3737/mcpCopiar Claude Code mostrado. Qualquer cliente que fale HTTP MCP funciona de forma idêntica, porque o endereço é tudo o que ele precisa.
Para um cliente que aceita JSON em vez de um comando: Cursor e qualquer outra coisa que aceite uma URL MCP
{
"mcpServers": {
"thatseoagent": {
"type": "http",
"url": "http://127.0.0.1:3737/mcp"
}
}
}
O mesmo endereço único, na outra notação. Não há cabeçalho Authorization, porque não há nada entre seu cliente e sua própria máquina. O campo de tipo também aceita streamable-http como um alias para http, se o seu cliente insistir nisso.
Quais clientes podem alcançá-lo
Um endereço de loopback só é acessível a partir da sua própria máquina. Esse único fato decide toda a tabela: um cliente que se conecta a partir da nuvem do seu fornecedor não consegue ver o seu servidor, por mais bem que fale MCP.
- Claude Code claude mcp add --transport http A sintaxe documentada aceita qualquer URL, incluindo uma de loopback.
- Cursor url em mcp.json Aponte para http://127.0.0.1:3737/mcp da mesma forma que você faria com um servidor remoto.
- Claude Desktop somente stdio Seu mecanismo local inicia um processo filho a partir de claude_desktop_config.json — comando e argumentos, sem campo para um endereço HTTP local. Seus conectores são buscados na nuvem da Anthropic.
- claude.ai, Cowork, mobile conector do lado da nuvem A central de ajuda da Anthropic é explícita: um conector personalizado é acessado pela infraestrutura de nuvem deles, e não pelo seu dispositivo, e servidores MCP locais não estão disponíveis no Cowork ou no claude.ai.
- ChatGPT HTTPS público exigido Uma URL de conector precisa ser acessível remotamente; um endereço localhost é recusado como inseguro.
Qualquer coisa não listada segue a mesma regra: se o cliente abre a conexão a partir da sua máquina, funciona; se ele abre a conexão a partir do servidor de alguém, não funciona.
Crie um cliente de aplicativo de desktop
No Google Cloud Console, em APIs & Services e depois em Credentials. Desktop app é o tipo que permite o redirecionamento de loopback que este login usa. Ative a Search Console API e a Google Analytics Data API no mesmo projeto.
Coloque os dois valores no .env
GOOGLE_CLIENT_ID e GOOGLE_CLIENT_SECRET, em um arquivo .env na raiz do servidor. O arquivo é ignorado pelo git, é lido uma vez na inicialização, e uma variável já definida no seu shell tem prioridade sobre ele.
Faça login uma vez
O comando imprime os dois escopos que ele solicita e o que deixa de funcionar sem cada um, abre seu navegador, recebe o redirecionamento em uma porta de loopback efêmera e para de escutar. Ambos os escopos são somente leitura. Execute novamente para trocar de conta.
pnpm login
O que nunca sai da sua máquina
Executar o servidor você mesmo move as partes sensíveis para o seu próprio disco. É isso que muda aqui, mais do que a licença.
Seus tokens do Google
Armazenados em um banco de dados SQLite local no diretório do próprio servidor, ignorado pelo git. Nada é transmitido para nós, porque não há "nós" no caminho da requisição mais.
Seu histórico de auditoria
Registros de sites, execuções de auditoria, leituras de métricas e um cache de resultados, no mesmo arquivo local. Ele é criado e migrado no primeiro uso e é opcional: desligue-o e todas as ferramentas sem credenciais continuam funcionando.
O socket de escuta
Ele faz bind em 127.0.0.1 e recusa requisições de origens cruzadas, então uma página web não consegue alcançá-lo. Também não há autenticação. No seu próprio laptop, essa é a troca certa; em uma máquina em que outras pessoas podem fazer login, não é.
O guia de configuração vive junto com o código
O repositório inclui um documento de configuração que leva uma máquina limpa a um servidor funcional e a um relatório completo, incluindo os passos do Google Cloud, e mapeia cada mensagem de erro comum para sua correção. Ele é escrito em três etapas e diz isso: a primeira não precisa de contas nem de chaves, e você pode parar depois dela. Ele é mantido ao lado daquilo que descreve, e é por isso que esta página o linka em vez de copiá-lo.