Conecte seu sistema de arquivos ao Claude com o MCP.

Sistema de arquivosPlano gratuitoFluxos de consultaClaude

Sistema de arquivos → Claude · com Query Streams

Com Query Streams, pergunte ao Claude sobre seu arquivo do Sistema de arquivos em linguagem simples: o Agent, que já está dentro da sua rede, executa o SQL somente para leitura, e nenhuma senha do banco de dados chega à IA. Leva cerca de dez minutos, e o plano Free cobre tudo.

Comece gratuitamente

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

Um Claude capaz de responder a perguntas sobre os arquivos e pastas do seu computador ou compartilhamento de arquivos 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 apenas as linhas. Uma vez que o Agente esteja instalado, conectar o Claude leva cerca de 90 segundos, caso você esteja familiarizado com a tela de configurações. Assim:

Claude · conectado a Fluxos de Consulta Somente leitura

Quais arquivos em fileset.files foram alterados mais recentemente e qual o tamanho deles?

qs_get_table_schema qs_executar_consulta inteligência_de_esquema

Aqui estão os três arquivos modificados mais recentemente em suas pastas. A planilha de fechamento trimestral foi alterada no final da tarde de ontem.

caminho_relativo	tamanho_bytes	UTC modificado
Finanças/2026/Fechamento do 3º Trimestre.xlsx	482113	2026-09-25 17:42:10
Contracts/Acme-renewal-2026.pdf	1893402	2026-09-25 14:05:37
Relatórios/semanais/resumo-de-operações-w39.docx	96120	2026-09-25 09:18:54

Quer que eu mostre quais pastas cresceram mais este mês? snapshots_de_diretório?

Quais pastas cresceram mais neste mês e alguma delas se destacou por ser excepcionalmente grande?

qs_executar_consulta qs_executar_consulta

Eu li conjunto de arquivos.diretórios para tamanho por pasta, então conjunto de arquivos.arquivos para o arquivo mais recente em cada um. Ambas as consultas eram somente leitura:

caminho	arquivos	tamanho	arquivo mais recente
Exportações/diárias	27	10,8 GB	2026-09-27 03:10
Finanças/2026	412	2,1 GB	2026-09-27 17:42
Fotos/visitas ao local	1,930	6,4 GB	2026-09-19 08:55

Exportações/diárias É este aqui: 27 cópias do mesmo dump de 400 MB, uma por noite, e nada apaga as antigas. O setor financeiro cresce como esperado. Quer os dez maiores arquivos em Exportações com suas respectivas datas?

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.

O Sistema de arquivos O cartão transforma as pastas do seu computador ou compartilhamento de arquivos em tabelas SQL que descrevem seus arquivos: nome, caminho, tamanho e data, além de um histórico de alterações e tamanhos das pastas. Ele indexa apenas os metadados dos arquivos e não lê o conteúdo dos mesmos, portanto, não é um leitor de arquivos como o servidor de sistema de arquivos de referência da Anthropic, e o Claude não pode abrir, alterar ou excluir arquivos por meio dele. Você direciona o Agente para as pastas em vez de um servidor de banco de dados, e ele cria e atualiza as tabelas automaticamente.

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 Sistema de arquivos 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 O sistema de arquivos cria apenas as tabelas de inventário.
   • Coloque uma pasta por linha em Pastas raizOs caminhos estão no computador do Agente. Digite um compartilhamento de rede como \\servidor\compartilhamento\pasta, e não como uma letra de unidade mapeada como Z:, porque o Agente é executado como um serviço e não consegue ver as unidades mapeadas no seu login.
   • Incluir padrões começa como **/*.csvAdicione padrões para cada tipo de arquivo que você deseja listar e use Excluir padrões para qualquer coisa que você queira excluir.
   • Sobre VerificarO agente lê uma amostra e mostra quantas pastas estão acessíveis, quantos arquivos correspondem e seu tamanho total. Nada foi criado ainda.

2. Veja quais tabelas você consegue.

   O sistema de arquivos não possui uma tabela de dados. Tudo reside em um único esquema chamado conjunto de arquivos, que o Agente armazena em cache no seu computador e atualiza a cada verificação. Claude vê descrições integradas para cada uma dessas tabelas sem precisar executar a Inteligência Semântica.

   Mesa	O que contém
   conjunto de arquivos.arquivos	Uma linha por arquivo que está lá agora: caminho_relativo, nome, extensão, tamanho_bytes, criado_utc, UTC modificado e proprietário (Apenas para Windows).
   conjunto de arquivos.eventos_de_arquivos	O histórico de alterações. Cada linha tem um tipo_de_evento tais como apareceram, modificaram-se ou desapareceram, o tempo em evento_eme o tamanho anterior.
   conjunto de arquivos.diretórios	Uma linha por pasta com a contagem de arquivos. bytes_da_subárvore, arquivo mais antigo e mais recente, e um motivo_pular quando uma pasta não foi lida.
   conjunto_de_arquivos.instantâneos_de_diretório	No máximo, um instantâneo de tamanho por pasta por dia, para que você possa ver quais pastas estão crescendo.
   conjunto de arquivos.volumes	Capacidade e espaço livre de cada unidade, com capacidade_bytes e bytes_livres.

   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 mesa certa. Três exemplos que funcionam bem com os arquivos e pastas do seu computador ou compartilhamento de arquivos:

   “Que tipos de arquivos existem nesta pasta e quanto espaço cada tipo de arquivo ocupa?”

   Claude lê o conjunto de arquivos.arquivos esquema (Leitura), em seguida, executa uma consulta que agrupa por extensão e somas tamanho_bytes (Executar consultas). Você obtém uma contagem e o tamanho total por tipo de arquivo.

   “Quais pastas são as maiores e quais foram ignoradas?”

   Claude faz perguntas conjunto de arquivos.diretórios (Executar consultas), classificar por bytes_da_subárvore e lista qualquer pasta com um motivo_pular, como um passado Profundidade máxima.

   “O que foi excluído do compartilhamento nos últimos sete dias?”

   Claude faz perguntas conjunto de arquivos.eventos_de_arquivos para linhas desaparecidas, filtradas e ordenadas por evento_em (Executar consultas). Você obtém cada arquivo ausente e quando a verificação o detectou.

   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 o arquivo do seu sistema de arquivos reside, 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

• Ative a opção "Monitorar pasta para alterações". Se você deseja que novos arquivos apareçam em segundos em um disco local.
• Pergunte quão recentes são os dados. Claude responde a partir da versão mais recente. última_vista_utc em arquivos_atual e o mais novo evento_em em arquivos_eventos.
• Leia o guia completo do sistema de arquivos. no Indexe um sistema de arquivos e consulte-o com 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 do sistema de arquivos
• Conectar fluxos de consulta ao Claude via MCP: configuração, permissões e solução de problemas
• Todos os guias MCP