Conectar o Codex à Searcherries

Conecte o Codex ao servidor MCP remoto da Searcherries para que ele leia os dados coletados do seu projeto. Você precisa do Codex (a CLI, o app para desktop ou a extensão para IDE) e de uma conta da Searcherries com um projeto; o plano grátis fornece os dados do Search Console e do GA4, e os dados de visibilidade em IA exigem o plano Starter ou Pro. As três versões do Codex compartilham a mesma configuração local, então você só configura o servidor uma vez.

Os mesmos comandos aparecem em Codex na página do MCP. O Codex não tem link de instalação para servidores MCP, então o comando de uma linha abaixo é o caminho mais curto; a opção do plugin, mais abaixo, adiciona oito skills de GEO prontas.

Conectar pela CLI

Execute este comando no terminal. Ele registra o servidor e inicia o login:

codex mcp add searcherries --url https://app.searcherries.com/mcp/searcherries && codex mcp login searcherries

Conclua o fluxo de autorização da Searcherries no navegador. Confira se você está logado na conta cujos projetos quer que o Codex leia.

Com a autorização pelo navegador, você não precisa gerar um token de acesso pessoal nem copiar manualmente o OAuth Client ID do Claude.

Ou instalar o plugin pela CLI

O plugin da Searcherries para o Codex adiciona o mesmo servidor MCP e mais oito skills de GEO: $action-plan, $geo-audit, $content-gaps, $competitor-gap, $page-brief, $question-review, $weekly-report e improve-ai-visibility. O Codex só instala plugins de um marketplace registrado, então este comando registra o marketplace da Searcherries a partir do GitHub, instala o plugin e inicia o login:

codex plugin marketplace add eduardmur/searcherries-codex-plugin && codex plugin add searcherries@searcherries && codex mcp login searcherries

Depois, abra uma nova sessão do Codex, porque as skills e os servidores incluídos só aparecem nas sessões iniciadas após a instalação. /plugins abre o navegador de plugins, $ seguido do nome de uma skill executa um fluxo de trabalho e codex plugin marketplace upgrade searcherries baixa as atualizações. O marketplace é o repositório público eduardmur/searcherries-codex-plugin.

O Codex CLI 0.163 também lista o diretório de plugins do ChatGPT como um marketplace integrado chamado openai-curated-remote, então codex plugin add searcherries@openai-curated-remote instala o pacote do diretório (o servidor e a skill improve-ai-visibility) sem registrar nada. A OpenAI não documenta esse nome de marketplace, por isso ele pode mudar.

Instalar o plugin no app para desktop do Codex

O Codex no app para desktop do ChatGPT usa o mesmo diretório de plugins do ChatGPT, onde a Searcherries está listada. Abra Plugins, procure Searcherries e selecione Install plugin (Instalar plugin); depois, aprove o acesso à Searcherries no navegador e abra um novo chat do Codex. O plugin contém o servidor MCP e a skill improve-ai-visibility, que transforma as descobertas em alterações de página no código do seu site.

A extensão para IDE não aceita plugins; nela, use os comandos da CLI acima ou a configuração abaixo.

Ou adicionar o servidor manualmente

No app para desktop, abra Settings → MCP servers (Configurações → Servidores MCP) e escolha Add server (Adicionar servidor); na extensão para IDE, o menu da engrenagem tem a mesma entrada MCP servers. Dê ao servidor o nome Searcherries, escolha Streamable HTTP, cole https://app.searcherries.com/mcp/searcherries, salve e reinicie se for pedido. Depois, selecione Authenticate (Autenticar) e faça login na Searcherries.

Você também pode adicionar esta seção ao ~/.codex/config.toml, junto dos servidores já configurados, e executar o comando de login acima:

[mcp_servers.searcherries]
url = "https://app.searcherries.com/mcp/searcherries"

Verificar a conexão

Execute:

codex mcp list

Dentro de uma conversa do Codex, /mcp mostra o estado da conexão. No Codex, peça:

Use a Searcherries para listar meus projetos. Se houver mais de um, pergunte qual projeto analisar.

Depois de escolher um projeto, você pode pedir um relatório com base nos dados disponíveis de visibilidade, concorrentes, citações e analytics.

Para detalhes atualizados da configuração do Codex, veja a documentação oficial de MCP.

Usar um token de acesso pessoal quando necessário

Se o seu cliente não conseguir concluir o OAuth, crie um token na página do MCP da Searcherries. Adicione a configuração abaixo ao arquivo de configuração do Codex, normalmente ~/.codex/config.toml:

[mcp_servers.searcherries]
url = "https://app.searcherries.com/mcp/searcherries"
bearer_token_env_var = "SEARCHERRIES_MCP_TOKEN"

Forneça o token por meio de uma variável de ambiente chamada SEARCHERRIES_MCP_TOKEN no ambiente que inicia o Codex. Mantenha o token fora de arquivos de configuração compartilhados, repositórios e capturas de tela.

O guia de tokens explica como criar, substituir e revogar tokens.

Solução de problemas

Se o servidor não for encontrado, confira se a URL inclui /mcp/searcherries. Se a autorização falhar, verifique se a conta tem um projeto (a tela de consentimento pede que você configure o seu site antes) e repita o login pelo navegador.

Na autenticação por token, a variável precisa estar disponível para o próprio processo do Codex, e não só em outra sessão do terminal. Se um token foi revogado ou expirou, substitua-o.

A conexão lê os dados salvos, mas não pode rodar uma nova análise nem alterar o seu projeto. Por isso, uma conexão bem-sucedida não atualiza, por si só, um relatório antigo.

Prompts e ferramentas

O servidor expõe nove ferramentas somente leitura (get-action-plan, list-projects, get-project-summary, get-ai-answers, get-search-performance, get-competitors, get-citations, get-ai-traffic, get-project-data) e sete prompts (action-plan, geo-audit, content-gaps, competitor-gap, page-brief, question-review, weekly-report) com receitas prontas para as tarefas mais comuns. Onde o Codex mostrar os prompts do servidor, escolha um e passe o nome ou o id do projeto. Se ele não mostrar, pergunte ao Codex no que trabalhar agora (isso chama get-action-plan) ou peça que ele comece por get-project-summary do seu projeto e siga a referência das ferramentas.