HumanDesign.aiPersonalÖppna appen ↗
FÖR DIG SJÄLVHjälpcenter

Anslut till HumanDesign.ai MCP

APIUppdaterad 28 aug. 20262 min läsning

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

  1. Konfigurera din MCP-klient med https://mcp.humandesign.ai/.
  2. Skicka initialize med protokollversion 2025-11-25.
  3. Skicka notifications/initialized.
  4. Anropa tools/list och 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.

Till toppen ↑Behöver du hjälp? Kontakta support ↗

Hitta ditt nästa svar.