Consultar o Google Search Console com Claude ou Cursor via MCP.
Uma configuração de 5 minutos que permite que sua ferramenta de IA faça perguntas em linguagem simples sobre seus dados de SEO — cliques, impressões, CTR, principais consultas, páginas com baixo desempenho — sem expor os tokens OAuth do Google Search Console ao fornecedor de IA ou abrir portas de firewall em sua rede.
Pergunte à Nova, obtenha SQL + gráficos
Conheça a Nova API REST de banco de dadosUma chave por parceiro. Nenhuma credencial é compartilhada.
Criar uma API AutomaçãoSincronização programada para mais de 6 plataformas
Explorar API para SQLConsultar APIs com SQL, sem código
Explorar Banco de dados de IA MCPClaude, Cursor, ChatGPT e Grok interagem com seus dados.
Conectar IAO Query Streams é uma plataforma segura de integração de dados em tempo real que integra todos os bancos de dados e APIs SaaS da sua conta ao Claude, Cursor, ChatGPT e Grok — tudo por meio de uma única chave MCP, sem necessidade de alterações no firewall. Este guia explica passo a passo como configurar o conector do Google Search Console para que sua ferramenta de IA possa responder a perguntas em linguagem simples sobre cliques, impressões, CTR e classificação de páginas, sem que você precise copiar e colar dados CSV exportados da interface web do GSC. Saiba mais em QueryStreams.com e inscreva-se gratuitamente Comece a fazer perguntas reais de SEO à sua ferramenta de IA.
O que o Query Streams MCP oferece para o Google Search Console?
Outros servidores "Google Search Console MCP" no cenário de código aberto conectam a ferramenta de IA diretamente à API do GSC. Isso funciona, mas insere um token OAuth do Google na configuração do seu cliente de IA, limita a ferramenta de IA apenas ao Search Console e não fornece nenhum registro de auditoria do que a IA realmente consultou. O Query Streams MCP resolve um problema mais amplo: uma única chave, todos os conectores, registro de auditoria completo e a ferramenta de IA nunca armazena suas credenciais do Google.
Zero buracos de firewall de entrada
O Agente de Rede abre uma única conexão de saída criptografada na nuvem para o Query Streams. Seu cliente de IA se conecta à nuvem, nunca à sua rede. Sem necessidade de abrir portas, adicionar IPs à lista de permissões ou usar VPN.
Uma chave, cada conector
A mesma chave MCP alcança todos os bancos de dados e APIs SaaS conectados à sua conta. Adicione um conector Stripe ou PostgreSQL amanhã e a ferramenta de IA o reconhecerá sem precisar digitar a chave novamente.
Inteligência de esquema integrada
A IA visualiza descrições selecionadas por IA, tipos semânticos, listas de valores de enumeração e chaves estrangeiras descobertas para cada coluna — não apenas os valores brutos. esquema_de_informação Saída. Gera SQL correto na primeira tentativa.
O modo somente leitura é imposto no agente.
Nem mesmo um LLM alucinado consegue emitir EXCLUIR ou ATUALIZAR por meio de fluxos de consulta MCP. O agente de rede rejeita tudo o que não for SELECIONAR, COM, ou EXPLICAR antes de chegar à fonte de dados.
limites de taxa por chave
Por padrão, são 60 requisições por minuto e 10 chamadas de execução por minuto, configuráveis por chave. Um loop descontrolado de chamadas de ferramentas de IA atinge um limite de tokens, não sua cota do GSC ou sua carteira.
Como funciona sem abrir portas do firewall
O agente de rede Query Streams é instalado uma única vez em qualquer máquina que consiga acessar o Google Search Console e estabelece uma conexão TLS de saída com a nuvem. Quando a IA faz uma pergunta, o agente chama a API do GSC, armazena a resposta em cache em um DuckDB local para que a IA possa executar SQL com base nela e transmite o resultado de volta pelo mesmo canal, sem expor nada na entrada e sem que a ferramenta de IA veja seu token OAuth do Google. Como funciona a conexão somente de saída →
Cliente de IA
Cursor, Claude,
ChatGPT, Grok
Servidor QS MCP
HTTP de fluxo
Autenticação com chave X-MCP
Agente de rede
Na sua rede
Link de saída na nuvem
Console de pesquisa do Google
OAuth mantido por
o agente
A tecla MCP que você fornece ao Cursor ou ao Claude tem escopo (ler / analisar / executar), revogável a qualquer momento e com limite de taxa por chave. A ferramenta de IA chama essas ferramentas MCP para realizar seu trabalho:
chave_padrão com opções de substituição de parâmetros.Por que a Inteligência de Esquema torna o Query Streams MCP diferente?
A maioria dos servidores "MCP para X" no cenário de código aberto oferece à sua ferramenta de IA o mesmo esquema_de_informação Seu banco de dados é entregue a um estranho. Nomes de colunas. Tipos de dados. Talvez uma chave primária. O especialista em direito fica sem saber o quê. status_id = 3 significa, o quê usr_eml lojas, ou se pedidos_do_cliente.id_do_cliente na verdade se junta a clientes.id (Nenhuma chave estrangeira foi declarada em nenhum dos casos). É por isso que o primeiro SQL que a maioria dos LLMs escreve em um esquema vazio está errado — não porque o LLM seja ruim, mas porque não possui os dados necessários para estar correto.
O Query Streams MCP retorna esse mesmo esquema enriquecido com o que chamamos de Inteligência de Esquema (IE) — Metadados selecionados por IA, gerados pela execução de consultas de perfil em seus dados. real dados antes mesmo que o cliente de IA os solicite. Quando a SI está habilitada em um conector e banco de dados, todas as ferramentas de esquema que a IA chama (qs_get_connector_schema, qs_get_table_schema, tabela_de_perfil_qs, qs_get_relacionamentos) retorna o esquema básico mais seis camadas de conhecimento selecionado. O LLM para de fazer suposições.
Para tornar isso concreto, veja o que o cliente de IA recebe de uma única consulta. qs_get_table_schema chamada contra o conector GSC análise_de_pesquisa tabela — primeiro sem Schema Intelligence, depois com ele.
As seis camadas do Schema Intelligence adicionam
Cada camada aborda uma classe específica de questões que o LLM teria que responder por tentativa e erro. A SI é opcional. (conector, banco de dados) O emparelhamento e a execução funcionam como uma análise de perfil única dos seus dados — não alteram seu esquema, não gravam no seu banco de dados e atualizam incrementalmente quando seu esquema é alterado.
Descrições selecionadas por IA
Propósito em linguagem simples para cada banco de dados, esquema, tabela e coluna — gerado uma única vez e atualizado quando o esquema muda. Classificação por nível de confiança; descrições criadas pelo usuário sempre prevalecem.
desempenho de pesquisa por consulta/página.”
Classificações de tabelas
Cada tabela é etiquetada como FACT (eventos transacionais), DIM (referência descritiva) ou LOOKUP (pequenos mapas de código), além de um domínio de negócios — vendas, RH, SEO, finanças, suporte e mais 14.
sites [DIM, domínio:seo]
Tipos semânticos por coluna
Dezoito tipos — moeda, e-mail, data_aaaammdd, código_de_status, porcentagem, posição_no_ranking, identificador, url, nome_da_pessoa e muito mais. A IA gera SQL adequado ao dialeto de cada tipo.
cliques: contador · data: data_aaaammdd
Valores de exemplo extraídos de dados reais
Linhas aleatórias são apresentadas ao LLM para que ele reconheça padrões que nenhum esquema consegue mostrar — convenções de formatação, valores codificados, estilos de abreviação e o formato real das suas strings.
Detecção de enumerações com distribuições
Colunas de baixa cardinalidade (50 ou menos valores distintos, no máximo 5% das linhas únicas) são mapeadas para sua lista completa de valores com a contagem de linhas. A IA nunca tenta adivinhar maiúsculas e minúsculas ou a ortografia.
| COMPRIMIDO (5%)
Descoberta implícita de chave estrangeira
A análise de sobreposição de dados entre tabelas encontra junções que não foram declaradas como restrições DDL. Armazenadas juntamente com chaves estrangeiras formais com pontuações de confiança, retornadas por qs_get_relacionamentos.
(Sobreposição de 97%, confiança de 0,9)
Mesmo prompt, SQL diferente
A prova está no SQL que a ferramenta de IA realmente escreve. Mesma sessão do Cursor, mesmo modelo Claude, mesmo prompt — “Mostre-me as 10 principais consultas do GSC com a maior CTR no mês passado, onde as impressões são superiores a 100.” Sem a Inteligência de Esquemas, o LLM precisa adivinhar. Com ela, o LLM sabe.
si_recomendação bloco informando à IA o que está faltando, incluindo uma opção de chamada única para ativar a SI no meio da conversa via qs_request_si_analysis. Como o Schema Intelligence funciona e quanto tempo leva →
O MCP não é para você? Experimente o Nova AI.
Ignore completamente a configuração JSON: A Nova AI está integrada ao portal web Query Streams. e faz as mesmas perguntas em linguagem simples com base nos seus dados do Google Search Console — “Quais foram as minhas 10 principais perguntas sobre o GSC na semana passada?— mesmo agente, mesma aplicação de modo somente leitura, mesma Inteligência de Esquema, sem infraestrutura MCP.
Conheça a Nova AIPré-requisitos
Antes de começar, certifique-se de ter:
- Uma conta gratuita do Query Streams em my.querystreams.com.
- O Agente de Rede Query Streams instalado em uma máquina com acesso à internet — veja Baixe o Agente de Fluxos de Consulta.
- Um conector do Google Search Console configurado para o agente — veja o existente Configuração do conector de API Guias para emparelhamento OAuth. O agente detém o token OAuth do Google; a ferramenta de IA nunca o utiliza.
- Qualquer cliente de IA compatível com MCP. Neste guia, mostraremos o Cursor, o Claude Desktop, o ChatGPT e o Grok; se você usa o Windsurf, o Zed, o Continue, o Cline, o VS Code Copilot, o Codex ou o Goose, o bloco de configuração é essencialmente o mesmo.
- Cinco minutos.
Gere uma chave MCP
Do /mcp Na página de Fluxos de Consulta, crie uma chave com os escopos desejados.
Insira-o no seu cliente de IA
Um único trecho JSON para Cursor, Claude, ChatGPT ou Grok. A mesma chave em todos os casos.
Faça uma pergunta
“Quais páginas perderam mais cliques no mês passado?” — a IA consulta as ferramentas certas e você obtém a resposta.
Etapa 1: Gere uma chave MCP em Fluxos de Consulta
Faça login no Query Streams e abra o Página MCP (ou faça login primeiro em my.querystreams.com e clique em MCP (na navegação à esquerda). Clique Gerar chaveDê à chave um nome reconhecível (algo como cursor-laptop ou claude-desktop), e selecione os escopos que você deseja que esta chave tenha:
ler— A IA consegue navegar pelos conectores e ler o esquema. Necessário para todo o resto.analisar— A IA pode analisar tabelas e descobrir relações (valores de amostra, distribuições, tipos semânticos). Opcional, mas altamente recomendado para SEO, onde a compreensão do formato das suas consultas é importante.executar— a IA consegue executar SQL. Sem isso, a IA só pode ler metadados do esquema.
Para um fluxo de trabalho típico do tipo "deixe o Claude analisar meus dados do Search Console", todos os três escopos são apropriados. Para uma chave que você está entregando a um colega de equipe ou a um cliente menos confiável, remova o escopo. executar e permitir que eles apenas naveguem. Você pode revogar qualquer chave a qualquer momento na mesma página; o cliente de IA verá. MCP_KEY_REVOGADO na próxima chamada, para de funcionar imediatamente. Não há atraso de propagação.
Copie a chave agora — o Query Streams a exibe uma vez e, em seguida, armazena apenas um hash. Se você a perder, gere uma nova. A chave tem o seguinte formato: qsmcp_ seguido por 48 caracteres aleatórios e é o que seu cliente de IA envia no Chave X-MCP Cabeçalho da solicitação.
Etapa 2: Adicione o Query Streams MCP ao seu cliente de IA
A configuração tem o mesmo formato em todos os clientes compatíveis com MCP — uma entrada de servidor MCP apontando para https://mcp.querystreams.com com a sua chave no Chave X-MCP Cabeçalho. Selecione seu cliente abaixo.
// Editar ~/.cursor/mcp.json { "servidores mcp": { "fluxos de consulta": { "url": "https://mcp.querystreams.com", "cabeçalhos": { "X-MCP-Key": "qsmcp_COLE_A_CHAVE_AQUI" } } } }
// Configurações → Desenvolvedor → Editar configuração { "servidores mcp": { "fluxos de consulta": { "url": "https://mcp.querystreams.com", "cabeçalhos": { "X-MCP-Key": "qsmcp_COLE_A_CHAVE_AQUI" } } } }
// Configurações → Aplicativos e Conectores → Adicionar MCP URL do servidor https://mcp.querystreams.com Cabeçalho de autenticação Chave X-MCP Valor do cabeçalho qsmcp_COLE_A_CHAVE_AQUI // Requer um plano pago do ChatGPT // (Plus / Pro / Team / Enterprise).
// Grok → Configurações → Ferramentas { "servidores_mcp": [{ "nome": "fluxos de consulta", "url": "https://mcp.querystreams.com", "auth_header": "X-MCP-Key", "valor_de_autorização": "qsmcp_..." }] }
Reinicie seu cliente de IA. Na próxima inicialização, ele detectará as oito ferramentas Query Streams MCP listadas acima e as exibirá em sua paleta de ferramentas. No Cursor e no Claude Desktop, você pode verificar digitando “conectores de lista” — a IA deveria ligar qs_list_connectors e envie seu conector do Google Search Console juntamente com qualquer outra configuração que você tenha feito.
Etapa 3: Faça uma pergunta à IA no Google Search Console
Você não escreve SQL — a IA faz isso. Você faz uma pergunta, a IA escolhe a ferramenta MCP adequada, o agente executa a consulta nos seus dados do GSC e a resposta retorna como texto e tabelas. Três exemplos de perguntas para experimentar primeiro:
Na primeira vez que a IA acionar uma ferramenta, seu cliente poderá exibir uma mensagem de confirmação solicitando sua aprovação para a chamada da ferramenta — esse é o fluxo de consentimento padrão do MCP, e não algo adicionado pelo Query Streams. Aprove uma vez e a IA prosseguirá com o restante da conversa livremente. Você pode revisar o consentimento a qualquer momento nas configurações do seu cliente.
Aviso de cobrança transparente: o uso do MCP é cobrado por bytes não comprimidos.
O suplemento para Excel da Query Streams, o suplemento para Planilhas Google, o Construtor de Consultas da Web e a IA Nova funcionam por meio de nossa conexão de nuvem compactada — nós medimos e cobramos. bytes comprimidos contra o seu domínio de dados. O transporte MCP (HTTP Streamable, conforme a especificação oficial do MCP) não oferece suporte confiável à compressão de ponta a ponta em todos os clientes e proxies intermediários, portanto, medimos e cobramos por isso. bytes não comprimidos para tráfego MCP.
- O que isso significa: Um conjunto de resultados do GSC de 1 MB custa aproximadamente 1 MB do seu domínio de dados quando obtido via MCP, em comparação com cerca de 150 a 250 KB via Excel/Planilhas/Nova/Construtor de Consultas. Os dados são os mesmos, o transporte é diferente, o tamanho da cobrança é diferente.
- O que isto não é: Uma taxa adicional ou uma penalidade por usar MCP. Nós repassamos os bytes reais enviados. Os outros clientes são mais baratos porque a compressão funciona de forma confiável nesses protocolos; não penalizamos você pela escolha do protocolo, mas precisamos ser transparentes sobre o custo.
- O que você pode fazer: Para consultas recorrentes muito extensas (por exemplo, exportações com mais de 100 mil linhas), prefira o caminho Excel/Planilhas/Nova. Para chamadas interativas de ferramentas de IA (a resposta típica de 100 a 5.000 linhas que se encaixa em um contexto de LLM), o MCP é a escolha certa e a diferença de custo é de apenas alguns centavos.
Perguntas frequentes
Preciso abrir portas ou usar uma VPN para utilizar isso? +
https://mcp.querystreams.com da internet pública — se o HTTPS de saída funcionar no host do agente, o MCP funciona. Veja como funciona a conexão somente de saída →
Quais ferramentas de IA posso usar com o Query Streams MCP? +
Posso revogar uma chave MCP? +
/mcp página, por organização através das configurações do plano e no nível da plataforma), nenhuma das quais requer rotação de senha do banco de dados ou reinicialização do agente. Mais informações sobre a segurança da chave MCP →
Como é feita a cobrança do uso do MCP no meu pacote de dados? +
bytes comprimidos, enquanto o MCP sobre faturas HTTP Streamable bytes não comprimidos (Um resultado de 1 MB corresponde a aproximadamente 150–250 KB através dos clientes comprimidos, em comparação com aproximadamente 1 MB via MCP). Como o uso do MCP é medido →
O Query Streams MCP funciona com minha conta do Google Workspace? +
Em que isso difere de executar um servidor GSC MCP de código aberto por conta própria? +
registros de eventosE o mesmo fluxo de faturamento do domínio de dados que você já usa — algo que um MCP direto não oferece.
O que acontece se a IA tentar gravar ou apagar dados? +
qs_executar_consulta A chamada é analisada por um validador somente leitura codificado que permite apenas SELECIONAR, COM, e EXPLICAR declarações; qualquer outra coisa retorna VIOLAÇÃO_SOMENTE_LEITURA e nunca chega ao Google Search Console. O validador é executado no processo do agente em sua rede, não na nuvem, portanto, uma superfície de nuvem comprometida não conseguiria contorná-lo. (A própria API do Search Console também é somente leitura, mas a mesma proteção se aplica a todos os outros conectores que você possa adicionar — PostgreSQL, MySQL etc.)
Posso ver o que a IA realmente perguntou? +
registros de eventos Com a organização, o usuário, a chave, o escopo, a latência e o código de resultado, o administrador da organização pode responder à pergunta “quem usou o MCP na semana passada, qual conector e o que foi solicitado?” com uma única consulta. Observe que registramos o nome da ferramenta e metadadosNão o texto SQL ou as linhas retornadas — esses dados trafegam pelo link na nuvem e nunca chegam aos logs da nuvem. Se você deseja uma auditoria completa do SQL, habilite a auditoria do lado do banco de dados no mecanismo subjacente; especificamente para o Google Cloud Platform, isso se traduz em uma entrada de log de auditoria do Google Workspace.
Preciso executar o Schema Intelligence para usar o Query Streams MCP? +
(conector, banco de dados) parE o MCP funciona bem sem ele. A IA recebe o esquema básico (tipos, chaves primárias, chaves estrangeiras formais, índices) e escreve consultas básicas. Com a SI ativada, a IA recebe seis camadas adicionais de metadados selecionados: (1) Descrições selecionadas por IA para cada banco de dados, tabela e coluna; (2) Classificações de tabelas (FACT para eventos transacionais, DIM para referência descritiva, LOOKUP para pequenos mapeamentos de código) mais uma tag de domínio de negócios (vendas, RH, SEO, finanças, suporte e mais 14); (3) um tipo semântico em cada coluna (moeda, e-mail, data_aaaammdd, código_de_status, porcentagem, posição_no_classificação, identificador, url, nome_da_pessoa e mais 9) que impulsiona a geração de SQL correto para cada dialeto; (4) Utilize valores de amostra dos seus dados reais para que o LLM reconheça padrões que nenhum esquema consegue mostrar; (5) Detecção de enumerações com distribuições de valores completos para colunas de baixa cardinalidade; e (6) Chaves estrangeiras descobertas por IA com base na sobreposição de dados entre tabelas, reveladas por meio de qs_get_relacionamentosSem SI, cada resposta da ferramenta de esquema também carrega um si_recomendação listar exatamente o que está faltando na chamada — a IA pode ler isso e oferecer a ativação da integração espacial no meio da conversa. qs_request_si_analysisO tempo de execução varia de acordo com o número de tabelas: um banco de dados pequeno, com menos de 100 tabelas, é concluído em cerca de 10 minutos; um banco de dados típico de tamanho médio (com algumas centenas de tabelas) termina em 15 a 25 minutos; um grande banco de dados corporativo com mais de 1.500 tabelas pode levar de 45 a 60 minutos para uma varredura completa. O SI é executado por meio do seu Agente de Rede em seus dados (nunca na nuvem), nunca grava em seu banco de dados, nunca altera seu esquema e atualiza incrementalmente quando seu esquema é alterado — portanto, as execuções subsequentes, após a adição ou alteração de tabelas, são muito mais rápidas do que a primeira. O efeito de ponta a ponta: com o SI ativado, seu cliente de IA grava SQL correto na primeira tentativa com muito mais frequência do que em qualquer servidor "MCP para X" que apenas entrega o LLM. esquema_de_informação.
E se eu adicionar outro conector mais tarde, como o Stripe ou o PostgreSQL? +
qs_list_connectors (adquire automaticamente). Um bloco de configuração compra toda a sua conta, presente e futura. Por que uma única chave serve para todos os conectores →
Preciso configurar o MCP apenas para conversar com meus dados? +
Comece agora
Conecte sua ferramenta de IA aos seus dados de SEO em cinco minutos.
Uma única chave MCP permite o acesso ao Google Search Console, a todos os bancos de dados e a todos os outros conectores de API da sua conta do Query Streams — com registro completo de auditoria, limites de taxa por chave e sem necessidade de alterações no firewall. Claude, Cursor, ChatGPT e Grok funcionam imediatamente.
Guias relacionados: Baixe o Agente de Fluxos de Consulta | Configuração do conector de API | Todos os guias do servidor MCP | Nova AI texto para SQL
Categoria: Servidor MCP
Tags: mcp, claude, cursor, chatgpt, grok, google-search-console, gsc, seo, ai
Meta descrição: Conecte Claude ou Cursor ao Google Search Console via MCP. Consulte dados de SEO com IA em linguagem natural. Gratuito.


