Respostas diretas sobre o servidor MCP ativo.
O transporte MCP canônico é o endpoint raiz em https://mcp.humandesign.ai/. A autoridade de cálculo continua sendo a API HumanDesign.ai.
O que é Human Design MCP?
É a interface oficial de agentes remotos da HumanDesign.ai. Clientes de IA compatíveis podem usar ferramentas de conta baseadas na assinatura via OAuth ou seis ferramentas de cálculo e referência via chave de API.
Este é um mecanismo de cálculo de Human Design separado?
Não. MCP, Agent HTTP, REST e HumanDesign.ai delegam os cálculos dos gráficos ao mesmo serviço oficial. OAuth e as chaves de API oferecem recursos diferentes, mas as versões dos cálculos e as decisões sobre cotas são centralizadas.
O que torna os dados do gráfico confiáveis?
O serviço valida os dados de nascimento, o local, o fuso horário IANA e o contexto do horário de verão antes do cálculo; retorna um resultado estruturado e versionado e rejeita dados ambíguos ou inválidos antes da cobrança. Os agentes são instruídos a não aproximar a matemática dos gráficos.
Como um agente deve formatar a data e a hora de nascimento?
Como o horário local do relógio: exatamente como aparecia no relógio do local de nascimento, sem Z nem deslocamento UTC, informando o fuso separadamente em timezone como identificador IANA. "birthDateTime": "1990-05-15T14:30:00" com "timezone": "America/New_York" significa duas e meia da tarde em Nova York. Um valor com Z ou deslocamento não especifica sozinho um horário local, e o fuso usado para interpretá-lo altera o gráfico. Nunca converta o horário de nascimento para UTC antes de enviá-lo.
Meu cliente envia Z ou deslocamento UTC. Isso vai causar problemas?
Ainda não. O MCP encaminha o valor e a API ainda o aceita, interpretando-o como UTC e sinalizando a descontinuação na resposta. Esses valores deixarão de ser aceitos, e a data será anunciada com antecedência. A mudança mais segura é usar um horário local sem sufixo e um fuso IANA; para quem não queria dizer UTC, isso também corrige o gráfico.
Quantas ferramentas de cálculo existem?
Seis: resolve_timezone, generate_chart, generate_composite_chart, get_reference_item, get_transits e search_celebrities. O OAuth acrescenta um catálogo de contas filtrado por assinatura, titularidade, função, permissões de recursos derivadas pelo servidor e direitos de acesso.
Quais clientes podem se conectar?
Qualquer cliente MCP compatível com Streamable HTTP pode se conectar. A documentação inclui guias para Claude, ChatGPT, Codex, Cursor e VS Code.
O que consome a cota de cálculo?
generate_chart, generate_composite_chart e get_transits consomem uma unidade quando uma solicitação validada chega ao cálculo. resolve_timezone, get_reference_item, search_celebrities, initialize, ping, tools/list, dados inválidos, acesso negado, consultas à biblioteca, verificações de status e a renderização de um gráfico existente não consomem unidades.
Como funcionam as tentativas seguras de cálculo?
As três ferramentas MCP que consomem cota exigem uma idempotencyKey estável. Reutilize-a somente com os mesmos argumentos normalizados para uma única tentativa planejada. Uma correspondência não consome cota adicional e pode recalcular de forma determinística; não reproduz byte a byte uma resposta armazenada. Chamadas MCP de trânsitos também exigem uma data explícita.
Um membro Free da HumanDesign.ai pode criar um gráfico?
Sim. O OAuth permite que um membro Free visualize uma prévia, confirme, crie, salve, consulte e renderize o próprio gráfico principal. O novo cálculo usa exatamente uma unidade e a renderização não gera uma segunda cobrança.
É possível criar gráficos compostos?
A interface de cálculo com chave de API pode gerar um novo gráfico composto de duas pessoas. Contas OAuth elegíveis podem recuperar e renderizar gráficos compostos salvos e autorizados. O servidor sempre aplica os limites de titularidade e assinatura.
O que acontece quando uma imagem não pode ser exibida em linha?
Antes de confirmar o sucesso, o servidor verifica o PNG ou SVG e também retorna um link seguro de download, válido por pouco tempo, como alternativa.
Onde gerencio o acesso e a cobrança?
Acesse HumanDesign.ai para gerenciar a assinatura da plataforma e o acesso à conta, ou my.humandesign.ai para chaves de API, uso do plano de API e cobrança.
Precisa de ajuda com a conta? Acesse my.humandesign.ai.