HumanDesign.aiPersonalAbrir app ↗
PARA VOCÊCentral de ajuda

Conecte‑se ao MCP da HumanDesign.ai

APIAtualizado em 28 de ago. de 2026Leitura de 2 min

Antes de começar

O MCP da HumanDesign.ai oferece ferramentas estruturadas de Human Design para clientes de IA compatíveis. Este guia aborda o catálogo de cálculos e referências que usa uma chave de API. Se seu cliente for compatível com a conexão OAuth da HumanDesign.ai, use esse fluxo quando precisar de acesso conectado à conta, como dados salvos na plataforma; as permissões e a disponibilidade do OAuth são escolhidas durante o login.

O endpoint MCP canônico é https://mcp.humandesign.ai/. Use POST / para solicitações MCP. GET / não é um teste de conexão e retorna 405 Method Not Allowed. POST /mcp é um alias de compatibilidade.

Adicione sua chave de API com segurança

Use um destes cabeçalhos de solicitação. Não inclua uma chave de API em uma URL, não a envie para um repositório nem a cole em um chat.

Authorization: Bearer YOUR_HDAI_API_KEY

ou:

X-Api-Key: YOUR_HDAI_API_KEY

Conecte-se e descubra suas ferramentas

  1. Configure seu cliente MCP com https://mcp.humandesign.ai/.
  2. Envie initialize com a versão do protocolo 2025-11-25.
  3. Envie notifications/initialized.
  4. Chame tools/list e use somente as ferramentas retornadas para sua chave.
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": { "name": "your-client", "version": "1.0.0" }
  }
}

Chamadas de descoberta como initialize, ping, e tools/list não consomem cota de cálculo. Uma chamada tools/call bem-sucedida consome uma unidade compartilhada da API; erros de validação e ferramentas indisponíveis não consomem.

Chame uma ferramenta

Use o nome da ferramenta e o esquema de entrada retornado por tools/list. Por exemplo, uma solicitação de mapa essencial tem este formato:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "generate_chart",
    "arguments": {
      "birthDateTime": "1990-05-15T14:30:00",
      "timezone": "America/New_York",
      "detailLevel": "core"
    }
  }
}

Leia o resultado

Chamadas bem-sucedidas retornam um resumo legível curto, um bloco de texto JSON e structuredContent. A resposta estruturada usa um envelope versionado com version, tool, data, metae um campo opcional error .

O catálogo atual de cálculos e referências oferece somente ferramentas. Não espere prompts MCP, recursos MCP, ferramentas de geração de relatórios, sessões de servidor ou blocos de imagem de mapas neste catálogo.

Voltar ao topo ↑Precisa de ajuda? Fale com o suporte ↗

Encontre sua próxima resposta.