Conecte seu sistema de arquivos ao Claude com o MCP.

MCP · Sistema de Arquivos para Claude

Perguntar Claude sobre o seu arquivo do sistema de arquivos, em inglês simples

Conecte o Claude, o Claude Code, o Cursor ou qualquer cliente MCP ao Query Streams uma única vez. O Claude lê a estrutura do seu arquivo do sistema de arquivos, escreve o SQL, executa-o em modo somente leitura através do Agente que já está conectado aos seus dados e retorna as linhas. Nenhuma senha do banco de dados chega à IA. Leva cerca de dez minutos, e o plano gratuito cobre esse processo.

Cerca de 10 minutos Claude, ChatGPT, Cursor + 11 outros clientes O arquivo permanece onde está. Somente leitura, sempre

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

A Claude that can answer questions about the files and folders on your computer or file share with live, read-only queries over the tables the Agent builds from your files, and tell you which file each answer came from — without ever seeing a login or a file path, and without a firewall change: the Agent already inside your network reads the folder and sends back only the rows. Once the Agent is in place, connecting Claude takes about 90 seconds if you are comfortable with a settings screen. Like this:

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?

Which folders grew the most this month, and is anything unusually large?

qs_executar_consulta qs_executar_consulta

I read conjunto de arquivos.diretórios for size by folder, then conjunto de arquivos.arquivos for the newest file in each. Both queries were read-only:

caminho	arquivos	size	newest file
Exports/daily	27	10.8 GB	2026-09-27 03:10
Finance/2026	412	2.1 GB	2026-09-27 17:42
Photos/site-visits	1,930	6.4 GB	2026-09-19 08:55

Exports/daily is the one to look at: 27 copies of the same 400 MB dump, one per night, and nothing deletes the old ones. Finance grows the way you would expect. Want the ten largest files under Exports with their dates?

Somente SELECIONAR, verificado pelo Agente Acessei a guia Atividade do MCP. 6 rows returned across 3 queries

Rather not wire up an AI client at all? On the Business plan, Nova is the assistant built into Query Streams itself. It has every tool Claude gets here, plus the ones Claude does not: it drafts and validates the SQL against your Schema Intelligence model, turns the answer into a chart, and saves the result as a query your team can run from Excel, Google Sheets or the REST API — no key, no connector, nothing to install. Use MCP when your people already live in Claude, Cursor or ChatGPT; use Nova when you want the answers inside the 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. Novo 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 o Schema Intelligence.

   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

   In Claude, Query Streams is in the Anthropic Connectors Directory: browse connectors, click Conectar. Elsewhere you paste one address into the app, https://mcp.querystreams.com/mcpe conecte-se por meio de um chat. Uma página de Fluxos de Consulta será aberta, você seleciona a organização e as permissões e clica em Aprovar conexãoNada para copiar, nada para manter em segredo. A conexão aparece em Aplicativos Conectados e pode ser revogada lá.

   Ferramentas de desenvolvedor · uma chave

   Claude Code, Cursor, VS Code e amigos

   Sobre Minhas chaves clique Gerar chaveDê uma olhada. Nome da chave como “Código Claude no meu laptop”, mantenha Ler e Executar Com a opção marcada, escolha uma Validade (Nunca, 30 dias, 90 dias ou 1 ano) e clique Gerar chaveCopie-o e então Continue a instalação: o Conectar A aba mostra o trecho de código exato para sua ferramenta com a chave já preenchida.

   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

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

   Analisar

   Criar tabelas de perfil, descobrir relacionamentos e agendar uma execução do Schema Intelligence. Isso consome créditos e dados do Nova AI, portanto, a tela de consentimento nunca é marcada previamente.

   Perdeu a chave? Aberto Minhas chavesO ícone do olho 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. Aberto Configurações → Conectores e clique em Navegue pelos conectores. Query Streams is listed in the Anthropic Connectors Directory: find Fluxos de consulta e clique em Conectar. (Or open the directory listing directly and click Conectar there.)
   2. If your organization hides directory connectors, click Adicionar conector personalizado instead. Name it Fluxos de consulta, colar https://mcp.querystreams.com/mcp, leave the OAuth fields empty, click Adicionar, then in any chat click + → Navegue pelos conectores → 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, 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.

   If you do add it by hand in Claude Desktop, use Configurações → Conectores → Adicionar, não o chat interno Adicionar ao mercado option, which expects a git repository. Connectors sync to your Claude account, so the mobile apps and Desktop pick it up automatically. Menu names are Anthropic’s and can move.

   Código Claude chave

   Um único comando, com a sua chave de "Minhas Chaves":

   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 Conectar 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). Você obtém a 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), classifica 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). 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_connectorse em Minhas chaves a chave Último uso A hora é atualizada em poucos segundos.

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

O que Claude pode fazer quando estiver conectado

Claude vê dezenove pequenas ferramentas. Você nunca as nomeia; Claude escolhe a certa para a sua pergunta. Em outras palavras:

Por que a Inteligência de Esquema é 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 o Schema Intelligence nele uma vez a partir de Nova → Inteligência. O Minhas chaves A aba mostra um painel de cobertura para cada conector. Como funciona a Inteligência de Esquemas.

O que os planos permitem

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

Um aplicativo conectado conta como uma chave. Além do valor por minuto, cada chave pode executar no máximo 10 consultas por minuto. Uma consulta retorna até 1.000 linhas e leva até 60 segundos para ser executada, a menos que Claude solicite mais, com um limite máximo de 50.000 linhas e cinco minutos. As linhas recebidas por Claude são contabilizadas no seu limite do Data Realm, o mesmo pool usado pelas suas consultas do Excel e do Planilhas Google, e o MCP (Maximum Charge Point - Ponto Máximo de Compressão) é medido antes da compressão, portanto, um resultado amplo custa mais aqui do que as mesmas linhas em uma planilha. As execuções do Schema Intelligence iniciadas por Claude consomem créditos do Nova AI, exatamente como acontece no 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