Conectar ISMS Copilot a Claude Code

Claude realiza el trabajo. ISMS Copilot es el experto en cumplimiento al que consulta y verifica ese trabajo. Tú decides y firmas.

Puedes utilizar tu cuenta de ISMS Copilot directamente desde Claude Code, Cursor o cualquier herramienta de IA compatible con MCP. Una vez conectado, tu herramienta de IA puede listar tus espacios de trabajo y documentos, leer tus memorias y mantener conversaciones reales con ISMS Copilot, actuando en tu nombre 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 estás conectado con un token de acceso personal? Elimina primero ese servidor, de lo contrario Claude Code seguirá utilizándolo: 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 de la misma manera, como una aplicación MCP personalizada: consulta la misma página. Para Cursor y Codex, consulta Conectar Cursor y Codex.

Alternativa: conectar con un token de acceso personal

Utiliza un token cuando el inicio de sesión no sea posible, 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 debe 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 con ISMS Copilot, todo sin salir de tu editor.

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

El servidor no elige un modo. Tu orquestador utiliza Fast por defecto, Think para verificaciones y análisis de múltiples pasos, y Beyond bajo solicitud, para una verificación final justo antes de una auditoría o para redacción de investigación prolongada. Si el orquestador omite mode, ISMS Copilot utiliza Fast.

• Fast (predeterminado): respuestas rápidas, sin razonamiento extendido.
• Think: razonamiento más profundo para verificaciones y análisis de múltiples pasos. Solo planes de pago. En un plan gratuito, una solicitud de Think recurre a Fast.
• Beyond: plan, borrador y verificación de múltiples pasos. 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 sondear 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. Sin eso, el orquestador aún puede elegir Beyond para una verificación final justo antes de una auditoría o para redacción de investigación prolongada.

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

Consulta Usar el modo Beyond.

Si alcanzas un límite de uso

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

La conexión utiliza el mismo límite de uso que la aplicación de chat: la asignación de tu plan, con la hora de restablecimiento que muestra la aplicación. Si create_conversation o send_message alcanzan el límite, el primer mensaje de error es la oración de espera o actualización (incluyendo la próxima hora de restablecimiento) 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 oración del equipo: pide al propietario más uso o espera hasta la próxima ventana de 4 horas. Su JSON lleva quota_scope, org_role y extra_usage_buyable, y ningún enlace de actualización.

Puedes:

1. Esperar hasta reset_at.
2. Abrir upgrade_url en un navegador mientras inicias sesión en la misma cuenta de ISMS Copilot (cuentas individuales y propietarios de organizaciones).
3. Cuando el JSON lleve 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, 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 lleva overflow_active: true).
4. Seguir utilizando 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 (las empresas, mencionadas anteriormente, son la excepción: una conexión por inicio de sesión, o un token con company_context:write, puede crearlas, cambiarlas y eliminarlas, y vincularlas o desvincularlas de espacios de trabajo, hasta el límite de tu plan). 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 ni desactivar desde tu herramienta de IA.

Si le preguntas a tu herramienta de IA sobre Protección de Datos, puede informarte 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 empresas; preguntar a ISMS Copilot, leer respuestas y marcar una respuesta estancada como fallida; crear, cambiar y eliminar empresas y vincularlas o desvincularlas de espacios de trabajo, editar 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 qué 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 por inicio de sesión en Agentes conectados.

Reconectar o rotar un token

Si una conexión por 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 deseas 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 otorgaste.
• 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 de inmediato.
• 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 por 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 recurre a Fast.
• Beyond se ejecutó como una respuesta normal: es probable que el orquestador omitiera mode. Pídele que envíe mode: "beyond", o di "usa Beyond" en el siguiente turno. Verifica beyond_denied_reason si una solicitud de Beyond fue degradada.