Conecta Query Streams a Claude y consulta tus bases de datos en lenguaje natural. Claude lee tu esquema, tus consultas guardadas y tu modelo de Schema Intelligence en tiempo real, ejecuta SQL de solo lectura a través de tu Network Agent y nunca accede a la contraseña de la base de datos. Esta guía abarca claude.ai, Claude Desktop y Claude Code, además de todos los demás clientes de MCP.
Versión corta. Query Streams is in the Anthropic Connectors Directory. In claude.ai open Settings → Connectors → Browse connectors, encontrar Flujos de consulta, haga clic Conectar, aprueba los permisos en la pantalla de consentimiento de Query Streams y pregunta a Claude “¿A qué bases de datos tengo acceso?” That’s it.
Antes de empezar
Necesitas cuatro cosas. La mayoría de las cuentas ya tienen las tres primeras.
Un plan que incluye MCP
MCP está disponible en todos los planes, incluido el gratuito. Lo que varía según el plan es la cantidad de llaves o aplicaciones conectadas que puedes tener y la cantidad de llamadas por minuto que Claude puede realizar; el plan gratuito permite una llave o una aplicación conectada y 30 llamadas por minuto.
Un agente de red que está en línea
El agente es un pequeño servicio que se ubica junto a su base de datos y establece una conexión saliente con Query Streams. Si su equipo ya ejecuta consultas en el Portal, Excel o Google Sheets, ya está instalado. Guía de instalación →
Al menos un conector
Un conector es una base de datos o una API registrada en el Portal. Claude ve todos los conectores a los que tu cuenta puede acceder, según los permisos que le hayas otorgado.
Acceso MCP en su usuario
Los creadores y propietarios de la organización tienen acceso MCP automáticamente. Otros usuarios necesitan que un administrador les dé permiso. MCP junto a su nombre en Cuenta → Control de acceso.
Cómo funciona
Claude nunca se conecta a su base de datos. Se comunica con el servidor MCP de Query Streams en nuestra nube, que reenvía cada solicitud a través de la única conexión saliente que su Agente de red ya mantiene abierta. El agente ejecuta la consulta localmente y transmite las filas de vuelta de la misma manera. Las solicitudes y los resultados fluyen en ambas direcciones a través de ese único canal iniciado por el agente, por lo que no es necesario abrir nada en su firewall.
OAuth, ámbitos, auditoría, límites de velocidad
una conexión TLS saliente
De ese diseño se derivan tres propiedades:
- Claude no tiene credenciales. La cadena de conexión a la base de datos reside en el agente. Claude solo posee una autorización OAuth o una clave MCP, las cuales puede revocar desde el Portal con un solo clic.
- Solo lectura, aplicada por el agente. Solo
SELECCIONE,CONyEXPLICARLas declaraciones son aceptadas. La verificación se realiza en su lado de la conexión, no en la nube ni en Claude. - Todo queda registrado. Cada llamada a herramienta aparece en la página MCP. Actividad pestaña y cada consulta en el historial de consultas, atribuida al usuario que se conectó.
Conectar con Claude
Existen dos formas de acceso. Las aplicaciones de chat utilizan OAuth y no requieren clave. Las herramientas para desarrolladores utilizan una clave MCP. Ambas acceden al mismo servidor y a las mismas herramientas.
Opción A: claude.ai y Claude Desktop (OAuth, sin clave)
Listed in the Anthropic Connectors Directory. Query Streams is an approved connector: claude.ai/directory/query-streams. On claude.ai and in Claude Desktop you can connect it with one click from Explorar conectores; no server URL needed. The custom-connector route below still works and is what to use if your Claude organization restricts directory connectors.
- En claude.ai abierto Settings → Connectors → Browse connectors, buscar Flujos de consulta y haga clic Conectar (or open the directory listing directly). In Claude Desktop the same option is under Configuración → Conectores. Can’t see it? Your organization may restrict directory connectors: click Agregar conector personalizado instead, name it Flujos de consulta and paste
https://mcp.querystreams.com/mcp. - Abre cualquier chat, haz clic en el + botón junto al cuadro de mensaje, elija Flujos de consulta y haga clic Conectar.
- Se abrirá una nueva pestaña del navegador con la pantalla de consentimiento de Query Streams. Inicie sesión si se le solicita, seleccione la organización, revise los permisos (consulte a continuación) y haga clic en Aprobar conexión.
- De vuelta en Claude verás Conectado a flujos de consultaLa primera vez que Claude usa una herramienta, esta le pide permiso. Elige Permitir siempre para que pueda funcionar sin necesidad de solicitarlo en cada llamada.
El conector está vinculado a su cuenta de Claude, no a un solo dispositivo, por lo que aparece automáticamente en las aplicaciones móviles de Claude y en Claude Desktop. Puede gestionarlo o revocarlo en cualquier momento desde el Portal. MCP → Aplicaciones conectadas pestaña.
No es lo mismo que “Agregar mercado”. En Claude Desktop el chat interno + → Explorar conectores → Agregar mercado La opción requiere un repositorio Git para los mercados de complementos, no una URL de servidor MCP. Configuración → Conectores → Agregar.
Opción B: Claude Code, Cursor y otras herramientas para desarrolladores (clave MCP)
Las herramientas para desarrolladores se autentican con una clave que usted genera en el Portal y pasa en el Clave X-MCP encabezamiento.
- Iniciar sesión en mi.querystreams.com, abierto MCP → Mis claves y haga clic Generar clave. Nómbralo según la herramienta y la máquina, como por ejemplo: portátil claude-codey elegir sus alcances.
- Copia la clave ahora. Puedes mostrarla y copiarla de nuevo más tarde desde Mis llavesLas llaves se ven como
qsmcp_seguido de 43 caracteres. - Para el código Claude, ejecute:
claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp --header "X-MCP-Key: qsmcp_PASTE_KEY_HERE" - Para Cursor, VS Code, Windsurf, Zed, JetBrains, Gemini CLI, Codex CLI, Continue y Cline, abra el MCP → Conectar pestaña en el Portal. Muestra una configuración lista para pegar para cada cliente con su clave ya ingresada.
Para verificar, pregunte “¿Qué conectores de Query Streams tengo?” El cliente debería llamar qs_list_connectors y la llave último uso La hora se actualiza en la pestaña Mis teclas en cuestión de segundos.
Permisos
Tanto si te conectas mediante OAuth como mediante clave, el acceso se controla mediante tres ámbitos. La pantalla de consentimiento los muestra; a partir de ellos se crea una clave.
| Alcance | Lo que Claude puede hacer | Cuándo concederlo |
|---|---|---|
| leer | Enumerar conectores y agentes, explorar esquemas, leer descripciones de Schema Intelligence, listar consultas guardadas y reglas de alerta. | Siempre. Todo lo demás se basa en ello. |
| analizar | Cree tablas de perfiles (valores de muestra, distribuciones, tipos semánticos), descubra relaciones implícitas y ponga en cola una ejecución de Schema Intelligence. | Recomendado. Esto es lo que permite a Claude comprender la estructura de tus datos antes de escribir las uniones. |
| ejecutar | Ejecuta consultas SQL de solo lectura y consultas guardadas, y envía las filas de vuelta. | Para quienes deban obtener respuestas, no solo consultar la estructura. Desactive esta opción para una clave de solo lectura. |
Una aplicación conectada puede limitarse a conectores específicos al aprobarla; una clave generada llega a todos los conectores de la organización. La revocación de una autorización o clave surte efecto en aproximadamente cinco minutos. Los administradores pueden ver todas las autorizaciones y claves activas de la organización en la página de MCP.
Lo que Claude puede hacer una vez conectado
Claude dispone de un pequeño conjunto de herramientas. Nunca las mencionas tú mismo; Claude elige la adecuada para tu pregunta. En pocas palabras:
Comprenda sus datos
Enumera los conectores, las bases de datos y los agentes. Consulta el árbol de esquema de cualquier base de datos con descripciones de tablas y columnas, tipos semánticos, valores de ejemplo, etiquetas de enumeración y relaciones declaradas y descubiertas.
Perfil y exploración
Analiza el perfil de una tabla para ver las distribuciones de valores reales antes de escribir un filtro. Descubre uniones entre tablas que no tienen claves foráneas declaradas.
Utilice sus consultas guardadas
Enumera las consultas parametrizadas guardadas de tu organización y ejecútalas con diferentes parámetros. Las consultas federadas que abarcan varias fuentes se ejecutan en el servidor y devuelven filas ya combinadas.
Ejecutar SQL ad-hoc
Escriba y ejecute consultas SQL de solo lectura en el dialecto adecuado para el conector. Los resultados predeterminados son 1000 filas y un tiempo de espera de 60 segundos, ambos configurables.
Revisar alertas
Consulta las reglas de alerta, su estado actual y las activaciones recientes. Claude puede proponer una nueva regla en modo de prueba; una persona la activa en la página de Alertas.
Mejorar el modelo
Compruebe la cobertura de Schema Intelligence por base de datos y, con su consentimiento, programe una ejecución de análisis para obtener mejores resultados en el futuro.
Por qué la inteligencia de esquemas es importante aquí
Cada respuesta que recibe Claude se etiqueta indicando a cuál de los tres niveles pertenece, y Claude ajusta el grado de confianza que deposita en lo que ve.
| Nivel | Lo que ve Claude | Resultado |
|---|---|---|
| Inteligencia de esquemas | Descripciones para cada tabla y columna, tipos semánticos, etiquetas de enumeración, valores de muestra, clasificación de hechos y dimensiones, uniones declaradas y descubiertas. | Claude escribe código SQL de calidad profesional al primer intento y explica los datos en términos propios de tu negocio. |
| Esquema capturado | Nombres de tablas y columnas, tipos, claves primarias, índices, claves foráneas declaradas. | Claude trabaja, pero tiene que deducir el significado a partir de los nombres y puede que necesite una pregunta de seguimiento. |
| Esquema en vivo | La base de datos no está incluida en la selección de captura del conector, por lo que la estructura se lee directamente del catálogo en cada solicitud. | Las consultas siguen ejecutándose. Claude realiza búsquedas con muestras cuando necesita más información. |
Si una base de datos es importante para tu equipo, ejecuta Schema Intelligence una sola vez. Para bases de datos grandes, limita la ejecución a las tablas que tus consultas realmente utilizan. Cómo funciona la inteligencia de esquemas →
Ejemplos de indicaciones
Empieza con algo cuya respuesta ya conozcas. Luego, haz preguntas de seguimiento; Claude mantiene el contexto.
¿A qué bases de datos y tablas tengo acceso, y cuáles de ellas disponen de Schema Intelligence?Mapea tus conectores y te indica dónde se obtendrán las mejores respuestas. Muéstrame cómo se relacionan los clientes con los pedidos en la base de datos de ventas y analiza el perfil de la columna de estado del pedido.Utiliza relaciones y perfiles de columnas. Claude te mostrará los códigos de estado reales y su significado. Ejecute la consulta guardada “Ingresos mensuales por región” para el segundo trimestre de este año.Ejecuta una consulta guardada de confianza con parámetros en lugar de generar su propio código SQL. Los 10 productos con mayores ingresos en los últimos 90 días. Luego, desglosado por canal.SQL ad hoc en el dialecto del conector, seguido de una continuación en el mismo hilo. ¿Qué reglas de alerta están configuradas y se activó alguna de ellas esta semana?Lee las reglas de alerta y su estado reciente.Consejos para obtener mejores respuestas
- Utiliza un proyecto Claude. Asocia el conector de Flujos de Consulta a un proyecto e incluye tus reglas de negocio en las instrucciones del proyecto: qué base de datos usar por defecto, qué consultas guardadas son las definiciones oficiales y las convenciones de nomenclatura. Claude sigue leyendo el esquema en tiempo real, por lo que las instrucciones son breves.
- Guarda las consultas que consideres canónicas. Claude recurre primero a las consultas guardadas, por lo que "clientes activos" significa lo que tu equipo diga que significa.
- Conceder el alcance del análisis. Analizar el perfil de una columna antes de filtrarla marca la diferencia entre adivinar un código de estado y usar el correcto.
- Solicita un gráfico. claude.ai genera gráficos a partir de las filas que recibe Claude.
Lo que cuesta
MCP en sí no tiene ningún cargo adicional en ningún plan. Se miden dos cosas:
- Volumen de datos. Los resultados de las consultas que se devuelven a Claude se contabilizan dentro del mismo presupuesto de datos que comparten Excel, Google Sheets, Portal y Nova. Dado que MCP se ejecuta a través de HTTP sin compresión de extremo a extremo, se mide en bytes sin comprimir, por lo que un resultado de 1 MB cuesta aproximadamente 1 MB, mientras que el mismo resultado para Excel suele costar entre 150 y 250 KB.
límite de vista previasensato para preguntas exploratorias. - La inteligencia de esquema se ejecuta. Al poner en cola un análisis a través de Claude, se facturan créditos de IA a su organización, al igual que si se ejecuta desde el Portal. Claude pregunta antes de hacerlo.
Solución de problemas
| Lo que ves | Qué significa | Arreglar |
|---|---|---|
| Claude no muestra ninguna herramienta de flujos de consulta. | El conector se agregó pero no se conectó desde un chat, o bien la aprobación de OAuth nunca se completó. | Abre un chat, haz clic +, seleccione Flujos de consulta, Conectary finalice la pantalla de consentimiento. |
MCP_KEY_REQUIRED o 401 | No se recibió ninguna clave ni autorización en el servidor. En el caso de clientes con clave, esto suele deberse a un error al copiar y pegar, como un salto de línea al final o que la clave esté en el encabezado incorrecto. | Vuelva a copiar la clave en el Clave X-MCP Encabezado. Para claude.ai, vuelva a conectarse desde el menú +. |
MCP_TOKEN_EXPIRADO | El token OAuth ha caducado tras un período de inactividad. | Claude normalmente se actualiza automáticamente. Si no es así, desconecte y vuelva a conectar el conector. |
CLAVE MCP REVOCADA o MCP_USUARIO_DESHABILITADO | La clave fue revocada o el acceso a MCP fue desactivado para su usuario. | Genere una nueva clave o pídale a un administrador que vuelva a habilitar MCP en Cuenta → Control de acceso. |
MCP_SCOPE_REQUERIDO | La subvención o llave carece del alcance para esa acción, en la mayoría de los casos. ejecutar. | Vuelva a conectar y apruebe el ámbito que falta, o genere una clave que lo incluya. |
MCP_PLAN_CADUCADO | La suscripción de su organización ha caducado. | La página MCP del Portal muestra el estado actual del plan y los pasos a seguir. |
MCP_AGENT_NOT_CONNECTED | El agente de red propietario del conector no está conectado en este momento. | Controlar Agentes de datos en el Portal. Inicie el servicio del agente en su host. |
CONECTOR MCP NO PERMITIDO | La clave está restringida a conectores específicos y este no es uno de ellos. | Edita la lista de conectores permitidos de la clave en Mis claves o utiliza una clave diferente. |
MCP_BASE_DE_DATOS_NO_CAPTURA | La base de datos no está incluida en la selección de captura de esquema del conector, por lo que no hay información de Schema Intelligence ni relaciones almacenadas para leer. Las consultas siguen funcionando. | Agregue la base de datos a la selección de captura en el conector del Portal y, opcionalmente, ejecute Schema Intelligence. |
TASA DE MCP_LIMITADA | Demasiadas llamadas por minuto para tu plan. | Un momento. Las sesiones con mucha actividad se benefician de la Inteligencia de Esquemas, que permite a Claude responder con menos llamadas. |
MCP_QUERY_TIMEOUT | La consulta superó el tiempo de espera establecido por defecto, que es de 60 segundos. | Pídele a Claude que agregue un filtro o un límite inferior de filas, o aumenta segundos de tiempo de espera hasta 300. |
MCP_SALIDA_DEMASIADO_GRANDE | El resultado era demasiado extenso como para entregárselo a Claude en una sola respuesta. | Pide que haya menos columnas o filas. Normalmente, Claude te lo sugerirá él mismo. |
| Violación de solo lectura | El SQL contenía algo distinto a SELECCIONE, CON o EXPLICAR. | Por diseño. Los escritos nunca se aceptan a través de MCP. |
¿Sigues atascado? Abre un ticket en my.querystreams.com/support o correo electrónico [email protected].
Seguridad y privacidad
- Claude recibe metadatos del esquema, descripciones de Schema Intelligence (incluidos valores de ejemplo) y los resultados de las consultas que usted realiza. Estos resultados se transmiten al proveedor de IA que usted eligió, según los términos de dicho proveedor.
- Query Streams no recibe ni almacena tu conversación con Claude.
- Las concesiones y claves de OAuth son por usuario y por organización. Un administrador puede ver y revocar cada concesión y clave desde la página de MCP.
- Encontrará todos los detalles en nuestra Política de privacidad y Condiciones del servicio.
Preguntas frecuentes
¿Necesito abrir un puerto o usar una VPN?
No. El agente establece una conexión TLS saliente en el puerto 443. Si la conexión HTTPS saliente funciona, MCP también funciona.
¿Puede Claude modificar mis datos?
No. El agente solo acepta instrucciones de lectura. Claude puede poner en cola una ejecución de Schema Intelligence y proponer una regla de alerta en modo de prueba; ambas escriben en los metadatos de Query Streams, nunca en la base de datos.
¿Qué otras herramientas de IA funcionan?
Todo lo que utiliza MCP: ChatGPT, Cursor, Claude Code, Windsurf, Zed, VS Code Copilot, JetBrains AI, Gemini CLI, Codex CLI, Continue, Cline y más. La página de MCP del Portal incluye una configuración predefinida para cada uno.
¿Funciona con varias organizaciones?
Cada subvención o clave está vinculada a una organización. Conéctese una vez por cada organización que necesite.
¿Cuál es la diferencia entre este y Nova?
Nova es el asistente integrado en el portal Query Streams y comparte el mismo modelo de Schema Intelligence. Usa Nova cuando quieras obtener respuestas dentro de Query Streams; usa MCP cuando quieras tener tus datos dentro de Claude junto con todo lo demás que hagas allí.
Guías específicas para conectores
Cada guía explica la misma conexión con ejemplos para esa fuente.
Bases de datos: Microsoft SQL Server · PostgreSQL · MySQL · MariaDB · Oracle · Copo de nieve · Google BigQuery · SQLite · Microsoft Access · DuckDB · Supabase
API: Raya · Shopify · HubSpot · Anuncios de Google · Google Analytics 4 · Consola de búsqueda de Google · ShipStation · iTick
Carpetas de archivos y registros (El agente escanea una carpeta y convierte los archivos en tablas): Sistema de archivos · Carpeta CSV · Carpeta de parquet · Carpeta de Excel · Carpeta SQLite · Carpeta JSONL · CSV de múltiples registros · Registros de máquinas · Registros del servidor web · Registros de contenedores · Registros de la aplicación · Registros del sistema · Registros personalizados
Bases de datos alojadas (PostgreSQL, MySQL, MariaDB y SQL Server gestionados, a los que el Agente accede a través de TLS): Neón · Amazon RDS · Base de datos Azure para PostgreSQL · Base de datos Azure para MySQL · Azure SQL · Google Cloud SQL · Base de datos de aleación de Google · Bases de datos gestionadas por DigitalOcean · Aiven · Puente crujiente · Heroku Postgres · Prestar · Ferrocarril · Fly.io Postgres · Bases de datos gestionadas por Vultr · Bases de datos gestionadas por OVHcloud · Bases de datos gestionadas por Scaleway · Base de datos OCI con PostgreSQL · MySQL HeatWave · Bases de datos en la nube de IBM para PostgreSQL · MariaDB SkySQL · Xata · Nube de escala temporal · PlanetScale Postgres · Prisma Postgres · Koyeb · Nilo
Conecta Claude a tus datos en aproximadamente un minuto.
Sin clave, sin archivo de configuración, sin VPN. Solo lectura por diseño.
Abra la página de MCP Cómo funciona MCP
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish