Conecta Timescale Cloud con Claude mediante MCP.

MCP · Plazo para Claude

Preguntar Claude Acerca de su base de datos Timescale, 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 base de datos Timescale, escribe el código SQL, lo ejecuta en modo de solo lectura a través del Agente que ya está con tus datos y devuelve las filas. La IA nunca recibe ninguna contraseña de la base de datos. El proceso dura unos diez minutos y está incluido en el plan gratuito.

Aproximadamente 10 minutos Claude, ChatGPT, Cursor + 11 clientes más Las credenciales permanecen contigo Solo lectura, siempre

Lo que obtendrás al final

A Claude that can answer questions about your Timescale service with live, read-only queries, explain what the columns mean, and follow up when you ask for more — without ever seeing a database login, and without a firewall change: the Agent already inside your network runs the SQL 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 ChatGPT Cursor Código Claude VS Code Windsurf Gemini CLI JetBrains Códice+5 másSolo lectura

¿Qué hay en condiciones ¿En mi base de datos Timescale? Muéstrame algunas filas y dime qué significa cada columna.

qs_get_table_schema qs_run_query inteligencia de esquema

Primero examiné la estructura de la tabla y luego ejecuté una consulta de solo lectura a través de su agente. Aquí están tres de las filas de condiciones:

intervalo_de_tiempo1hora	hora	temperatura promedio
1042	Comerciantes de Northwind	Seattle
1057	Equipamiento alpino	Denver
1063	Alimentos del puerto	Halifax

intervalo_de_tiempo1hora identifica la fila. hora y temperatura promedio are described in your Schema Intelligence model, so I can filter on them by name.

Which three temperatura promedio values brought in the most revenue this quarter, and how does that compare with last quarter? Anything I should look into?

qs_obtener_relaciones qs_run_query qs_run_query

I joined condiciones a pedidos on the relationship Schema Intelligence found, then ran one aggregate for each quarter. Both queries were read-only and returned 3 rows each:

temperatura promedio	This quarter	Last quarter	Change
Denver	184,200	133,900	+38%
Seattle	171,650	168,400	+2%
Halifax	96,300	129,700	−26%

Denver is the story: revenue up 38% on almost the same number of customers, so average order value rose. Halifax fell 26%, and the drop is two customers who ordered every month last quarter and not at all this quarter — worth a call before month end. Seattle is flat. Want the two Halifax accounts by name?

SELECCIONAR solamente, verificado por el Agente registrado en la pestaña Actividad de MCP 9 rows returned across 3 queries Misma conexión en 14 clientes MCP.

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.

Timescale Cloud almacena tus datos en la nube, gestionada por su proveedor. Claude, en cambio, se ejecuta en un navegador o terminal y no tiene conocimiento de ello. El método habitual consiste en pegar un esquema en el chat y esperar que funcione, o bien proporcionar la contraseña de Timescale a un servidor MCP de código abierto. Query Streams funciona de forma diferente: el agente que ya está integrado en tu servicio Timescale ejecuta las consultas SQL que escribe Claude en modo de solo lectura, y el servidor MCP, entretanto, verifica quién realiza la consulta, qué acciones puede realizar y con qué frecuencia. Claude obtiene respuestas, pero nunca credenciales.

Timescale, ahora Tiger Cloud de Tiger Data, es PostgreSQL con la extensión TimescaleDB. Para Claude, las hipertablas se comportan como tablas normales, y funciones como time_bucket funcionan en sus consultas.

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.

Escala de tiempo conectada a través del Agente

El agente se instala en cualquier ordenador que esté siempre encendido, con la conexión de escala de tiempo añadida en los agentes de datos.

Elige el Plazo Tarjeta. El modo de conexión directa, la base de datos tsdb, el nombre de usuario tsdbadmin y la opción Usar SSL ya están completados. En la consola de Tiger Cloud, abre tu servicio y ve a Información del servicio, luego a Información de conexión. Copia la URL del servicio y pégala en el campo URL del servicio, luego agrega tu contraseña. La consola no vuelve a mostrar la contraseña después de que se crea el servicio. Los puertos varían según el servicio y el pooler, así que copia el tuyo.

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. Abra MCP en el portal

   Iniciar sesión en mi.querystreams.com y abierto Transmisiones → En vivo → MCPLa página tiene cuatro pestañas: Conectar, Aplicaciones conectadas, Mis llaves y, para los administradores, Actividad. Compruebe el Mis llaves Panel lateral: muestra el conector de Timescale y si Schema Intelligence se ha ejecutado en él. La cobertura completa es lo que permite a Claude escribir SQL de Timescale correcto al primer intento.

   MCP abierto

   ¿Ves el mensaje "MCP está desactivado para tu cuenta"? Su organización tiene MCP pero su usuario está desactivado. Un administrador lo activa con el MCP cambia al lado de tu nombre debajo Cuenta → Control de accesoLos creadores, propietarios y administradores están presentes desde el principio.

2. Elige cómo te conectarás

   Hay 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.

3. Conectar con Claude

   Selecciona la receta del 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 cuya respuesta ya conozcas, para que puedas ver cómo Claude elige la herramienta adecuada. Tres que funcionan bien con tu servicio Timescale:

   “¿Qué datos tengo en mi servicio Timescale?”

   Claude enumera las tablas que puede ver, te indica cuáles tienen inteligencia de esquema y te pregunta qué quieres ver.

   “Muéstrame diez filas de condiciones y explica cada columna.”

   Claude primero lee la estructura de la tabla (Leer), luego ejecuta una consulta SELECT a través de su agente (Ejecutar) y describe qué significan hour y avg_temp.

   “¿Cuántas filas tiene la condición por avg_temp? ¿Qué avg_temp tiene la mayor cantidad?”

   Claude escribe la cláusula GROUP BY en el dialecto de Timescale, la ejecuta y responde con una frase que incluye una pequeña tabla. Continúa la conversación en el mismo chat; así se mantiene el contexto.

   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 pocos segundos. Una aplicación conectada aparece debajo Aplicaciones conectadas con la hora en que estuvo conectado y se usó por última vez.

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

• Guarda las consultas que consideres canónicas En el Generador de consultas, Claude recurre primero a las consultas guardadas, por lo que "clientes activos" significa lo que tu equipo diga que significa.
• Utiliza un proyecto Claude con Query Streams adjunto y coloque sus reglas de la casa en sus instrucciones: qué base de datos de Timescale usar por defecto, cuáles consultas guardadas son las definiciones oficiales.
• Grant Analyze cuando se buscan respuestas más profundas. Analizar una columna antes de filtrarla marca la diferencia entre adivinar un código de estado y usar el correcto. Consume créditos de Nova AI, así que permanecerá desactivado hasta que lo indiques.
• Solicita un gráfico. claude.ai dibuja gráficos a partir de las filas que recibe Claude.

Cuando algo no funciona

Preguntas que hace la gente

Guías relacionadas

• Conecta Microsoft SQL Server con Claude mediante MCP.
• Conecta PostgreSQL con Claude usando MCP.
• Conecta MySQL con Claude usando MCP.
• Conecta Microsoft Access con Claude mediante MCP.
• Conectar Query Streams a Claude mediante MCP: configuración, permisos y solución de problemas
• Todas las guías MCP