CISO ADAPT

Conecte o CISO Adapt ao Claude Desktop

Use o Claude para consultar e agir no seu workspace de GRC — governança, risco, conformidade, políticas e muito mais — com as mesmas permissões do aplicativo web do CISO Adapt.

Requisitos

• Claude Desktop no macOS ou Windows
• Uma conta CISO Adapt ativa
• Uma chave de API MCP do CISO Adapt → Configurações → Integrações → MCP
• Para configuração manual: Node.js (apenas para a opção npx / mcp-remote)

URL do servidor MCP

Seu endpoint MCP é a URL do backend do CISO Adapt com /mcp anexado:

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

Use esse valor sempre que a configuração solicitar a URL do servidor MCP. Ambientes de produção devem usar HTTPS.

Obtenha sua chave de API MCP

1. Entre no CISO Adapt.
2. Abra API Tokens.
3. Crie ou copie sua chave de API MCP (formato: mcp_…).
4. Use-a como token Bearer: Authorization: Bearer mcp_your_api_key_here

Trate sua chave de API MCP como uma senha. Nunca a envie para o controle de versão nem a compartilhe em canais públicos.

Método 2 - Configuração manual do claude_desktop_config.json

Usuários avançados podem registrar o servidor diretamente no arquivo de configuração do Claude Desktop. Mescle um dos blocos abaixo no objeto mcpServers existente — substitua a chave de API de exemplo pela sua chave real em Configurações → Integrações → MCP.

Localização do arquivo de configuração

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

Opção A - URL HTTP direta

Use esta opção quando o Claude Desktop suportar MCP remoto via HTTP com cabeçalhos personalizados (típico para endpoints HTTPS hospedados).

claude_desktop_config.json

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

Opção B - mcp-remote via npx

Use esta opção quando precisar de uma ponte stdio para um servidor MCP remoto — comum para desenvolvimento local ou quando o transporte HTTP direto não estiver disponível. O pacote mcp-remote faz a ponte entre o Claude Desktop e seu endpoint MCP HTTP. Para URLs HTTPS de produção, --allow-http é omitido; adicione-o manualmente apenas se apontar para um 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"
      }
    }
  }
}

Após editar a configuração, saia completamente e reabra o Claude Desktop. Confirme se o servidor CISO Adapt aparece na lista de MCP / conectores do Claude.

Verifique a conexão

1. Reinicie o Claude Desktop após instalar a extensão ou editar a configuração.
2. Verifique se cisoadapt aparece como um servidor MCP conectado.
3. Inicie um novo chat e confirme se as ferramentas do CISO Adapt estão disponíveis.

Exemplos de prompts

• "Dê-me um resumo executivo da nossa postura de risco."
• "Quais frameworks de conformidade estamos acompanhando e onde estão as maiores lacunas?"
• "Resuma nossas políticas abertas que precisam de revisão neste trimestre."
• "Liste os riscos de alta severidade atribuídos à minha equipe."

Solução de problemas

Erros de não autorizado ou 401

Confirme se o cabeçalho Authorization é exatamente Bearer mcp_… (incluindo o prefixo Bearer). Regere a chave no CISO Adapt se necessário.

O servidor não aparece no Claude

Valide a sintaxe JSON em claude_desktop_config.json, garanta que o Node.js esteja instalado para a opção npx e reinicie o Claude Desktop completamente.

HTTP local / conexão recusada

Garanta que o backend do CISO Adapt esteja em execução e acessível na sua URL do servidor MCP. Para configurações HTTP localhost, use a Opção B com --allow-http.

Falha no download

Tente novamente o botão de download acima. Se o problema persistir, entre em contato com o administrador do CISO Adapt — o pacote da extensão é servido pelo backend da sua organização.