Conectar qualquer cliente MCP

claude.ai, Claude Desktop, Claude Code e ChatGPT conectam-se por login: adicione o URL do servidor sem cabeçalho, faça login no ISMS Copilot quando o cliente solicitar e clique em Aprovar. Não há token para copiar. Outros clientes usam um token de acesso pessoal (seção 3).

1. Endpoint

https://account.ismscopilot.com/v1/account/mcp

Transporte: HTTP MCP. Autenticação: faça login no ISMS Copilot e aprove (OAuth). Fallback: Authorization: Bearer pat-isms-…

2. Passos do cliente

claude.ai e Claude Desktop (conector personalizado)

Estes passos são do claude.ai. O Claude Desktop usa os mesmos conectores da sua conta Claude.

1. No Claude, abra Personalizar → Conectores, clique em + Adicionar e depois em Adicionar conector personalizado.
2. Nomeie-o como ISMS Copilot, cole o endpoint acima como o URL do servidor MCP remoto e continue.
3. Deixe os campos avançados de OAuth vazios e não adicione cabeçalhos de requisição.
4. Clique em Adicionar e depois em Conectar. Faça login no ISMS Copilot e clique em Aprovar.

Em uma organização Claude Team ou Enterprise, um Owner adiciona o conector uma vez em Configurações da organização → Conectores (Adicionar, depois Personalizado, depois Web). Cada membro então o encontra em Personalizar → Conectores e clica em Conectar, fazendo login com sua própria conta do ISMS Copilot. Ninguém age em nome de outra pessoa.

ChatGPT (app MCP personalizado)

O ChatGPT conecta-se por login com as configurações padrão. O ISMS Copilot não está listado no diretório de apps do ChatGPT: adicione-o você mesmo como app personalizado.

1. Nas configurações do ChatGPT, ative o modo de desenvolvedor (nas versões recentes, fica junto às configurações de apps). Em workspaces Business e Enterprise, um administrador pode precisar permitir primeiro os apps MCP personalizados.
2. Crie um app personalizado (o ChatGPT pode chamá-lo de conector), dê o nome ISMS Copilot e cole o endpoint acima como URL do servidor MCP.
3. Escolha OAuth como autenticação e mantenha as configurações padrão.
4. Crie-o e conecte: faça login no ISMS Copilot e clique em Aprovar.

Os nomes dos menus do ChatGPT mudam entre planos e versões. Os passos atuais da OpenAI: Developer mode and MCP apps in ChatGPT.

Claude Code

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

Em seguida, execute /mcp em uma sessão, escolha ismscopilot, faça login e clique em Aprovar. Tutorial completo: Conectar ISMS Copilot ao Claude Code.

Cursor e Codex

Use um token de acesso pessoal: formatos de configuração em Conectar Cursor e Codex. Eles também podem se conectar com login onde o cliente suporta MCP OAuth.

Qualquer outro cliente

Adicione um servidor MCP HTTP remoto com o endpoint acima e um token de acesso pessoal (seção 3). Um cliente que suporta login MCP também pode se conectar sem token.

O que você aprova

O cliente pode ler sua conta, workspaces, documentos (metadados), memórias e perfil da empresa; perguntar ao ISMS Copilot e ler respostas; atualizar o perfil da empresa e memórias, e criar workspaces. Não pode criar chaves de API ou comprar créditos. As alterações feitas são identificadas no ISMS Copilot como Added by OAuth app: <name> ou Updated by OAuth app: <name>, com o nome registrado pelo cliente. Desconecte-o a qualquer momento em Configurações → Aplicativos conectados, em Agentes conectados.

3. Token de acesso pessoal

Para Cursor, Codex e outros clientes que não fazem login, ou para CI e máquinas headless:

1. Em chat.ismscopilot.com, abra Configurações → Aplicativos conectados → Criar token. Copie o valor pat-isms-… uma vez.
2. Adicione o servidor com o cabeçalho Authorization: Bearer pat-isms-…. Claude Code:

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

Mantenha --scope user para que o servidor esteja disponível em todas as pastas. Configurações de token para Cursor e Codex: Conectar Cursor e Codex.

4. Modos (Fast, Think, Beyond)

create_conversation e send_message aceitam mode opcional:

Um turno Fast ou Think que retorna status: "generating" é mais curto: consulte get_reply a cada 2-5 segundos.

A conexão não escolhe automaticamente um modo a partir da pergunta. Peça ao agente para “usar Beyond” quando quiser esse caminho. Detalhes: Usando o modo Beyond.

5. Teste rápido

Peça ao agente para listar seus workspaces do ISMS Copilot. Se as ferramentas não aparecerem, reinicie o cliente após adicionar o servidor, verifique se concluiu o login e clicou em Aprovar ou, com um token, confirme que ele não foi truncado ao colar.

Se atingir um limite de uso

Conexões de login (Claude, ChatGPT): o texto de erro informa o limite e quando ele é redefinido, sem convite para upgrade. O JSON inclui 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 um token de acesso pessoal.

A conexão usa a mesma janela de sessão UTC de 4 horas que o aplicativo de chat. Se create_conversation ou send_message atingir o limite, o primeiro texto 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 owners de organização também recebem upgrade_url. Membros de organização recebem a frase da equipe: peça ao owner para obter uso extra ou espere até a próxima janela de 4 horas. Seu JSON inclui quota_scope, org_role e extra_usage_buyable, e nenhum link de upgrade.

Espere até reset_at ou abra upgrade_url em um navegador enquanto estiver logado na mesma conta do ISMS Copilot (contas individuais e owners de organização). Quando o JSON incluir fallback_available: true e o overflow do seu plano estiver disponível (contas individuais pagas com Advanced Data Protection desativado; nunca em um pool de equipe), você também pode pedir ao agente para continuar: com sua autorização explícita, ele reenvia com overflow_consent: true e o turno é executado no mesmo overflow de até 2x que o aplicativo web oferece (a resposta inclui overflow_active: true). Ferramentas de leitura ainda funcionam após o limite de chat.

Veja O que fazer quando atingir seu limite de uso.

6. Desconectar ou rotacionar

Desconecte uma conexão por login em Configurações → Aplicativos conectados, em Agentes conectados. A próxima chamada desse cliente será recusada até que você faça login e aprove novamente.

Para um token, remova o servidor e adicione-o novamente com um novo token:

claude mcp remove ismscopilot

Sempre revogue o token antigo em Configurações se ele puder ter vazado.