Servidor MCP para agentes de programación
funcionalPermite que Claude Code, Cursor, VS Code y Windsurf usen tus conexiones guardadas en modo solo lectura sobre MCP, sin compartir contraseñas.
SQLly puede ejecutarse como un Servidor de Model Context Protocol (MCP), por lo que agentes de codificación como Claude Code, Cursor, VS Code, Windsurf y Claude Desktop pueden usar las conexiones que ya guardaste en SQLly. El agente puede listar conexiones, explorar tablas, leer definiciones de columnas, obtener un resumen del esquema y ejecutar una
SELECT a la vez, con filas limitadas. Nunca ve una contraseña, y las conexiones de producción siempre se rechazan.
- Solo local y con stdio. El agente se inicia
sqlly-cli mcpen tu máquina y se comunica con ella por la entrada y la salida estándar. Nada escucha en un puerto de red. - Solo lectura por defecto. Las escrituras solo son posibles si eliges permitirlas, y aun así cada una se abre en SQLly para que la confirmes.
- Las contraseñas se quedan en tu llavero. El servidor inicia sesión en tus bases de datos por sí mismo; el agente solo recibe nombres de conexión, texto del esquema y filas de resultados.
Configurándolo
- Abierto Ajustes › IA › MCP y encuentra SQLLY como servidor MCP.
- Elige el Límite global: Solo lectura (predeterminado), o Lectura/escritura con confirmación. Elige qué conexiones guardadas exponer.
- Presiona el botón de copiar de tu agente: Copiar para Claude Code, Copiar para Cursor, Copiar para VS Code, Copiar para Windsurf o Copiar para Claude Desktop, y pega el fragmento donde ese agente guarda sus servidores MCP.
- Pide al agente que liste tus conexiones SQLly.
Los fragmentos nombran la ruta completa a sqlly-cli, la herramienta de línea de comandos que viene incluida en la app. SQLly la busca primero junto a la app y luego en tu
PATH; si no encuentra ninguna, el fragmento dice simplemente sqlly-cli. Las formas son:
# Claude Code claude mcp add --transport stdio sqlly -- /path/to/sqlly-cli mcp // Cursor, Windsurf and Claude Desktop { "mcpServers": { "sqlly": { "command": "/path/to/sqlly-cli", "args": ["mcp"] } } } // VS Code (.vscode/mcp.json) { "servers": { "sqlly": { "type": "stdio", "command": "/path/to/sqlly-cli", "args": ["mcp"] } } }
El mismo panel también tiene una lista de externa Servidores MCP. Esa lista va en la otra dirección: servidores a los que SQLly se conecta para que su propio asistente de IA sepa qué herramientas ofrecen. No la necesitas para que un agente use SQLly.
Lo que el agente puede hacer
| Herramienta | Lo que hace |
|---|---|
list_connections | Lista las conexiones expuestas con su motor, servidor, base de datos, entorno y si cada una es de producción o solo de lectura. |
list_tables | Lista las tablas en la base de datos de una conexión. |
describe_table | Columnas, tipos y nulabilidad para una tabla. |
get_schema_context | Un resumen del esquema ajustado a un presupuesto de tokens. |
run_readonly_query | Ejecuta un solo SELECT y devuelve hasta el límite de filas. Cualquier otra cosa se rechaza sin ejecutar. |
open_in_app | Abre una pestaña de consulta en SQLly, opcionalmente con SQL completado. No se ejecuta nada. |
propose_write | Propone una instrucción que cambia datos para que la confirmes en SQLly (solo cuando se permiten escrituras). |
get_proposal_status | Si una propuesta está pendiente, abierta, ejecutada, rechazada o caducada. |
Modos de solo lectura y de lectura/escritura
La Límite global establece el máximo que permite cualquier conexión. Luego cada conexión puede ajustarse a un valor menor: Heredar global, Bloqueado (no expuesto en absoluto), Solo lectura, o Lectura/escritura con confirmación. Una conexión nunca recibe más que el techo global.
El modo de solo lectura lo impone la base de datos, no solo la comprobación de instrucciones de SQLly. En PostgreSQL, MySQL y MariaDB, cada consulta se ejecuta en una transacción de solo lectura que siempre se revierte; SQLite la ejecuta como solo consulta; SQL Server, que no tiene transacciones de solo lectura, la ejecuta dentro de una transacción revertida más un filtro de instrucciones. En ClickHouse solo se aplica el filtro de solo SELECT, y los comandos de Redis se comprueban contra una lista de solo lectura.
Con escrituras permitidas, propose_write nunca ejecuta nada por sí mismo. SQLly abre la instrucción en una nueva pestaña de consulta, muestra un recuento estimado de filas y un resumen del plan de una línea donde el motor lo admite, y la ejecuta solo a través del cuadro de confirmación habitual una vez que lo apruebas.
Límites
- Filas y celdas. Como máximo 100 filas por consulta (el valor predeterminado y el tope), y los valores largos de las celdas se cortan en 200 caracteres por defecto (hasta 2000).
- Límites de peticiones. Por defecto, 60 consultas, 5 escrituras y 2 cambios de esquema por minuto, ajustables hasta 600, 60 y 20.
- Tiempo de espera por inactividad. Por defecto, el servidor se detiene tras 15 minutos sin solicitudes (ajustable de 30 segundos a un día).
El registro de actividad
SQLly registra en un registro privado de tu máquina cada llamada del agente a una herramienta y el desenlace de cada propuesta. Cada entrada incluye hora, herramienta, conexión, base de datos, duración, número de filas y resultado. El SQL se guarda censurado, nunca con sus valores literales. Pulsa Abrir actividad MCP en los ajustes de MCP para explorarlo, filtrarlo por herramienta, resultado o conexión, y exportarlo como CSV o JSON.
Edición de Mac App Store
El sandbox de Apple impide que las aplicaciones de la App Store inicien otros programas, por lo que la edición de Mac App Store no puede actuar como un servidor MCP para otras aplicaciones, ni puede iniciar servidores MCP locales (stdio). Los servidores MCP a los que accedes por HTTP todavía funcionan allí. Ver macOS y la Mac App Store.