Anslut till HumanDesign.ai MCP
Innan du börjar
HumanDesign.ai MCP ger kompatibla AI-klienter strukturerade Human Design-verktyg. Den här guiden tar upp beräknings- och referenskatalogen som använder en API-nyckel. Om din klient stöder HumanDesign.ai OAuth-anslutningen använder du den när du behöver kontokopplad åtkomst, till exempel sparade plattformsdata. OAuth-behörigheter och tillgänglighet väljs vid inloggning.
Den kanoniska MCP-slutpunkten är https://mcp.humandesign.ai/ . Använd POST / för MCP-förfrågningar. GET / är inte ett anslutningstest och returnerar 405 Method Not Allowed. POST /mcp är ett kompatibilitetsalias.
Lägg till API-nyckeln på ett säkert sätt
Använd ett av dessa förfrågningshuvuden. Lägg inte en API-nyckel i en URL, checka inte in den i ett kodarkiv och klistra inte in den i en chatt.
Authorization: Bearer YOUR_HDAI_API_KEY
eller:
X-Api-Key: YOUR_HDAI_API_KEY
Anslut och hitta dina verktyg
- Konfigurera din MCP-klient med
https://mcp.humandesign.ai/. - Skicka
initializemed protokollversion2025-11-25. - Skicka
notifications/initialized. - Anropa
tools/listoch använd endast de verktyg som returneras för din nyckel.
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": { "name": "your-client", "version": "1.0.0" }
}
}
Upptäcktsanrop som initialize, ping, och tools/list förbrukar ingen beräkningskvot. Ett lyckat tools/call förbrukar en gemensam API-enhet; valideringsfel och otillgängliga verktyg gör det inte.
Anropa ett verktyg
Använd verktygsnamnet och indataschemat som returneras av tools/list . Ett grundläggande diagramanrop ser till exempel ut så här:
{
"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"
}
}
}
Läs resultatet
Lyckade anrop returnerar en kort, lättläst sammanfattning, ett JSON-textblock och structuredContent . Det strukturerade svaret använder ett versionshanterat kuvert med version, tool, data, metaoch ett valfritt error -fält.
Den aktuella beräknings- och referenskatalogen exponerar endast verktyg. Förvänta dig inte MCP-prompter, MCP-resurser, verktyg för rapportgenerering, serversessioner eller bildblock med diagram från den här katalogen.