Conecte Query Streams a Claude y haga preguntas sobre sus bases de datos en lenguaje sencillo. Claude lee su esquema, sus consultas guardadas y sus Inteligencia semántica El modelo se ejecuta en tiempo real, realiza consultas SQL de solo lectura a través del Agente de red 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. Instala el Agente de red junto a su base de datos una vez (unos minutos) y agregue un conector. Después de eso, Query Streams está en el Directorio de conectores antrópicos. En claude.ai abierto Configuración → Conectores → Explorar conectores, 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?” Claude solo puede ver los datos que proporciona un Agente: si omite el Agente, le indicará que no hay conectores.
Antes de empezar
Necesitas cuatro cosas. Si encontraste Query Streams dentro de Claude, el Agente y un conector son las dos que aún tienes que configurar.
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 el pequeño servicio que se ubica junto a su base de datos y realiza una conexión saliente a Query Streams. ¿Cuenta nueva? Instálelo ahora desde my.querystreams.com/descargar, unos minutos después Ventanas, macOS o LinuxSi tu equipo ya ejecuta consultas en el Portal, Excel o Google Sheets, ya está instalado.
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)
Incluido en el Directorio de Conectores Antrópicos. Query Streams es un conector aprobado: claude.ai/directorio/flujos-de-consultaEn claude.ai y en Claude Desktop puedes conectarlo con un solo clic desde Explorar conectoresNo se necesita una URL de servidor. La ruta del conector personalizado que se muestra a continuación sigue funcionando y es la que debe usar si su organización Claude restringe los conectores de directorio.
- En claude.ai abierto Configuración → Conectores → Explorar conectores, buscar Flujos de consulta y haga clic Conectar (o abrir el listado del directorio directamente). En Claude Desktop la misma opción está en Configuración → Conectores. ¿No lo ves? Es posible que su organización restrinja los conectores de directorio: haga clic aquí. Agregar conector personalizado En cambio, nómbralo Flujos de consulta y pegar
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 | Permite listar conectores y agentes, explorar esquemas, leer descripciones de inteligencia semántica y consultar las consultas guardadas y las 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 Inteligencia Semántica. | 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 Inteligencia Semántica por base de datos y, con su consentimiento, programe una ejecución de análisis para obtener mejores respuestas en el futuro.
Por qué la inteligencia semántica 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 semántica | 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 la Inteligencia Semántica 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 semántica →
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 cuentan con inteligencia semántica?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 semántica está en marcha. 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 dice que no hay conectores ni agente de red. | Tu cuenta aún no tiene ningún agente en ejecución, o bien el agente no tiene ninguna fuente de datos añadida. | Instale el agente desde my.querystreams.com/descargar, agregue un conector debajo Datos → Agentes de datos → Agregar conector, entonces pregunta de nuevo. |
| 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 inteligencia semántica 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 la función de Inteligencia Semántica. |
TASA DE MCP_LIMITADA | Demasiadas llamadas por minuto para tu plan. | Un momento. Las sesiones con mucha actividad se benefician de la inteligencia semántica, 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 teniendo problemas? Envía un correo electrónico. [email protected].
Seguridad y privacidad
- Claude recibe metadatos de esquema, descripciones de inteligencia semántica que incluyen valores de ejemplo y los resultados de las consultas que usted realiza. Estos resultados se transmiten al proveedor de IA que usted eligió para conectarse, 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 sentencias de lectura. Claude puede poner en cola una ejecución de Inteligencia Semántica y proponer una regla de alerta en modo de prueba; ambas escriben en los metadatos de Query Streams, nunca en su 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 inteligencia semántica. 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 a Claude con tus datos
Instala el agente una sola vez, en pocos minutos. Después, conectar Claude es tan sencillo como hacer clic: sin clave, sin archivo de configuración, sin VPN. De diseño, solo lectura.
Instalar el agente Abra la página de MCP Cómo funciona MCP
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish