Conectar Cursor, VS Code e outros clientes MCP

A Searcherries é um servidor MCP padrão do tipo Streamable HTTP. Os clientes compatíveis com OAuth se registram sozinhos na URL do servidor e fazem login pelo navegador. Um cliente que não consegue fazer isso pode usar um token de acesso pessoal.

A URL do servidor é:

https://app.searcherries.com/mcp/searcherries

Você precisa de uma conta da Searcherries com um projeto. O plano grátis fornece os dados do Search Console e do GA4 do projeto; os dados de visibilidade em IA (respostas, concorrentes, citações, recomendações) exigem o plano Starter ou Pro, e um teste grátis ativo também vale. A página do MCP tem uma aba para cada cliente com uma configuração pronta para copiar.

Cursor

O jeito mais rápido é o link de instalação: Adicionar a Searcherries ao Cursor. O Cursor abre e pede que você instale o servidor. Depois, selecione Connect (Conectar) ao lado de Searcherries nas configurações de MCP e aprove o acesso no navegador.

Para adicionar manualmente:

Abra as configurações do Cursor e procure MCP. Abra a configuração global de MCP ou abra diretamente o ~/.cursor/mcp.json.
Cole a configuração abaixo e salve. Se o arquivo já tiver servidores, adicione a Searcherries dentro do objeto mcpServers existente.
Ative a Searcherries na lista de MCP. Selecione Connect ou o aviso de login e aprove o acesso no navegador.
Abra um chat do Agent e pergunte: “Liste meus projetos da Searcherries”. Permita a chamada da ferramenta da Searcherries quando o Cursor pedir.

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

Para usar o servidor em um só projeto, salve a mesma configuração em .cursor/mcp.json dentro desse projeto. O guia de MCP do Cursor descreve essas configurações.

VS Code com GitHub Copilot

O jeito mais rápido é o link de instalação: Instalar a Searcherries no VS Code. O VS Code abre e pede que você instale o servidor. Depois, inicie o servidor, confirme que confia nele e faça login na Searcherries pelo navegador.

Para adicionar manualmente:

Abra a Paleta de Comandos: Ctrl+Shift+P no Windows e no Linux, Cmd+Shift+P no Mac.
Execute MCP: Add Server, escolha HTTP e cole a URL do servidor.
Dê ao servidor o nome searcherries. Escolha Global para todos os projetos ou Workspace para o projeto atual.
Inicie o servidor, confirme que confia nele e conclua o login na Searcherries quando for solicitado.
Abra o Copilot Chat no modo Agent, ative a Searcherries em Configure Tools (Configurar ferramentas) e pergunte: “Liste meus projetos da Searcherries”.

Você também pode adicionar o servidor ao .vscode/mcp.json. Mantenha os servidores que já existirem dentro do objeto servers.

{
  "servers": {
    "searcherries": {
      "type": "http",
      "url": "https://app.searcherries.com/mcp/searcherries"
    }
  }
}

A extensão do Codex dentro do VS Code tem configurações de MCP próprias; para ela, siga o guia do Codex. O guia de servidores MCP do VS Code descreve a parte do Copilot.

Qualquer outro cliente

Procure a seção MCP servers (servidores MCP) ou Integrations (integrações) no seu app e adicione um servidor remoto chamado Searcherries.
Escolha Streamable HTTP, cole a URL do servidor e use OAuth ou o login pelo navegador, se o app oferecer.
Se o app só aceitar um token bearer, crie um como descrito abaixo e defina o cabeçalho Authorization como Bearer YOUR_TOKEN.
Salve, ative o servidor e pergunte: “Liste meus projetos da Searcherries”.

Um cliente que só aceita servidores de comando local (stdio) precisa de um adaptador HTTP remoto próprio.

Tokens de acesso

Use um token de acesso pessoal quando um cliente MCP não conseguir concluir a autorização no navegador. Com o token, esse cliente lê os dados da Searcherries disponíveis para a sua conta. Clientes que fazem login pelo navegador não precisam de token.

O mesmo token também autentica a API REST, então um único token pode servir a um cliente MCP e a um script ou plataforma de automação.

Criar um token

Abra o MCP na Searcherries.
Abra a aba Other clients (Outros clientes) e localize Access tokens (Tokens de acesso).
Digite um Token name (nome do token) descritivo, como “Assistente de analytics no meu notebook”.
Selecione Create token (Criar token).
Copie o valor exibido na hora e guarde-o em um lugar seguro.

O token aparece uma única vez e não pode ser recuperado na página depois. Se você perdê-lo, revogue-o e crie outro.

Uma conta pode ter até cinco tokens de acesso pessoais ativos. A tabela mostra as datas de criação e de expiração de cada token. Guie-se pela expiração exibida em vez de supor que um token dura para sempre.

Configurar o cliente

Use uma conexão MCP remota ou Streamable HTTP com a URL do servidor acima e configure um cabeçalho HTTP de autorização:

Authorization: Bearer YOUR_TOKEN

YOUR_TOKEN é um marcador de exemplo. Substitua-o pelo valor que você gerou, usando o campo seguro de credenciais do cliente ou o suporte a variáveis de ambiente, quando houver.

Alguns clientes usam uma configuração parecida com esta:

{
  "mcpServers": {
    "searcherries": {
      "type": "http",
      "url": "https://app.searcherries.com/mcp/searcherries",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

O formato da configuração muda de um cliente para outro. A aba Other clients da página do MCP na Searcherries traz os dados de conexão para você adaptar ao seu cliente.

Revogar o acesso

Localize o token pessoal na tabela e selecione Revoke (Revogar). Confirme a ação. Os clientes que usam esse token perdem o acesso na hora, então atualize ou desconecte qualquer cliente que dependia dele.

A tabela de tokens pessoais gerencia os tokens criados nela. Para encerrar uma conexão feita por OAuth, use os controles de conectores do cliente externo; não presuma que revogar um token pessoal sem relação com essa conexão também desconecta o OAuth.

Manter o token em sigilo

Não coloque tokens em repositórios públicos, documentos compartilhados, mensagens ao suporte ou capturas de tela. Se um token ficar exposto, revogue-o e gere um substituto.

Se a seção Access tokens não estiver disponível, use OAuth, se o cliente aceitar, ou fale com o suporte. Você não precisa executar nenhum comando de administração do servidor.