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 modelo de Inteligência de Esquema em tempo real, executa SQL somente leitura por meio do seu Agente de Rede e nunca vê a senha do banco de dados. Este guia abrange claude.ai, Claude Desktop e Claude Code, além de todos os outros clientes MCP.
Versão curta. Query Streams is in the Anthropic Connectors Directory. In claude.ai open Settings → Connectors → Browse connectors, encontrar Fluxos de consulta, clique ConectarAprove as permissões na tela de consentimento do Query Streams e pergunte a Claude. “A que bases de dados tenho acesso?” That’s it.
Antes de começar
Você precisa de quatro coisas. A maioria das contas já possui as três primeiras.
Um plano que inclui o MCP
O MCP está disponível em todos os planos, inclusive no plano gratuito. O que varia de acordo com o plano é a quantidade de chaves ou aplicativos conectados que você pode armazenar e o número de chamadas por minuto que o Claude pode fazer; o plano gratuito permite uma chave ou um aplicativo conectado e 30 chamadas por minuto.
Um agente de rede que está online.
O agente é um pequeno serviço que fica ao lado do seu banco de dados e faz uma conexão de saída com o Query Streams. Se sua equipe já executa consultas no Portal, Excel ou Planilhas Google, ele já está instalado. Guia de instalação →
Pelo menos um conector
Um conector é um banco de dados ou fonte de API registrada no Portal. Claude vê todos os conectores que sua conta pode ver, sujeitos às permissões que você conceder.
Acesso MCP no seu usuário
Os criadores e proprietários da organização têm acesso ao MCP automaticamente. Outros usuários precisam que um administrador marque a caixa. MCP ao lado do nome deles em Conta → Controle de acesso.
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.
OAuth, escopos, auditoria, limites de taxa
uma conexão TLS de saída
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,COMeEXPLICARAs 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-se com Claude
Existem duas formas de acesso. Os aplicativos de bate-papo usam OAuth 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 e Claude Desktop (OAuth, sem chave)
Listed in the Anthropic Connectors Directory. Query Streams is an approved connector: claude.ai/directory/query-streams. On claude.ai and in Claude Desktop you can connect it with one click from Navegue pelos conectores; no server URL needed. The custom-connector route below still works and is what to use if your Claude organization restricts directory connectors.
- Sobre claude.ai abrir Settings → Connectors → Browse connectors, procurar Fluxos de consulta e clique em Conectar (or open the directory listing directly). In Claude Desktop the same option is under Configurações → Conectores. Can’t see it? Your organization may restrict directory connectors: click Adicionar conector personalizado instead, name it Fluxos de consulta and paste
https://mcp.querystreams.com/mcp. - Abra qualquer chat e clique no + botão ao lado da caixa de mensagem, escolha Fluxos de consulta e clique em Conectar.
- 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.
- 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 → Aplicativos Conectados aba.
Não é o mesmo que "Adicionar ao marketplace". No Claude Desktop, o chat interno + → Procurar conectores → Adicionar marketplace A opção requer um repositório Git para marketplaces de plugins, não um URL de servidor MCP. Use Configurações → Conectores → Adicionar.
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.
- Faça login em my.querystreams.com, abrir MCP → Minhas Chaves e clique em Gerar chaveDê o nome da ferramenta e da máquina, como por exemplo: laptop claude-codee escolha seus escopos.
- Copie a chave agora. Você poderá mostrá-la e copiá-la novamente mais tarde. Minhas chavesAs teclas parecem com
qsmcp_seguido de 43 caracteres. - Para o código Claude, execute:
claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp --header "X-MCP-Key: qsmcp_PASTE_KEY_HERE" - Para Cursor, VS Code, Windsurf, Zed, JetBrains, Gemini CLI, Codex CLI, Continue e Cline, abra o MCP → Conectar A aba no Portal exibe uma configuração pronta para colar para cada cliente, com sua chave já preenchida.
Para verificar, pergunte “Quais conectores de fluxos de consulta eu tenho?” O cliente deve ligar qs_list_connectors e a chave último usado A hora é atualizada na aba "Minhas Chaves" em questão de 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.
| Escopo | O que Claude pode fazer | Quando conceder |
|---|---|---|
| ler | Liste conectores e agentes, navegue pelo esquema, leia as descrições do Schema Intelligence, liste as consultas salvas e as regras de alerta. | Sempre. Tudo o mais se constrói a partir disso. |
| analisar | Tabelas de perfil (valores de amostra, distribuições, tipos semânticos), descobrem relações implícitas e enfileiram uma execução do Schema Intelligence. | Recomendado. É isso que permite ao Claude entender o formato dos seus dados antes de escrever as junções. |
| executar | Execute consultas SQL somente leitura e consultas salvas e transmita as linhas de volta. | Para quem precisa obter respostas, e não apenas navegar pela estrutura. Deixe desativado para uma chave somente de navegação. |
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 página do MCP.
O que Claude pode fazer quando estiver conectado
Claude enxerga um pequeno conjunto de ferramentas. Você nunca as menciona; Claude escolhe a ferramenta certa para a sua pergunta. Em outras palavras:
Entenda seus dados
Liste conectores, bancos de dados e agentes. Leia a árvore de esquema de qualquer banco de dados com descrições de tabelas e colunas, tipos semânticos, valores de exemplo, rótulos de enumeração e relacionamentos declarados e descobertos.
Perfil e exploração
Analise o perfil de uma tabela para visualizar a distribuição real de valores antes de aplicar um filtro. Descubra junções entre tabelas que não possuem chaves estrangeiras declaradas.
Utilize suas consultas salvas
Liste as consultas parametrizadas salvas da sua organização e execute-as com parâmetros diferentes. Consultas federadas que abrangem várias fontes são executadas no servidor e retornam linhas já unidas.
Executar SQL ad-hoc
Escreva e execute SQL somente leitura no dialeto correto para o conector. Os resultados são exibidos por padrão em 1.000 linhas e com um tempo limite de 60 segundos, ambos ajustáveis.
Verificar alertas
Veja as regras de alerta, seu estado atual e os acionamentos recentes. Claude pode propor uma nova regra em modo de teste; basta ativá-la na página de Alertas.
Melhorar o modelo
Verifique a cobertura do Schema Intelligence por banco de dados e, com sua concordância, agende uma execução de análise para que as respostas futuras sejam melhores.
Por que a Inteligência de Esquema é 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ê.
| Nível | O que Claude vê | Resultado |
|---|---|---|
| Inteligência de esquemas | Descrições para cada tabela e coluna, tipos semânticos, rótulos de enumeração, valores de exemplo, classificação de fatos e dimensões, junções declaradas e descobertas. | Claude escreve SQL com qualidade de produção logo na primeira tentativa e explica os dados em termos de negócio. |
| Esquema capturado | Nomes de tabelas e colunas, tipos, chaves primárias, índices, chaves estrangeiras declaradas. | Claude trabalha, mas precisa inferir o significado dos nomes e pode precisar de uma pergunta complementar. |
| Esquema ao vivo | O banco de dados não está na seleção de captura do conector, portanto a estrutura é lida em tempo real do catálogo a cada solicitação. | As consultas ainda são executadas. Claude explora com seleções de exemplo quando precisa de mais informações. |
Se um banco de dados for importante para sua equipe, execute o Schema Intelligence 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 de Esquemas →
Exemplos de perguntas
Comece com algo cuja resposta você já saiba. Depois, faça perguntas complementares; Claude mantém o contexto.
A quais bancos de dados e tabelas tenho acesso e quais deles possuem Schema Intelligence?Mapeia suas conexões e indica onde as respostas serão mais fortes. Mostre-me como os clientes se relacionam com os pedidos no banco de dados de vendas e crie um perfil da coluna de status do pedido.Utiliza relacionamentos e perfis de coluna. Claude mostrará os códigos de status reais e seus significados. Execute a consulta salva "Receita mensal por região" referente ao segundo trimestre deste ano.Executa uma consulta salva confiável com parâmetros em vez de criar seu próprio SQL. Os 10 produtos mais lucrativos dos últimos 90 dias. Em seguida, detalhe por canal.SQL ad-hoc no dialeto do conector, seguido de uma continuação na mesma linha de raciocínio. Quais regras de alerta estão configuradas e alguma delas foi acionada esta semana?Lê as regras de alerta e seu estado atual.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 da consulta retornados ao Claude contam para o mesmo orçamento de domínio de dados que o seu uso do Excel, Planilhas Google, Portal e Nova compartilham. Como o MCP é executado em HTTP sem compressão de ponta a ponta, ele é medido em bytes não comprimidos; portanto, um resultado de 1 MB custa cerca de 1 MB, enquanto o mesmo resultado no Excel normalmente custa de 150 a 250 KB. Mantenha
limite_de_visualizaçãoSensato para questões exploratórias. - O Schema Intelligence 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
| O que você vê | O que significa | Consertar |
|---|---|---|
| Claude não exibe nenhuma ferramenta de fluxos de consulta. | O conector foi adicionado, mas não foi conectado por meio de um chat, ou a aprovação do OAuth nunca foi concluída. | Abra um chat, clique +, selecione Fluxos de Consulta, Conectare finalize a tela de consentimento. |
CHAVE MCP OBRIGATÓRIA ou 401 | Nenhuma chave ou autorização chegou ao servidor. Para clientes com chave, isso geralmente ocorre devido a um erro de copiar e colar, como uma nova linha no final ou a chave em um cabeçalho incorreto. | Copie a chave novamente para o Chave X-MCP Cabeçalho. Para claude.ai, reconecte-se pelo menu +. |
MCP_TOKEN_EXPIRED | O token OAuth expirou após um período de inatividade. | Claude normalmente reinicia sozinho. Caso contrário, desconecte e reconecte o conector. |
MCP_KEY_REVOGADO ou MCP_USUÁRIO_DESATIVADO | A chave foi revogada ou o acesso MCP foi desativado para o seu usuário. | Gere uma nova chave ou peça a um administrador para reativar o MCP. Conta → Controle de acesso. |
MCP_SCOPE_REQUIRED | A concessão ou a chave geralmente não contemplam essa ação. executar. | Reconecte e aprove o escopo ausente ou gere uma chave que o inclua. |
MCP_PLAN_LAPSED | A assinatura da sua organização expirou. | A página MCP no Portal mostra o estado atual do plano e o caminho a seguir. |
MCP_AGENT_NOT_CONNECTED | O agente de rede que possui o conector não está conectado no momento. | Verificar Agentes de dados No Portal, inicie o serviço do agente em seu host. |
CONECTOR_MCP_NÃO_PERMITIDO | A chave é restrita a conectores específicos e este não é um deles. | Edite a lista de permissões do conector da chave em "Minhas Chaves" ou use uma chave diferente. |
MCP_DATABASE_NOT_CAPTURED | O banco de dados não está na seleção de captura de esquema do conector, portanto não há Inteligência de Esquema nem relacionamentos armazenados para leitura. As consultas ainda funcionam. | Adicione o banco de dados à seleção de captura no conector do Portal e, opcionalmente, execute a Inteligência de Esquema. |
MCP_TAXA_LIMITADA | Muitas chamadas por minuto para o seu plano. | Aguarde um momento. Sessões com grande volume de chamadas se beneficiam da Inteligência de Esquema, que permite que Claude responda com menos chamadas. |
MCP_QUERY_TIMEOUT | A consulta ultrapassou o tempo limite, que é de 60 segundos por padrão. | Peça ao Claude para adicionar um filtro ou um limite inferior de linhas, ou aumente o número de linhas. tempo limite_segundos até 300. |
MCP_OUTPUT_TOO_LARGE | O resultado foi demasiado grande para ser entregue a Claude numa única resposta. | Peça menos colunas ou linhas. Normalmente, Claude sugerirá isso por conta própria. |
| violação de modo somente leitura | O SQL continha algo diferente de SELECIONAR, COM ou EXPLICAR. | Por design. As solicitações de escrita nunca são aceitas pelo MCP. |
Ainda com dúvidas? Abra um chamado em my.querystreams.com/support ou envie um e-mail [email protected].
Segurança e privacidade
- Claude recebe metadados de esquema, descrições de Inteligência de Esquema, incluindo valores de exemplo, e os resultados das consultas que você solicita. Esses resultados são transmitidos 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 do Schema Intelligence 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 utilize MCP: ChatGPT, Cursor, Claude Code, Windsurf, Zed, VS Code Copilot, JetBrains AI, Gemini CLI, Codex CLI, Continue, Cline e muito mais. A página de MCP do Portal possui uma configuração pronta para cada um deles.
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 de Esquema. 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
Conecte Claude aos seus dados em cerca de um minuto.
Sem chave, sem arquivo de configuração, sem VPN. Somente leitura por padrão.
Abra a página do MCP Como funciona o MCP
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish