Ver categorías

Conecta Fly.io Postgres con Claude mediante MCP.

4 minutos de lectura

MCP · Fly.io a Claude

Preguntar Claude Acerca de su base de datos Fly.io, 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 Fly.io, escribe la consulta SQL, la ejecuta en modo de solo lectura a través del Agente que ya está con tus datos y devuelve las filas. La IA nunca recibe la 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
¿Tienes algún problema? Pregúntanos. Abrir Ayuda En Consultas de flujos (menú superior derecho → Soporte) y envíanos un mensaje. Personas reales lo leen, y «No sé qué me pide esta pantalla» es una pregunta perfectamente válida.

Lo que obtendrás al final

Logotipo de Fly.io PostgresA Claude that can answer questions about your Fly.io Managed Postgres cluster 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:

Nova, the Query Streams assistant

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.

Fly.io Postgres 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 tu contraseña de Fly.io a un servidor MCP de código abierto. Query Streams funciona de forma diferente: el agente que ya se encuentra en tu clúster Fly.io Managed Postgres 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.

Fly.io Managed Postgres no está en internet pública. El agente accede a él a través de un túnel proxy local fly mpg o un enlace WireGuard a su organización Fly.

DÓNDE CORRE EL AGENTEcualquier ordenador o servidor siempre encendido con conexión a internet.Tu Fly.iobase de datosLas credenciales se quedan aquíAgente de flujos de consultasejecuta el SQL que escribe ClaudeSELECCIONAR solamente, se aplica aquíFlujos de consultaServidor MCPComprueba claves, ámbitos, límite de velocidad · registra cada llamadaDÓNDE PREGUNTASclaude.ai, Claude Desktop, Claude Code, Cursor, ChatGPTSu cliente de IAContiene una clave o una conexión, nunca una contraseña.
Claude nunca accede a tu base de datos de Fly.io. Se comunica con el servidor MCP de Query Streams, que reenvía la solicitud a través de la conexión saliente que tu agente ya mantiene abierta. El agente ejecuta la consulta y devuelve únicamente las filas.

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.

Fly.io conectado a través del Agente

The Agent installed on any always-on computer, with the Fly.io connection added in Data Agents.

Choose the Fly.io Postgres tarjeta. Rellena previamente el puerto 5432, base de datos fly-db, user fly-user and SSL on. Fly Managed Postgres lives only on your Fly private network, so run fly mpg proxy on the Agent's machine. Set the host to 127.0.0.1 with the local port it prints, and turn SSL off for the tunnel. Copy the password from the cluster's Conectar pestaña.

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.

¿Dónde se realiza el trabajo? En el ordenador donde se ejecuta el Agente, este recibe la consulta SQL que escribió Claude, comprueba que sea una sentencia SELECT, la ejecuta y devuelve las filas. Por lo tanto, ese ordenador debe estar encendido cuando realices la consulta; tu portátil solo necesita el cliente de IA.

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 tu conector Fly.io y si Schema Intelligence se ha ejecutado en él. La cobertura completa es lo que permite a Claude escribir código SQL Fly.io correcto al primer intento.

    ¿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 clúster de Postgres administrado de Fly.io:

    “¿Qué datos tengo en mi clúster de Postgres administrado por Fly.io?”
    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 clientes y explícame 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 nombre y ciudad.
    “¿Cuántas filas tienen los clientes por ciudad? ¿Qué ciudad tiene la mayor cantidad?”
    Claude escribe la cláusula GROUP BY en el dialecto de Fly.io, 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.

Eso es todo. Ahora Claude responde desde tu clúster de Postgres administrado por Fly.io cada vez que le preguntas, sin importar en qué instancia de Claude hayas abierto. Nada salió de tu red excepto las filas necesarias para responder la pregunta, y nadie introdujo una contraseña en una IA.

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:

Comprenda sus datos

Enumere los conectores, las bases de datos y los agentes. Lea las tablas y columnas de su base de datos Fly.io con descripciones, valores de ejemplo y relaciones una vez ejecutada la función Schema Intelligence.

Perfil y exploración

Analiza una columna para ver sus valores reales antes de filtrarla. Descubre uniones entre tablas que nunca han tenido una clave externa declarada. (Analizar)

Utilice sus consultas guardadas

Enumera las consultas guardadas y parametrizadas en las que confía tu equipo y ejecútalas con nuevos valores. Las consultas federadas que abarcan varias fuentes se ejecutan en el servidor y devuelven el resultado ya combinado.

Ejecutar SQL de solo lectura

Escribe y ejecuta una consulta SELECT en el dialecto correcto para Fly.io. Hasta 1000 filas y 60 segundos por defecto; Claude puede solicitar más, hasta 50 000 filas y cinco minutos. (Ejecutar)

Revisar alertas

Enumera tus reglas de alerta, su estado actual y las activaciones recientes. Claude puede redactar una regla a modo de prueba; una persona la activa en la página de Alertas.

Mejorar el modelo

Verifique la cobertura de Schema Intelligence por base de datos y, con su aprobación, programe una ejecución para obtener mejores resultados. (Analizar)

Los nombres de las herramientas, por si quieres reconocerlas en las respuestas de Claude.
PermisoHerramientas
Leerqs_list_organizaciones qs_list_agentes qs_list_connectors qs_get_si_status qs_get_connector_schema qs_get_table_schema qs_obtener_relaciones qs_list_consultas_guardadas qs_obtener_estado_de_tarea qs_list_alert_rules qs_obtener_estado_de_alerta qs_list_alertas_recientes
Analizartabla_perfil_qs qs_descubrir_relaciones qs_request_si_analysis qs_setup_si
Ejecutarqs_run_query qs_run_consulta_guardada qs_create_alert_rule (Solo propone; nunca armado por Claude)

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.

NivelLo que ve ClaudeResultado
Inteligencia de esquemasDescripciones de cada tabla y columna, valores de ejemplo, significados de enumeraciones, uniones declaradas y descubiertas.Claude escribe la consulta SQL correcta para Fly.io a la primera y explica los datos en términos que tu negocio pueda entender.
Esquema capturadoNombres de tablas y columnas, tipos y claves.Claude trabaja, pero deduce el significado a partir de los nombres y puede que pida una aclaración.
Esquema en vivoLa base de datos está fuera de la selección de captura del conector, por lo que la estructura se lee en tiempo real en cada solicitud (requiere el permiso de ejecución; SQL Server, MySQL y PostgreSQL).Las consultas siguen ejecutándose. Claude realiza búsquedas con pequeñas selecciones cuando necesita más.

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:

PlanClaves por usuarioClaves por organizaciónLlamadas por minuto
Gratis1130
Núcleo personal1160
Personal Plus1190
Núcleo empresarial23120
Negocios Plus35150
Business Max510240
Núcleo empresarial525300
Enterprise Plus850450
Enterprise Max10100600

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

Solo lectura, verificado por el Agente

Solo se ejecutan las sentencias SELECT. La comprobación se realiza en el ordenador que ejecuta el Agente, antes de que la base de datos de Fly.io vea la consulta SQL, por lo que nada de lo que escriba Claude puede modificar los datos.

Sin credenciales en IA

El inicio de sesión de Fly.io permanece en el Agente. Claude posee una clave o conexión de Query Streams, que puede revocar desde la página de MCP; el cambio surte efecto en aproximadamente cinco minutos.

Todo queda registrado.

Cada llamada a herramienta aparece en el MCP. Actividad pestaña y cada consulta en Historial de consultas como tipo de cliente MCP, atribuida a la persona cuya clave o conexión la generó. El texto SQL y la clave en sí nunca se escriben en el registro de actividad.

Lo que recibe el proveedor de IA

Los nombres de las tablas y columnas, las descripciones de Schema Intelligence (incluidos los valores de ejemplo) y las filas de las consultas que solicitas se envían al proveedor de IA con el que te conectaste, según sus términos y condiciones. Query Streams nunca ve tu chat.

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 Fly.io usar por defecto, qué 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

Lo que vesQué significaArreglar
Claude no muestra ninguna herramienta de flujos de consulta.Se agregó el conector, pero nunca se conectó desde un chat, o la clave se pegó en el lugar equivocado.En Claude: + → Explorar conectores → Consultar flujos → ConectarEn una herramienta para desarrolladores: reiníciala y luego verifica. Último uso en mis llaves.
MCP_KEY_REQUIRED o 401No se recibió ninguna clave en el servidor, normalmente debido a un salto de línea accidental al copiar y pegar o a que la clave estaba en el encabezado incorrecto.Copia la clave de nuevo desde Mis claves y envíala. Clave X-MCP encabezamiento.
MCP_USUARIO_DESHABILITADOUn administrador desactivó MCP para su usuario.Pídeles que giren el MCP volver a encender debajo Cuenta → Control de acceso.
MCP_SCOPE_REQUERIDO o MCP_SCOPE_DENIEDLa clave o conexión carece de permiso para esa acción, normalmente Ejecutar.Edita la clave en Mis claves y marca la casilla. Ejecutaro bien, vuelva a conectar la aplicación y apruébela.
MCP_KEY_ORG_LIMIT_EXCEEDEDSe ha agotado el límite de claves de tu plan. En el plan gratuito, esto equivale a una clave o una aplicación conectada.Cancela uno que ya no uses o cambia a un plan superior.
MCP_AGENT_NOT_CONNECTED o MCP_AGENT_NO_REGISTRADOEl agente propietario de tu base de datos de Fly.io no está conectado en este momento.Abrir Datos → Agentes de datos y ejecutar el Agente en su ordenador.
MCP_BASE_DE_DATOS_NO_CAPTURALa base de datos está fuera del rango de captura del conector, por lo que no hay esquema almacenado ni información de esquema disponible. Las consultas siguen funcionando.Añádelo a la selección de captura en el conector y, a continuación, ejecuta la función de Inteligencia de esquema si quieres obtener respuestas más completas.
TASA DE MCP_LIMITADADemasiadas llamadas por minuto para tu plan, o más de 10 consultas por minuto en una misma clave.Espera un momento. La inteligencia de esquemas permite a Claude responder con menos llamadas.
MCP_QUERY_TIMEOUT o MCP_SALIDA_DEMASIADO_GRANDELa consulta superó el tiempo de espera o devolvió más información de la que Claude puede procesar en una sola respuesta.Solicita menos filas o columnas, o un filtro de fecha. Claude suele sugerirlo él mismo.
MCP_DATOS_REALM_AGOTADOSe ha agotado el límite de datos asignado a su organización para este período.Espera a que se restablezca el saldo o recárgalo desde el Portal.
Violación de solo lecturaLa consulta SQL no era una sentencia SELECT.Por diseño. Nada escribe a través de MCP.

Preguntas que hace la gente

¿Puede Claude modificar mis datos de Fly.io?

No. El agente solo acepta sentencias SELECT y lo verifica antes de ejecutar la consulta SQL. Claude puede poner en cola una ejecución de Schema Intelligence o crear una regla de alerta como prueba; ambas escriben en los metadatos de Query Streams, nunca en la base de datos de Fly.io.

¿Necesito abrir un puerto o usar una VPN?

No. El agente establece una conexión saliente en el puerto 443 y tanto las solicitudes como las filas viajan a través de él. Si HTTPS saliente funciona, MCP también funciona.

¿El plan gratuito realmente cubre esto?

Sí. Free es un plan que conservas, no una prueba que caduca. MCP está incluido en todos los planes; Free permite una llave o una aplicación conectada y 30 llamadas por minuto. Consulta exactamente qué incluye Free en el página de precios.

¿Qué otras herramientas de IA funcionan además de Claude?

Cualquier aplicación que utilice MCP a través de HTTP: ChatGPT, Cursor, VS Code con Copilot, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev y JetBrains AI, todas tienen una receta predefinida en la pestaña Conectar.

¿Claude tiene una visión global de la organización?

Una clave llega a todos los conectores de tu organización. Una aplicación conectada puede limitarse a conectores específicos una vez aprobada. Cada clave o conexión pertenece a una organización; conéctala una vez por cada organización que necesites.

¿Cuál es la diferencia entre este y Nova?

Nova es el asistente dentro del portal de Query Streams y comparte el mismo modelo de Schema Intelligence. Usa Nova cuando quieras respuestas dentro de Query Streams; usa MCP cuando quieras que tus datos estén dentro de Claude junto con todo lo demás que hagas allí.

¿Conoce Claude el dialecto SQL de Fly.io?

Sí. Cada respuesta del esquema le indica a Claude qué tipo de conector está analizando, y Claude escribe SQL para ese motor. Con la Inteligencia de Esquema, también ve las descripciones de las columnas y los valores de ejemplo, por lo que deja de adivinar qué significa un código de estado o una abreviatura.

¿Mi clúster de Postgres administrado por Fly.io tiene que estar en el mismo ordenador que Claude?

No. Solo el Agente debe estar donde se encuentra tu clúster de Postgres administrado por Fly.io, o en cualquier computadora con conexión a internet que esté siempre activa. Claude puede estar en tu computadora portátil, tu teléfono o en un servidor en otro lugar; solo se comunica con los flujos de consulta.

¿Sigues atascado? Abrir Ayuda En Query Streams, indíquenos en qué paso se encuentra y qué observa. Le ayudaremos a conectarse.
Actualizado el septiembre 28, 2026

Funciona con BetterDocs