Conectar un asistente

MCP (Model Context Protocol) es el estándar que usan los asistentes para hablar con sistemas externos. Eel expone un servidor, así que un asistente compatible puede consultar tus datos sin que tú escribas integración alguna.

POST https://api.eel.software/mcp

Cómo se conecta

La credencial es la misma de siempre, en la misma cabecera:

• Una clave de API para que el asistente actúe como el espacio.
• Un token de app conectada para que actúe como una persona.

Un cliente que hable el protocolo no necesita configuración: pide el endpoint sin credencial, recibe un 401 que apunta a los metadatos de autorización, y hace el flujo de OAuth solo.

Varios espacios de trabajo, una sola conexión

El detalle completo, incluido cómo agregar o quitar espacios después de conectar, está en Espacios de trabajo en MCP.

Al autorizar una app conectada, la pantalla de consentimiento ofrece una casilla por cada espacio de trabajo que puedas conceder, y puedes marcar varios a la vez. El espacio marcado que aparece primero en la lista queda como el espacio por defecto de esa conexión; los demás quedan igual de autorizados.

Por eso toda herramienta admite un argumento opcional, que no cambia nada para quien solo usa un espacio:

workspace?: string   // id o slug; si se omite, el espacio por defecto de la conexión

Si el asistente lo omite, la llamada actúa en el espacio por defecto de la conexión. Si lo pasa, actúa en ese otro espacio, siempre que la conexión esté autorizada ahí; si no lo está, la llamada falla con un error que nombra los espacios autorizados, para que el modelo sepa qué probar. nest_list_workspaces sirve para consultarlos de antemano: marca authorized: true en los que esta conexión puede usar, que no es lo mismo que pertenecer al espacio sin más.

Este argumento solo aparece con una app conectada. Una clave de API sigue atada a un único espacio, así que sus herramientas nunca lo muestran.

Ampliar o quitar espacios de una conexión ya autorizada se hace después, en Nest, bajo Apps conectadas, sin volver a autorizar nada desde el lado del asistente.

Detalles de transporte

Vale la pena saberlos antes de elegir cliente:

• Solo POST. GET y DELETE responden 405. No hay SSE.
• Sin sesiones. No existe Mcp-Session-Id y nada guarda estado entre una llamada y la siguiente.
• Respuestas JSON, no flujo de eventos.

El catálogo se recorta solo

Un asistente conectado no ve el catálogo completo: ve solo las herramientas que tu credencial puede llamar. Una herramienta para la que no tienes permiso no aparece siquiera en la lista.

Eso te ahorra problemas. Un modelo que ve una herramienta y recibe un "no puedes" tiende a insistir, a inventar rodeos o a decirle al usuario que algo falló. Un modelo que nunca la vio trabaja con lo que hay.

Con una clave sin permisos conocidos, el servidor queda vacío.

Una conexión autorizada antes de que existiera una herramienta tampoco la ve. Aprueba sus permisos nuevos en Nest, en Apps conectadas. La herramienta aparece en el catálogo la próxima vez que el asistente se conecta. Si quieres verla ya, desactiva y vuelve a activar el conector: no hace falta autorizarlo de nuevo.

Tu credencial manda

Conectar un asistente no amplía nada de lo que puedes hacer. Cada llamada se verifica de nuevo en la aplicación que la atiende, con la misma credencial y las mismas reglas que la API HTTP.

Por eso una referencia a algo que no puedes leer vuelve marcada como restringida en lugar de mostrar su contenido.

Lo que cambia respecto de la API HTTP

Casi nada, pero hay dos diferencias reales:

• Los booleanos son booleanos. En las rutas HTTP algunos parámetros llegan como las cadenas 'true' y 'false'; en las herramientas son del tipo que parecen.
• El límite de ritmo lo aplica cada aplicación, no el endpoint de MCP.

Ten presente además que los errores del propio endpoint no siguen del todo la tabla de códigos de la API. Un método no permitido, por ejemplo, responde 405 con el código invalid_request.