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 a ele um token de acesso pessoal limitado pelos escopos que você selecionou.

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 serão enviados e o nome que o aplicativo forneceu. Aprove apenas se você iniciou a conexão a partir de sua própria ferramenta de IA.

Um Aprovar concede um conjunto fixo:

Pode	Escopos
Ler sua conta, workspaces, documentos (metadados), memórias e perfil da empresa	`account:read`, `workspaces:read`, `documents:read`, `memories:read`, `company_context:read`
Fazer perguntas ao ISMS Copilot e ler respostas	`conversations:create`
Atualizar o perfil da empresa e memórias, e criar workspaces	`company_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. As respostas também nunca incluem campos de upgrade ou compra, como upgrade_url ou extra_usage_buyable.

As alterações feitas por um aplicativo conectado via login são identificadas no ISMS Copilot com o nome que o aplicativo registrou: Added by OAuth app: <name> nas memórias, Updated by OAuth app: <name> no perfil da 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 será recusada e seu token de atualização deixará 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 máquinas CI e headless, ou quando você deseja um conjunto mais restrito de escopos do que o concedido pelo login.

Prefixo e ciclo de vida

Etapa	Comportamento
Criar	Configurações → Aplicativos conectados → Criar token
Exibir	Segredo completo exibido uma vez; começa com `pat-isms-`
Armazenar	Apenas na configuração do cliente; nunca faça commit no git
Revogar	Mesma página de Configurações; entra em vigor imediatamente
Expiração	Opcional na criação

Escopos (típicos)

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

Conta

Capacidade	Leitura	Escrita / ação
Informações da conta	sim	não
Workspaces	listar (`workspaces:read`)	criar workspaces pessoais com `create_workspace` (`workspaces:write`)
Documentos	listar apenas metadados (sem ferramenta de obtenção por ID)	não
Memórias	sim	criar / editar quando concedido
Contexto da empresa	`get_company_context` (`company_context:read`)	`set_company_context` (`company_context:write`), uma substituição completa do perfil
Conversas	n/a	iniciar e enviar quando concedido

Model API (grupo Aplicativos conectados)

Escopo	Finalidade
`api_keys:read`	Listar metadados de chaves `sk-isms` (sem segredos)
`api_keys:write`	Criar / revogar chaves `sk-isms` via MCP
`api_credits:read`	Ler saldo de créditos de API pré-pagos
`api_credits:checkout`	Criar um 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 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.
As escritas no contexto da empresa são uma substituição completa. set_company_context sobrescreve todo o perfil com os campos que você passar (nome da empresa, setor, escala, país da sede, função de privacidade, tipos de dados, região de hospedagem, pilha tecnológica, notas); um objeto vazio o limpa. Leia primeiro com get_company_context se quiser alterar apenas um campo.
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

Nomeie tokens por dispositivo ou finalidade (claude-laptop, cursor-ci).
Prefira expiração curta para máquinas temporárias.
Revogue quando um laptop for perdido ou um segredo de CI for rotacionado.
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 de 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 de chamada.

Tokens, escopos e segurança

Nesta página