Servidor MCP para asistentes de IA, en DeviceChain
DeviceChain incluye un servidor opcional de Model Context Protocol para que los asistentes de IA puedan leer lo que una persona tiene permitido leer. Se basa en un principio: un agente de IA nunca puede hacer más que la persona que lo autorizó. Es una capa fina, seleccionada sobre la API GraphQL existente de la plataforma, no una pasarela amplia. En Preview también puede proponer acciones sobre alarmas que solo una persona puede aprobar.
Qué puede leer un asistente
El servidor expone herramientas de lectura, cada una una consulta contra la misma API GraphQL que usa la consola. Cubren los dispositivos y sus capacidades, el último estado conocido de un dispositivo, sus mediciones más recientes, las mediciones sin procesar y agregadas en un intervalo, las posiciones informadas, las alarmas y los comandos emitidos a un dispositivo. Una herramienta devuelve exactamente lo que ese usuario, en ese inquilino, tiene permitido ver.
No hay ninguna herramienta genérica para ejecutar una consulta, y las lecturas sensibles, como las credenciales, el rastro de auditoría, los destinatarios de notificaciones y los secretos de aprovisionamiento, se dejan fuera deliberadamente.
Propuestas de acciones sobre alarmas (Preview)
Si el operador activa las acciones de agentes y la autorización incluye el ámbito act, se añaden propose_alarm_action, get_proposal y list_my_proposals. Un agente puede proponer confirmar o limpiar alarmas, pero no aprobar ni ejecutar acciones.
Una persona aprueba en la consola con su propia sesión y un segundo factor reciente. La aprobación final ejecuta la acción como esa persona. Cerrar la sesión termina la aprobación. No hay modo automático.
Cómo se concede el acceso
El servidor es un servidor de recursos OAuth 2.1 delante de un servidor de autorización de la plataforma: código de autorización con PKCE, metadatos RFC 8414, rotación de tokens de actualización y vinculación de audiencia RFC 8707. El usuario inicia sesión, elige el inquilino que concede y da su consentimiento. Hasta que llegue el registro dinámico de clientes, un administrador registra los clientes.
Por qué no puede extralimitarse
El servidor no tiene ninguna credencial privilegiada de la plataforma. Cada llamada reenvía el token validado del propio llamador al servicio GraphQL, que vuelve a aplicar las mismas comprobaciones de inquilino y de rol. El inquilino se fija cuando se concede el acceso en lugar de pasarse como parámetro, así que ninguna herramienta recibe un argumento de inquilino que un agente pueda cambiar. Las herramientas sí aceptan identificadores de dispositivo, filtros e intervalos de tiempo. Un token de acceso emitido para el servidor lo nombra como audiencia, y cualquier otro token se rechaza.
Cada llamada a una herramienta escribe una línea en el registro del servicio con el inquilino, el actor, el cliente y el resultado, porque las lecturas no son entradas del diario de auditoría.
Lo que no hace.
- MCP no tiene herramientas de aprobación ni ejecución. Un agente no puede enviar comandos ni iniciar despliegues: solo se ejecutan propuestas para confirmar o limpiar alarmas, tras la aprobación de una persona.
- Activar el servicio mcp no basta: el servidor de autorización permanece desactivado hasta que un operador configura una URL de emisor, y hasta entonces ningún cliente puede obtener un token. El servicio mcp tampoco está en un despliegue por defecto.
- Las herramientas que listan dispositivos aún no indican si un dispositivo está desactivado.