Servidor MCP local

En Kerry Studio, el servidor MCP local conecta asistentes de IA de escritorio, Cursor, Claude Desktop y otros, a las conexiones guardadas. Sin él, listar tablas o ejecutar SQL desde el chat exige pegar el esquema o el resultado a mano. Kerry escucha solo en tu ordenador, guarda contraseñas, SSH y certificados en la app, y entrega al asistente el proyecto, el entorno, el tipo de base, el nombre de la base, el esquema y el resultado de las consultas que ejecute. Eso no va a los servidores de Kerry. El cliente de IA puede enviar lo que MCP devolvió a su modelo en la nube.

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.

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.

json

{
  "mcpServers": {
    "kerry-studio": {
      "url": "http://127.0.0.1:18765/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

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. Sin eso no hay esquema ni SELECT. Quien abre la sesión es Kerry, en tu ordenador, con las credenciales de la app. Las pestañas 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.

A qué puede acceder el asistente

Las contraseñas, SSH y certificados se quedan en Kerry. Kerry es quien abre la sesión de base, en tu ordenador. 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

Kerry no envía eso a los servidores de Kerry. El cliente de IA lo recibe en tu ordenador y, si el modelo está en la nube, puede enviar lo recibido a su proveedor.

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
Completo	Todo lo anterior, más SQL de escritura

Ver quién está conectado

La sección Observabilidad del panel lista las aplicaciones que hablan con Kerry.

El número de arriba 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.

Si algo sale mal

El cliente de IA no alcanza a Kerry: comprueba que la URL use 127.0.0.1, no localhost, 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.
La consulta fue rechazada: el servidor está en solo lectura. Activa el modo completo si la escritura es intencionada. SHOW y EXPLAIN de un SELECT son lectura; FOR UPDATE y SELECT INTO no.
No encontró la base: pide por proyecto y entorno (nombre o @alias), no por la etiqueta de la conexión.
El SQL con @alias falló: enfoca una pestaña SQL ligada a ese proyecto y entorno, como en Ejecutar consulta.

Si regeneras el token en el panel, pega el JSON otra vez en el cliente.