Un asistente de IA llega a los servidores MCP de su organización de una de dos formas: con una clave de API o como una aplicación que conectó con un inicio de sesión. Esta página muestra cómo configurar cada una de forma segura y cómo terminar el acceso. Los pasos de conexión están en Conectar un asistente de IA.
Claves MCP
No existe un tipo aparte de clave MCP. Una clave MCP es una clave de API normal que tiene el permiso Conectar clientes MCP (mcp_server.connect), creada en Claves de API como cualquier otra. Consulte Autenticación.
Qué marcar
| Permiso | Necesario para |
|---|---|
| Conectar clientes MCP (grupo MCP) | Acceder a cualquier servidor MCP |
Ver dispositivos (iot_device.devices.read) | list_devices, get_device |
Lectura de telemetría (telemetry.read) | get_latest_readings, get_reading_series |
Use los preajustes Solo lectura de los módulos; no se necesita nada más. Una clave con Conectar clientes MCP pero sin el permiso de una herramienta no ve esa herramienta. Una clave sin Conectar clientes MCP es rechazada por todos los servidores MCP, sean cuales sean los demás permisos que tenga.
Cada herramienta se ejecuta solo mientras tanto la clave como su titular tengan el permiso de la herramienta. Si el titular pierde un permiso, el asistente pierde la herramienta en su siguiente llamada.
Buenas prácticas
- Una clave por asistente y persona. Póngale un nombre que permita saber quién la usa: «Asistente de escritorio – Alex».
- Caducidad corta. De 30 a 90 días, y después rote la clave.
- Lista blanca de IP cuando el asistente se ejecuta en un servidor fijo.
- Sin otros permisos. Una clave MCP con permisos adicionales también funciona en la API REST con ellos.
- No guarde la clave en archivos compartidos. Los archivos de configuración de los asistentes suelen sincronizarse o subirse al control de versiones; guarde la clave en el almacén de secretos del asistente o en una variable de entorno, si lo permite.
Seguimiento y cancelación de una clave
- La página de la clave muestra Último uso, Última IP de uso y Verificaciones totales.
- Cada llamada a una herramienta queda en el registro de auditoría como
mcp_server.tool.called(omcp_server.tool.refused), con la clave como actor, la herramienta, el resultado y la duración. - Desactivar, Revocar o Rotar clave en la página de la clave termina o sustituye el acceso de inmediato. Consulte Autenticación.
- El cortafuegos de IA registra incidencias sobre claves que se comportan mal. Sus acciones (limitar o desactivar una clave) están en desarrollo.
Aplicaciones conectadas
Una aplicación que conectó con un inicio de sesión aparece en Aplicaciones conectadas (en la sección Desarrollador del menú): «Aplicaciones de IA que conectó a este espacio de trabajo con un inicio de sesión. Desconectar una la detiene de inmediato».
| Columna | Muestra |
|---|---|
| Aplicación | El nombre y el host de la aplicación |
| Acceso | Lectura o Lectura y cambios |
| Estado | Conectada, Desconectada o Pausada por el cortafuegos de IA |
| Conectada | Cuándo la aprobó |
| Último uso | Su última llamada |
Use Buscar aplicación o host… para encontrar una. Los administradores (que tienen Gestionar ajustes MCP) pueden cambiar entre Mías y Todas (administradores) para ver las aplicaciones de todos los miembros.
Desconectar una aplicación
- Abra Aplicaciones conectadas.
- Seleccione Desconectar en la fila de la aplicación.
- Confirme ¿Desconectar esta aplicación?: «
perderá el acceso a este espacio de trabajo de inmediato. Para volver a usarla, conéctela de nuevo.»
La siguiente llamada de la aplicación es rechazada con 401. Los miembros pueden desconectar sus propias aplicaciones; los administradores pueden desconectar las de cualquiera. Desconectar requiere una persona con sesión iniciada: una clave de API no puede hacerlo.
Una conexión también termina:
- después de 90 días (conéctela de nuevo),
- cuando su token de actualización se usa dos veces, lo que puede indicar que fue copiado (la conexión se revoca y el evento se audita como de gravedad alta),
- cuando la persona que la conectó ya no es un miembro activo.
Pausada por el cortafuegos de IA
En desarrollo: las acciones del cortafuegos de IA, incluida la pausa de una aplicación conectada, están en desarrollo. Hoy el cortafuegos solo registra incidencias; consulte Cortafuegos de IA.
Cuando esta acción se publique, una aplicación pausada será rechazada en cada llamada durante hasta 7 días y su estado mostrará Pausada por el cortafuegos de IA. Si ve ese estado y no lo esperaba, desconecte la aplicación y revise el registro de auditoría antes de volver a conectarla.
Por HTTP
| Método | Ruta | Quién | Hace |
|---|---|---|---|
| GET | /api/mcp/grants | Cualquier miembro con sesión iniciada que tenga Conectar clientes MCP | Sus aplicaciones conectadas: { data, total } |
| GET | /api/mcp/grants/all | Gestionar ajustes MCP | Las de todos |
| DELETE | /api/mcp/grants/{grantId} | El propietario de la aplicación, o un administrador | Desconecta: { "revoked": true } |
Las listas aceptan page (desde 0), pageSize (por defecto 20, como máximo 100), search (nombre de la aplicación o host), sort y status (active, suspended, revoked). Las rutas están bajo https://<su host>/tenant/<tenantId>.
Qué opción elegir
| Situación | Use |
|---|---|
| Un asistente en su propio ordenador | Una clave de API, o el inicio de sesión si el asistente lo ofrece |
| Un asistente alojado que añade conectores por dirección | El inicio de sesión |
| Un agente programado o un script sin persona | Una clave de API, marcada como clave de servicio si debe sobrevivir a su creador |
| Un asistente compartido de equipo | Una clave de API por asistente con permisos de solo lectura; nunca el inicio de sesión de una persona |