Tokens, ámbitos y seguridad
Cómo funcionan las conexiones de inicio de sesión (OAuth) y los tokens pat-isms: qué puede hacer cada uno, ámbitos, desconexión, caducidad y límites estrictos.
Un cliente MCP actúa como tu usuario de una de dos formas: inicias sesión y lo apruebas (OAuth, el valor predeterminado), o le proporcionas un token de acceso personal limitado por los ámbitos que seleccionaste.
Inicio de sesión (OAuth)
Cuando añades https://account.ismscopilot.com/v1/account/mcp a un cliente sin encabezado, el cliente te pide que inicies sesión en ISMS Copilot. La página de consentimiento muestra la dirección a la que se envían los resultados y el nombre que la aplicación se dio a sí misma. Aprueba solo si iniciaste la conexión desde tu propia herramienta de IA.
Un Aprobar otorga un conjunto fijo:
| Puede | Ámbitos |
|---|---|
| Leer tu cuenta, espacios de trabajo, documentos (metadatos), memorias y perfil de la empresa | account:read, workspaces:read, documents:read, memories:read, company_context:read |
| Hacer preguntas a ISMS Copilot y leer respuestas | conversations:create |
| Actualizar el perfil de tu empresa y memorias, y crear espacios de trabajo | company_context:write, memories:write, workspaces:write |
Una conexión de inicio de sesión nunca puede crear, listar o revocar claves API, y nunca puede verificar o comprar créditos API. Esas acciones son solo para tokens. Sus respuestas tampoco incluyen nunca campos de mejora o compra como upgrade_url o extra_usage_buyable.
Los cambios que realiza una aplicación con inicio de sesión se etiquetan en ISMS Copilot con el nombre que la aplicación registró: Added by OAuth app: <name> en memorias, Updated by OAuth app: <name> en el perfil de tu empresa y espacios de trabajo. El nombre lo elige la aplicación misma, así que trátalo como una pista, no como una prueba. Un cambio posterior desde la aplicación web o un token reemplaza la etiqueta.
Desconectar: Configuración → Aplicaciones conectadas, en Agentes conectados. La siguiente llamada de esa aplicación es rechazada y su token de actualización deja de funcionar. Para volver a conectar, inicia sesión y aprueba de nuevo.
Tokens de acceso personal (alternativa)
Usa un token para un cliente que no puede iniciar sesión, para CI y máquinas sin interfaz gráfica, o cuando deseas un conjunto de ámbitos más reducido que el que otorga el inicio de sesión.
Prefijo y ciclo de vida
| Paso | Comportamiento |
|---|---|
| Crear | Configuración → Aplicaciones conectadas → Crear token |
| Mostrar | Se muestra el secreto completo una sola vez; comienza con pat-isms- |
| Almacenar | Solo en la configuración del cliente; nunca lo confirmes en git |
| Revocar | En la misma página de Configuración; surte efecto de inmediato |
| Caducidad | Opcional al crear |
Ámbitos (típicos)
Las etiquetas exactas en la interfaz de usuario pueden variar ligeramente; la intención es:
Cuenta
| Capacidad | Lectura | Escritura / acción |
|---|---|---|
| Información de la cuenta | sí | no |
| Espacios de trabajo | listar (workspaces:read) | crear espacios de trabajo personales con create_workspace (workspaces:write) |
| Documentos | listar solo metadatos (sin herramienta get-by-ID) | no |
| Memorias | sí | crear / editar cuando se otorga permiso |
| Contexto de la empresa | get_company_context (company_context:read) | set_company_context (company_context:write), un reemplazo completo del perfil |
| Conversaciones | n/a | iniciar y enviar cuando se otorga permiso |
Model API (grupo Aplicaciones conectadas)
| Ámbito | Propósito |
|---|---|
api_keys:read | Listar metadatos de claves sk-isms (sin secretos) |
api_keys:write | Crear / revocar claves sk-isms a través de MCP |
api_credits:read | Leer el saldo de créditos API prepagados |
api_credits:checkout | Crear una URL de Stripe Checkout para recarga (un humano paga en el navegador) |
Estos ámbitos no permiten que un pat-isms realice inferencias. El orquestador aún usa una clave sk-isms separada para api.ismscopilot.com. Consulta Configurar desde Claude Code o Grok.
Otorga el conjunto mínimo para el trabajo del orquestador. Un token de espacio de trabajo de solo lectura no puede iniciar conversaciones.
Límites estrictos (por diseño)
- La creación de espacios de trabajo es solo personal y está limitada. Un espacio de trabajo creado por un orquestador no se comparte con tu equipo, no hereda la Protección Avanzada de Datos de tu organización y está limitado a 10 nuevos espacios de trabajo cada 24 horas (cada creación cuenta, incluidas las de la aplicación web y el espacio de trabajo inicial de una cuenta nueva). Configura la personalidad, las instrucciones y el uso compartido con el equipo en la aplicación web.
- Las escrituras en el contexto de la empresa son un reemplazo completo.
set_company_contextsobrescribe todo el perfil con los campos que pases (nombre de la empresa, sector, escala, país de la sede, rol de privacidad, tipos de datos, región de alojamiento, pila tecnológica, notas); un objeto vacío lo borra. Léelo primero conget_company_contextsi solo deseas cambiar un campo. - Beyond está disponible cuando el orquestador pasa
mode: "beyond"(Fast es el valor predeterminado). Planes de pago, 10 ejecuciones por día UTC (50 en Unlimited). Consulta Usar el modo Beyond. - La Protección Avanzada de Datos no se puede activar o desactivar mediante el token. El orquestador puede informar el estado; tú lo cambias en Configuración → Protección de datos.
- Se aplican límites de frecuencia (del orden de ~120 solicitudes/minuto por token; las conversaciones concurrentes están limitadas por cuenta). Si alcanzas los límites, reduce la frecuencia y reintenta.
pat-ismspor sí solo no ejecuta completados de la Model API. Las herramientas de la Model API generansk-ismsy abren la página de pago de créditos; la facturación de Embed partner sigue siendo independiente.
Lista de verificación de seguridad
- Nombra los tokens por dispositivo o propósito (
claude-laptop,cursor-ci). - Prefiere una caducidad corta para máquinas temporales.
- Revoca cuando se pierda un portátil o rote un secreto de CI.
- Nunca incluyas
pat-isms-…en repositorios públicos, capturas de pantalla o tickets de soporte.
El uso cuenta contra tu suscripción de chat normal y los límites de tu plan, no contra los créditos prepagados de la API. Tu orquestador aún lee cada respuesta devuelta como entrada, por lo que el texto de la respuesta también cuenta para el contexto y el uso de la propia herramienta que realiza la llamada.