Conectar ISMS Copilot a Claude Code

Puedes usar tu cuenta de ISMS Copilot directamente desde Claude Code, Cursor o cualquier herramienta de IA compatible con MCP. Una vez conectada, tu herramienta de IA puede listar tus espacios de trabajo y documentos, leer tus memorias y mantener conversaciones reales de ISMS Copilot, actuando como tú y cubierta por tu suscripción existente.

Lo que necesitas

• Una cuenta de ISMS Copilot. La conexión está cubierta por tu suscripción, sin facturación separada.
• Una terminal con Claude Code (u otro cliente MCP) instalado.
• Algunas capacidades dependen de tu plan (consulta Elegir cómo responde).

Conectar en tres pasos

¿Ya te conectaste con un token de acceso personal? Elimina primero ese servidor; si no, Claude Code lo sigue usando: claude mcp remove ismscopilot.

1. Añade el servidor (no se necesita token):

claude mcp add --scope user --transport http ismscopilot https://account.ismscopilot.com/v1/account/mcp

2. En una sesión de Claude Code, ejecuta /mcp, selecciona ismscopilot y sigue los pasos en tu navegador. Desde una terminal, claude mcp login ismscopilot hace lo mismo.
3. Inicia sesión en ISMS Copilot y haz clic en Aprobar en la página de consentimiento.

Luego pregunta, por ejemplo, "lista mis espacios de trabajo de ISMS Copilot".

claude.ai y Claude Desktop se conectan a la misma URL del servidor con el mismo inicio de sesión: consulta Conectar cualquier cliente MCP. ChatGPT se conecta del mismo modo, como app MCP personalizada: consulta la misma página. Para Cursor y Codex, consulta Conectar Cursor y Codex.

Alternativa: conectar con un token de acceso personal

Usa un token cuando no sea posible iniciar sesión, por ejemplo en CI o en una máquina sin interfaz gráfica:

1. En ISMS Copilot, abre Configuración, luego Aplicaciones conectadas.
2. Haz clic en Crear token. Dale un nombre (por ejemplo, "Claude Code CI"), elige los permisos que debería tener (consulta Permisos) y copia el token. Solo lo verás una vez.
3. Pega el comando mostrado en tu terminal. Se verá así:

claude mcp add --scope user --transport http ismscopilot https://account.ismscopilot.com/v1/account/mcp --header "Authorization: Bearer pat-isms-..."

Qué puede hacer tu herramienta de IA

Una conexión puede leer y hacer lo siguiente, y nada más. Una conexión por inicio de sesión obtiene todas las filas a continuación; un token obtiene las filas que cubren sus permisos:

Así, desde tu herramienta de IA puedes listar tus espacios de trabajo y documentos, crear un espacio de trabajo personal, añadir o editar una memoria y mantener una conversación fundamentada de ISMS Copilot, todo sin salir de tu editor.

Elegir cómo responde (Fast, Think y Beyond)

Cuando inicias o continúas una conversación desde tu herramienta de IA, eliges el modo. La conexión no lo selecciona a partir de la pregunta. Si el orquestador omite mode, ISMS Copilot usa Fast.

• Fast (predeterminado): respuestas rápidas, sin razonamiento extendido.
• Think: razonamiento más profundo para preguntas difíciles. Solo planes de pago. En un plan gratuito, una solicitud Think vuelve a Fast.
• Beyond: plan de múltiples pasos, borrador y verificación. Solo planes de pago, 10 ejecuciones por día UTC (50 en Unlimited). Escala de minutos. El orquestador debe pasar mode: "beyond" en create_conversation o send_message, luego consultar get_reply aproximadamente cada 10-20 segundos hasta que se complete la ejecución. Si Beyond no puede ejecutarse, el turno responde a través del flujo normal e incluye beyond_denied_reason.

En la práctica:

• "Piensa cuidadosamente sobre esto" es suficiente para Think.
• "Usa Beyond" o "ejecuta esto en Beyond" es suficiente para Beyond. El orquestador no actualizará una pregunta difícil por sí mismo.

Un turno Fast o Think que no esté listo en línea devuelve status: "generating". El orquestador luego consulta get_reply aproximadamente cada 2-5 segundos hasta que devuelve complete.

Consulta Usar el modo Beyond.

Si alcanzas un límite de uso

Conexiones de inicio de sesión (Claude, ChatGPT): el texto de error indica el límite y cuándo se restablece, sin invitación a mejorar el plan. El JSON incluye reset_at pero nunca upgrade_url, usage_url ni extra_usage_buyable. Los campos de mejora y compra descritos a continuación solo aparecen en conexiones con un token de acceso personal.

La conexión usa la misma ventana de sesión UTC de 4 horas que la aplicación de chat. Si create_conversation o send_message alcanzan el límite, el primer texto de error es la frase de espera o actualización (incluyendo la próxima hora de reinicio) y el bloque JSON incluye reset_at. Las cuentas individuales y los propietarios de organizaciones también obtienen upgrade_url. Los miembros de la organización obtienen la frase del equipo en su lugar: pide al propietario más uso o espera hasta la próxima ventana de 4 horas. Su JSON incluye quota_scope, org_role y extra_usage_buyable, y no tiene enlace de actualización.

Puedes:

1. Esperar hasta reset_at.
2. Abrir upgrade_url en un navegador mientras estás conectado a la misma cuenta de ISMS Copilot (cuentas individuales y propietarios de organizaciones).
3. Cuando el JSON incluya fallback_available: true y el desbordamiento de tu plan esté disponible (cuentas individuales de pago con Advanced Data Protection desactivado; nunca en un grupo de equipo), indica al orquestador que continúe: con tu aprobación explícita, lo reenvía con overflow_consent: true y el turno se ejecuta en el mismo desbordamiento de hasta 2x que ofrece la aplicación web (la respuesta incluye overflow_active: true).
4. Seguir usando herramientas de lectura. Los espacios de trabajo, memorias, documentos e información de la cuenta siguen funcionando después del límite de chat.

Consulta Qué hacer cuando alcanzas tu límite de uso.

La configuración permanece en la aplicación web

La configuración protegida de la cuenta es de solo lectura desde la conexión (el contexto de la empresa, mencionado anteriormente, es el único perfil que un token con company_context:write puede reemplazar). En particular, Advanced Data Protection (que enruta tus datos a través de un proveedor con sede en la UE y sin retención) no se puede activar o desactivar desde tu herramienta de IA.

Si le preguntas a tu herramienta de IA sobre Protección de Datos, puede informar si está habilitada para tu cuenta y te indicará Configuración, Protección de Datos en chat.ismscopilot.com para cambiarla. Esto es deliberado: un token de conexión no debería poder cambiar una configuración global de residencia de datos.

Permisos

Cuando inicias sesión y haces clic en Aprobar, la herramienta obtiene un conjunto fijo: leer tu cuenta, espacios de trabajo, documentos (metadatos), memorias y perfil de la empresa; preguntar a ISMS Copilot y leer respuestas; actualizar tu perfil de la empresa y memorias, y crear espacios de trabajo. No puede crear claves API ni comprar créditos. Los cambios que realiza se etiquetan en ISMS Copilot con el nombre de la herramienta, como Added by OAuth app: <name> o Updated by OAuth app: <name>.

Cuando creas un token en su lugar, eliges exactamente lo que puede hacer (leer espacios de trabajo, leer documentos, leer y escribir memorias, iniciar conversaciones, etc.). Concede solo lo que necesites. Un token que solo lee tus espacios de trabajo no puede cambiar tus memorias ni iniciar conversaciones.

Puedes ver y desconectar cada conexión en cualquier momento en Configuración, Aplicaciones conectadas: tokens en la lista de tokens, conexiones de inicio de sesión en Agentes conectados.

Reconectar o rotar un token

Si una conexión de inicio de sesión deja de funcionar (por ejemplo, después de desconectarla), ejecuta /mcp, selecciona ismscopilot e inicia sesión nuevamente.

Si te conectaste con un token y quieres cambiar a uno nuevo, elimina primero el servidor existente. De lo contrario, Claude Code mantendrá el token antiguo:

claude mcp remove ismscopilot

Luego añade el servidor nuevamente, con inicio de sesión o con el nuevo token.

Seguridad

• Una conexión actúa como tú, por lo que puede acceder exactamente a lo que tu cuenta ya puede acceder, limitado por lo que aprobaste o los permisos que concediste.
• Está cubierta por tu suscripción, sin facturación separada.
• Puedes desconectarla en cualquier momento en Configuración, Aplicaciones conectadas. La desconexión surte efecto inmediatamente.
• Trata un token como una contraseña. Si uno se expone, revócalo y crea uno nuevo.

Solución de problemas

• Conectado pero las herramientas no aparecen: vuelve a ejecutar el comando de conexión con --scope user, o ejecuta claude mcp remove ismscopilot y añádelo nuevamente.
• Autenticación fallida o "necesita autenticación": una conexión de inicio de sesión fue desconectada o expiró: ejecuta /mcp e inicia sesión nuevamente. Un token puede haber sido revocado o expirado: crea uno nuevo en Configuración, Aplicaciones conectadas.
• El modo Think no parece más profundo: Think requiere un plan de pago. En un plan gratuito vuelve a Fast.
• Beyond se ejecutó como una respuesta normal: es probable que el orquestador haya omitido mode. Pídele que envíe mode: "beyond", o di "usa Beyond" en el siguiente turno. Revisa beyond_denied_reason si una solicitud de Beyond fue degradada.