Novedad: el cortafuegos de IA supervisa toda la plataforma y explica cada incidente con palabras sencillas. Vea cómo funciona

Claves MCP y aplicaciones conectadas

Da a un asistente de IA una clave de API solo con los permisos MCP y de lectura que necesita, y consulta y desconecta las aplicaciones conectadas.

Un asistente de IA accede a los servidores MCP de tu organización de una de dos maneras: con una clave de API o como una aplicación que conectaste con un inicio de sesión. Esta página muestra cómo configurar cada una de forma segura y cómo finalizar 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. Consulta Autenticación.

Qué marcar

PermisoNecesario 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

Usa 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, independientemente de lo que tenga además.

Cada herramienta solo se ejecuta 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. Ponle un nombre que permita saber quién la usa: «Asistente de escritorio – Alex».
  • Caducidad corta. De 30 a 90 días, y después rota la clave.
  • Lista de IP permitidas cuando el asistente se ejecute en un servidor fijo.
  • Sin otros permisos. Una clave MCP con permisos adicionales también funciona en la API REST con ellos.
  • Mantén la clave fuera de los archivos compartidos. Los archivos de configuración de los asistentes suelen sincronizarse o subirse a repositorios; guarda la clave en el almacén de secretos del asistente o en una variable de entorno, donde se permita.

Supervisar y finalizar una clave

  • La página de la clave muestra Último uso, IP del último uso y Verificaciones totales.
  • Cada llamada a una herramienta figura en el registro de auditoría como mcp_server.tool.called (o mcp_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 finalizan o reemplazan el acceso de inmediato. Consulta Autenticación.
  • El cortafuegos de IA registra incidentes sobre las claves que se comportan mal y puede limitar o revocar esa clave.

Aplicaciones conectadas

Una aplicación que conectaste con un inicio de sesión aparece en Aplicaciones conectadas (en la parte Desarrollador del menú): «Aplicaciones de IA que conectaste a este espacio de trabajo con un inicio de sesión. Desconectar una detiene su acceso de inmediato.»

ColumnaMuestra
AplicaciónEl nombre de la aplicación y su host
AccesoLectura o Lectura y cambios
EstadoConectada, Desconectada o Pausada por el cortafuegos de IA
ConectadaCuándo la aprobaste
Último usoSu última llamada

Usa Buscar aplicación o host… para encontrar una. Los administradores (que tienen Gestionar ajustes MCP) pueden cambiar entre Mías y Todos (administradores) para ver las aplicaciones de todos los miembros.

Desconectar una aplicación

  1. Abre Aplicaciones conectadas.
  2. Selecciona Desconectar en la fila de la aplicación.
  3. Confirma ¿Desconectar esta aplicación?: «Nombre de la aplicación perderá el acceso a este espacio de trabajo de inmediato. Para volver a usarla, conéctala de nuevo.»

La siguiente llamada de la aplicación se rechaza 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 (vuelve a conectarla),
  • 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 queda auditado con gravedad alta),
  • cuando la persona que la conectó deja de ser miembro activo.

Por HTTP

MétodoRutaQuiénFunción
GET/api/mcp/grantsCualquier miembro con sesión iniciada que tenga Conectar clientes MCPTus aplicaciones conectadas: { data, total }
GET/api/mcp/grants/allGestionar ajustes MCPLas de todos
DELETE/api/mcp/grants/{grantId}El propietario de la aplicación, o un administradorDesconectar: { "revoked": true }

Las listas admiten 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://<tu host>/tenant/<tenantId>.

Qué opción elegir

SituaciónUsar
Un asistente en tu propio ordenadorUna clave de API, o el inicio de sesión si el asistente lo ofrece
Un asistente alojado que añade conectores por direcciónEl inicio de sesión
Un agente programado o un script sin una personaUna clave de API, marcada como clave de servicio si debe sobrevivir a su creador
Un asistente de equipo compartidoUna clave de API por asistente con permisos de solo lectura; nunca el inicio de sesión de una persona