Docs do GSC Magic

O que é o GSC Magic

O GSC Magic é um servidor MCP hospedado. Você entra uma vez, adiciona uma URL ao seu cliente de IA e o agente passa a ler seus dados de busca diretamente, em vez de trabalhar com exportações em CSV e capturas de tela.

Além disso, o painel em app.gscmagic.com mostra os mesmos dados em gráficos, guarda um histórico maior que os 16 meses do Google, envia alertas e registra tudo o que seus agentes fazem.

Início rápido

1. Crie sua conta. Abra o painel e continue com o Google, ou crie uma conta com e-mail e senha (você confirmará o endereço por e-mail). Use a conta do Google que é dona das suas propriedades do Search Console.
2. Permita o acesso. No primeiro login, o Google é consultado uma única vez sobre Search Console (leitura e escrita) e Google Analytics 4 somente leitura. As ferramentas de escrita só são oferecidas no Pro e no Agency, e você pode desativá-las em Settings → Write access.
3. Importe seus sites. Na tela Welcome, escolha as propriedades a adicionar. O GSC Magic mostra primeiro as de maior movimento e respeita o limite de sites do seu plano. Sites do Bing e propriedades do GA4 com o mesmo host são vinculados automaticamente.
4. Conecte seu cliente de IA. Siga Clientes de IA, abaixo. O endpoint é https://mcp.gscmagic.com/mcp.
5. Pergunte alguma coisa. Comece com “Liste meus sites no GSC Magic.” Depois experimente um prompt de Exemplos de prompts.

A página Connect do painel traz as mesmas instruções, com botões de um clique e um teste de conexão.

Clientes de IA

O endpoint é o mesmo em todos os lugares:

https://mcp.gscmagic.com/mcp

Os clientes que oferecem suporte a OAuth levam você a fazer login por uma página do GSC Magic. Para os que não oferecem, use um token de acesso.

Claude (claude.ai, desktop e celular)

1. Use Add to Claude: ele abre o GSC Magic no diretório de conectores do Claude. Ou abra Customize → Connectors → Add custom connector, dê o nome GSC Magic e cole o endpoint.
2. Clique em Connect ao lado de GSC Magic, continue com o Google (ou e-mail) e permita o acesso.
3. Em uma nova conversa, ative o GSC Magic em + → Connectors e peça “Liste meus sites no GSC Magic.”

Nos planos Team e Enterprise, somente um Owner pode adicionar o conector (Organization settings → Connectors → Add → Custom); depois, os membros clicam em Connect por conta própria. Conectores adicionados na web aparecem nos apps de desktop e de celular.

ChatGPT

1. No chatgpt.com, abra Plugins, clique em + e escolha Add custom MCP server. Não é preciso ativar o Developer mode.
2. Dê o nome GSC Magic, cole a URL do servidor acima e escolha OAuth. Deixe o client ID e o secret em branco, aceite o aviso de risco e clique em Create.
3. Entre com o Google (ou com seu e-mail e senha do GSC Magic) quando o ChatGPT abrir a página do GSC Magic e, depois, digite @ em uma nova conversa e escolha GSC Magic.

Servidores MCP personalizados exigem um plano pago do ChatGPT; no Business, só proprietários e administradores do workspace podem adicioná-los. O ChatGPT não tem campo para um cabeçalho personalizado, então não consegue usar um token de acesso. Se a sua conta ainda mostra o fluxo antigo <em>Settings → Apps → Create app</em>, use lá o mesmo nome, a mesma URL e as mesmas configurações de OAuth.

Claude Code

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp

Depois digite /mcp, escolha gsc-magic e selecione Authenticate. Com um token, em vez do login pelo navegador:

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp \
  --header "Authorization: Bearer gsm_YOUR_TOKEN"

Cursor

Adicione isto a ~/.cursor/mcp.json e clique em Connect ao lado de gsc-magic em Settings → MCP:

{
  "mcpServers": {
    "gsc-magic": {
      "url": "https://mcp.gscmagic.com/mcp"
    }
  }
}

Versões antigas do Cursor concluem o login em cursor://, que o GSC Magic não aceita. Use um token nelas:

{
  "mcpServers": {
    "gsc-magic": {
      "url": "https://mcp.gscmagic.com/mcp",
      "headers": {
        "Authorization": "Bearer gsm_YOUR_TOKEN"
      }
    }
  }
}

VS Code, Windsurf e outros

Qualquer cliente que fale MCP remoto via Streamable HTTP funciona. Informe o endpoint e, se ele não suportar OAuth, este cabeçalho de requisição:

Authorization: Bearer gsm_YOUR_TOKEN

A página Connect do painel traz trechos prontos para VS Code, Windsurf, Hermes Agent, OpenClaw, Grok e DeepSeek.

Tokens de acesso

Um token de acesso (gsm_…) permite que um cliente se conecte sem login pelo navegador. Serve para scripts, ferramentas de automação e clientes sem OAuth.

• Crie um no painel, em Connect → Access tokens (proprietário ou administrador do workspace). O token completo é exibido uma única vez. Guarde-o na configuração do próprio cliente, nunca em uma conversa.
• Os tokens expiram após 365 dias por padrão. Você pode escolher outra validade, de até 730 dias, ou nenhuma.
• Marque Read-only para que um token seja incapaz de escrever, qualquer que seja o seu plano.
• Um token funciona apenas no endpoint MCP, não na API do painel, e pode ser revogado a qualquer momento. A revogação vale imediatamente.
• O botão Test connection da página Connect verifica se um endpoint e um token funcionam.

Fontes de dados

Conectado não é vinculado. O acesso ao GA4 ou uma chave do Bing apenas torna as propriedades detectáveis. Para ver dados na página Overview, vincule uma propriedade do GA4 e um site do Bing a cada site em Sites. Em Sources você vê quantos sites estão vinculados.

Cada fonte tem Reconnect e Disconnect. Desconectar o GA4 faz o GSC Magic parar de lê-lo e remove as linhas do GA4 que armazenamos; sua conexão com o Google e o Search Console continuam como estão.

Painel

Histórico. Depois que você adiciona um site, o GSC Magic recupera até 16 meses de dados diários (14 dias no Free) e passa a atualizar a cada seis horas. Ao subir de plano, os meses mais antigos são trazidos. Você pode exportar ou excluir seu histórico armazenado a qualquer momento.

Alertas e resumo

No Pro e no Agency, o GSC Magic verifica seus sites após cada sincronização e envia um e-mail quando algo pede atenção. O envio é por e-mail para o proprietário do workspace. Toda mensagem tem um link para cancelar a inscrição.

• Queda de tráfego: uma página perdeu uma grande parte dos cliques (30% por padrão).
• Indexação: uma página que tinha tráfego deixou de aparecer.
• Canibalização: duas das suas páginas passaram a dividir uma consulta.
• Ranking: uma consulta importante caiu várias posições.
• Tráfego de IA: as sessões vindas de assistentes de IA deram um salto (exige GA4).

Você pode editar limites, desativar regras e excluí-las (com um Desfazer por alguns segundos). Um resumo semanal sintetiza seus sites. No Free, o cartão What changed do Overview mostra uma prévia do que essas regras encontrariam. Cada ocorrência é informada uma vez por semana.

Exemplos de prompts

Troque example.com pelo seu site. Seu agente escolhe sozinho as ferramentas certas.

Mais ideias na biblioteca de prompts.

Referência de ferramentas

As ferramentas marcadas com escrita alteram algo no Google, no Bing ou no IndexNow. Elas só são oferecidas ao agente no Pro e no Agency enquanto o modo de escrita estiver ativado em Settings (ele é ativado assim que o Google concede acesso total ao Search Console no login) e a fonte autorizar. Todas as demais são somente leitura.

Planos e limites

• Teste de 7 dias do Pro em contas novas, sem necessidade de cartão. Quando termina, a conta volta ao Free. Um teste por endereço de e-mail.
• Toda chamada a uma ferramenta conta, inclusive as que falham. O limite diário é zerado à meia-noite UTC.
• Se um plano terminar e você tiver mais sites do que o novo plano permite, o painel pergunta quais manter e o endpoint MCP fica pausado até você escolher.
• Pagamentos e faturas são tratados pela Polar. Cancele quando quiser; o plano continua ativo até o fim do período pago.

Equipes e perfis

O plano Agency inclui cinco assentos, contando o proprietário. Todos trabalham no workspace, nos dados e no plano do proprietário.

Grupos de clientes restringem uma pessoa a sites selecionados. Um membro ou administrador de um grupo vê apenas esses sites no painel, nos alertas e via MCP, e mais nada. Subdomínios contam como sites separados, então você pode dar a.com a um cliente e blog.a.com a outro. Os convites são enviados por e-mail e valem por sete dias.

Segurança e privacidade

• As credenciais do Google e do Bing são criptografadas em repouso. Os tokens de acesso são armazenados apenas como hashes.
• Seu agente vê somente dados de contas que você conectou, dentro do seu workspace e do seu perfil.
• Contas Free são somente leitura. No Pro e no Agency, as ferramentas de escrita ficam disponíveis até que o proprietário desative o modo de escrita em Settings; membros são sempre somente leitura e cada token pode ser forçado a somente leitura.
• As sessões expiram após 14 dias de inatividade. Ações sensíveis, como excluir sua conta, exigem um login recente.
• Exporte tudo o que guardamos sobre você em Settings ou exclua ali sua conta e seus dados. As assinaturas pagas ativas precisam ser canceladas antes.

Os detalhes estão na política de privacidade e nos termos. Para relatar uma vulnerabilidade, escreva para support@gscmagic.com.

Solução de problemas

Ainda travado? Escreva para support@gscmagic.com informando o cliente que você usa e a mensagem de erro. Nunca inclua um token de acesso.

Respostas rápidas