Conecta tu sistema de archivos a Claude con MCP.

MCP · Sistema de archivos para Claude

Preguntar Claude acerca de su archivo del sistema de archivos, en inglés sencillo

Conecta Claude, Claude Code, Cursor o cualquier cliente MCP a Query Streams una sola vez. Claude lee la estructura de tu archivo del sistema de archivos, escribe la consulta SQL, la ejecuta en modo de solo lectura a través del agente que ya está con tus datos y devuelve las filas. Ninguna contraseña de la base de datos llega a la IA. El proceso dura unos diez minutos y está incluido en el plan gratuito.

Aproximadamente 10 minutos Claude, ChatGPT, Cursor + 11 clientes más El archivo permanece donde está. Solo lectura, siempre

Lo que obtendrás al final

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 Flujos de consulta Solo lectura

¿Qué archivos del conjunto de archivos (fileset.files) se modificaron más recientemente y cuál es su tamaño?

qs_get_table_schema qs_run_query inteligencia de esquema

Aquí están los tres archivos modificados más recientemente en sus carpetas. El libro de trabajo de cierre trimestral se modificó a última hora de la tarde de ayer.

ruta_relativa	tamaño_bytes	UTC modificado
Finanzas/2026/Cierre del tercer trimestre.xlsx	482113	2026-09-25 17:42:10
Contracts/Acme-renewal-2026.pdf	1893402	2026-09-25 14:05:37
Informes/semanales/resumen-operaciones-w39.docx	96120	2026-09-25 09:18:54

¿Quieres que te muestre qué carpetas crecieron más este mes? instantáneas_de_directorio?

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

qs_run_query qs_run_query

I read directorios de conjuntos de archivos for size by folder, then archivo.archivos for the newest file in each. Both queries were read-only:

camino	archivos	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?

SELECCIONAR solamente, verificado por el Agente registrado en la pestaña Actividad de 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.

El Sistema de archivos La tarjeta convierte las carpetas de tu ordenador o recurso compartido de archivos en tablas SQL que describen tus archivos: nombre, ruta, tamaño y fecha, además de un historial de cambios y el tamaño de las carpetas. Solo indexa los metadatos de los archivos y no lee su contenido, por lo que no es un lector de archivos como el servidor de sistema de archivos de referencia de Anthropic, y Claude no puede abrir, modificar ni eliminar archivos a través de ella. El Agente apunta a las carpetas en lugar de a un servidor de base de datos, y este crea y actualiza las tablas automáticamente.

Lo que necesitarás

Una cuenta de Query Streams

MCP está disponible en todos los planes, incluido el gratuito. El plan gratuito permite una clave o una aplicación conectada, que es todo lo que necesita esta guía. Regístrese en mi.querystreams.com.

El agente en un ordenador que pueda abrir la carpeta

Versión 2.6.0 o posterior. La carpeta puede estar en ese equipo o en un recurso compartido de archivos al que pueda acceder. El Agente se ejecuta como un servicio, así que escriba recursos compartidos como \\servidor\recurso compartido\carpeta, no como una letra de unidad asignada. ¿Es nuevo en el Agente? Instálalo en Windows, macOS o Linux.

MCP activado para ti

Los creadores, propietarios y administradores lo tienen desde el principio. Todos los demás necesitan un administrador para cambiar el MCP cambiar junto a su nombre debajo Cuenta → Control de accesoHasta entonces, la página de MCP indica que "MCP está deshabilitado para su cuenta".

Un cliente de IA

Claude en la web, Claude Desktop o las aplicaciones móviles de Claude se conectan sin necesidad de clave. Claude Code, Cursor, ChatGPT y otras diez herramientas también funcionan; el Portal incluye una configuración predefinida para cada una.

Configúralo en cuatro pasos.

1. Apunte el Agente hacia la carpeta

   En el portal abierto Datos → Agentes de datos, encuentra el Agente que puede abrir la carpeta y haz clic en su Agregar conector botón. Debajo del Archivos y carpetas pastilla clic la Sistema de archivos tarjeta. El mago luego te guía a través Carpetas, Controlar, Configuración, Reino y Revisar:

   Carpetas

   Escribe el Carpetas raíz, uno por línea, como rutas en la computadora del Agente. Escanear subcarpetas está encendido, Profundidad máxima es 8. Incluir patrones comienza con el glob correcto para este tipo de archivo; agregar Excluir patrones si la carpeta contiene archivos que no desea. Una letra de unidad asignada muestra una advertencia ámbar: el Agente no puede verla, así que utilice la \\servidor\recurso compartido camino en su lugar.

   Controlar

   El agente lee una muestra de hasta 64 archivos y muestra lo que creará. Todavía no se ha creado nada. Listo para crear significa que todos los archivos muestreados encajan. Un banner ámbar, “{n} de {m} archivo(s) se apartarán”, enumera los archivos que no encajan con Mostrar qué archivos y por qué; puedes crear el conector de todos modos y corregirlos más tarde. Si la carpeta mezcla diseños, un panel azul ofrece Cambiar a una tabla por diseño.

   Configuración

   Intervalo de escaneo (cada hora por defecto, desde cada 5 minutos hasta diariamente) es la frecuencia con la que el Agente busca archivos nuevos, modificados y desaparecidos. Vigila la carpeta para ver los cambios. Reacciona en cuestión de segundos en discos locales. Cuando un archivo desaparece es Deja caer sus filas por defecto.

   Realm, Reseña

   Seleccione el ámbito de datos en el que se contabilizan las filas, revise el resumen y haga clic. Crear conector. El primer escaneo comienza de inmediato; el conector Manifiesto La pestaña muestra lo que construyó y los archivos que guardó.

   • No hay Nombre de la tabla campo. El sistema de archivos solo crea las tablas de inventario.
   • Coloque una carpeta por línea en Carpetas raízLas rutas están en el equipo del agente. Escriba un recurso compartido de red como \\servidor\recurso compartido\carpeta, no como una letra de unidad asignada como Z:, porque el Agente se ejecuta como un servicio y no puede ver las unidades asignadas en su inicio de sesión.
   • Incluir patrones comienza como **/*.csv. Agregue patrones para cada tipo de archivo que desee listar y utilice Excluir patrones para cualquier cosa que quieras omitir.
   • En ControlarEl agente lee una muestra y muestra cuántas carpetas son accesibles, cuántos archivos coinciden y su tamaño total. Aún no se ha creado nada.

2. Mira qué mesas te tocan

   El sistema de archivos no tiene tabla de datos. Todo se encuentra en un esquema llamado conjunto de archivos, que el Agente almacena en caché en su ordenador y actualiza en cada escaneo. Claude ve descripciones integradas para cada una de estas tablas sin necesidad de ejecutar Schema Intelligence.

   Mesa	Lo que contiene
   archivo.archivos	Una fila por cada archivo que existe actualmente: ruta_relativa, nombre, extensión, tamaño_bytes, creado_utc, UTC modificado y dueño (Solo para Windows).
   conjunto_de_archivos.eventos_de_archivos	El historial de cambios. Cada fila tiene un tipo_de_evento tales como aparecieron, se modificaron o desaparecieron, el tiempo en evento_eny el tamaño anterior.
   directorios de conjuntos de archivos	Una fila por carpeta con recuentos de archivos, bytes_subárbol, archivo más antiguo y más nuevo, y un skip_reason cuando no se leyó una carpeta.
   Conjunto de archivos.Instantáneas de directorio	Como máximo, una instantánea del tamaño por carpeta al día, para que puedas ver qué carpetas están creciendo.
   volúmenes de conjuntos de archivos	Capacidad y espacio libre de cada unidad, con capacidad_bytes y bytes_gratis.

   Cada conector de carpeta también le da a Claude las mismas tablas de contabilidad, todo en el conjunto de archivos esquema:

   Mesa	Lo que contiene
   archivos	Todos los archivos que contiene la carpeta: ruta, nombre, extensión, tamaño, fecha de creación y modificación. Si le preguntas "¿qué hay en esta carpeta?", Claude te lo mostrará.
   eventos_de_archivos	Historial de cambios: una fila por archivo que apareció, fue modificado, desapareció o fue apartado (deriva), con el tiempo en evento_en y la razón en detalle.
   directorios, volúmenes	Tamaños y cantidad de carpetas, y los discos o recursos compartidos donde se encuentran las carpetas raíz.
   _archivo_fuente, _row_id	Dos columnas en cada fila de datos: de qué archivo proviene la fila y un ID de fila estable dentro de ese archivo. Agrupar por _archivo_fuente para comparar archivos.

3. Conectar con Claude

   Abrir Transmisiones → En vivo → MCPHay dos maneras de entrar, y ambas terminan en el mismo lugar:

   Aplicaciones de chat · sin clave

   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/mcpy conéctese desde un chat. Se abrirá una página de Flujos de consulta, seleccione la organización y los permisos, y haga clic. Aprobar conexión. Nada que copiar, nada que mantener en secreto. La conexión aparece bajo Aplicaciones conectadas y puede ser revocada allí.

   Herramientas para desarrolladores · una clave

   Claude Code, Cursor, VS Code y amigos

   En Mis llaves hacer clic Generar clave. Dale un Nombre de la clave como “Código Claude en mi portátil”, mantener Leer y Ejecutar Marcado, elige uno Vencimiento (Nunca, 30 días, 90 días o 1 año) y haga clic Generar claveCópialo y luego Continuar instalando: el Conectar La pestaña muestra el fragmento exacto de su herramienta con la clave ya rellenada.

   Ambos métodos utilizan los mismos tres permisos, que usted elige en la pantalla de consentimiento o en la clave:

   Leer

   Lista los conectores, explora tablas y columnas, lee tus consultas guardadas y reglas de alerta. Nunca devuelve datos de filas.

   Ejecutar

   Ejecuta consultas SQL de solo lectura y consultas guardadas a través de tu Agente y devuelve las filas. Sin esto, Claude puede describir tus datos, pero no responder a partir de ellos.

   Analizar

   Perfila tablas, descubre relaciones y programa una ejecución de Schema Intelligence. Consume créditos de Nova AI y datos asignados, por lo que la pantalla de consentimiento nunca lo marca previamente.

   ¿Perdiste la llave? Abrir Mis llaves: el icono del ojo lo muestra de nuevo y Copiar clave completa Copia el permiso. Revoca el permiso allí si se pierde un portátil; todos los clientes que lo utilicen fallarán en su siguiente llamada, en unos cinco minutos.

   Luego, elige la receta para el Claude que vayas a usar. La dirección del servidor es la misma en todas partes: https://mcp.querystreams.com/mcp.

   Claude en la web, Claude para escritorio y móvil Sin llave

   1. Abrir Configuración → Conectores y haga clic Explorar conectores. Query Streams is listed in the Anthropic Connectors Directory: find Flujos de consulta y haga clic Conectar. (Or open the directory listing directly and click Conectar there.)
   2. If your organization hides directory connectors, click Agregar conector personalizado instead. Name it Flujos de consulta, pegar https://mcp.querystreams.com/mcp, leave the OAuth fields empty, click Añadir, then in any chat click + → Explorar conectores → Flujos de consulta → Conectar.
   3. Se abre una pestaña de Flujos de consulta. Inicie sesión si se le solicita, seleccione la organización y revise. Leer y Ejecutar, opcionalmente Limitar a conectores específicosy haga clic Aprobar conexión.
   4. De vuelta en Claude verá "Conectado a flujos de consulta". La primera vez que Claude usa una herramienta, pregunta; elija Permitir siempre.

   If you do add it by hand in Claude Desktop, use Configuración → Conectores → Agregar, no el chat interno Agregar 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 llave

   Un comando, con tu clave de Mis Claves:

   Terminal

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

   Eso escribe el proyecto actual. .mcp.json. Agregar --ámbito usuario Tener Query Streams en cada proyecto. Ejecutar /mcp Dentro de Claude Code para verlo conectado.

   Cursor llave

   Abrir Configuración del cursor → MCP → Agregar nuevo servidor MCPo editar .cursor/mcp.json en la raíz de tu espacio de trabajo:

   .cursor/mcp.json

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

   Reiniciar Cursor o ejecutar MCP: Reiniciar servidores; a flujos de consultas El distintivo aparece en la barra de estado del MCP.

   ¿Usar otra cosa? El Conectar pestaña tiene recetas listas para pegar para ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev y JetBrains AI, además de una Pegar y combinar herramienta que deja caer el flujos de consultas Entrada en un archivo de configuración que ya tienes. Cualquier cliente que utilice MCP a través de HTTP funciona: servidor https://mcp.querystreams.com/mcp, encabezado Clave X-MCP (un Autorización: Portador El encabezado con la misma clave también funciona).

4. Haz tu primera pregunta

   Empieza con algo que puedas comprobar abriendo la carpeta, para que veas a Claude alcanzar la mesa correcta. Tres que funcionan bien con los archivos y carpetas de tu ordenador o recurso compartido de archivos:

   “¿Qué tipos de archivos hay en esta carpeta y cuánto espacio ocupa cada tipo de archivo?”

   Claude lee el archivo.archivos esquema (Leer), luego ejecuta una consulta que agrupa por extensión y sumas tamaño_bytes (Ejecutar). Obtendrá un recuento y un tamaño total por tipo de archivo.

   “¿Cuáles son las carpetas más grandes y cuáles se omitieron?”

   Claude pregunta directorios de conjuntos de archivos (Ejecutar), ordena por bytes_subárbol y enumera cualquier carpeta con un skip_reason, como uno pasado Profundidad máxima.

   “¿Qué se eliminó de la carpeta compartida en los últimos siete días?”

   Claude pregunta conjunto_de_archivos.eventos_de_archivos para filas desaparecidas, filtradas y ordenadas por evento_en (Ejecutar). Obtendrá cada archivo faltante y cuándo el escaneo lo detectó.

   Para confirmar el cableado, pregunte “¿Qué conectores de Query Streams tengo?”Claude llama qs_list_connectorsy en Mis llaves la llave Último uso La hora se actualiza en cuestión de segundos.

Cómo se muestran los archivos nuevos, modificados y eliminados

Lo que Claude puede hacer una vez conectado

Claude ve diecinueve herramientas pequeñas. Nunca las nombras tú mismo; Claude elige la adecuada para tu pregunta. En pocas palabras:

Por qué la inteligencia de esquemas es importante aquí

Cada respuesta que recibe Claude está etiquetada con la procedencia de la estructura, y Claude ajusta el grado de confianza que deposita en lo que ve.

Si una base de datos es importante, ejecute Schema Intelligence en ella una vez desde Nova → Inteligencia. El Mis llaves La pestaña muestra un panel de cobertura por conector. Cómo funciona la inteligencia de esquemas.

Lo que permiten los planes

MCP está incluido en todos los planes, incluido el gratuito, sin coste adicional. Cada plan establece cuántas teclas o aplicaciones conectadas puedes mantener pulsadas y cuántas llamadas por minuto puede realizar Claude:

Una aplicación conectada cuenta como una clave. Además de la cifra por minuto, cada clave puede ejecutar como máximo 10 consultas por minuto. Una consulta devuelve hasta 1000 filas y se ejecuta durante un máximo de 60 segundos, a menos que Claude solicite más, hasta un límite de 50 000 filas y cinco minutos. Las filas que recibe Claude se contabilizan dentro de su asignación de Data Realm, el mismo pool que utilizan sus consultas de Excel y Hojas de cálculo, y MCP se mide antes de la compresión, por lo que un resultado amplio cuesta más aquí que las mismas filas en una hoja de cálculo. Las ejecuciones de Schema Intelligence iniciadas desde Claude consumen créditos de Nova AI, exactamente igual que desde el Portal. Consulte la página de precios. para las asignaciones.

Mantenerlo seguro

Buenos pasos a seguir

• Activar la opción "Guardar carpeta" para detectar cambios. Si desea que los archivos nuevos aparezcan en cuestión de segundos en un disco local.
• Pregunte qué tan recientes son los datos. Claude responde desde el más reciente última_vista_utc en archivos_actual y el más nuevo evento_en en eventos_de_archivos.
• Lea la guía completa del sistema de archivos. en Indexa un sistema de archivos y consúltalo con SQL. para cada entorno.

Cuando algo no funciona

Preguntas que hace la gente

Guías relacionadas

• Conecta una carpeta de archivos CSV a Claude con MCP.
• Conectar una carpeta de archivos de Excel a Claude con MCP
• Conecta una carpeta de bases de datos SQLite a Claude con MCP.
• Conectar una carpeta de archivos Parquet a Claude con MCP
• Guía del conector del sistema de archivos
• Conectar Query Streams a Claude mediante MCP: configuración, permisos y solución de problemas
• Todas las guías MCP