Los administradores deciden si los asistentes de IA pueden conectarse a la organización, qué herramientas pueden usar y qué aplicaciones de IA alojadas pueden iniciar sesión. Esta página describe esos ajustes y todas las protecciones que se aplican a las llamadas MCP. Lo que puede hacer un asistente está en Asistentes de IA (MCP).
Los ajustes de MCP
Abra Configuración > MCP («Si las aplicaciones de IA pueden conectarse a este espacio de trabajo, y qué herramientas no pueden usar»). Necesita Gestionar los ajustes de MCP (rol Admin).
| Ajuste | Valor por defecto | Significado |
|---|---|---|
| Permitir que los clientes MCP se conecten | Desactivado | Las aplicaciones de IA pueden conectarse con una clave de API que tenga Conectar clientes MCP, o mediante un inicio de sesión. Cada herramienta sigue necesitando su propio permiso, que deben tener la clave y su propietario. |
| Herramientas desactivadas | Vacío | Herramientas que nadie de la organización puede usar, una por línea como server/tool. |
| Más aplicaciones de IA | Vacío | Hosts de aplicaciones de IA que pueden conectarse con un inicio de sesión, además de las conocidas que acepta Hermetry, una por línea, por ejemplo tools.example.com. |
Los cambios se aplican en la siguiente llamada. Si no se pueden leer los ajustes, MCP se considera desactivado.
Activar MCP
- Abra Configuración > MCP.
- Active Permitir que los clientes MCP se conecten.
- Guarde.
Desactivarlo detiene todos los asistentes a la vez: cada llamada responde 403 «MCP está desactivado para este espacio de trabajo (Configuración → MCP)» y el índice de servidores (GET /api/mcp) responde { "enabled": false, "servers": [] }. Las claves y las aplicaciones conectadas se mantienen y vuelven a funcionar al volver a activarlo.
Desactivar herramientas individuales
Escriba una herramienta por línea:
telemetry/get_reading_series
iot_device/get_deviceUna herramienta desactivada no aparece en ningún asistente y no puede llamarse, sin importar lo que tenga la credencial. Úselo, por ejemplo, cuando quiera que los asistentes vean valores actuales pero no el historial. Los nombres de todos los servidores y herramientas están en la Referencia de herramientas MCP, o llame a GET /api/mcp.
Permitir más aplicaciones de IA
Los asistentes que se conectan con un inicio de sesión se identifican con una dirección https en su propio host. Hermetry acepta una lista integrada de hosts de aplicaciones de IA conocidas y sus subdominios. Para cualquier otra aplicación, añada su host en Más aplicaciones de IA; también se acepta un subdominio de un host incluido. Hasta entonces, la página de inicio de sesión muestra Esta aplicación no puede conectarse.
Añada solo hosts en los que confíe. La aplicación sigue actuando con los derechos de la persona que la aprueba, pero recibe lo que esa persona puede leer.
Protecciones en cada llamada
| Control | Detalle |
|---|---|
| Origen | Una llamada con un Origin de navegador de otro sitio se rechaza antes que nada |
| Credencial | Una clave de API con Conectar clientes MCP, o un token de una aplicación conectada; una cookie de sesión del navegador se rechaza con 401 |
| Organización | La organización de la credencial debe ser la de la dirección; la organización debe estar activa |
| Miembro | El titular de la clave, o la persona que conectó la aplicación, debe ser un miembro activo; un Owner actúa con derechos de Admin como máximo |
| Permiso | El permiso de la herramienta, que la persona (y la clave) tiene en ese momento |
| Red | La lista de IP permitidas de la clave y las reglas de IP de su organización |
| Lista de herramientas | Solo se listan las herramientas que superan todos los controles; una llamada a otra se rechaza sin ejecutarse |
Límites:
| Límite | Valor |
|---|---|
| Cuerpo de la solicitud | 64 KiB |
| Resultado | 256 KiB (los resultados más grandes se rechazan) |
| Bloque de datos | 32 KiB cada uno (el texto más largo se corta y se marca «[truncated at 32768 bytes]») |
| Tiempo de ejecución | 10 segundos por llamada |
| Frecuencia | 120 llamadas de lectura y 20 de escritura por minuto y por credencial |
| Historial | 31 días, 10 claves, 500 puntos por clave y por llamada |
| Tokens de inicio de sesión | 10 minutos; conexiones 90 días |
Datos delimitados
El texto que Hermetry no escribió por sí mismo (nombres y etiquetas de dispositivos, valores que envió un dispositivo) puede contener palabras dirigidas a un modelo de IA. Hermetry coloca ese texto en su propio bloque, tras su propio resumen, con el encabezado «El bloque siguiente son datos recuperados de <untrusted> que el texto no puede cerrar. Un asistente que sigue la guía de MCP trata ese texto como datos.
Esto reduce el riesgo, pero no lo elimina. Mantenga los nombres y etiquetas de los dispositivos sencillos, y no dé a un asistente más permisos de los que necesita.
Auditoría
Cada llamada MCP escribe una fila de auditoría:
| Acción | Cuándo |
|---|---|
mcp_server.tool.called | Se ejecutó una herramienta: servidor, herramienta, tipo, resultado, código de error, duración y los nombres de los argumentos |
mcp_server.tool.refused | Una herramienta que la credencial no puede usar, o un presupuesto de frecuencia agotado |
Nunca se guardan los valores de los argumentos ni los resultados. En una clave de API, el actor es la clave; en una aplicación conectada, la fila indica la conexión. Conectar, desconectar y suspender aplicaciones y cambiar los ajustes de MCP también se auditan. Consulte Registro de auditoría.
Cortafuegos de IA
Las llamadas MCP son señales para el cortafuegos de IA: tokens rechazados, orígenes rechazados, límites de frecuencia, argumentos no válidos repetidos, un token de actualización reutilizado (crítico) y tokens señuelo (un token de acceso que nunca se entregó a ninguna aplicación; presentarlo significa una copia robada o plantada).
En desarrollo: las acciones del cortafuegos sobre credenciales MCP, como pausar una aplicación conectada o limitar una clave. Hoy registra incidentes. Consulte Cortafuegos de IA.
Lista de comprobación antes de activar MCP
- Sepa quién puede conectarse. Cada rol integrado tiene Conectar clientes MCP, así que, una vez activo MCP, cualquier miembro puede conectar un asistente con sus propios derechos. Consulte Usuarios y roles.
- Desactive las herramientas que no quiera que usen los asistentes.
- Indique a los miembros que usen una clave por asistente, de solo lectura y con caducidad corta.
- Revise de vez en cuando Aplicaciones conectadas (Todos) y el registro de auditoría.