En Kerry Studio, el servidor MCP local conecta las conexiones guardadas a un cliente de IA de escritorio, como Claude Desktop, ChatGPT, Gemini, Conductor, Cursor, OpenCode, entre otros. Sin él, listar tablas, ver columnas o ejecutar SQL en el chat exige pegar el esquema o el resultado a mano.
El servidor escucha solo en tu ordenador. Contraseñas, SSH y certificados quedan protegidos en la app. MCP no los expone. El asistente recibe el proyecto, el entorno, el tipo de base, el nombre de la base, el esquema y el resultado de las consultas que ejecute. Kerry no envía eso a los servidores de Sireeus. Lo que llega al asistente es configurable: qué proyectos y entornos puede usar el servidor, y qué valores omitir en mcp.log y en la respuesta. El cliente de IA aún puede enviar lo que MCP devolvió a su modelo en la nube. Úsalo solo con agentes en los que confíes.
Antes de empezar
Necesitas:
- Un workspace abierto en Kerry Studio
- Un cliente de IA de escritorio con soporte MCP
Abrir el panel
- Abre un workspace.
- En la barra lateral derecha, haz clic en el icono Servidor MCP.
- O usa el pie del workspace (MCP activado / MCP desactivado), o la paleta de comandos (⌘K / CtrlK) y elige Abrir panel MCP.
Por defecto el servidor no se vuelve a encender al cerrar y abrir Kerry Studio. Las preferencias de arranque están en Configuración → MCP (icono de engranaje en el encabezado Configuración del panel, o paleta ⌘K / CtrlK → Configuración: MCP):
- Al iniciar la app → Iniciar con el servidor activo: enciende el servidor MCP al abrir Kerry Studio (desactivado por defecto).
- Al iniciar la app → Iniciar siempre en modo de solo lectura: en el siguiente arranque vuelve a solo lectura aunque la sesión anterior estuviera en modo completo (activado por defecto).
En el panel, el icono de libro junto al engranaje abre la documentación (Abrir documentación).
Configurar el cliente de IA
- En el panel, activa Activar servidor MCP.
- Haz clic en Copiar JSON.
- Pega el JSON en la configuración MCP de tu cliente (o combínalo con la que ya tienes).
- Reinicia el cliente si no recarga servidores por sí solo.
Si el cliente registra MCP como un binario local, como OpenCode, no pegues el JSON. Usa el comando en Cómo usarlo en OpenCode.
La dirección predeterminada es http://127.0.0.1:18765/mcp. Puerto HTTP en el panel cambia ese puerto. Con el servidor encendido, el campo queda bloqueado. Copiar JSON usa el puerto actual y el token real. No uses el YOUR_TOKEN de ejemplo.
{
"mcpServers": {
"kerry-studio": {
"url": "http://127.0.0.1:18765/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}Cómo usarlo en OpenCode
Algunos clientes de IA de escritorio, como OpenCode, registran un servidor MCP como un binario local por defecto. Kerry no es ese tipo de servidor. Escucha por HTTP en tu ordenador. En esas apps, registra Kerry por la URL, no como comando.
El JSON en formato mcpServers vale para los clientes que pegan la configuración. En OpenCode, con el servidor encendido en el panel, ejecuta:
opencode mcp add kerry-studio --global --url http://127.0.0.1:18765/mcp --header 'Authorization=Bearer YOUR_TOKEN'Sustituye YOUR_TOKEN por el token que Copiar JSON pone en el JSON. Si cambiaste Puerto HTTP, usa ese puerto en la URL. --global deja Kerry disponible en todos los proyectos de OpenCode. Si el comando rechaza ese flag, tu versión no lo tiene. Ejecuta el mismo comando sin --global.
Solo lectura y modo completo
Por defecto el servidor está en solo lectura: el asistente puede listar conexiones, ver el esquema y ejecutar consultas de lectura: SELECT, SHOW, DESCRIBE, EXPLAIN (incluido ANALYZE de un SELECT). INSERT, UPDATE, DELETE, SELECT … FOR UPDATE, SELECT INTO, INTO OUTFILE y consultas WITH que cambian datos se rechazan.
El modo de solo lectura ya abre la base en la sesión del asistente. Sin eso no hay esquema ni SELECT. Las pestañas SQL de Kerry no tienen que estar conectadas.
El cambio de modo en el panel rige al momento, así que no hace falta reiniciar Kerry Studio.
En Configuración → MCP → Solo lectura, Forzar solo lectura al iniciar el servidor (activado por defecto) mantiene el interruptor Modo solo lectura del panel marcado y bloqueado, y aplica solo lectura cada vez que se enciende el servidor.
Permisos
En Kerry Studio, Permisos restringen qué proyectos y entornos guardados puede usar el servidor MCP local. Sin esa restricción, cualquier conexión guardada queda disponible para el asistente. El valor por defecto es todos los proyectos y entornos.
Solo lectura y lectura y escritura tienen listas propias. Así puedes dejar el modo de lectura con el catálogo entero y, en el modo completo, liberar solo algunos proyectos.
Abre Permisos con Configurar en el panel MCP, en Configuración → MCP, o en la paleta (⌘K / CtrlK) en MCP Permisos.
En Permisos del servidor MCP, la parte de arriba cambia entre Solo lectura y Lectura y escritura. En uso indica cuál de esas listas está aplicando el panel ahora: si Modo solo lectura está activado, la marca queda en Solo lectura; si está desactivado, queda en Lectura y escritura. Ajustar una lista no cambia la otra.
En la lista Lectura y escritura, Escritura predeterminada define Insertar, Actualizar y Eliminar para la lista, con los tres activados por defecto. Cada proyecto o conexión puede diferir de ese valor. El cambio rige en la siguiente petición del asistente.
Si Permitir todos los proyectos y entornos está activado, el servidor usa el catálogo entero en esa lista. Apágalo cuando quieras elegir proyecto a proyecto.
Con el interruptor apagado, cada proyecto y cada entorno del proyecto tiene su propio control. En Incluir automáticamente el acceso a, decides si Proyectos nuevos y sus entornos actuales y Entornos nuevos en los proyectos entran solos. La búsqueda reduce lo que ves por proyecto, alias SQL (@alias) o entorno. Activar todos y Desactivar todos valen para lo que está visible. La flecha al lado aplica la misma acción a un entorno: Activar todos en un entorno o Desactivar todos en un entorno.
Cuando activas o desactivas Modo solo lectura en el panel, Kerry pasa a aplicar la lista correspondiente. El cambio rige en la siguiente petición del asistente. Si el proyecto no está en esa lista, Kerry no abre la conexión para el asistente. Una consulta con @alias, por ejemplo @billing.orders, apunta a una conexión guardada y también se bloquea si esa conexión no es accesible.
A qué puede acceder el asistente
Los errores de conexión no devuelven usuario, host, contraseña ni ruta de archivo. El resultado SQL que recibe el asistente tampoco lleva rutas, hosts, URI de conexión ni claves. La cuadrícula de la pestaña en Kerry sigue igual.
La lista de conexiones muestra el proyecto, el entorno, el tipo de base y el nombre de la base (en un archivo local, el nombre del archivo, no la ruta).
Con el servidor encendido, el asistente también recibe:
- nombres de tablas y vistas
- columnas y detalles de tabla
- hasta 500 filas de cada resultado SQL que el asistente ejecute
- control de la pestaña de diagrama ER en el workspace abierto
Controlar el diagrama ER
En Kerry Studio, el asistente puede usar la pestaña de diagrama ER como lo harías tú. Abre la pestaña de ese proyecto y entorno si aún no existe, o enfoca la que ya está abierta. Si esa pestaña aún no está conectada, usar el diagrama (sincronizar, filtrar, encuadrar) la conecta y actualiza el esquema. El asistente solo controla pestañas de diagrama ER. Los permisos de MCP valen para abrir, sincronizar y cambiar de entorno. También filtra tablas, cambia el diseño, enfoca relaciones, ajusta el zoom y exporta la imagen. En la exportación, Kerry guarda el archivo en la carpeta de Configuración → MCP. El valor predeterminado es el escritorio. Si no puede, pide dónde guardar. El asistente recibe la ruta completa. MCP no puede elegir la carpeta.
El SQL sin @alias sigue en una sesión aparte y no cambia la pestaña. El SQL con @alias, por ejemplo @billing.orders, usa la pestaña SQL activa.
Mientras el asistente controla el diagrama, la pestaña muestra la marca MCP. El pie del workspace muestra controlando la UI.
Ejemplos:
- «Abre el diagrama ER del proyecto billing en el entorno Desarrollo.»
- «En el diagrama, muestra solamente las tablas que se relacionan con
public.orders.» - «Encuadra el diagrama y expórtalo en PNG.»
Cómo pedir en el chat
Di el proyecto y el entorno, no solo la etiqueta técnica de la conexión (por ejemplo postgres).
Ejemplos:
- «en el proyecto billing, entorno Desarrollo, lista las tablas»
- «en Billing / Desarrollo, ¿qué columnas tiene
public.products?»
El asistente usa las conexiones guardadas en Kerry. El SQL sin @alias se ejecuta en una sesión aparte: no cambia la pestaña ni la barra Entidades. El SQL con @alias, por ejemplo @billing.orders, usa la pestaña SQL activa, como Ejecutar consulta: @proyecto.tabla sigue el entorno de la pestaña. La pestaña activa tiene que ser SQL y estar ligada a ese proyecto y entorno. Solo los proyectos guardados aparecen en Entidades.
Qué puede hacer el asistente
| Modo | El asistente puede |
|---|---|
| Solo lectura | Listar conexiones, encontrar un proyecto y un entorno, ver tablas y columnas, buscar en el esquema, ejecutar SQL de lectura, abrir y controlar la pestaña de diagrama ER |
| Completo | Todo lo anterior, más el SQL de escritura permitido en Permisos (Insertar, Actualizar y Eliminar) |
Ver quién está conectado
La sección Observabilidad del panel lista las aplicaciones que hablan con Kerry.
- El número de abajo es cuántas aplicaciones están conectadas.
- Cada tarjeta es una aplicación. El número de la tarjeta es cuántas sesiones de base abrió esa aplicación.
- Aparece un aviso cuando una aplicación se conecta, se desconecta o empieza a consultar una base, aunque el panel esté cerrado.
Para quitar una aplicación: haz clic en el icono de papelera de la tarjeta (Cerrar conexión) y confirma. Eso termina la conexión de esa aplicación. Si otra aplicación sigue usando la misma base, se queda. Si era la última, Kerry cierra las conexiones MCP de esa base.
Auditar el servidor
En Kerry Studio, el archivo mcp.log registra cada intercambio con el asistente, con la app y la sesión. En el archivo, REQUEST es la solicitud que el asistente envió, incluido el SQL. RESPONSE es lo que Kerry devolvió. Abre el archivo en el encabezado Observabilidad del panel MCP o en Configuración, MCP. Si los registros están desactivados, el icono queda desactivado.
Kerry oculta el valor cuando el nombre del campo es el término de la lista o lo contiene. También oculta el valor si el SQL da otro nombre a la columna, la usa en una expresión, o lee el campo dentro de un JSON y lo devuelve con otro nombre. Eso vale en PostgreSQL, MySQL, Oracle y SQLite.
De forma predeterminada, se oculta:
- En el archivo y en la respuesta al asistente: valores de contraseñas, tokens, autorización y claves privadas, cuando el campo coincide con la lista predeterminada de ese destino.
- Solo en el archivo mcp.log: valores de campos cuyo nombre es o contiene email, y correos que aparecen en el texto, aunque no sean una columna llamada email.
- Solo en la respuesta al asistente: textos de conexión, claves y fragmentos de error que mostrarían host, usuario, ruta o contraseña. Eso no depende del nombre de la columna.
El SQL entra en mcp.log porque la auditoría guarda la solicitud tal como llegó. Usa el archivo para comprobar si alguna columna de tu base sigue apareciendo con el valor real en el RESPONSE. Eso importa para campos que Kerry no conoce, como un nombre completo o un documento. Si aparece, en Valores omitidos en el panel MCP o en la paleta de comandos (⌘K / CtrlK), añade el campo, elige el destino (archivo, asistente o ambos) y si la coincidencia es igual o contiene.
Si desactivas los registros, esa elección se mantiene. Si el archivo ya existe, Kerry pide confirmación y lo elimina.
Si algo sale mal
- El cliente de IA no alcanza a Kerry: comprueba que la URL use
127.0.0.1, nolocalhost, y que el puerto coincida con Puerto HTTP. Después de cambiar el puerto, usa Copiar JSON otra vez. - El cliente no conecta después de pegar el JSON: apaga y enciende el servidor en el panel, o reinicia el cliente de IA.
- OpenCode no conecta: Kerry no es un MCP binario. Usa
opencode mcp addcon--urly el headerAuthorization. Si el comando rechaza--global, omite el flag. - La consulta fue rechazada: el servidor está en solo lectura, o ese tipo de operación está desactivado en Permisos. Activa el modo completo si la escritura es intencionada y enciende Insertar, Actualizar o Eliminar según el SQL.
SHOWyEXPLAINde unSELECTson lectura;FOR UPDATEySELECT INTOno. - No encontró la base: pide por proyecto y entorno (nombre o
@alias), no por la etiqueta de la conexión. - El SQL con
@aliasfalló: enfoca una pestaña SQL ligada a ese proyecto y entorno, como en Ejecutar consulta. - El diagrama ER no se abrió o el entorno fue rechazado: revisa Permisos y pide el proyecto y el entorno que están en esa lista. El panel MCP solo existe con un workspace abierto.
Si regeneras el token en el panel, pega el JSON otra vez en el cliente.