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:
| Pode | Escopos |
|---|---|
| Ler sua conta, workspaces, documentos (metadados), memórias e empresas | account:read, workspaces:read, documents:read, memories:read, company_context:read |
| Fazer perguntas ao ISMS Copilot e ler respostas | conversations:create |
| Criar, alterar e excluir empresas e vinculá-las a workspaces ou desvinculá-las, editar 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. 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
| 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 |
| Empresas | list_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 |
| 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 pré-pagos da API |
api_credits:checkout | Criar 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_companyouset_company_contextcom umworkspace_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_workspaceeunlink_workspace_companymovem o vínculo de um workspace sem alterar os campos da empresa.set_company_contextsemworkspace_idsubstitui 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-ismssozinho não executa conclusões da Model API. As ferramentas da Model API criamsk-ismse 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 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.