Conecte arquivos CSV com vários registros ao Claude com o MCP.

CSV com vários registrosPlano gratuitoFluxos de consultaClaude

CSV com vários registros → Claude · com Query Streams

Com Query Streams, pergunte ao Claude sobre seu arquivo CSV com vários registros em linguagem natural: o Agent, que já está dentro da sua rede, executa o SQL em modo somente leitura, e nenhuma senha do banco de dados chega à IA. Leva cerca de dez minutos, e o plano Free dá conta.

Comece gratuitamente

O resultado final será o que você obterá.

Um Claude capaz de responder a perguntas sobre arquivos CSV que misturam vários tipos de registros com consultas em tempo real, somente leitura, nas tabelas que o Agente cria a partir dos seus arquivos, e informar de qual arquivo cada resposta veio — sem nunca ver um login ou o caminho do arquivo, e sem alterar o firewall: o Agente, já dentro da sua rede, lê a pasta e envia de volta apenas as linhas. Uma vez que o Agente esteja instalado, conectar o Claude leva cerca de 90 segundos, caso você esteja familiarizado com uma tela de configurações. Assim:

Claude · conectado a Fluxos de Consulta Somente leitura

Liste os cabeçalhos dos lotes dos arquivos desta semana, do mais antigo para o mais recente.

qs_get_table_schema qs_executar_consulta inteligência_de_esquema

Claude lê a estrutura de conjunto de arquivos.data_hdr e vê colunas posicionais. Ele executa um SELECT através do seu Agente e informa que está lendo. campo_1 como o número do lote e campo_2 como a data do lote.

_arquivo_fonte	campo_1	campo_2
inbound/2026-09-21/batch_0917.csv	B-000917	2026-09-21
inbound/2026-09-23/batch_0918.csv	B-000918	2026-09-23
inbound/2026-09-25/batch_0919.csv	B-000919	2026-09-25

Acompanhe os detalhes. Claude se junta a nós. dados_hdr para a tabela de detalhes em _arquivo_fonte e _seq, no mesmo chat.

Some a soma de cada lote desta semana a partir de suas linhas de detalhe e sinalize aqueles que não correspondem ao total do cabeçalho.

qs_get_relacionamentos qs_executar_consulta qs_executar_consulta

Eu entrei dados_hdr para dados_dtl sobre _arquivo_fonte e _seq, somado campo_4 analisou os detalhes e comparou-os com o cabeçalho. campo_3:

Lote	Total do cabeçalho	Total detalhado	Corresponder
B-000917	48,210.00	48,210.00	✓
B-000918	51,904.50	51,904.50	✓
B-000919	46,300.00	39,115.25	✗ −7.184,75

B-000919 faltam 7.184,75. Seu último detalhe _seq O arquivo tem 214 linhas, enquanto o cabeçalho indica 228, portanto foi cortado antes do trailer. Vale a pena solicitar novamente antes da emissão da fatura.

Somente SELECIONAR, verificado pelo Agente Acessei a guia Atividade do MCP. 6 linhas retornadas em 3 consultas

Prefere não instalar um cliente de IA? No plano de negócios, Nova é o assistente integrado ao próprio Query Streams. Ele usa o mesmo conjunto de ferramentas do Agent que seu cliente de IA obtém aqui, além de recursos que um cliente externo não oferece: ele elabora e valida o SQL com base no seu modelo de Inteligência Semântica, transforma a resposta em um gráfico e salva o resultado como uma consulta que sua equipe pode executar no Excel, Planilhas Google ou na API REST — sem chave, sem conector, sem necessidade de instalação. Use o MCP quando sua equipe já utiliza o Claude, o Cursor ou o ChatGPT; use o Nova quando desejar as respostas dentro do Portal.

Alguns sistemas criam arquivos CSV que misturam vários tipos de registro em um único arquivo, como uma linha de cabeçalho, linhas de detalhes e um rodapé, cada um marcado por uma etiqueta em uma coluna. O conector CSV de múltiplos registros os separa para que o Claude possa consultar cada tipo de registro como sua própria tabela. Não há necessidade de configurar um banco de dados. O Agente lê a pasta em seu computador e armazena as linhas em cache como tabelas SQL.

O que você vai precisar

Uma conta do Query Streams

O MCP está disponível em todos os planos, inclusive no plano gratuito. O plano gratuito permite uma chave ou um aplicativo conectado, que é tudo o que este guia precisa. Cadastre-se em my.querystreams.com.

O agente em um computador que pode abrir a pasta

Versão 2.6.0 ou posterior. A pasta pode estar nesse computador ou em um compartilhamento de arquivos acessível a ele. O Agente é executado como um serviço, portanto, digite "compartilhamentos" como \\servidor\compartilhamento\pasta, não como uma letra de unidade mapeada. No Windows, ele pode fazer login em um compartilhamento com um login que você armazena; no Linux ou Mac, monte o compartilhamento primeiro (no Linux, em /mnt ou /mídia, um Mac sob /VolumesNovo no Agente? Instale-o no Windows., macOS ou Linux.

MCP ativado para você

Criadores, proprietários e administradores têm acesso desde o início. Todos os outros precisam de um administrador para ativar o recurso. MCP alterne ao lado do nome deles abaixo Conta → Controle de acessoAté então, a página do MCP exibe a mensagem "O MCP está desativado para sua conta".

Um cliente de IA

O Claude na web, o Claude Desktop ou os aplicativos móveis do Claude se conectam sem necessidade de chave. O Claude Code, o Cursor, o ChatGPT e cerca de outras dez ferramentas também funcionam; o Portal possui uma configuração pronta para cada uma delas.

Configure em quatro etapas

1. Aponte o Agente para a pasta.

   No portal aberto Dados → Agentes de DadosEncontre o agente que pode abrir a pasta e clique nele. Adicionar conector botão. Abaixo do Arquivos e pastas clique na pílula CSV com vários registros cartão. O mago então te guia através de Pastas, Verificar, Configurações, Reino e Análise:

   Pastas

   Digite o Pastas raiz, um por linha, como caminhos no computador do Agente. Analisar subpastas está ligado, Profundidade máxima é 8. Incluir padrões começa com o padrão glob correto para este tipo de arquivo; adicione Excluir padrões Se a pasta contiver arquivos indesejados, uma letra de unidade mapeada exibirá um aviso em amarelo: o Agente não consegue vê-la, portanto, use a \\servidor\compartilhamento caminho em vez disso.

   Verificar

   O agente lê uma amostra de até 64 arquivos e mostra o que irá construir. Nada foi criado ainda. Pronto para criar significa que todos os arquivos amostrados se encaixam. Uma faixa âmbar, “{n} de {m} arquivo(s) serão separados”, lista os arquivos que não se encaixam. Mostre quais arquivos e por quê.Você pode criar o conector de qualquer maneira e corrigi-lo mais tarde. Se a pasta contiver layouts mistos, um painel azul oferece opções. Mude para uma tabela por layout..

   Configurações

   Intervalo de varredura (por padrão, a cada hora, podendo variar de 5 minutos a diariamente) é a frequência com que o Agente procura por arquivos novos, alterados ou que desapareceram. Acompanhe as alterações na pasta. Reage em segundos nos discos locais. Quando um arquivo desaparece é Solte suas fileiras Por padrão.

   Realm, Review

   Selecione o domínio de dados correspondente à contagem de linhas, verifique o resumo e clique. Criar conectorA primeira varredura começa imediatamente; o conector Manifesto A aba mostra o que foi compilado e quaisquer arquivos que foram separados.

   • Não existe Nome da tabela campo. As tabelas são nomeadas a partir das etiquetas de registro.
   • Definir Layout do arquivo, o Coluna de etiqueta de registro (número) que segura a etiqueta, e o Delimitador.
   • Escolher Escopo da tabelaO padrão gera uma tabela por tag. Uma tabela por extensão de arquivo e tag. Mantém a mesma tag separada em diferentes tipos de arquivo.
   • Antes de configurar, o assistente observa que todos os arquivos correspondentes devem compartilhar o mesmo layout. Os primeiros pinos de sincronização seguem um layout de exemplo, e os arquivos que apresentarem discrepâncias posteriores são separados e relatados.
   • Sobre VerificarO agente lê uma amostra e lista as tabelas que irá criar. Os arquivos que serão reservados aparecem em Mostre quais arquivos e por quê..

2. Veja quais tabelas você consegue.

   As tabelas recebem nomes personalizados, uma para cada etiqueta de registro, como por exemplo: dados_hdr para a tag HDR. As colunas são numeradas por posição. campo_1 para campo_N, sem a coluna de tags. Unir tipos de registro em _arquivo_fonte e _seq.

   Mesa	O que contém
   dados_<tag>, por exemplo dados_hdr	Cada linha com essa tag de cada arquivo, como campo_1 para campo_N, mais _seq, _arquivo_fonte e _row_id.
   dados_<extensão>_<tag>	O mesmo ocorre, dividido também por extensão de arquivo, quando Escopo da tabela é Uma tabela por extensão de arquivo e tag..
   arquivos	Todos os arquivos correspondentes ainda presentes na pasta, com caminho, tamanho e data de modificação.
   arquivos_eventos	O histórico de alterações, incluindo linhas de deriva para arquivos reservados devido a uma tag desconhecida ou uma contagem de colunas incorreta. Classificar por evento_em.
   diretórios	Contagem e tamanho dos arquivos em cada pasta na raiz.

   Cada conector de pastas também fornece a Claude as mesmas tabelas de contabilidade, todas no mesmo formato. conjunto de arquivos esquema:

   Mesa	O que contém
   arquivos	Todos os arquivos presentes na pasta: caminho, nome, extensão, tamanho, data de criação e data de modificação. Pergunte "o que há nesta pasta?" e Claude lerá a resposta.
   arquivos_eventos	O histórico de alterações: uma linha por arquivo que apareceu, foi modificado, desapareceu ou foi arquivado (deriva), com o tempo em evento_em e a razão em detalhe.
   diretórios, volumes	Tamanhos e quantidades de pastas, e os discos ou compartilhamentos onde as pastas raiz estão localizadas.
   _arquivo_fonte, _row_id	Duas colunas em cada linha de dados: o arquivo de origem da linha e um ID de linha fixo dentro desse arquivo. Agrupar por _arquivo_fonte para comparar arquivos.

3. Conecte-se com Claude

   Aberto Transmissões → Ao vivo → MCPExistem duas entradas, e ambas levam ao mesmo lugar:

   Aplicativos de bate-papo · sem chave

   claude.ai, Claude Desktop, ChatGPT

   No claude.ai e no Claude Desktop, abra o Listagem de fluxos de consulta No Diretório de Conectores da Anthropic, clique em Conectar e aprovar. Adicionando por URL, https://mcp.querystreams.com/mcp, é a alternativa. No ChatGPT, você adiciona Fluxos de Consulta a partir do aplicativo (modo desenvolvedor por enquanto) e faz login com Fluxos de Consulta. De qualquer forma, uma página de Fluxos de Consulta será aberta: selecione a organização e as permissões e clique em Aprovar conexãoNada para copiar. A conexão aparece no Conexões aba e pode ser revogada lá.

   Ferramentas de desenvolvedor · uma chave

   Claude Code, Cursor, VS Code e amigos

   Na página MCP, clique Conecte um cliente de IAO guia pergunta Como seu cliente de IA se conectará?: escolher Use uma chave em um arquivo de configuração, escolha sua ferramenta, então Gere uma chave para isso: um Nome da chave, Ler e Executar consultas marcado, um Validade (Nunca, 30 dias, 90 dias ou 1 ano). Configure-o Mostra o trecho com a chave preenchida, e Verifique a conexão Aguarda a primeira chamada.

   Ambas as formas utilizam as mesmas três permissões, que você escolhe na tela de consentimento ou na chave:

   Ler

   Liste conectores, navegue por tabelas e colunas, leia suas consultas salvas e regras de alerta. Nunca retorna dados de linha.

   Executar consultas

   Execute consultas SQL somente leitura e consultas salvas por meio do seu Agente e retorne as linhas. Sem isso, seu cliente de IA pode descrever seus dados, mas não responder com base neles.

   Analisar

   Crie perfis das tabelas, descubra relações e coloque uma execução do Semantic Intelligence na fila. A criação de perfis e a descoberta são gratuitas; uma execução do Semantic Intelligence consome créditos do Nova AI e a franquia de dados, por isso a tela de consentimento nunca a marca previamente.

   Perdeu a chave? Está listado no Conexões guia: Revelar a chave completa mostra isso novamente e Copiar chave completa copia-o. Revogue-o lá se um laptop desaparecer; todos os clientes que o utilizam falham na próxima chamada, em cerca de cinco minutos.

   Em seguida, selecione a receita do Claude que você utiliza. O endereço do servidor é o mesmo em todos os lugares: https://mcp.querystreams.com/mcp.

   Claude na web, Claude para desktop e dispositivos móveis. sem chave

   1. Abra o Listagem de fluxos de consulta No Diretório de Conectores da Anthropic, clique em ConectarNa área de trabalho, ele fica localizado em + → Conectores.
   2. Alternativa, caso sua organização oculte conectores de diretório: Configurações → Conectores → Adicionar conector personalizado, nome Fluxos de consulta, URL https://mcp.querystreams.com/mcp, Campos OAuth vazios, Adicionar; então em um bate-papo + → Fluxos de consulta → Conectar.
   3. Uma aba "Fluxos de Consulta" será aberta. Faça login, se solicitado, selecione a organização e revise. Ler e Executar consultas, opcionalmente Limitar a conectores específicose clique Aprovar conexão.
   4. De volta ao Claude, você vê “Conectado aos Fluxos de Consulta”. Na primeira vez que o Claude usa uma ferramenta, ele pergunta: escolha Permitir sempre.

   Se você adicionar manualmente no Claude Desktop, use Configurações → Conectores → Adicionar, não o chat interno Adicionar ao mercado opção, que espera um repositório git. Os conectores sincronizam com sua conta Claude, então os aplicativos móveis e o Desktop os reconhecem automaticamente. Os nomes dos menus são da Anthropic e podem ser alterados.

   Código Claude chave

   Um único comando, com a sua chave da aba Conexões:

   terminal

   claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp \ --header "X-MCP-Key: qsmcp_COLE_SUA_CHAVE_AQUI"

   Isso descreve o projeto atual. .mcp.json. Adicionar --escopo usuário Para ter fluxos de consulta em todos os projetos. Execute /mcp dentro do Código Claude para ver se está conectado.

   Cursor chave

   Aberto Configurações do cursor → MCP → Adicionar novo servidor MCPou editar .cursor/mcp.json na raiz do seu espaço de trabalho:

   .cursor/mcp.json

   { "mcpServers": { "querystreams": { "url": "https://mcp.querystreams.com/mcp", "headers": { "X-MCP-Key": "qsmcp_COLE_SUA_CHAVE_AQUI" } } } }

   Reinicie o Cursor ou execute MCP: Reiniciar servidores; um fluxos de consulta O ícone aparece na barra de status do MCP.

   Usar outra coisa? O Portal Conecte um cliente de IA guia Possui receitas prontas para colar para ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev e JetBrains AI, além de um Colar e mesclar ferramenta que solta o fluxos de consulta entrada em um arquivo de configuração que você já possui. Qualquer cliente que se comunique via MCP sobre HTTP funciona: servidor https://mcp.querystreams.com/mcp, cabeçalho Chave X-MCP (um Autorização: Portador O cabeçalho com a mesma chave também funciona).

4. Faça sua primeira pergunta

   Comece com algo que você possa verificar abrindo a pasta, para ver Claude alcançar a tabela correta. Três opções que funcionam bem com arquivos CSV que misturam vários tipos de registros:

   “Quais arquivos chegaram na pasta hoje?”

   Claude consulta o arquivo fileset.files em busca de relative_path, size_bytes e modified_utc, do mais recente para o mais antigo.

   “Coloque o cabeçalho de cada arquivo ao lado do seu rodapé e mostre ambos.”

   Claude une data_hdr à sua tabela de trailer com base em _source_file e _seq e retorna uma linha por arquivo.

   “Algum arquivo foi descartado devido a uma etiqueta desconhecida ou a uma contagem de colunas incorreta?”

   Claude lê as linhas de deriva em files_events, começando pelo evento mais recente, e nomeia cada arquivo e o motivo.

   Para confirmar a fiação, pergunte “Quais conectores de fluxos de consulta eu tenho?”Claude liga qs_list_connectors, o guia do Portal Verifique a conexão passo diz Conectadoe a chave ou aplicativo no Conexões A aba mostra o seu Último uso tempo em questão de segundos.

Acessando um arquivo em um compartilhamento de rede

O Agente abre arquivos como um serviço em segundo plano, não como você, portanto, um arquivo em outro computador requer uma etapa adicional. Qual etapa depende do computador em que o Agente está sendo executado.

Se o teste não conseguir acessar a pasta compartilhada, procure por estas palavras no resultado: inalcançável Significa que o computador do agente não recebeu resposta do servidor. No Linux ou no Mac, não montado Significa que o compartilhamento ainda precisa ser montado, e essa mensagem inclui o comando de montagem exato para o seu servidor.

Como os arquivos novos, alterados e excluídos são exibidos

O que Claude pode fazer quando estiver conectado

Seu cliente de IA visualiza as ferramentas de Fluxos de Consulta e seleciona a mais adequada para sua pergunta. O Portal Ferramentas guia lista todas as ferramentas e modos incluídos no seu plano. Query Streams solicita que seu cliente de IA leia as colunas de cada tabela antes de consultá-la, para que use os nomes reais em vez de adivinhar. Em todos os planos, incluindo o Free:

O conjunto de ferramentas analíticas. Nos planos pagos, o Agente realiza o trabalho preparatório no local onde seu arquivo CSV com vários registros está armazenado, permitindo que seu cliente de IA concentre sua atenção no processamento. A versão gratuita funciona como sempre funcionou.

Os valores padrão estão em Contexto guia: limite de células de texto, visualização do esquema, tamanho do resultado, padrões de análise e resultados retidos.

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

Cada resposta que Claude recebe é etiquetada com a origem da estrutura, e Claude ajusta o grau de confiança que deposita no que vê.

Se um banco de dados for importante, execute a Inteligência Semântica nele uma vez a partir de Nova → Inteligência. O Conexões A aba mostra um painel de cobertura para cada conector. Como funciona a Inteligência Semântica.

O que os planos permitem

O MCP está incluído em todos os planos, inclusive no gratuito, sem custo adicional. O que cada plano define é a quantidade de chaves ou aplicativos conectados que você pode armazenar e quantas chamadas por minuto seu cliente de IA pode fazer:

Um aplicativo conectado conta como uma chave. Além do limite por minuto, cada chave pode executar no máximo 10 consultas por minuto. Uma consulta é executada por até 60 segundos, a menos que seu cliente de IA solicite mais tempo, que pode chegar a cinco minutos. Seu plano também define quantas linhas uma consulta retorna e, com o conjunto de ferramentas Analíticas, por quanto tempo e qual o tamanho máximo que um resultado pode ser armazenado. o guia completo do MCP lista todos os planos. O que seu cliente de IA recebe é contabilizado na sua franquia do Data Realm, o mesmo limite usado pelas consultas do Excel e do Sheets: o uso do AI-agent (MCP) contabiliza cada byte entregue ao seu cliente de IA, incluindo resultados, leituras de esquema e páginas de resultados mantidos, antes de qualquer compactação de transporte negociada pelo seu cliente; já as consultas de planilhas contabilizam o resultado compactado entregue pelo seu Network Agent. As execuções do Semantic Intelligence iniciadas pelo seu cliente de IA consomem créditos Nova AI, exatamente como as iniciadas pelo Portal. Consulte a página de preços. pelas verbas.

Mantendo-o seguro

Boas próximas jogadas

• Executar Inteligência Semântica então Claude aprende o quê campo_1 para campo_N média em cada tipo de registro. As tabelas de arquivos já contêm descrições integradas.
• Verifique os arquivos_eventos após a primeira sincronização de qualquer arquivo reservado para uma tag desconhecida.
• Leia o guia completo sobre CSV com vários registros. em Consultar arquivos CSV com vários registros usando SQL Para cada cenário.

Quando algo não funciona

Perguntas que as pessoas fazem

Guias relacionados

• Conecte uma pasta de arquivos CSV ao Claude com o MCP.
• Conecte uma pasta de arquivos do Excel ao Claude com o MCP.
• Conecte uma pasta de bancos de dados SQLite ao Claude com o MCP.
• Conecte uma pasta de arquivos Parquet ao Claude com o MCP.
• Guia do conector multi-gravação
• Conectar fluxos de consulta ao Claude via MCP: configuração, permissões e solução de problemas
• Todos os guias MCP