CISO ADAPT

Conecta CISO Adapt a Claude Desktop

Usa Claude para consultar y actuar sobre tu espacio de trabajo GRC: gobernanza, riesgo, cumplimiento, políticas y más, con los mismos permisos que la aplicación web de CISO Adapt.

Requisitos

• Claude Desktop en macOS o Windows
• Una cuenta activa de CISO Adapt
• Una Clave API MCP desde CISO Adapt → Configuración → Integraciones → MCP
• Para configuración manual: Node.js (solo para la opción npx / mcp-remote)

URL del servidor MCP

Tu endpoint MCP es la URL del backend de CISO Adapt con /mcp añadido:

https://backend.dashboard.cisoadapt.ai/mcp

Usa este valor donde la configuración solicite URL del servidor MCP. Los entornos de producción deben usar HTTPS.

Obtén tu clave API MCP

1. Inicia sesión en CISO Adapt.
2. Abre Tokens de API.
3. Crea o copia tu clave API MCP (formato: mcp_…).
4. Úsala como token Bearer: Authorization: Bearer mcp_your_api_key_here

Trata tu clave API MCP como una contraseña. Nunca la subas a control de versiones ni la compartas en canales públicos.

Método 2 - Configuración manual de claude_desktop_config.json

Los usuarios avanzados pueden registrar el servidor directamente en el archivo de configuración de Claude Desktop. Fusiona uno de los bloques siguientes en el objeto mcpServers existente: reemplaza la clave API de ejemplo con tu clave real desde Configuración → Integraciones → MCP.

Ubicación del archivo de configuración

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Opción A - URL HTTP directa

Usa esta opción cuando Claude Desktop admita MCP remoto sobre HTTP con cabeceras personalizadas (típico para endpoints HTTPS alojados).

claude_desktop_config.json

{
  "mcpServers": {
    "cisoadapt": {
      "url": "https://backend.dashboard.cisoadapt.ai/mcp",
      "headers": {
        "Authorization": "Bearer mcp_your_api_key_here"
      }
    }
  }
}

Opción B - mcp-remote mediante npx

Usa esta opción cuando necesites un puente stdio hacia un servidor MCP remoto: común para desarrollo local o cuando el transporte HTTP directo no esté disponible. El paquete mcp-remote conecta Claude Desktop con tu endpoint MCP HTTP. Para URLs de producción HTTPS, --allow-http se omite; añádelo manualmente solo si apuntas a un endpoint HTTP.

claude_desktop_config.json

{
  "mcpServers": {
    "cisoadapt": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://backend.dashboard.cisoadapt.ai/mcp",
        "--header",
        "Authorization:${CISOADAPT_MCP_AUTH}"
      ],
      "env": {
        "CISOADAPT_MCP_AUTH": "Bearer mcp_your_api_key_here"
      }
    }
  }
}

Después de editar la configuración, cierra y vuelve a abrir Claude Desktop por completo. Confirma que el servidor CISO Adapt aparece en la lista de MCP / conectores de Claude.

Verifica la conexión

1. Reinicia Claude Desktop después de instalar la extensión o editar la configuración.
2. Comprueba que cisoadapt aparece como servidor MCP conectado.
3. Inicia un nuevo chat y confirma que las herramientas de CISO Adapt están disponibles.

Ejemplos de prompts

• “Dame un resumen ejecutivo de nuestra postura de riesgo.”
• “¿Qué marcos de cumplimiento estamos siguiendo y dónde están las mayores brechas?”
• “Resume nuestras políticas abiertas que necesitan revisión este trimestre.”
• “Lista los riesgos de alta severidad asignados a mi equipo.”

Solución de problemas

Errores de no autorizado o 401

Confirma que la cabecera Authorization sea exactamente Bearer mcp_… (incluido el prefijo Bearer). Regenera la clave en CISO Adapt si es necesario.

El servidor no aparece en Claude

Valida la sintaxis JSON en claude_desktop_config.json, asegúrate de que Node.js esté instalado para la opción npx y reinicia Claude Desktop por completo.

HTTP local / conexión rechazada

Asegúrate de que el backend de CISO Adapt esté en ejecución y sea accesible en tu URL de servidor MCP. Para configuraciones HTTP localhost, usa la Opción B con --allow-http.

La descarga falla

Reintenta el botón de descarga anterior. Si el problema persiste, contacta a tu administrador de CISO Adapt: el paquete de extensión se sirve desde el backend de tu organización.