Ver categorías

Cómo conectar SQLite a Claude / Cursor a través de MCP (Configuración del servidor SQLite MCP)

26 minutos de lectura

SERVIDOR MCP SQLITE

Consulta SQLite con Claude o Cursor vía MCP.

Haga preguntas en lenguaje sencillo sobre cualquier tema. .db, .sqlite, o .sqlite3 Los archivos (cachés de aplicaciones, registros de IoT, configuraciones de desarrollo/prueba, análisis integrados) se transmiten a través de un enlace seguro en la nube, solo para salida, con Schema Intelligence integrado en el conector SQLite MCP para que la IA escriba SQL correcto al primer intento.

Sin agujeros en el cortafuegos Una llave, cada conector Datos en tiempo real, sin retardo de caché. Trae tu propia herramienta de IA

Query Streams es una plataforma segura de integración de datos en tiempo real que incorpora todas las bases de datos y API SaaS de su cuenta a Claude, Cursor, ChatGPT y Grok, mediante una única clave MCP y sin necesidad de modificar el firewall. Esta guía explica cómo conectar específicamente el conector SQLite MCP, para que su herramienta de IA pueda responder preguntas en lenguaje sencillo sobre cualquier tema. .db, .sqlite, o .sqlite3 archivo que tiene en el disco (registros de eventos de la aplicación, cachés de sensores de IoT, almacenes de sincronización de aplicaciones móviles, accesorios de desarrollo/prueba, análisis integrados) sin que copie y pegue exportaciones CSV desde DB Browser para SQLite, DBeaver o el sqlite3 CLI. Más información en QueryStreams.com y regístrese gratis para empezar a hacerle preguntas reales a tu herramienta de IA sobre SQLite.

Lo que Query Streams MCP te ofrece para SQLite

Otros servidores “SQLite MCP” en el entorno de código abierto conectan la herramienta de IA directamente a un servidor local. .db ruta de archivo en la misma máquina. Eso funciona para el desarrollador que posee ese archivo, pero vincula la herramienta de IA a un solo proceso en una sola máquina, no proporciona un registro de auditoría de lo que la IA solicitó y falla por completo cuando el archivo SQLite reside en un servidor, una puerta de enlace IoT, un dispositivo integrado o en cualquier entorno donde el cliente de IA no tenga acceso al sistema de archivos local. El servidor Query Streams MCP para SQLite resuelve un problema más amplio: una clave llega a todos .db El agente de red puede ver el archivo, la herramienta de IA nunca guarda la ruta del archivo y cada lectura se audita.

Cero agujeros en el firewall de entrada

El agente de red abre un único enlace en la nube cifrado de salida a Query Streams. Su cliente de IA se conecta a la nube, nunca al host donde se encuentra su .db El archivo existe. No hay que abrir ningún puerto, ni añadir ninguna IP a la lista de permitidos, ni usar VPN, ni compartir ningún archivo SQLite a través de SMB/NFS solo para que un LLM pueda leerlo.

Una llave, cada conector

La misma clave MCP llega a todas las bases de datos y API SaaS que tu cuenta tenga conectadas. Registra varios archivos SQLite (base de datos de la aplicación, análisis.sqlite, caché.sqlite3) y la herramienta de IA selecciona el correcto por su nombre, junto con cualquier otro conector que agregue posteriormente, sin necesidad de volver a introducirlo.

Inteligencia de esquema integrada

La IA ve descripciones curadas por IA, tipos semánticos, listas de valores enum y claves foráneas descubiertas para cada columna de SQLite, no solo Información de la tabla PRAGMA salida. Crítico para SQLite, donde las marcas de tiempo Unix codificadas en enteros, los booleanos 0/1 y los blobs JSON en TEXTO Las columnas pueden interpretarse fácilmente de forma errónea por un LLM.

Solo lectura aplicada en el agente

Ni siquiera un LLM alucinante puede emitir BORRAR, ACTUALIZAR, o ELIMINAR TABLA a través de Query Streams MCP. El agente de red abre su .db archivo en modo de solo lectura y rechaza todo lo que no sea SELECCIONE, CON, o EXPLICAR — Es seguro ejecutarlo junto con cualquier aplicación que sea propietaria del archivo en modo WAL.

Límites de tarifa por llave

De forma predeterminada, se permiten 60 solicitudes por minuto y 10 llamadas de ejecución por minuto, configurables por clave. Un bucle de llamadas a herramientas de IA descontrolado accede a un depósito de tokens, no al disco donde reside el archivo SQLite ni a la aplicación que escribe en él.

Cómo funciona sin abrir los puertos del firewall

El agente de red de Query Streams se instala una vez en una máquina que pueda leer su archivo SQLite (una computadora portátil, un servidor local, una puerta de enlace de IoT o cualquier host con HTTPS saliente) y marca un enlace TLS saliente a la nube; nunca se expone nada entrante y la herramienta de IA nunca ve el .db ruta del archivo. Cómo funciona la conexión solo de salida →

Cliente de IA

Cursor, Claude,
ChatGPT, Grok

Servidor QS MCP

HTTP en streaming
Autenticación con clave X-MCP

Agente de red

En tu red
Enlace a la nube fuera

Base de datos SQLite

.db / .sqlite /
.sqlite3 archivo

No se requiere puerto de entrada: el agente realiza la llamada, nunca al revés.

La tecla MCP que le das a Cursor o Claude tiene alcance (leer / analizar / ejecutar), revocable en cualquier momento y con límite de uso por clave. La herramienta de IA llama a estas herramientas MCP para realizar su trabajo:

querystreams-mcp · catálogo de herramientas
qs_list_organizacionesleer
Devuelve la organización vinculada a la clave de llamada.
qs_list_agentesleer
Lista de agentes de red y estado en línea.
qs_list_connectorsleer
Enumera los conectores de datos (una entrada por servidor de base de datos o API).
qs_get_connector_schemaleer
Devuelve las tablas, vistas y columnas de SQLite que la IA puede consultar, con enriquecimiento de Schema Intelligence cuando esté disponible.
tabla_perfil_qsanalizar
Valores de muestra, distribuciones, detección de enumeraciones, tipos semánticos: bajo demanda.
qs_list_consultas_guardadasleer
Plantillas SQL parametrizadas predefinidas en las que el equipo confía. La IA las ejecuta sin tener acceso al código SQL.
qs_run_consulta_guardadaejecutar
Ejecuta una consulta guardada por clave_patrón con anulación de parámetros opcional.
qs_run_queryejecutar
Ejecuta una consulta SELECT contra un conector. El validador de solo lectura se ejecuta en el agente, antes de la .db El archivo se abre alguna vez.

Por qué Schema Intelligence hace que Query Streams MCP sea diferente

La mayoría de los servidores "MCP para SQLite" en el entorno de código abierto le entregan a su herramienta de IA lo básico. Información de la tabla PRAGMA La salida SQLite da un extraño. Nombres de columnas. Clases de almacenamiento (ENTERO, TEXTO, REAL, GOTA). Tal vez una clave primaria. El LLM se ve obligado a adivinar que marca de tiempo de eventos es un número entero de época Unix (no una fecha ISO), que feature_flags.is_enabled es un booleano 0/1 (no un tinyint), o que eventos.tipo_de_evento En realidad es una enumeración de cinco valores oculta dentro de un TEXTO columna. La permisiva afinidad de tipos de SQLite hace que esto sea peor que en cualquier otra base de datos: la clase de almacenamiento no te dice qué hay realmente en la columna.

Query Streams MCP devuelve ese mismo esquema enriquecido con Inteligencia de esquemas (IE) — Metadatos seleccionados mediante IA y elaborados a partir de sus datos SQLite reales, de modo que cada herramienta de esquema que la IA utiliza devuelve seis capas de conocimiento seleccionado sobre el esquema básico, y el LLM deja de adivinar. Cómo la inteligencia de esquemas enriquece cada llamada de esquema →

Para concretar esto, aquí está lo que el cliente de IA obtiene de vuelta de una sola qs_get_table_schema llamada contra una base de datos SQLite típica de análisis de aplicaciones (eventos, usuarios, sesiones, indicadores de características) — primero sin Inteligencia de Esquema, luego con ella.

Sin inteligencia de esquema fuente_de_datos: esquema_capturado
// lo que ve el LLM == TABLA: eventos == – id ENTERO [PK, NO NULO] – user_id ENTERO NO NULO – tipo_de_evento TEXTO NO NULO – marca de tiempo ENTERO NO NULO - propiedades TEXTO == TABLA: usuarios == – id ENTERO [PK] - correo electrónico TEXTO – creado_en TEXTO == TABLA: sesiones == – id ENTERO [PK] – user_id ENTERO – duración_segundos ENTERO == TABLA: indicadores de características == – id ENTERO [PK] – nombre_de_la_bandera TEXTO – está_habilitado ENTERO Claves foráneas: (ninguno declarado) si_recomendación: estado: “no_ejecutar” lo_que_falta_para_esta_llamada: – Claves foráneas descubiertas por IA – Valores de muestra por columna + detección de enumeraciones – Fecha codificada en enteros e indicadores booleanos – Descripciones de tablas y columnas – Clasificaciones de tipos semánticos nota: “Solo clase de almacenamiento, sin contexto semántico”
Con inteligencia de esquema fuente_de_datos: inteligencia_de_esquema
// lo que ve el LLM == TABLA: eventos [HECHO, dominio:análisis_de_productos] == “Telemetría de acciones del usuario; una fila por evento. La marca de tiempo está en segundos de la época Unix.” - identificación ENTERO [PK] identificador – user_id ENTERO identificador FK -> users.id (100% de solapamiento, conf 0.99) – tipo_de_evento TEXTO código_de_estado (enumeración) Registro (8%) | Inicio de sesión (41%) | Visualización (38%) | Compra (9%) | Cierre de sesión (4%) – marca de tiempo ENTERO fecha_época_unix Utilice datetime(timestamp,'unixepoch'). Rango: 01/11/2025 a 06/05/2026 - propiedades TEXTO json_blob (puede ser nulo) Ejemplo: {“page”:”/pricing”,”ref”:”google”} == TABLA: usuarios [DIM, dominio:identidad] == – correo electrónico TEXTO correo electrónico Ejemplo: [email protected], [email protected] – creado_en TEXTO fecha_iso (cadena) Muestra: '2026-02-14T09:31:08Z' == TABLA: sesiones [HECHO, dominio:análisis_de_productos] == – user_id ENTERO identificador FK -> users.id (97% de solapamiento, confianza 0,94) – duración_segundos ENTERO duración_segundos Rango: 3 – 7210 · media 412 == TABLA: indicadores de características [BUSCAR, dominio:configuración] == – nombre_de_bandera TEXTO identificador Ejemplo: ['new_checkout','dark_mode','beta_search'] – está_habilitado ENTERO booleano (0/1) Distribución: 0 (62%) | 1 (38%) — tratar como booleano

Las seis capas que añade Schema Intelligence

Cada capa aborda una clase de preguntas que el LLM adivinaría de otro modo. El pase de perfilado SI opcional se ejecuta en sus datos SQLite sin cambiar su esquema; abre el .db El archivo es de solo lectura y nunca se escribe en él. Qué aporta Schema Intelligence y cómo se mantiene actualizado →

Descripciones seleccionadas por IA

Descripción clara y concisa de cada base de datos, tabla y columna: se genera una sola vez y se actualiza automáticamente al cambiar el esquema. Se evalúa la fiabilidad; las descripciones escritas por el usuario siempre son las más útiles.

eventos: “telemetría de acciones del usuario;
una fila por evento registrado.

Clasificaciones de tablas

Cada tabla está etiquetada como FACT (eventos transaccionales), DIM (referencia descriptiva) o LOOKUP (mapas de código pequeño), además de un dominio empresarial: product_analytics, identity, configuration, sales, finance y 14 más.

eventos [FACT, dominio:product_analytics]
indicadores de características [BUSCAR, dominio:configuración]

Tipos semánticos por columna

Dieciocho tipos: moneda, correo electrónico, fecha_iso, fecha_época_unix, código_estado, booleano, json_blob, identificador y más. Fundamental para SQLite, donde la clase de almacenamiento no indica si un INTEGER es un contador, una época Unix o un indicador 0/1.

marca de tiempo: fecha_época_unix
is_enabled: booleano (0/1)

Valores de muestra a partir de datos reales

Se muestran filas aleatorias al LLM para que reconozca patrones que ningún esquema puede mostrar: formas JSON dentro de columnas de TEXTO, codificaciones de fecha de época ISO-8601 frente a Unix y los valores reales que escribe su aplicación.

propiedades: {“página”:”/precios”,
“ref”:”google”}

Detección de enumeraciones con distribuciones

Las columnas de baja cardinalidad (50 valores distintos o menos, con un máximo del 5 % de las filas únicas) se asignan a su lista completa de valores con recuentos de filas. La IA nunca adivina mayúsculas ni minúsculas en las etiquetas de tipo de evento o nombres de indicadores.

tipo_de_evento: registro (8%) | inicio_de_sesión (41%)
| Ver (38%) | Comprar (9%) | Cerrar sesión (4%)

Descubrimiento implícito de claves foráneas

El análisis de superposición de datos entre tablas encuentra uniones que no están declaradas como restricciones DDL, algo común en SQLite donde PRAGMA claves_foráneas A menudo está desactivado y las claves foráneas son aplicadas por el código de la aplicación, no por la base de datos.

eventos.user_id -> usuarios.id
(Solapamiento del 100%, confianza 0,99)

Misma solicitud, diferente SQL

La prueba está en el SQL que realmente escribe la herramienta de IA. Misma sesión de Cursor, mismo modelo de Claude, misma solicitud. “¿Qué usuarios tuvieron mayor actividad esta semana y qué funciones utilizaron?” Sin la Inteligencia de Esquemas, el LLM tiene que adivinar. Con ella, el LLM sabe.

Sin inteligencia de esquema
— Primer intento de LLM contra esquemas simples: SELECCIONE ID de usuario, tipo de evento, CONTAR(*) AS n DESDE eventos DONDE marca de tiempo >= '2026-04-29' GRUPO POR ID de usuario, tipo de evento ORDENAR POR n DESC LÍMITE 10 La marca de tiempo es un ENTERO (época Unix), no un texto. La comparación de cadenas con '2026-04-29' no devuelve nada. No hay unión: el resultado contiene identificadores, no correos electrónicos de usuario. “esta semana” codificado de forma fija, no dinámica. Sin reconocimiento de enumeraciones: podría omitirse tipos de eventos válidos. Devuelve silenciosamente 0 filas; LLM no tiene idea de por qué.
Con inteligencia de esquema
— Primer intento de LLM con SI habilitado: CON activo AS ( SELECCIONE e.user_id, e.event_type, CONTAR(*) AS n DESDE eventos e DONDE e.timestamp >= strftime('%s',fecha y hora('ahora',-7 días)) GRUPO POR e.user_id, e.event_type) SELECCIONE u.email, a.event_type, un AS eventos_esta_semana DESDE activo a ÚNASE A usuarios u EN u.id = a.user_id ORDENAR POR un DESC LÍMITE 10 10 filas. Correcto al primer intento. marca de tiempo vista como date_unix_epoch Eventos de descubrimiento de FK surgieron.user_id -> users.id enum-aware: se conservaron los 5 valores de event_type. Fecha y hora idiomáticas de SQLite ('ahora','-7 días')
¿No quieres ejecutar Schema Intelligence? MCP sigue funcionando: las herramientas de esquema devuelven metadatos simples (tipos, claves primarias, claves foráneas formales, índices) y cada respuesta degradada lleva un si_recomendación bloque que le indica a la IA lo que le falta, incluyendo una opción de llamada única para habilitar SI en medio de la conversación a través de qs_request_si_analysis. Cómo funciona Schema Intelligence y cuánto tiempo tarda →
Nova AI

¿MCP no es para ti? Prueba Nova AI en su lugar.

Omita por completo la configuración JSON: Nova AI está integrada en el portal web Query Streams. y formula las mismas preguntas en lenguaje sencillo en todo el conector SQLite y en todos los demás conectores de su cuenta: el mismo agente, la misma aplicación de solo lectura, la misma inteligencia de esquema, sin necesidad de la infraestructura de MCP.

Conozca a Nova AI

Requisitos previos

Antes de comenzar, asegúrese de tener:

  1. Una cuenta gratuita de Query Streams en mi.querystreams.com.
  2. El agente de red de Query Streams instalado en una máquina que pueda leer su .db archivo — ver Descargar el agente de flujos de consultas.
  3. Un conector SQLite configurado contra el agente; consulte el archivo existente. configuración del conector guías para dirigir al agente hacia su .db, .sqlite, o .sqlite3 El agente guarda la ruta del archivo; la herramienta de IA nunca la ve.
  4. Cualquier cliente de IA compatible con MCP. En esta guía mostraremos Cursor, Claude Desktop, ChatGPT y Grok; si usa Windsurf, Zed, Continue, Cline, VS Code Copilot, Codex o Goose, el bloque de configuración es prácticamente el mismo.
  5. Cinco minutos.
Solo necesitas configurar el agente una vez. El mismo agente que impulsa los complementos de Query Streams para Excel y Google Sheets, el generador de consultas web y Nova AI también se utiliza para MCP. Agregar MCP a una cuenta existente de Query Streams solo requiere generar una clave; el agente y el conector SQLite ya están en funcionamiento.
1

Generar una clave MCP

Desde /mcp En la página de Flujos de consulta, cree una clave con los ámbitos que desee.

2

Introdúzcalo en su cliente de IA

Un fragmento JSON para Cursor, Claude, ChatGPT o Grok. La misma clave en todas partes.

3

Haz una pregunta

“¿Cuáles fueron nuestros 10 mejores clientes por valor de por vida?” — la IA utiliza las herramientas adecuadas y usted obtiene la respuesta.

Paso 1: Generar una clave MCP en Query Streams

Inicie sesión en Query Streams y abra el Página MCP (o inicie sesión primero en mi.querystreams.com y haga clic MCP en la navegación izquierda). Haga clic Generar clave, dale a la clave un nombre reconocible (algo así como cursor-portátil o escritorio claude), y seleccione los ámbitos que desea que tenga esta clave:

  • leer — La IA puede examinar conectores y leer esquemas. Necesario para todo lo demás.
  • analizar — La IA puede perfilar tablas y descubrir relaciones (valores de muestra, distribuciones, tipos semánticos). Opcional, pero muy recomendable para trabajar con SQLite, donde comprender las fechas codificadas como enteros, los valores booleanos 0/1 y las columnas JSON-in-TEXT es importante antes de que el LLM escriba las uniones.
  • ejecutar — La IA puede ejecutar SQL. Sin esto, la IA solo puede leer los metadatos del esquema.

Para un flujo de trabajo típico de "dejar que Claude analice mis datos SQLite", los tres alcances son apropiados. Para una clave que le entregas a un compañero de equipo o a un cliente menos confiable, deja caer ejecutar y dejarles solo navegar. Puede revocar cualquier clave en cualquier momento desde la misma página; el cliente de IA verá CLAVE MCP REVOCADA en su siguiente llamada y deja de funcionar inmediatamente. No hay retardo de propagación.

Copia la clave ahora: Query Streams la muestra una vez y luego solo almacena un hash. Si la pierdes, genera una nueva. La clave se ve así: qsmcp_ seguido de 48 caracteres aleatorios y es lo que su cliente de IA envía en el Clave X-MCP encabezado de la solicitud.

Paso 2: Agregue Query Streams MCP a su cliente de IA.

La configuración tiene la misma forma en todos los clientes compatibles con MCP: una entrada de servidor MCP que apunta a https://mcp.querystreams.com con su llave en el Clave X-MCP Encabezado. Seleccione su cliente a continuación.

Cursor
Cursor ~/.cursor/mcp.json
// Editar ~/.cursor/mcp.json
{
  "mcpServers": {
    "flujos de consulta": {
      "url": "https://mcp.querystreams.com",
      "encabezados": {
        "Clave X-MCP": "qsmcp_PEGAR_CLAVE_AQUÍ"
      }
    }
  }
}
Escritorio de Claude
Escritorio de Claude claude_desktop_config.json
// Ajustes → Desarrollador → Editar configuración
{
  "mcpServers": {
    "flujos de consulta": {
      "url": "https://mcp.querystreams.com",
      "encabezados": {
        "Clave X-MCP": "qsmcp_PEGAR_CLAVE_AQUÍ"
      }
    }
  }
}
ChatGPT
ChatGPT Aplicaciones y conectores
// Ajustes → Aplicaciones y conectores → Agregar MCP
URL del servidor  https://mcp.querystreams.com
Encabezado de autenticación Clave X-MCP
Valor del encabezado qsmcp_PEGAR_CLAVE_AQUÍ

// Requiere un plan de pago de ChatGPT
// (Plus / Pro / Equipo / Empresa).
Comprender
Comprender Herramientas MCP remotas
// Grok → Configuración → Herramientas
{
  "mcp_servers": [{
    "nombre": "flujos de consulta",
    "url": "https://mcp.querystreams.com",
    "encabezado_autenticación": "Clave X-MCP",
    "auth_value": "qsmcp_..."
  }]
}

Reinicie su cliente de IA. En su próximo inicio, detectará las ocho herramientas de Query Streams MCP enumeradas anteriormente y las mostrará en su paleta de herramientas. En Cursor y Claude Desktop puede verificarlo escribiendo “conectores de lista” — la IA debería llamar qs_list_connectors y devuelve tu conector SQLite junto con cualquier otra cosa que hayas configurado.

Paso 3: Hazle una pregunta a la IA sobre SQLite.

No escribes SQL, lo hace la IA. Haces una pregunta, la IA elige la herramienta MCP correcta, el agente abre el .db El archivo está en modo de solo lectura, se ejecuta la consulta y la respuesta se devuelve como texto más tablas. Tres ejemplos de indicaciones para probar primero:

“Muéstrame los usuarios activos diarios de los últimos 30 días.”
Compromiso
La IA llamará qs_get_connector_schema para descubrir el eventos, usuarios, y sesiones mesas, entonces qs_run_query con una consulta SELECT que utiliza operaciones matemáticas de fechas idiomáticas de SQLite — fecha(marca de tiempo, 'época unix') para el cubo del día, fecha y hora('ahora', '-30 días') para el límite inferior — CONTAR(DISTINCT user_id) por día. La Inteligencia de Esquemas le enseñó que marca de tiempo de eventos es un entero de época Unix, no una cadena, por lo que el filtro de fecha devuelve filas. Verás la tendencia de DAU en línea como una tabla, además de una interpretación escrita que señala la caída del fin de semana y cualquier pico inusual.
“¿Qué funciones tienen la mayor tasa de participación?”
Producto
La IA se une eventos a indicadores de características en el JSON propiedades columna (usando json_extract(propiedades, '$.feature')), filtros feature_flags.is_enabled = 1 mediante la detección booleana de Schema Intelligence en la columna INTEGER 0/1, y calcula la tasa de participación como CONTAR(ID de usuario distintos con evento) / CONTAR(ID de usuario distintos total)El resultado es una lista de características clasificadas: la IA normalmente señala qué características necesitan promoción y cuáles parecen una carga muerta. La detección de enumeraciones de SI en tipo_de_evento Esto significa que no excluye accidentalmente nombres de eventos válidos al adivinar las mayúsculas y minúsculas.
“Enumerar los usuarios que no han iniciado sesión en 60 días.”
Retención
La IA escribe una CTE que encuentra la última de cada usuario acceso evento - MÁXIMO(marca de tiempo) FILTRO (DONDE event_type = 'login') agrupados por ID de usuario — luego filtra a los usuarios donde datetime(last_login, 'unixepoch') < datetime('now', '-60 días'), se une de nuevo a usuarios para obtener el correo electrónico y la fecha de registro. El resultado es una lista enfocada ordenada por fecha de última conexión (más antigua), además de una interpretación escrita que señala los grupos con mayor riesgo de abandono. Puedes profundizar preguntando “¿Cómo se compara eso con nuestro plazo de 30 días?” y la IA vuelve a ejecutarse con el nuevo límite.

La primera vez que la IA llame a una herramienta, es posible que su cliente muestre una solicitud de confirmación para que usted apruebe la llamada. Este es el flujo de consentimiento estándar de MCP, no una función adicional de Query Streams. Una vez aprobada, la IA continuará con el resto de la conversación sin problemas. Puede revisar el consentimiento en cualquier momento en la configuración de su cliente.

Aviso de facturación transparente: El uso de MCP se factura por bytes sin comprimir.

El complemento de Excel de Query Streams, el complemento de Google Sheets, el generador de consultas web y Nova AI se ejecutan a través de nuestro enlace comprimido en la nube; medimos y facturamos. bytes comprimidos contra su dominio de datos. El transporte MCP (HTTP Streamable según la especificación oficial de MCP) no admite de forma fiable la compresión de extremo a extremo en todos los clientes y proxies intermedios, por lo que medimos y facturamos. bytes sin comprimir para el tráfico MCP.

  • Lo que esto significa: Una consulta de registro de eventos SQLite de 500 KB consume aproximadamente 500 KB de su dominio de datos cuando se obtiene a través de MCP, en comparación con los 80-120 KB que consume a través de Excel, Hojas de cálculo, Nova o el Generador de consultas. Un agregado de eventos de 5000 filas que se descarga como 750 KB de JSON a través de MCP habría ocupado entre 120 y 150 KB de bytes comprimidos con LZ4 a través de los clientes de Excel, Hojas de cálculo, Nova o el Generador de consultas. Los datos de la aplicación SQLite con cadenas de tipo de evento repetidas se comprimen aproximadamente 5 veces mediante LZ4. Mismos datos, diferente transporte, diferente tamaño facturable.
  • Lo que esto no es: Un recargo o una penalización por usar MCP. Transmitimos los bytes reales enviados. Los demás clientes son más baratos porque la compresión funciona de forma fiable en esos protocolos; no te penalizamos por la elección del protocolo, pero debemos ser transparentes sobre la estructura de costes.
  • Qué puedes hacer: para consultas recurrentes muy grandes (por ejemplo, volcar el archivo completo) eventos tabla para archivado), prefiero la ruta Excel / Sheets / Nova. Para llamadas a herramientas de IA interactivas (la respuesta SQLite típica de 100 a 5000 filas que se ajusta a un contexto LLM), MCP es la opción correcta y la diferencia de costo es de centavos.

Preguntas frecuentes

¿Necesito abrir puertos o usar una VPN para poder usar esto? +
Sin reglas de entrada, reenvío de puertos, NAT punchthrough o VPN: el agente de red realiza una conexión TLS saliente (puerto 443) y su cliente de IA llega https://mcp.querystreams.com desde internet pública, por lo que si el HTTPS saliente funciona en el host del agente, MCP funcionará. Vea cómo funciona la conexión solo de salida →
¿Qué herramientas de IA puedo usar con Query Streams MCP? +
Cualquier cliente compatible con el protocolo abierto Model Context Protocol (MPPT): Claude Desktop, Claude Code, Cursor, ChatGPT (de pago), Grok, Gemini CLI, Windsurf, Zed y más de 500 clientes adicionales. Puedes usar tu propia herramienta de IA; no es necesario cambiar. Lista completa de clientes de IA compatibles →
¿Puedo revocar una clave MCP? +
Sí, tres interruptores de apagado independientes (por tecla desde el /mcp página, por organización a través de la configuración del plan y a nivel de plataforma), ninguno de los cuales requiere una rotación de contraseña de base de datos o un reinicio del agente. Más información sobre la seguridad de las claves MCP →
¿Cómo se factura el uso de MCP a mi dominio de datos? +
Las llamadas de ejecución de MCP deducen del mismo presupuesto de datos que ya utilizan Excel, Google Sheets, Web Query Builder y Nova AI: un único presupuesto de consumo para todos los métodos de acceso. El tamaño medido para MCP es diferente. Los demás clientes utilizan nuestro enlace de nube comprimida (les facturamos) bytes comprimidos); MCP se ejecuta sobre Streamable HTTP, que no admite de forma fiable la compresión de extremo a extremo a través de todos los clientes y proxies, por lo que facturamos bytes sin comprimirUna consulta de registro de eventos SQLite de 500 KB devuelta a Excel suele costar entre 80 y 120 KB de su dominio de datos; el mismo resultado de 500 KB devuelto a Cursor a través de MCP cuesta aproximadamente 500 KB. Somos transparentes al respecto porque preferimos que lo sepa de antemano a que se lleve una sorpresa al final del ciclo de facturación.
¿Funciona Query Streams MCP con mi? .db / .sqlite / .sqlite3 ¿Archivo? ¿Qué hay del modo WAL y el acceso multiproceso? +
Sí, el Agente de red abre cualquier archivo SQLite 3.x (independientemente de la extensión). .db, .sqlite, .sqlite3, o ninguna extensión en absoluto) a través del estándar sqlite3 controlador. El conector es el ruta del archivo, no es una URL de servidor, por lo que cualquier cosa que el usuario del agente pueda leer en el disco es válida. El modo WAL (registro de escritura anticipada) es compatible de forma predeterminada. El agente abre el archivo en modo de solo lectura por defecto (modo=ro en la URI), por lo que es seguro ejecutarlo junto con la aplicación propietaria del archivo: su aplicación puede seguir escribiendo mientras la IA lee, y viceversa. Para escenarios multiproceso, el agente utiliza el modo de caché compartida de SQLite más un tiempo de espera de ocupación configurable (5 segundos por defecto) para que los bloqueos breves de escritura no provoquen errores de "la base de datos está bloqueada". Consejo: registrar cada .db Archivo como conector independiente y podrá ejecutar varias bases de datos SQLite desde una sola clave MCP. base de datos de la aplicación, análisis.sqlite, caché.sqlite3, sesión.db, todos visibles para el LLM por nombre. El agente también admite sistemas de archivos en red (SMB, NFS, EFS), pero para un mejor rendimiento mantenga el .db archivo local al host del agente.
¿En qué se diferencia esto de ejecutar yo mismo un servidor SQLite MCP de código abierto? +
Un servidor SQLite MCP directo (existen proyectos comunitarios en GitHub, en su mayoría simples envoltorios alrededor de sqlite3) es un MCP por .db ruta de archivo en el sistema de archivos local del cliente de IA. Eso funciona en la computadora portátil de un desarrollador, pero falla en el momento en que el archivo SQLite reside en una máquina diferente, una puerta de enlace IoT o cualquier entorno donde el cliente de IA no tenga acceso al sistema de archivos local. Para que Claude lea desde el registro de su aplicación SQLite + Google Search Console + su cuenta de Stripe + su almacén de Snowflake, necesitaría cuatro servidores MCP configurados por separado en cada cliente de IA, cada uno con su propio modelo de alcance, cada uno con su propia historia de auditoría. Query Streams MCP es una clave que llega a cada conector que su cuenta ha emparejado: el archivo SQLite reside en la máquina en la que se ejecuta el agente, no en la máquina del cliente de IA. También obtiene Schema Intelligence (fundamental para la afinidad de tipo permisiva de SQLite), aplicación de solo lectura en la capa del agente, límites de velocidad por clave, registro de auditoría en registros_de_eventosy la misma canalización de facturación del dominio de datos que ya utiliza, ninguna de las cuales le proporciona un MCP SQLite directo.
¿Qué ocurre si la IA intenta escribir o borrar datos? +
Es rechazado por el agente antes de la .db El archivo se abre alguna vez para escritura. Cada qs_run_query La llamada es analizada por un validador de solo lectura codificado que solo permite SELECCIONE, CON, y EXPLICAR declaraciones; cualquier otra cosa devuelve SOLO LECTURA_VIOLACIÓN y nunca llega a SQLite. El validador se ejecuta en el proceso del agente en su máquina, no en la nube, por lo que una infraestructura de nube comprometida no podría eludirlo. Medidas de seguridad adicionales para SQLite: El agente abre además el archivo con ?modo=ro En la URI de conexión, incluso si un atacante malintencionado lograra escribir sin que el analizador lo detectara, la propia biblioteca SQLite rechazaría la operación. Dos capas independientes de control de solo lectura: una en el validador y otra en el identificador del archivo.
¿Puedo ver qué preguntó exactamente la IA? +
Sí. Cada llamada a la herramienta MCP escribe una fila en el propio Query Streams. registros_de_eventos tabla con la organización, usuario, clave, ámbito, latencia y código de resultado. El administrador de la organización puede responder "¿quién usó MCP la semana pasada, qué conector y qué preguntaron?" con una sola consulta. Tenga en cuenta que registramos la nombre de la herramienta y metadatosNo se trata del texto SQL ni de las filas devueltas; estas fluyen a través del enlace en la nube y nunca llegan a los registros de la nube. Advertencia de auditoría específica de SQLite: SQLite no tiene un registro de auditoría nativo del lado del servidor (es una biblioteca integrada, no un servidor), por lo que para la captura completa del texto SQL tiene dos opciones prácticas: (a) habilitar registro a nivel de aplicación en cualquier aplicación que posea el archivo: la mayoría de los ORM y los envoltorios de SQLite pueden emitir un registro de depuración de cada instrucción preparada; o (b) envuelva el manejador SQLite de su aplicación con el sqlite3_trace_v2 o sqlite3_update_hook Devoluciones de llamada de la API de C (y equivalentes en Python) sqlite3.set_trace_callback, del Nodo mejor-sqlite3 ganchos, etc.) para registrar cada instrucción en un archivo. Para Query Streams MCP específicamente, el registros_de_eventos Por lo general, el registro de actividad es suficiente, ya que está vinculado a la identidad, el alcance y la clave de la IA, que es precisamente lo que suele necesitar una auditoría.
¿Es necesario ejecutar Schema Intelligence para usar Query Streams MCP? +
No - La inteligencia de esquema es opcional por (conector, base de datos) pary MCP funciona bien sin él. La IA obtiene el esquema desnudo (clases de almacenamiento, claves primarias, claves foráneas formales cuando PRAGMA foreign_keys = ON(índices) y escribe consultas básicas. Con SI habilitado, la IA obtiene seis capas adicionales de metadatos seleccionados: (1) Descripciones seleccionadas por IA en cada tabla y columna; (2) clasificaciones de tablas (FACT para eventos transaccionales, DIM para referencia descriptiva, LOOKUP para mapas de código pequeños) más una etiqueta de dominio comercial (product_analytics, identity, configuration, sales, finance y 14 más); (3) un tipo semántico en cada columna, especialmente valioso para SQLite, donde la misma clase de almacenamiento INTEGER puede ser un contador, una época Unix, un booleano 0/1 o una clave externa, y donde TEXT puede contener una cadena de fecha ISO-8601, un correo electrónico, un UUID o un blob JSON; (4) Muestra valores de tus datos reales para que LLM reconozca la estructura JSON dentro de una columna de TEXTO; (5) Detección de enumeraciones con distribuciones de valores completos en columnas de baja cardinalidad como tipo_de_evento o nombre_de_bandera; y (6) Claves foráneas descubiertas por IA basadas en la superposición de datos entre tablas, que salieron a la luz a través de qs_obtener_relaciones — particularmente importante para las bases de datos SQLite donde la aplicación formal de claves foráneas a menudo está deshabilitada. Sin SI, cada respuesta de la herramienta de esquema también conlleva una si_recomendación listar exactamente lo que falta para la llamada: la IA puede leer esto y ofrecer activar SI en medio de la conversación a través de qs_request_si_analysisEl tiempo de ejecución varía según el número de tablas: una base de datos pequeña con menos de 100 tablas se completa en unos 10 minutos; una base de datos típica de tamaño medio (unos cientos de tablas) termina en 15-25 minutos; una base de datos empresarial grande con más de 1500 tablas puede tardar entre 45 y 60 minutos en un escaneo completo. La mayoría de los archivos SQLite de nivel de aplicación (menos de 50 tablas) terminan en bastante menos de 10 minutos. SI se ejecuta a través de su Agente de red contra sus datos (nunca en la nube), nunca escribe en su .db El archivo nunca modifica su esquema y se actualiza incrementalmente cuando este cambia. El efecto de extremo a extremo: con SI habilitado, su cliente de IA escribe SQL correcto al primer intento con mucha más frecuencia que contra cualquier servidor "MCP para X" que simplemente entrega el LLM. Información de la tabla PRAGMA.
¿Qué ocurre si añado otro conector más adelante, como Stripe o PostgreSQL? +
Nada cambia en el lado del cliente: la misma clave llega al nuevo conector en el momento en que el agente la empareja (qs_list_connectors (lo recoge automáticamente). Un bloque de configuración compra toda tu cuenta, presente y futura. Por qué una sola llave sirve para todos los conectores →
¿Tengo que configurar MCP solo para chatear con mis datos? +
No - Nova AI está integrada en el portal Query Streams. Funciona con cualquier conector (incluido SQLite) sin necesidad de configuración ni archivos de configuración de MCP. Usa Nova para interactuar con tus datos dentro de Query Streams; usa MCP cuando quieras que tu cliente de IA (Claude, Cursor, ChatGPT, etc.) acceda a los mismos datos: mismo agente, mismos conectores, misma inteligencia de esquema subyacente. Obtén más información sobre Nova AI →

Comience

Conecta tu herramienta de IA a tus datos SQLite en cinco minutos.

Una clave MCP llega a todos .db Archivo que el agente puede ver, cualquier otra base de datos y cualquier conector API en su cuenta de Query Streams, con registro de auditoría completo, límites de velocidad por clave y sin cambios en el firewall. Claude, Cursor, ChatGPT y Grok funcionan de inmediato.

Guías relacionadas: Descargar el agente de flujos de consultas | Configuración del conector de base de datos | Todas las guías del servidor MCP | Nova AI texto a SQL

Categoría: Servidor MCP

Etiquetas: mcp, claude, cursor, sqlite, base de datos, herramientas para desarrolladores, base de datos integrada

Meta Descripción: Conecta SQLite (.db / .sqlite / .sqlite3) a Claude o Cursor a través de Query Streams MCP. Salida, solo lectura, 5 min.

Actualizado el 16 de junio de 2026

Funciona con BetterDocs