Conectar fluxos de consulta ao Claude via MCP: Configuração, permissões e resolução de problemas

Conecte fluxos de consulta ao Claude e faça perguntas sobre seus bancos de dados em linguagem natural. O Claude lê seu esquema, suas consultas salvas e seu Inteligência Semântica O modelo funciona em tempo real, executa SQL somente leitura por meio do seu Agente de Rede e nunca vê a senha do banco de dados. Seu cliente de IA faz a solicitação; o Agente de Rede, seu parceiro dentro da sua rede, realiza o trabalho pesado onde os dados residem. Este guia abrange claude.ai, Claude Desktop, ChatGPT e Claude Code, além de todos os outros clientes MCP.

Antes de começar

Você precisa de quatro coisas. Se você encontrou o Query Streams dentro do Claude, o Agente e um conector são os dois itens que você ainda precisa configurar.

Como funciona

Claude nunca se conecta ao seu banco de dados. Ele se comunica com o servidor Query Streams MCP em nossa nuvem, que retransmite cada solicitação pela única conexão de saída que seu Agente de Rede já mantém aberta. O agente executa a consulta localmente e transmite as linhas de volta da mesma forma. As solicitações e os resultados fluem em ambas as direções por esse único canal iniciado pelo agente, portanto, nada precisa ser aberto em seu firewall.

Três propriedades decorrem desse projeto:

• Claude não possui credenciais. A sua cadeia de conexão com o banco de dados reside no agente. Claude possui apenas uma concessão OAuth ou uma chave MCP, ambas as quais você pode revogar no Portal com um único clique.
• Somente leitura, aplicado no agente. Apenas SELECIONAR, COM e EXPLICAR As declarações são aceitas. A verificação ocorre do seu lado da conexão, não na nuvem e nem no Claude.
• Tudo é registrado. Cada chamada de ferramenta aparece na página do MCP. Atividade A guia e todas as consultas no Histórico de Consultas são atribuídas ao usuário que se conectou.

Conecte seu cliente de IA

A página MCP no Portal (Transmissões → Ao vivo → MCP) possui quatro abas: Conexões, Contexto, Ferramentas e, para administradores, Atividade. Em Conexões, o Conecte um cliente de IA O botão abre um guia de quatro etapas: Como seu cliente de IA se conectará?, Escolha seu cliente de IA, Configure-o e Verifique a conexãoExistem duas maneiras de acessar. Os aplicativos de bate-papo aprovam o acesso pelo próprio aplicativo e não precisam de chave. As ferramentas de desenvolvedor usam uma chave MCP. Ambas acessam o mesmo servidor e as mesmas ferramentas.

Opção A: claude.ai, Claude Desktop e ChatGPT (aprovar pelo aplicativo, sem chave)

1. Abra o Listagem de fluxos de consulta e clique em ConectarO conector sincroniza com sua conta Claude, portanto, o Claude Desktop o exibe em + → Conectores. Não consegue ver o anúncio? Sua organização pode restringir conectores de diretório: em Configurações → Conectores clique Adicionar conector personalizado, dê um nome a isso Fluxos de consulta, colar https://mcp.querystreams.com/mcpEm seguida, clique em um bate-papo. +, escolher Fluxos de consulta e clique em Conectar.
2. Uma nova aba do navegador será aberta na tela de consentimento do Query Streams. Faça login, se solicitado, selecione a organização, revise as permissões (veja abaixo) e clique em Aprovar conexão.
3. De volta a Claude, você verá Conectado a fluxos de consultaNa primeira vez que Claude usar uma ferramenta, ela pedirá permissão. Escolha Permitir sempre Assim, pode funcionar sem precisar solicitar informações a cada chamada.

O conector está vinculado à sua conta Claude, e não a um dispositivo específico, por isso aparece automaticamente nos aplicativos móveis e no Claude Desktop. Você pode gerenciá-lo ou revogá-lo a qualquer momento pelo Portal. MCP → Conexões aba.

ChatGPT. Adicionar fluxos de consulta diretamente do aplicativo: por enquanto, isso significa ativar o modo de desenvolvedor nas configurações do ChatGPT, criar a conexão por lá e clicar em Adicionar fluxos de consulta. Faça login com o Query Streams e aprovando na mesma tela de consentimento. O guia do Portal mostra os passos atuais do ChatGPT; uma lista oficial do ChatGPT está a caminho.

Opção B: Claude Code, Cursor e outras ferramentas de desenvolvedor (chave MCP)

As ferramentas de desenvolvedor autenticam com uma chave que você gera no Portal e passa no Chave X-MCP cabeçalho.

1. Faça login em my.querystreams.com, abrir MCP e clique em Conecte um cliente de IA. Escolher Use uma chave em um arquivo de configuração e escolha sua ferramenta.
2. Clique em Gere uma chave para sua ferramenta. Dê a ela o nome da ferramenta e da máquina, como por exemplo: laptop claude-code, manter Ler e Executar consultase escolha um prazo de validade. Você poderá revelar e copiar a chave novamente mais tarde a partir do Conexões aba. As teclas têm a seguinte aparência: qsmcp_ seguido de 43 caracteres.
3. Configure-o Exibe a configuração pronta para colar do Cursor, VS Code, Windsurf, Zed, JetBrains, Gemini CLI, Codex CLI, Continue, Cline e outros, com sua chave já preenchida. Para o Claude Code, basta um comando:
   claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp --header "X-MCP-Key: qsmcp_PASTE_KEY_HERE"
4. Verifique a conexão aguarda a primeira chamada daquela chave e diz Conectado.

Para verificar a qualquer momento, pergunte. “Quais conectores de fluxos de consulta eu tenho?” O cliente deve ligar qs_list_connectorse a chave Último uso A hora na aba Conexões é atualizada em segundos.

Permissões

Quer você se conecte via OAuth ou por chave, o acesso é controlado por três escopos. A tela de consentimento os exibe; uma chave é criada com base neles.

Um aplicativo conectado pode ser limitado a conectores específicos após sua aprovação; uma chave gerada é distribuída para todos os conectores da organização. A revogação de uma concessão ou chave entra em vigor em cerca de cinco minutos. Os administradores podem visualizar todas as concessões e chaves ativas da organização na guia Conexões.

O que seu cliente de IA pode fazer depois de conectado

Seu cliente de IA visualiza as ferramentas do Query Streams e seleciona a mais adequada para sua pergunta; você nunca precisa acioná-las diretamente. O Portal guia Ferramentas lista todas as ferramentas e modos, o que cada um faz e quais estão incluídos no seu plano.

Para uma pergunta sobre seus dados, Query Streams orienta seu cliente de IA em quatro etapas: listar seus conectores, ler as tabelas do banco de dados’s, ler as colunas de cada tabela que ele consultará e, em seguida, executar uma consulta somente leitura. Ler as colunas primeiro é o que evita que ele adivinhe nomes. Em todos os planos, inclusive o Free:

O conjunto de ferramentas analíticas

Nos planos pagos, o Agente de Rede realiza o trabalho preparatório onde seus dados residem: ele mede, cria perfis, armazena e analisa resultados, para que seu cliente de IA entre em cada questão com o contexto já preparado e concentre sua atenção no raciocínio. O plano gratuito funciona como sempre funcionou, com resultados padrão. O passo a passo completo está em Analise seus dados com seu cliente de IA.

Você mantém o controle. O guia Contexto Define os valores padrão: o limite de células de texto, a visualização do esquema para bancos de dados grandes, o tamanho do resultado e os padrões de análise, e mostra o que seu cliente de IA recebe. Também lista os resultados que cada Agente possui. Cada tecla pode substituir os valores padrão, cada chamada é registrada na guia Atividade e um administrador pode ativar/desativar as configurações padrão. Análise local fora para um agente sob Dados → Agentes de Dados.

O que o seu plano inclui

O MCP está incluído em todos os planos, inclusive no plano gratuito, e o plano gratuito nunca expira.

Um aplicativo conectado conta como uma chave. Em todos os planos, cada chave executa no máximo 10 consultas por minuto. O número de linhas por consulta representa a quantidade máxima de linhas que uma consulta retorna para o seu cliente de IA; solicitar mais linhas retorna o limite do seu plano e exibe essa informação, nunca um erro. Um resultado em espera é mantido para consultas subsequentes, até o limite de tempo e tamanho do plano, dentro da capacidade do computador do Agente. Veja todos os planos lado a lado: precificação.

Por que a Inteligência Semântica é importante aqui?

Cada resposta que Claude recebe é etiquetada com a qual dos três níveis ela veio, e Claude ajusta o grau de confiança que deposita no que vê.

Se um banco de dados é importante para sua equipe, execute a Inteligência Semântica nele uma única vez. Para bancos de dados grandes, limite a execução às tabelas que suas consultas realmente utilizam. Como funciona a Inteligência Semântica →

Exemplos de perguntas

Comece com algo cuja resposta você já saiba. Depois, faça perguntas complementares; Claude mantém o contexto.

Dicas para melhores respostas

• Use um projeto Claude. Anexe o conector Query Streams a um projeto e insira suas regras de negócio nas instruções do projeto: qual banco de dados usar por padrão, quais consultas salvas são as definições oficiais e as convenções de nomenclatura. O Claude ainda lê o esquema em tempo real, então as instruções permanecem concisas.
• Salve as consultas que você considera canônicas. Claude prioriza as consultas salvas, então "clientes ativos" significa o que sua equipe define como significado.
• Conceda a permissão de análise. Analisar o perfil de uma coluna antes de filtrá-la é a diferença entre adivinhar um código de status e usar o correto.
• Peça um gráfico. O claude.ai gera gráficos a partir das linhas que Claude recebe.

Quanto custa

A MCP em si não cobra nenhuma taxa adicional em nenhum plano. Duas coisas são cobradas à parte:

• Volume de dados. Os resultados das consultas retornados ao Claude são contabilizados no mesmo limite de uso do realm de dados compartilhado pelo Excel, Google Sheets, Portal e Nova. No MCP, são contabilizados todos os bytes entregues ao Claude — resultados, leituras de esquema e páginas de resultados retidas — antes de qualquer compactação de transporte, pois um cliente de IA os recebe sem compactação; os resultados de planilhas, Portal e API são contabilizados com a compactação aplicada aos resultados entregues pelo seu Network Agent. Uma resposta com falha nunca é contabilizada. Mantenha pequenas as perguntas exploratórias; em planos com gerenciamento de contexto, pedir primeiro ao Claude que estime o tamanho de um resultado (mode: shape) evita buscar linhas desnecessárias.
• A Inteligência Semântica está em execução. Ao executar uma análise no Claude, os créditos de IA são cobrados da sua organização, exatamente como acontece ao executá-la no Portal. O Claude solicita sua permissão antes de realizar essa análise.

Resolução de problemas

Ainda com dúvidas? Envie um e-mail. [email protected].

Segurança e privacidade

• Claude recebe metadados de esquema, descrições de Inteligência Semântica, incluindo valores de exemplo, e os resultados das consultas que você solicita. Com o conjunto de ferramentas Analíticas, ele geralmente recebe uma estimativa de tamanho, um perfil ou uma resposta com resultado retido, e o resultado completo permanece com o Agente. O que ele recebe é transmitido ao provedor de IA que você escolheu conectar, de acordo com os termos desse provedor.
• O Query Streams não recebe nem armazena sua conversa com o Claude.
• As concessões e chaves OAuth são por usuário e por organização. Um administrador pode visualizar e revogar todas as concessões e chaves na página do MCP.
• Todos os detalhes estão em nosso Política de Privacidade e Termos de Serviço.

Perguntas frequentes

Preciso abrir uma porta ou usar uma VPN?
Não. O agente estabelece uma conexão TLS de saída na porta 443. Se o HTTPS de saída funcionar, o MCP funciona.

Claude pode alterar meus dados?
Não. O agente aceita apenas instruções de leitura. Claude pode enfileirar uma execução de Inteligência Semântica e propor uma regra de alerta no modo de teste; ambas gravam nos metadados do Query Streams, nunca no seu banco de dados.

Quais outras ferramentas de IA funcionam?
Qualquer coisa que fale MCP: ChatGPT, Cursor, Claude Code, Windsurf, Zed, VS Code Copilot, JetBrains AI, Gemini CLI, Codex CLI, Continue, Cline e muito mais. O Portal Conecte um cliente de IA O guia possui uma configuração pronta para cada um.

O que é um resultado retido?
Em planos com análise de resultados, seu cliente de IA pode solicitar que o agente mantenha um resultado completo por um período. Perguntas subsequentes, como um detalhamento por região ou a próxima página de linhas, são respondidas a partir dessa cópia, sem a necessidade de uma segunda consulta ao banco de dados. A duração e o tamanho do resultado armazenado aumentam conforme o plano.

Quais planos incluem o conjunto de ferramentas analíticas?
O gerenciamento de contexto e a análise de resultados estão disponíveis no Personal Core e versões superiores; análises mais aprofundadas estão disponíveis no Business Core e versões superiores. A mesa de planejamento Tem os detalhes.

Isso altera o plano gratuito?
Não. O plano gratuito funciona como sempre funcionou, com resultados padrão.

Funciona com várias organizações?
Cada concessão ou chave está vinculada a uma organização. Conecte-se uma única vez para cada organização necessária.

Qual a diferença entre este e o Nova?
Nova é o assistente integrado ao Portal Query Streams e compartilha o mesmo modelo de Inteligência Semântica. Use Nova quando quiser respostas dentro do Query Streams; use MCP quando quiser seus dados dentro do Claude, juntamente com tudo o que você faz lá.

Guias específicos para conectores

Cada guia aborda a mesma conexão com exemplos para aquela fonte.

Bancos de dados: Microsoft SQL Server · PostgreSQL · MySQL · MariaDB · Oráculo · Floco de neve · Google BigQuery · SQLite · Microsoft Access · DuckDB · Supabase

APIs: Listrado · Shopify · HubSpot · Anúncios do Google · Google Analytics 4 · Console de pesquisa do Google · ShipStation · iTick

Pastas de arquivos e registros (O agente examina uma pasta e transforma os arquivos em tabelas): Sistema de arquivos · Pasta CSV · Pasta Parquet · Pasta do Excel · Pasta SQLite · Pasta JSONL · CSV com vários registros · Registros de máquinas · Registros do servidor web · Registros do contêiner · Registros de aplicativos · Registros do sistema · Registros personalizados

Bancos de dados hospedados (Servidores PostgreSQL, MySQL, MariaDB e SQL Server gerenciados, acessados pelo Agente via TLS): Néon · Amazon RDS · Banco de Dados do Azure para PostgreSQL · Banco de Dados do Azure para MySQL · Azure SQL · Google Cloud SQL · Google AlloyDB · Bancos de dados gerenciados da DigitalOcean · Aiven · Ponte Crocante · Heroku Postgres · Render · Ferrovia · Fly.io Postgres · Bancos de dados gerenciados da Vultr · Bancos de dados gerenciados da OVHcloud · Bancos de dados gerenciados da Scaleway · Banco de dados OCI com PostgreSQL · Onda de calor MySQL · Bancos de dados IBM Cloud para PostgreSQL · MariaDB SkySQL · Xata · Nuvem de escala de tempo · PlanetScale Postgres · Prisma Postgres · Koyeb · Nilo