OAuth para sua conta. Chaves de API para cálculos.
O Human Design MCP oferece intencionalmente dois tipos de credenciais com diferentes níveis de acesso. Escolha OAuth para as ferramentas privadas da conta HumanDesign.ai; escolha uma chave de API para a interface original de cálculo e referência.
OAuth do HumanDesign.ai
- Adicione
https://mcp.humandesign.ai/como servidor MCP remoto Streamable HTTP, sem um cabeçalho de autorização estático. - Use a ação Authenticate, Connect,
/mcp, ou de login MCP do cliente. - Entre na página identificada com a marca HumanDesign.ai e revise os limites da conta selecionada e os recursos disponíveis.
- Reconecte-se após mudanças na assinatura, função na área de trabalho, permissão ou autorização.
O acesso OAuth sempre respeita a assinatura e a propriedade. Contas Free e Individual podem criar, salvar, visualizar e renderizar o próprio gráfico principal; Individual também inclui visibilidade do uso da conta. Personal ou Pro é necessário para acessar gráficos autorizados de outras pessoas e recursos mais amplos da plataforma.
Acesso a cálculos por chave de API
As chaves de API Bearer e X-Api-Key continuam compatíveis com as seis ferramentas de cálculo e referência. Elas não expõem dados da conta, biblioteca, relatórios ou Builder.
Authorization: Bearer $HDAI_API_KEY
# or
X-Api-Key: $HDAI_API_KEYSegurança de credenciais
- Os tokens OAuth são tratados pelo cliente MCP e pelo serviço de autorização; nunca os cole em prompts ou arquivos de origem.
- Armazene chaves de API em uma variável de ambiente ou em um gerenciador seguro de segredos.
- Nunca registre cabeçalhos de autorização, tokens de atualização, chaves de API, URLs de recursos assinadas ou resultados estruturados de gráficos privados.
- Desconecte o conector ou limpe a autenticação MCP para revogar o acesso delegado.
- Gerencie as chaves de API e o uso do plano de cálculos em my.humandesign.ai.
Erros de autenticação
| Código | Significado | Ação |
|---|---|---|
401 | Credencial ausente, malformada, expirada ou revogada | Faça login OAuth novamente no cliente ou restaure a configuração protegida da chave de API. |
403 | Origem, concessão de recurso, assinatura, função, propriedade ou permissão negada | Revise os limites da conta; reconecte-se após uma alteração de acesso aprovada. |
429 | A cota de cálculos ou o limite seguro de solicitações foi atingido | Revise o uso; não tente novamente em rápida sucessão. |