Ver categorías

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

28 minutos de lectura

SERVIDOR MCP MySQL

Consultar MySQL con Claude o Cursor vía MCP.

Conecte MySQL (local, AWS RDS, Azure Database for MySQL o Google Cloud SQL) a Claude o Cursor con una clave MCP. Schema Intelligence maneja peculiaridades dialectales (intercalación insensible a mayúsculas y minúsculas, palabras reservadas entre comillas invertidas, AHORA() - INTERVALO n DÍA, LÍMITE n) así que la IA escribe MySQL válido en su 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 MySQL MCP para que su herramienta de IA pueda responder preguntas en lenguaje natural sobre pedidos, clientes, catálogos de productos y cualquier otro dato de MySQL (uniones, agregaciones, exploración de esquemas, informes ad hoc) sin necesidad de copiar y pegar exportaciones CSV desde MySQL Workbench, phpMyAdmin, DBeaver o HeidiSQL. Más información en QueryStreams.com y regístrese gratis para empezar a hacerle a tu herramienta de IA preguntas reales sobre MySQL.

Lo que Query Streams MCP te ofrece para MySQL

Otros servidores “MySQL MCP” del ecosistema de código abierto conectan la herramienta de IA directamente a una cadena de conexión MySQL. Si bien esto funciona, añade una contraseña de base de datos a la configuración del cliente de IA, limita el acceso de la herramienta a ese único punto final de MySQL y no proporciona un registro de auditoría de las consultas realizadas por la IA. El servidor Query Streams MCP para MySQL resuelve un problema más amplio: una sola clave, todos los conectores, registro de auditoría completo y la herramienta de IA nunca almacena las credenciales de MySQL.

Cero agujeros en el firewall de entrada

El agente de red abre un único enlace en la nube cifrado para Query Streams. Su cliente de IA se conecta a la nube, nunca a su servidor MySQL. No hay puertos que abrir, direcciones IP que incluir en la lista de permitidos, VPN ni oyentes de MySQL expuestos a internet.

Una llave, cada conector

La misma clave MCP llega a todas las bases de datos y API SaaS conectadas a tu cuenta. Si añades un conector de Stripe o PostgreSQL mañana, la herramienta de IA lo reconocerá junto a tus tablas MySQL sin necesidad de volver a introducir la clave.

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 MySQL, no solo las que están vacías. esquema_de_información Genera código SQL preciso al primer intento, incluso en esquemas MySQL antiguos con nombres de columna crípticos.

Solo lectura aplicada en el agente

Ni siquiera un LLM alucinante puede emitir BORRAR, ACTUALIZAR, o TRUNCAR a través de Query Streams MCP. El agente de red rechaza todo lo que no sea SELECCIONE, CON, o EXPLICAR antes de que MySQL vea siquiera la consulta SQL.

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 afecta a un depósito de tokens, no a tu grupo de conexiones MySQL ni a tu factura de alojamiento.

Cómo funciona sin abrir los puertos del firewall

El agente de red de Query Streams se instala una sola vez en una máquina que pueda acceder a su servidor MySQL y establece un enlace TLS saliente a la nube a través del protocolo de red MySQL estándar; nunca se expone ningún tráfico entrante y la herramienta de IA nunca ve su cadena de conexión MySQL. 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 MySQL

Cadena de conexión
retenido por el agente

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 bases de datos, tablas y columnas de MySQL 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 que MySQL vea la consulta SQL.

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

La mayoría de los servidores “MCP para MySQL” en el entorno de código abierto le dan a su herramienta de IA la misma esquema_de_información MySQL le entrega un extraño. Nombres de columnas. Tipos de datos. Tal vez una clave primaria. El LLM se queda adivinando qué status_id = 3 significa, qué usr_eml tiendas, o si artículos_del_pedido.id_del_pedido en realidad se une a pedidos.id (Nunca se declaró ninguna clave foránea, algo común en los esquemas heredados de la era MyISAM que son anteriores a la aplicación de claves foráneas en InnoDB, y en los esquemas de MySQL 5.6 donde los desarrolladores omitieron las declaraciones de claves foráneas por motivos de "rendimiento"). Por eso, la primera consulta SQL que la mayoría de los LLM escriben sobre un esquema vacío es incorrecta, no porque el LLM sea malo, sino porque no tiene los datos necesarios para ser correcto.

Query Streams MCP devuelve ese mismo esquema enriquecido con Inteligencia de esquemas (IE) — Metadatos seleccionados por IA y perfilados a partir de su actual Datos MySQL, por lo que cada herramienta de esquema devuelve el esquema básico más seis capas de conocimiento seleccionado y el LLM deja de adivinar. Por qué Schema Intelligence diferencia a Query Streams MCP →

Para concretar esto, aquí está lo que el cliente de IA obtiene de vuelta de una sola qs_get_table_schema llamada a una base de datos típica de comercio electrónico MySQL (clientes, pedidos, artículos del pedido, productos, pagos, categorías) — primero sin Inteligencia de Esquema, luego con ella.

Sin inteligencia de esquema fuente_de_datos: esquema_capturado
// lo que ve el LLM == TABLA: clientes == – id int(11) [PK, NOT NULL] - correo electrónico varchar(255) NO NULO - nombre varchar(200) – creado_en marca de tiempo NO NULO == TABLA: pedidos == – id int(11) [PK] – ID_cliente int(11) NO NULO – cantidad_total decimal(10,2) NO NULO - estado varchar(20) NO NULO – fecha_del_pedido marca de tiempo NO NULO == TABLA: artículos_de_pedido == – id int(11) [PK] – ID_de_pedido int(11) NO NULO – ID_producto int(11) NO NULO - cantidad int(11) NO NULO – precio_unitario decimal(10,2) NO NULO == TABLA: productos == – id int(11) [PK] - nombre varchar(200) - categoría varchar(80) – sku varchar(64) == TABLA: pagos == – id int(11) [PK] – ID_de_pedido int(11) NO NULO - método varchar(20) NO NULO - cantidad decimal(10,2) NO NULO == TABLA: categorías == – id int(11) [PK] - nombre varchar(80) 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 – Descripciones de tablas y columnas – Clasificaciones de tipos semánticos – Etiquetado de dominio empresarial nota: “Solo tipos, sin contexto semántico”
Con inteligencia de esquema fuente_de_datos: inteligencia_de_esquema
// lo que ve el LLM == TABLA: clientes [DIM, dominio:clientes] == “Una fila por cliente registrado. El correo electrónico es único para cada cliente activo.” - identificación int(11) [PK] identificador - correo electrónico varchar(255) correo electrónico Ejemplo: [email protected], [email protected] - nombre varchar(200) nombre_de_la_persona – creado_en marca de tiempo fecha_iso Muestra: 2026-04-28 14:02:11 == TABLA: pedidos [HECHO, dominio:ventas] == “Filas de encabezado del pedido del cliente; una por cada proceso de pago. total_amount es el total general en USD.” - identificación int(11) [PK] identificador – ID_cliente entero(11) identificador FK -> customers.id (100% de solapamiento, conf 0.99) – cantidad_total decimal(10,2) moneda_USD Rango: 0,00 – 4.820,00 · media 142,30 - estado varchar(20) código_de_estado (enumeración) Pagado (54%) | Enviado (24%) | Entregado (12%) | Pendiente (5%) cancelado (3%) | reembolsado (2%) – fecha_del_pedido marca de tiempo fecha_iso == TABLA: artículos_de_pedido [HECHO, dominio:ventas] == “Una fila por producto por pedido. Ingresos = SUMA(cantidad * precio_unitario).” – ID_de_pedido entero(11) identificador FK -> orders.id (98% de solapamiento, confianza 0,95) – ID_producto entero(11) identificador FK -> products.id (100% de solapamiento, conf 0.99) - cantidad entero(11) encimera – precio_unitario decimal(10,2) moneda_USD == TABLA: productos [DIM, dominio:productos] == – nombre varchar(200) contenido_de_texto - categoría varchar(80) código_categoría (enumeración) FK -> categories.name (100% de superposición, conf 0.99) – sku varchar(64) identificador Muestra: ['QS-001-MINT','QS-014-DARK','QS-027-AMBER'] == TABLA: pagos [HECHO, dominio:finanzas] == – order_id entero(11) identificador FK -> orders.id (100% de solapamiento, conf 0.99) - método varchar(20) método_de_pago (enumeración) Tarjeta (78%) | PayPal (14%) | Transferencia bancaria (6%) | Efectivo (2%) - cantidad decimal(10,2) moneda_USD

Las seis capas que añade Schema Intelligence

Cada capa aborda un tipo de pregunta que el LLM intentaría adivinar. La fase de perfilado SI opcional se ejecuta sobre sus datos MySQL sin modificar su esquema ni escribir en su base de datos, y se actualiza de forma incremental cuando cambia su esquema. Qué aporta Schema Intelligence y cómo se mantiene actualizado →

Descripciones seleccionadas por IA

Descripción clara y concisa de cada base de datos, esquema, 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.

pedidos: “Encabezados de pedidos de clientes;
una fila por caja.

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 comercial: ventas, recursos humanos, SEO, finanzas, soporte y 14 más.

pedidos [HECHO, dominio:ventas]
clientes [DIM, dominio:clientes]

Tipos semánticos por columna

Dieciocho tipos: currency_usd, email, date_iso, status_code, percentage, ranking_position, identifier, url, person_name y más. La IA genera SQL MySQL correcto para cada tipo, adaptado al dialecto correspondiente.

monto_total: moneda_USD
correo electrónico: correo electrónico · fecha_pedido: fecha_iso

Valores de muestra a partir de datos reales

Se muestran filas aleatorias al LLM para que reconozca patrones que ningún esquema puede mostrar: convenciones de formato, valores codificados, estilos de abreviaturas y la forma real de las cadenas.

sku: ['QS-001-MINT', 'QS-014-DARK',
'QS-027-ÁMBAR']

Detección de enumeraciones con distribuciones

Columnas de baja cardinalidad (50 valores distintos o menos, como máximo el 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 ni ortografía.

Estado: pagado (54%) | enviado (24%)
| entregado (12%) | pendiente (5%) …

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. Almacenado junto con las claves foráneas formales con puntuaciones de confianza, devueltas por qs_obtener_relaciones.

order_items.order_id -> orders.id
(98% de solapamiento, confianza 0,95)

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. “¿Cuáles fueron los 5 productos con mayores ingresos en los últimos 30 días?” 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_producto, SUM(precio unitario) AS ingresos DESDE artículos del pedido DONDE fecha_pedido >= '2024-01-01' Y estado = 'Pagado' ORDENAR POR ingresos DESC LÍMITE 5 ERROR: order_date / status no está en order_items La fecha y el estado del pedido se aplican a los pedidos, no a los artículos. no JOIN — order_items no tiene marca de tiempo SUM(unit_price) ignora la cantidad: ingresos incorrectos Fecha codificada de forma fija: "últimos 30 días" es dinámica. 'Pagado' mayúsculas y minúsculas incorrectas (los valores reales están en minúsculas) Devuelve product_id, no el nombre del producto.
Con inteligencia de esquema
— Primer intento de LLM con SI habilitado: SELECCIONE p.id, p.name, SUM(oi.cantidad * oi.precio_unitario) AS ingresos DESDE pedidos o ÚNASE A artículos del pedido oi EN oi.order_id = o.id ÚNASE A productos p EN p.id = oi.product_id DONDE o.fecha_pedido >= AHORA() – INTERVALO 30 DÍA Y o.status = 'pagado' GRUPO POR p.id, p.name ORDENAR POR ingresos DESC LÍMITE 5 5 filas. Correcto al primer intento. Las etiquetas FACT/DIM guiaron la estructura de unión. El descubrimiento de FK reveló order_id -> orders.id order_date vio tipo semántico = date_iso La búsqueda de enumeración seleccionó la 'paid' en minúsculas correctas. MySQL-idiomático NOW() – INTERVALO 30 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 →

Conecta AWS RDS, Azure Database o Google Cloud SQL MySQL a Claude

Actualmente, la mayoría de las implementaciones de MySQL en producción se ejecutan en un servicio en la nube gestionado, en lugar de en un servidor propio. Query Streams MCP funciona de la misma manera con MySQL gestionado en las principales plataformas en la nube; la única diferencia radica en dónde se instala el Agente de red y en el método de autenticación elegido. A continuación, se describen los tres escenarios de implementación más comunes, junto con la configuración recomendada para cada uno.

AWS RDS para MySQL / Aurora MySQL

Par EC2/VPC

Instale el agente de red en una instancia EC2 pequeña en el mismo grupo de VPC y subred como su instancia de RDS para una latencia de red inferior a un milisegundo. db.t4g.micro Esto es más que suficiente para el tamaño del grupo de conexiones del tráfico típico de MCP; amplíelo solo si tiene muchos usuarios con consultas guardadas simultáneas.

  • Autorización: autenticación de base de datos IAM Recomendado; se admite la autenticación por contraseña como alternativa.
  • Aurora MySQL: apuntar al agente hacia el clúster lector punto final: MCP es de solo lectura en el agente, por lo que el punto final del escritor nunca es necesario.
  • Conmutación por error multi-AZ: RDS lo gestiona de forma transparente; el agente se reconecta automáticamente.
  • Salida: la salida HTTPS del agente a agente.querystreams.com Funciona a través de cualquier puerta de enlace NAT estándar o ruta de salida de VPC, sin necesidad de reglas de firewall personalizadas.

Base de datos Azure para MySQL (Servidor flexible)

VNet / enlace privado

Instale el Agente de red en una máquina virtual de Azure en el misma VNet como su servidor flexible (o utilice un punto final privado / enlace privado). Los FQDN terminan en *.mysql.database.azure.com; B1ms ráfaga Es un buen nivel de partida para el agente anfitrión.

  • Autorización: Azure AD / Microsoft Entra ID Se recomienda la autenticación para entornos de producción; se admite la autenticación SQL (nombre de usuario/contraseña).
  • SSL: Azure requiere TLS de forma predeterminada; el agente lo aplica automáticamente y fija el paquete de la CA raíz de Microsoft.
  • Servidor único (heredado): Aún se ofrece soporte; se aplica el cronograma de descontinuación de Microsoft. Migre a Flexible Server cuando le convenga: la cadena de conexión del agente cambia, pero todo lo demás permanece idéntico.
  • Salida: La salida estándar de Azure VNet funciona sin cambios; no es necesario agregar ninguna regla al firewall de Azure.

Google Cloud SQL para MySQL

GCE / Cloud Run

Instale el Agente de red en una máquina virtual GCE en el mismo proyecto y región Como instancia de Cloud SQL, o ejecútela en Cloud Run con salida directa de VPC. Se permite la IP pública, pero se recomienda usar una IP privada a través de la conexión de servicios privados de Cloud SQL.

  • Autorización: autenticación de base de datos IAM Recomendado; admite autenticación por contraseña.
  • Proxy de autenticación SQL en la nube: Compatible: el agente se conecta a través del proxy cuando está configurado. La mayoría de las instalaciones omiten el proxy porque el agente ya se encuentra dentro de la VPC.
  • Generación: Se admiten todas las generaciones de Cloud SQL para MySQL (el protocolo de comunicación es MySQL estándar).
  • Salida: Cloud Run + salida directa de VPC, o una instancia de GCE con salida predeterminada, ambas alcanzan agente.querystreams.com sin realizar cambios en el cortafuegos.
El agente que realiza la llamada saliente es idéntico en las tres plataformas en la nube. Ya sea que su MySQL se encuentre en AWS RDS, Azure Database for MySQL o Google Cloud SQL, el enlace en la nube desde el Agente de red a Query Streams utiliza el mismo HTTPS de salida. agente.querystreams.com en el puerto 443. No se requieren cambios en el firewall de entrada en ninguna nube, ni inclusión de direcciones IP en listas blancas, ni VPN, ni NAT punchthrough. Según las directrices de seguridad de Microsoft, AWS y Google, se recomienda priorizar la autenticación de la base de datos IAM/Azure AD sobre las contraseñas permanentes siempre que el motor lo admita; el almacén de credenciales del agente gestiona las tres opciones.
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 a su conector MySQL: el mismo agente, la misma aplicación de solo lectura, la misma inteligencia de esquema, sin 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 acceder a su servidor MySQL — ver Descargar el agente de flujos de consultas.
  3. Un conector MySQL configurado contra el agente; consulte el archivo existente. configuración del conector Guías para la cadena de conexión. El agente almacena la contraseña del usuario de MySQL (o las credenciales de IAM/Azure AD para MySQL en la nube administrada); la herramienta de IA nunca las modifica.
  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 da servicio a MCP. Agregar MCP a una cuenta existente de Query Streams solo requiere generar una clave; el agente y el conector MySQL 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 MySQL, donde comprender la estructura de los datos es fundamental cuando el LLM genera uniones entre esquemas heredados.
  • 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 de MySQL", los tres ámbitos son apropiados. Para una clave que le entregas a un compañero de equipo o a un cliente menos confiable, deja de lado 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 MySQL junto con cualquier otra cosa que hayas configurado.

Paso 3: Hazle una pregunta a MySQL a la IA.

No tienes que escribir SQL; la IA lo hace. Haces una pregunta, la IA selecciona la herramienta MCP adecuada, el agente ejecuta la consulta en tu base de datos MySQL y la respuesta se devuelve como texto y tablas. Tres ejemplos de preguntas para probar primero:

“¿Cuál ha sido nuestra tendencia de ingresos diarios durante los últimos 30 días?”
Ganancia
La IA llama qs_get_connector_schema para descubrir el pedidos, artículos del pedido, clientes, y productos mesas, entonces qs_run_query con una SELECT que agrupa por FECHA(o.order_date), se une pedidos a artículos del pedidoy agregados SUM(oi.cantidad * oi.precio_unitario)Utiliza el estilo idiomático de MySQL. DONDE o.order_date >= NOW() - INTERVALO 30 DÍAS para el límite de tiempo y el valor de enumeración descubierto por SI 'pagado' para excluir los pedidos pendientes y cancelados. Obtendrá un resultado de 30 filas con el día, los ingresos brutos, el número de pedidos y el valor promedio del pedido (AOV). La IA suele detectar caídas durante el fin de semana, crecimientos semanales y cualquier anomalía que detecte sin que usted tenga que pedírselo.
“¿Qué productos tienen existencias bajas?”
Inventario
La IA inspecciona productos para una columna de inventario o existencias (Schema Intelligence la muestra como una encimera tipo semántico), se correlaciona con los últimos 30 días de cantidad_de_artículos_del_pedido demanda y proyecta días de cobertura. El resultado es una tabla clasificada con el nombre del producto, el stock actual, la demanda diaria promedio y los días proyectados hasta el agotamiento del stock. La IA suele resaltar los productos que caen por debajo de un umbral de cobertura de 14 días como reordenar candidatos y los agrupa por categoría para que el equipo de compras pueda agrupar sus órdenes de compra.
“Muéstrame los principales clientes que no han realizado ningún pedido en más de 60 días.”
Retención
La IA utiliza clientes unido a pedidos con un MAX(o.order_date) agregado por cliente, filtrado a TENIENDO MÁX(o.order_date) < AHORA() - INTERVALO 60 DÍASy clasificados por valor histórico de por vida (SUMA(o.total_amount) (a lo largo de todo el historial del cliente). El resultado es una lista enfocada de clientes inactivos de alto valor con correo electrónico, fecha del último pedido, días desde el último pedido y gasto total. La IA generalmente sugiere una campaña de recuperación y señala a cualquier cliente cuya inactividad coincida con un reembolso o una escalada de soporte. Puede profundizar con “¿Por qué dejó de hacer pedidos Acme-corp?” y la IA sacará pagos y el historial de pedidos.

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 transporte HTTP Streamable de MCP no puede comprimir de extremo a extremo de forma fiable, por lo que cobra bytes sin comprimir donde facturan los clientes de Excel, Hojas de cálculo, Generador de consultas y Nova bytes comprimidosUna consulta agregada de MySQL de 3 MB cuesta aproximadamente 3 MB a través de MCP, en comparación con los 400-600 KB en esos transportes, porque los datos de MySQL con valores de enumeración VARCHAR repetidos (estados, categorías, métodos de pago) se comprimen entre 5 y 7 veces a través de LZ4. Mismos datos, transporte diferente, tamaño facturable diferente. Cómo funciona la facturación del dominio de datos en diferentes transportes →

Preguntas frecuentes

¿Necesito abrir puertos o usar una VPN para poder usar esto? +
Sin reglas de entrada, reenvío de puertos, NAT punchthrough ni 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: 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 comprimirUn resultado agregado de MySQL de 3 MB que se devuelve a Excel suele ocupar entre 400 y 600 KB de su base de datos (LZ4 comprime los valores repetidos de enumeración VARCHAR entre 5 y 7 veces); el mismo resultado de 3 MB que se devuelve a Cursor a través de MCP ocupa aproximadamente 3 MB. 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 MySQL 5.7 / 8.0 / 8.1, Percona Server o Aurora MySQL? +
Sí, el agente de red utiliza el controlador estándar MySQL Connector/NET. MySQL 5.7+ (Edición Comunitaria + Edición Empresarial), MySQL 8.0 y 8.1, Servidor Percona para MySQL (un reemplazo directo con el motor XtraDB), MariaDB como MySQL (complemento de instalación) (compatible con el protocolo de cable en la capa de conexión) y AWS Aurora MySQL son todos compatibles. Para clústeres Aurora MySQL, apunte el agente al punto final del lector del clúster; el agente solo ejecuta SELECCIONE Las consultas se realizan mediante la aplicación de MCP de solo lectura, por lo que el punto final del escritor nunca es necesario. Las opciones de autenticación incluyen: contraseña_nativa_de_mysql, contraseña_sha2_en_caché (el valor predeterminado de MySQL 8), Autenticación de base de datos AWS IAM, Azure AD / Microsoft Entra ID en Azure Database para MySQL y Autenticación de base de datos de Google IAM En Cloud SQL para MySQL. Se admite completamente SSL/TLS con certificados CA personalizados. Para instancias antiguas de MySQL 5.6, póngase en contacto con el soporte técnico; existe una ruta de controlador alternativa para ellas. Consejo: Registre cada instancia de MySQL que utilice como un conector independiente. Sus conectores “production-oltp-mysql” y “warehouse-replica-mysql” pueden ser dos conectores separados con la misma clave, y LLM selecciona el adecuado según la consulta (las búsquedas puntuales se realizan en OLTP, las agregaciones grandes en la réplica de lectura o el almacén de datos). El servidor MCP no tiene acceso a las credenciales; solo el agente las tiene.
¿En qué se diferencia esto de ejecutar yo mismo un servidor MySQL MCP de código abierto? +
Un servidor MySQL MCP directo (existen proyectos comunitarios en GitHub) es un MCP por fuente de datos. Para que Claude lea desde su MySQL + 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 sus propias credenciales, 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. También obtiene Schema Intelligence, 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 de MySQL directo.
¿Qué ocurre si la IA intenta escribir o borrar datos? +
Se rechaza en el agente antes de que la fuente de datos vea el SQL. 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 MySQL. El validador se ejecuta en el proceso del agente en su red, no en la nube, por lo que una superficie de nube comprometida no podría eludirlo. (Puede agregar un usuario de solo lectura del lado de MySQL (por ejemplo GRANT SELECT ON db.* a un dedicado qs_readonly usuario) encima si quieres ir un paso más allá: el validador del agente es independiente de los permisos de MySQL que hayas configurado.
¿Puedo ver qué preguntó exactamente la IA? +
Sí. Cada llamada a la herramienta MCP escribe una fila en registros_de_eventos con la organización, el usuario, la clave, el alcance, la latencia y el 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 el nombre de la herramienta y metadatos, no el texto SQL ni las filas devueltas: esas fluyen a través del enlace en la nube y nunca llegan a los registros de la nube. Si desea una auditoría SQL completa, habilite la auditoría del lado de la base de datos en el motor subyacente; para MySQL específicamente, eso es registro_de_auditoría complemento (MySQL Enterprise Audit), el Plugin de registro de auditoría de Percona para instalaciones comunitarias/de Percona o para su canalización de registro general/de consultas lentas existente.
¿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 recibe el esquema básico (tipos, claves primarias, claves foráneas formales, índices) y escribe consultas básicas. Con SI habilitado, la IA recibe seis capas adicionales de metadatos seleccionados: (1) Descripciones elaboradas por IA en cada base de datos, 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 (ventas, RRHH, SEO, finanzas, soporte y 14 más); (3) un tipo semántico en cada columna (currency_usd, email, date_iso, status_code, percentage, ranking_position, identifier, url, person_name y 9 más) que impulsa la generación de SQL MySQL correcta según el dialecto; (4) Muestra valores de tus datos reales para que el LLM reconozca patrones que ningún esquema puede mostrar; (5) Detección de enumeraciones con distribuciones de valores completos para columnas de baja cardinalidad; 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. 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 mediana típica (unos cientos de tablas) finaliza 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. SI se ejecuta a través de su Agente de red contra sus datos (nunca en la nube), nunca escribe en su base de datos, nunca cambia su esquema y se actualiza incrementalmente cuando cambia su esquema, por lo que las ejecuciones posteriores a la adición o modificación de tablas son mucho más rápidas que la primera. 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. esquema_de_información.
¿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 MySQL) 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 →
¿Funciona Query Streams MCP con AWS RDS para MySQL, Azure Database para MySQL o Google Cloud SQL para MySQL? +
Sí, los servicios MySQL gestionados en las principales plataformas en la nube cuentan con soporte completo. AWS RDS para MySQL (Implementaciones de instancia única y Multi-AZ), AWS Aurora MySQL clústeres (apunta al punto final del lector de clústeres: el agente solo ejecuta SELECCIONE), Base de datos Azure para MySQL (tanto servidor único como servidor flexible), y Google Cloud SQL para MySQL (todas las generaciones) funcionan sin necesidad de configuración adicional. Instale el Agente de red en la misma VPC, VNet o región de GCP que su instancia de DBaaS para obtener consultas de baja latencia. El agente utiliza credenciales MySQL estándar. autenticación de base de datos IAM en RDS, Azure AD / Microsoft Entra ID en Azure Database para MySQL, autenticación de base de datos IAM en Cloud SQL, o autenticación mediante contraseña simple en cualquiera de ellos. El enlace en la nube desde el agente a Query Streams es idéntico independientemente de qué DBaaS aloje su motor; todo lo que está por debajo del agente es su infraestructura existente, y Query Streams nunca ve las credenciales de la base de datos.

Comience

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

Una clave MCP permite acceder a MySQL (local, AWS RDS, Azure Database for MySQL o Google Cloud SQL), a cualquier otra base de datos y a cualquier conector API de su cuenta de Query Streams, con un registro de auditoría completo, límites de velocidad por clave y sin necesidad de modificar el firewall. Claude, Cursor, ChatGPT y Grok funcionan sin configuración adicional.

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, mysql, base de datos, base de datos de código abierto, aws-rds, base de datos azure, cloud-sql, aurora-mysql

Meta Descripción: Conecta MySQL a Claude o Cursor mediante Query Streams MCP. Compatible con RDS, Azure y Cloud SQL. Solo para conexiones salientes, configuración en 5 minutos.

Actualizado el 16 de junio de 2026

Funciona con BetterDocs