Conectar o ISMS Copilot ao Claude Code

Claude faz o trabalho. ISMS Copilot é o especialista em conformidade que ele consulta e verifica o trabalho. Você decide e assina.

Você pode usar sua conta do ISMS Copilot diretamente do Claude Code, Cursor ou qualquer ferramenta de IA compatível com MCP. Uma vez conectado, sua ferramenta de IA pode listar seus workspaces e documentos, ler suas memórias e manter conversas reais do ISMS Copilot, agindo como você e coberta pela sua assinatura existente.

O que você precisa

• Uma conta do ISMS Copilot. A conexão é coberta pela sua assinatura, sem cobrança separada.
• Um terminal com o Claude Code (ou outro cliente MCP) instalado.
• Algumas capacidades dependem do seu plano (veja Escolhendo como ele responde).

Conecte em três passos

Já está conectado com um token de acesso pessoal? Remova esse servidor primeiro, caso contrário, o Claude Code continuará usando-o: claude mcp remove ismscopilot.

1. Adicione o servidor (nenhum token necessário):

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

2. Em uma sessão do Claude Code, execute /mcp, escolha ismscopilot e siga as etapas no seu navegador. Pelo terminal, claude mcp login ismscopilot faz o mesmo.
3. Faça login no ISMS Copilot e clique em Aprovar na página de consentimento.

Depois, pergunte, por exemplo, "liste meus workspaces do ISMS Copilot."

claude.ai e Claude Desktop conectam-se ao mesmo URL do servidor com o mesmo login: veja Conectar qualquer cliente MCP. ChatGPT conecta-se da mesma forma, como um aplicativo MCP personalizado: veja a mesma página. Para Cursor e Codex, veja Conectar Cursor e Codex.

Fallback: conectar com um token de acesso pessoal

Use um token quando o login não for possível, por exemplo, em CI ou em uma máquina headless:

1. No ISMS Copilot, abra Configurações, depois Aplicativos conectados.
2. Clique em Criar token. Dê um nome (por exemplo, "Claude Code CI"), escolha as permissões que ele deve ter (veja Permissões) e copie o token. Você só o verá uma vez.
3. Cole o comando exibido no seu terminal. Ele se parece com isto:

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

O que sua ferramenta de IA pode fazer

Uma conexão pode ler e fazer o seguinte, e nada mais. Uma conexão por login obtém todas as linhas abaixo; um token obtém as linhas que suas permissões cobrem:

Assim, a partir da sua ferramenta de IA, você pode listar seus workspaces e documentos, criar um workspace pessoal, adicionar ou editar uma memória e manter uma conversa fundamentada do ISMS Copilot, tudo sem sair do seu editor.

Escolhendo como ele responde (Fast, Think e Beyond)

O servidor não escolhe um modo. Seu orquestrador usa Fast por padrão, Think para verificações e análises em várias etapas, e Beyond sob solicitação, para uma verificação final logo antes de uma auditoria ou para rascunhos longos de nível de pesquisa. Se o orquestrador omitir mode, o ISMS Copilot usa Fast.

• Fast (padrão): respostas rápidas, sem raciocínio estendido.
• Think: raciocínio mais profundo para verificações e análises em várias etapas. Apenas planos pagos. Em um plano gratuito, uma solicitação Think recai para Fast.
• Beyond: plano, rascunho e verificação em várias etapas. Apenas planos pagos, 10 execuções por dia UTC (50 no Unlimited). Escala de minutos. O orquestrador deve passar mode: "beyond" em create_conversation ou send_message, depois consultar get_reply a cada 10-20 segundos até que a execução seja concluída. Se o Beyond não puder ser executado, a resposta é dada pelo fluxo normal e inclui beyond_denied_reason.

Na prática:

• “Pense cuidadosamente sobre isso” é suficiente para Think.
• “Use Beyond” ou “execute isso no Beyond” é suficiente para Beyond. Sem isso, o orquestrador ainda pode escolher Beyond para uma verificação final logo antes de uma auditoria ou para rascunhos longos de nível de pesquisa.

Uma resposta Fast ou Think que não estiver pronta inline retorna status: "generating". O orquestrador então consulta get_reply a cada 2-5 segundos até que retorne complete.

Veja Usando o modo Beyond.

Se você atingir um limite de uso

Conexões por login (Claude, ChatGPT): o texto de erro informa o limite e quando ele é redefinido, sem convite para upgrade. O JSON carrega reset_at, mas nunca upgrade_url, usage_url ou extra_usage_buyable. Os campos de upgrade e compra descritos abaixo aparecem apenas em conexões com token de acesso pessoal.

A conexão usa o mesmo limite de uso que o aplicativo de chat: a cota do seu plano, com o horário de redefinição mostrado no aplicativo. Se create_conversation ou send_message atingir o limite, a primeira mensagem de erro é a frase de espera ou upgrade (incluindo o próximo horário de redefinição) e o bloco JSON inclui reset_at. Contas individuais e proprietários de organizações também recebem upgrade_url. Membros de organizações recebem a frase da equipe: peça ao proprietário para obter uso extra ou espere até a próxima janela de 4 horas. Seu JSON carrega quota_scope, org_role e extra_usage_buyable, e nenhum link de upgrade.

Você pode:

1. Esperar até reset_at.
2. Abrir upgrade_url em um navegador enquanto estiver logado na mesma conta do ISMS Copilot (contas individuais e proprietários de organizações).
3. Quando o JSON carregar fallback_available: true e o overflow do seu plano estiver disponível (contas pagas individuais com Advanced Data Protection desativado; nunca em um pool de equipe), peça ao orquestrador para continuar: com sua aprovação explícita, ele reenvia com overflow_consent: true e a resposta é executada no mesmo overflow de até 2x que o aplicativo web oferece (a resposta carrega overflow_active: true).
4. Continuar usando ferramentas de leitura. Workspaces, memórias, documentos e informações da conta ainda funcionam após o limite de chat.

Veja O que fazer quando você atinge seu limite de uso.

Configurações permanecem no aplicativo web

Configurações protegidas da conta são somente leitura a partir da conexão (empresas, acima, são a exceção: uma conexão por login, ou um token com company_context:write, pode criá-las, alterá-las e excluí-las e vinculá-las a workspaces ou desvinculá-las, até o limite do seu plano). Em particular, Advanced Data Protection (que roteia seus dados por meio de um provedor baseado na UE com retenção zero) não pode ser ativado ou desativado a partir da sua ferramenta de IA.

Se você perguntar à sua ferramenta de IA sobre Proteção de Dados, ela pode informar se está ativada para sua conta e indicará Configurações, Proteção de Dados em chat.ismscopilot.com para alterá-la. Isso é deliberado: um token de conexão não deve ser capaz de alterar uma configuração global de residência de dados.

Permissões

Quando você faz login e clica em Aprovar, a ferramenta obtém um conjunto fixo: ler sua conta, workspaces, documentos (metadados), memórias e empresas; perguntar ao ISMS Copilot, ler respostas e marcar uma resposta parada como falha; criar, alterar e excluir empresas e vinculá-las a workspaces ou desvinculá-las, editar memórias e criar workspaces. Ela não pode criar chaves de API ou comprar créditos. As alterações feitas são rotuladas no ISMS Copilot com o nome da ferramenta, como Added by OAuth app: <name> ou Updated by OAuth app: <name>.

Quando você cria um token, escolhe exatamente o que ele pode fazer (ler workspaces, ler documentos, ler e gravar memórias, iniciar conversas, etc.). Conceda apenas o que for necessário. Um token que só lê seus workspaces não pode alterar suas memórias ou iniciar conversas.

Você pode ver e desconectar todas as conexões a qualquer momento em Configurações, Aplicativos conectados: tokens na lista de tokens, conexões por login em Agentes conectados.

Reconectar ou rotacionar um token

Se uma conexão por login parar de funcionar (por exemplo, depois de desconectá-la), execute /mcp, escolha ismscopilot e faça login novamente.

Se você se conectou com um token e deseja mudar para um novo, remova o servidor existente primeiro. Caso contrário, o Claude Code manterá o token antigo:

claude mcp remove ismscopilot

Em seguida, adicione o servidor novamente, com login ou com o novo token.

Segurança

• Uma conexão age como você, portanto, pode acessar exatamente o que sua conta já pode acessar, limitado pelo que você aprovou ou pelas permissões que concedeu.
• Ela é coberta pela sua assinatura, sem cobrança separada.
• Você pode desconectá-la a qualquer momento em Configurações, Aplicativos conectados. A desconexão entra em vigor imediatamente.
• Trate um token como uma senha. Se um for exposto, revogue-o e crie um novo.

Solução de problemas

• Conectado, mas as ferramentas não aparecem: execute novamente o comando de conexão com --scope user ou execute claude mcp remove ismscopilot e adicione-o novamente.
• Falha de autenticação ou "precisa de autenticação": uma conexão por login foi desconectada ou expirou: execute /mcp e faça login novamente. Um token pode ter sido revogado ou expirado: crie um novo em Configurações, Aplicativos conectados.
• O modo Think não parece mais profundo: Think requer um plano pago. Em um plano gratuito, ele recai para Fast.
• Beyond foi executado como uma resposta normal: o orquestrador provavelmente omitiu mode. Peça para enviar mode: "beyond" ou diga “use Beyond” na próxima resposta. Verifique beyond_denied_reason se uma solicitação Beyond foi rebaixada.