ISMS Copilot Docs

Tokens, escopos e segurança

Como funcionam as conexões de login (OAuth) e os tokens pat-isms: o que cada um pode fazer, escopos, desconexão, expiração e limites rígidos.

Um cliente MCP atua como seu usuário de uma de duas formas: você faz login e o aprova (OAuth, o padrão), ou fornece um token de acesso pessoal limitado pelos escopos que selecionou.

Login (OAuth)

Quando você adiciona https://account.ismscopilot.com/v1/account/mcp a um cliente sem cabeçalho, o cliente solicita que você faça login no ISMS Copilot. A página de consentimento mostra o endereço para onde os resultados são enviados e o nome que o aplicativo deu a si mesmo. Aprove apenas se você iniciou a conexão a partir de sua própria ferramenta de IA.

Um Aprovar concede um conjunto fixo:

PodeEscopos
Ler sua conta, workspaces, documentos (metadados), memórias e empresasaccount:read, workspaces:read, documents:read, memories:read, company_context:read
Fazer perguntas ao ISMS Copilot e ler respostasconversations:create
Criar, alterar e excluir empresas e vinculá-las a workspaces ou desvinculá-las, editar memórias e criar workspacescompany_context:write, memories:write, workspaces:write

Uma conexão de login nunca pode criar, listar ou revogar chaves de API, e nunca pode verificar ou comprar créditos de API. Essas ações permanecem exclusivas para tokens. Suas respostas nunca incluem campos de upgrade ou compra, como upgrade_url ou extra_usage_buyable.

As alterações feitas por um aplicativo conectado são identificadas no ISMS Copilot com o nome que o aplicativo registrou: Added by OAuth app: <name> em memórias, Updated by OAuth app: <name> em uma empresa e workspaces. O nome é escolhido pelo próprio aplicativo, portanto, trate-o como uma dica, não como prova. Uma alteração posterior feita pelo aplicativo web ou por um token substitui o rótulo.

Desconectar: Configurações → Aplicativos conectados, em Agentes conectados. A próxima chamada desse aplicativo é recusada e seu token de atualização para de funcionar. Para reconectar, faça login e aprove novamente.

Tokens de acesso pessoal (alternativa)

Use um token para um cliente que não pode fazer login, para CI e máquinas headless, ou quando deseja um conjunto mais restrito de escopos do que o concedido pelo login.

Prefixo e ciclo de vida

EtapaComportamento
CriarConfigurações → Aplicativos conectados → Criar token
ExibirSegredo completo exibido uma vez; começa com pat-isms-
ArmazenarApenas na configuração do cliente; nunca faça commit no git
RevogarMesma página de Configurações; entra em vigor imediatamente
ExpiraçãoOpcional na criação

Escopos (típicos)

Os rótulos exatos na interface podem variar ligeiramente; a intenção é:

Conta

CapacidadeLeituraEscrita / ação
Informações da contasimnão
Workspaceslistar (workspaces:read)criar workspaces pessoais com create_workspace (workspaces:write)
Documentoslistar apenas metadados (sem ferramenta de obtenção por ID)não
Memóriassimcriar / editar quando concedido
Empresaslist_companies, get_company, get_company_context (company_context:read)create_company, update_company, delete_company, link_company_to_workspace, unlink_workspace_company, set_company_context (company_context:write), até o limite de empresas do seu plano
Conversasn/ainiciar e enviar quando concedido

Model API (grupo Aplicativos conectados)

EscopoFinalidade
api_keys:readListar metadados de chaves sk-isms (sem segredos)
api_keys:writeCriar / revogar chaves sk-isms via MCP
api_credits:readLer saldo de créditos pré-pagos da API
api_credits:checkoutCriar uma URL de Checkout do Stripe para recarga (um humano paga no navegador)

Esses escopos não permitem que um pat-isms faça inferência. O orquestrador ainda usa uma chave sk-isms separada para api.ismscopilot.com. Veja Configurar a partir do Claude Code ou Grok.

Conceda o conjunto mínimo para a tarefa do orquestrador. Um token de workspace somente leitura não pode iniciar conversas.

Limites rígidos (por design)

  • A criação de workspace é pessoal e orçada. Um workspace criado por um orquestrador não é compartilhado com sua equipe, não herda a Proteção Avançada de Dados da sua organização e é limitado a 10 novos workspaces a cada 24 horas (cada criação conta, incluindo as feitas pelo aplicativo web e o workspace inicial de uma conta nova). Defina persona, instruções e compartilhamento com a equipe no aplicativo web.
  • Empresas têm nome e limite de plano. Uma empresa é vinculada a zero ou mais workspaces; atualizar uma empresa (update_company ou set_company_context com um workspace_id) substitui os campos que você passar (nome, setor, escala, país da sede, função de privacidade, tipos de dados, região de hospedagem, pilha tecnológica, notas) e atualiza todos os workspaces vinculados a ela de uma vez. link_company_to_workspace e unlink_workspace_company movem o vínculo de um workspace sem alterar os campos da empresa. set_company_context sem workspace_id substitui o padrão no nível da conta. O número de empresas que você pode criar é limitado pelo seu plano.
  • Beyond está disponível quando o orquestrador passa mode: "beyond" (Fast é o padrão). Planos pagos, 10 execuções por dia UTC (50 no Unlimited). Veja Usando o modo Beyond.
  • A Proteção Avançada de Dados não pode ser alternada via token. O orquestrador pode relatar o status; você a altera em Configurações → Proteção de Dados.
  • Limites de taxa se aplicam (na ordem de ~120 solicitações/minuto por token; conversas simultâneas são limitadas por conta). Se atingir os limites, recue e tente novamente.
  • pat-isms sozinho não executa conclusões da Model API. As ferramentas da Model API criam sk-isms e abrem o checkout de créditos; a cobrança do Embed partner permanece separada.

Lista de verificação de segurança

  1. Nomeie tokens por dispositivo ou finalidade (claude-laptop, cursor-ci).
  2. Prefira expiração curta para máquinas temporárias.
  3. Revogue quando um laptop for perdido ou um segredo de CI for rotacionado.
  4. Nunca coloque pat-isms-… em repositórios públicos, capturas de tela ou tickets de suporte.

O uso é contabilizado contra sua assinatura normal de chat e limites do plano, não contra créditos pré-pagos da API. Seu orquestrador ainda lê cada resposta retornada como entrada, portanto, o texto da resposta também é contabilizado no contexto e uso da própria ferramenta que fez a chamada.

Nesta página