Conecte‑se ao MCP da HumanDesign.ai
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
- Configure seu cliente MCP com
https://mcp.humandesign.ai/. - Envie
initializecom a versão do protocolo2025-11-25. - Envie
notifications/initialized. - Chame
tools/liste 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.