Você autoriza recursos, não uma nova função na área de trabalho.
O OAuth permite que Claude, Codex ou ChatGPT atuem como o usuário conectado do HumanDesign.ai. Ele não cria acesso, altera a assinatura nem concede ao agente a propriedade de uma área de trabalho.
O que significa selecionar uma área de trabalho
A tela de consentimento pergunta “Onde Claude deve trabalhar?” porque uma conta paga pode ter uma biblioteca pessoal e uma ou mais áreas de trabalho de equipe ou empresa. A escolha define o limite dos dados, não é uma permissão adicional da assinatura. Cada chamada ainda verifica a assinatura, a função, as concessões de recursos, a propriedade e as permissões do produto. Autorizar o Builder se aplica aos projetos elegíveis dentro desse limite; os projetos não exigem concessões OAuth separadas.
Contas Free e Individual: não têm seletor de área de trabalho. A conexão fica limitada à conta pessoal e ao próprio gráfico principal do usuário; o Individual também inclui o uso da conta. Personal ou Pro é necessário para acessar gráficos de outras pessoas e ferramentas mais amplas da plataforma.
Para manter o consentimento claro, Personal e Pro exibem uma permissão combinada de Gráficos e biblioteca em vez de caixas de seleção sobrepostas para “seu gráfico” e “biblioteca”. No limite Personal, ela inclui o gráfico principal e a biblioteca permitida; em uma área de trabalho selecionada, restringe-se aos gráficos e compostos autorizados naquela área.
Escopos de identidade e concessões de recursos
O protocolo OAuth solicita apenas escopos de identidade e sessão, como email, profile, e offline_access. Após o login, o HumanDesign.ai deriva as seguintes concessões internas de recursos com base no limite da conta selecionada, assinatura, função, propriedade e permissões. São rótulos de aplicação de políticas, não escopos OAuth adicionais que um cliente possa solicitar para contornar a assinatura.
| Concessão de recurso | Permite |
|---|---|
charts:read | Ler registros de gráficos autorizados |
charts:generate | Criar o gráfico principal do usuário conectado após prévia e confirmação |
library:read | Pesquisar e recuperar itens permitidos da biblioteca |
library:organize | Gerenciar pastas e a organização dos itens |
reports:read | Ler modelos, relatórios e status de geração |
builder:read | Ler projetos e execuções do Builder autorizados |
builder:write | Cancelar uma execução ativa do Builder quando permitido |
account:usage | Ler saldos, cota e resumo de uso |
O que aparece no agente
tools/list é filtrado pelas concessões de recursos atuais do usuário autenticado, assinatura, função na área de trabalho, propriedade e permissões. Alterações de plano, função e concessões revogadas passam a valer após reconexão ou renovação do token. O status das operações e seu cancelamento também verificam novamente o recurso que autorizou a operação original, para que a remoção de uma permissão não mantenha acessível um trabalho anterior pelas ferramentas de operação.
Confirmação e efeitos externos
Quando uma ferramenta oferece prévia ou confirmação, a confirmação fica vinculada ao responsável, limite, ação, argumentos, destino, valor máximo e prazo de validade. Alterar qualquer um desses dados a invalida. A criação do gráfico principal usa uma prévia de uma unidade e confirmação; a exclusão de uma pasta da biblioteca também exige confirmação. O cancelamento de operações e execuções do Builder só é executado diretamente quando o estado atual permite cancelamento. Ações de publicação e entrega de maior risco permanecem indisponíveis nesta versão.
Revogar acesso
Desconecte o HumanDesign.ai nas configurações do conector do cliente ou limpe a autenticação MCP. A revogação encerra a conexão delegada; não exclui dados do HumanDesign.ai nem altera a assinatura.