HumanDesign.aiPersonalBuksan ang app ↗
PARA SA IYOHelp center

Kumonekta sa HumanDesign.ai MCP

APINa-update noong 28 Agosto 20262 minutong basahin

Bago magsimula

Nagbibigay ang HumanDesign.ai MCP ng nakaayos na Human Design tool para sa mga compatible na AI client. Saklaw ng gabay na ito ang catalog ng kalkulasyon at reference na gumagamit ng API key. Kung sinusuportahan ng client mo ang koneksyon ng HumanDesign.ai OAuth, gamitin ang daloy na iyon kapag kailangan mo ng access na konektado sa account, gaya ng naka-save na data sa platform; pinipili ang mga pahintulot at availability ng OAuth habang nag-sign in.

Ang canonical MCP endpoint ay https://mcp.humandesign.ai/. Gamitin ang POST / para sa mga MCP request. GET / hindi pagsubok ng koneksyon at nagbabalik ito ng 405 Method Not Allowed. POST /mcp ay compatibility alias.

Idagdag nang ligtas ang API key mo

Gamitin ang isa sa mga request header na ito. Huwag maglagay ng API key sa URL, mag-commit nito sa repository o i-paste sa chat.

Authorization: Bearer YOUR_HDAI_API_KEY

o:

X-Api-Key: YOUR_HDAI_API_KEY

Kumonekta at tuklasin ang mga tool mo

  1. I-configure ang MCP client mo gamit ang https://mcp.humandesign.ai/.
  2. Ipadala initialize na may protocol version 2025-11-25.
  3. Ipadala notifications/initialized.
  4. Tawagin ang tools/list at gamitin lang ang mga tool na ibinalik para sa key mo.
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": { "name": "your-client", "version": "1.0.0" }
  }
}

Hindi kumokonsumo ng calculation quota ang mga discovery call gaya ng initialize, ping, at tools/list Hindi gumagamit ng tools/call ng isang pinagsasaluhang API unit ang matagumpay na tawag; walang ginagamit ang mga pagkabigo sa validation at hindi available na tool.

Tumawag ng tool

Gamitin ang pangalan ng tool at input schema na ibinalik ng tools/list. Halimbawa, ganito ang hugis ng kahilingan para sa core chart:

{
  "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"
    }
  }
}

Basahin ang resulta

Nagbabalik ang matagumpay na tawag ng maikling buod na madaling basahin, JSON text block at structuredContent. Gumagamit ang nakaayos na tugon ng versioned na envelope na may version, tool, data, meta, at opsyonal na field na error .

Mga tool lang ang inilalantad ng kasalukuyang calculation/reference catalog. Huwag umasa ng MCP prompt, MCP resource, tool sa pagbuo ng ulat, server session o chart image block mula sa catalog na ito.

Bumalik sa itaas ↑Kailangan ng tulong? Makipag-ugnayan sa support ↗

Hanapin ang susunod mong sagot.