Uma conexão MCP, quatro interfaces para agentes.
Use diretamente o endpoint hospedado, baixe os arquivos de projeto do Claude Code ou instale o pacote de plugins em dois formatos preparado para Claude Code e para o sistema universal de plugins ChatGPT/Codex.
Claude Code: configuração mais rápida
CLAUDE.md é um guia, não um instalador. É necessário estar conectado ao próprio Claude Code, e um projeto .mcp.json precisa ser considerado confiável antes de iniciar o OAuth do MCP.
- Abra a pasta do projeto e execute
claude. - Se o Claude Code informar que você está desconectado, execute
/login. - Aprove o projeto e seu
.mcp.jsonquando solicitado. - Execute
/mcp, selecionehuman-design-aie conclua o OAuth do HumanDesign.ai.
Como alternativa, depois de entrar no Claude Code, adicione a conexão no escopo do usuário:
claude mcp add --transport http --scope user human-design-ai https://mcp.humandesign.ai/
claude mcp login human-design-aiPara compartilhar um projeto, salve o seguinte como .mcp.json na pasta raiz do projeto.
.mcp.json
{
"mcpServers": {
"human-design-ai": {
"type": "http",
"url": "https://mcp.humandesign.ai/"
}
}
}Claude.ai e Claude Desktop
- Abra Personalizar → Conectores.
- Selecione Adicionar conector personalizado.
- Use
https://mcp.humandesign.ai/como URL do MCP remoto. - Selecione Conectar e conclua o OAuth do HumanDesign.ai.
- Ative o HumanDesign.ai no menu de conectores durante uma conversa.
Os responsáveis pelas organizações Team e Enterprise adicionam o conector primeiro nas configurações da organização; depois, cada membro conecta sua própria conta HumanDesign.ai.
Codex
~/.codex/config.toml
[mcp_servers.human_design_ai]
url = "https://mcp.humandesign.ai/"
auth = "oauth"
startup_timeout_sec = 30
tool_timeout_sec = 60Autenticar
codex mcp login human_design_aiChatGPT
- Ative o modo de desenvolvedor em Configurações → Segurança e login.
- Abra Plugins, selecione o botão de adição e insira a URL remota do MCP
https://mcp.humandesign.ai/. - Analise as ferramentas descobertas e conclua o OAuth.
- Ative a conexão em uma nova conversa do Work e teste primeiro alguns prompts representativos somente para leitura.
O que o plugin inclui
O pacote contém manifestos de plugin para Claude e OpenAI, a definição do MCP remoto, recursos visuais da marca e uma habilidade de fluxo de trabalho que ensina o agente a usar gráficos individuais e gráficos compostos de relacionamento salvos, renderizar bodygraphs autorizados, respeitar os limites de Free/Individual/Personal/Pro e tratar confirmações, idempotência e segredos com segurança.
Gráficos compostos de relacionamento
Com OAuth, membros Personal e Pro podem recuperar e renderizar gráficos compostos salvos aos quais têm acesso. Criar um novo composto a partir de dois conjuntos de dados de nascimento usa a interface de cálculo separada e, por isso, requer uma chave de API protegida do HumanDesign.ai; após a validação, consome uma unidade de cálculo. O servidor ativo sempre aplica as regras de propriedade, consentimento, assinatura, tipo de credencial e cota.
Por que conectar uma assinatura?
Free oferece a todos os membros um ponto de partida confiável com o próprio gráfico, enquanto Individual acrescenta visibilidade do uso da conta dentro desse mesmo limite. Personal amplia o acesso a gráficos autorizados, biblioteca de compostos salvos, relatórios próprios, profissionais, aprendizado comunitário e conexões com pessoas que exploram padrões de design semelhantes. Pro expande isso para áreas de trabalho profissionais. As ferramentas do Website Builder só aparecem quando o HumanDesign.ai habilita o Builder para sua conta e quando tools/list as anuncia. As assinaturas HumanDesign.ai também oferecem uma experiência mais completa na plataforma, incluindo recursos de trânsito elegíveis; a ferramenta de cálculo do MCP get_transits exige separadamente uma chave de API Startup ou superior. As orientações baixáveis para agentes são neutras: explicam uma autorização ausente uma única vez e seguem o catálogo ativo, sem inserir promoções repetidas de upgrade nas conversas.
Instalar um plugin não contorna a autorização do HumanDesign.ai. O servidor retorna apenas as ferramentas permitidas pela conta conectada. Nunca cole um token OAuth ou chave de API em um prompt.