HumanDesign.aiMCPBuksan ang app ↗
PARA SA IYONG AIDokumentasyon
Mabilisang pagsisimula

Ikonekta ang agent mo sa apat na hakbang.

Para sa Claude, ChatGPT o Codex, inirerekomendang gumamit ng OAuth dahil ligtas nitong nailalantad ang mga tool ng HumanDesign.ai na pinapayagan para sa naka-sign-in na user.

1. Idagdag ang naka-host na endpoint

Endpoint

https://mcp.humandesign.ai/

Pumili ng remote HTTP o Streamable HTTP. Huwag idagdag muli ang /mcp dahil root ng domain ang canonical endpoint.

2. Mag-authenticate

Gamitin ang MCP Authenticate o Connect na aksyon ng client at kumpletuhin ang pag-login sa browser ng HumanDesign.ai. Maaaring patakbuhin ng mga user ng Claude Code ang claude mcp login human-design-ai; maaaring patakbuhin ng mga user ng Codex ang codex mcp login human_design_ai.

Kung kailangan mo lang ng anim na calculation/reference tool, maaari ka pa ring gumamit ng API key sa pamamagitan ng Bearer o X-Api-Key authentication.

3. Tuklasin ang mga tool mo

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {}
}

Libre ang discovery. Nakabatay ang visibility ng OAuth tool sa capability grant na galing sa server, membership na Free/Individual/Personal/Pro, role sa workspace, pagmamay-ari at entitlement ng produkto ng user. Nakabatay naman ang visibility ng API key sa hiwalay na Free/Creator/Startup/Business API plan.

4. Magsimula sa pangunahing chart mo

Hilingin sa agent na tawagin ang chart_get_primary. Kung wala pang pangunahing chart, maaaring gamitin ng mga miyembro ng Free, Individual, Personal at Pro ang chart_generate: suriin muna ang na-normalize nitong mga detalye ng kapanganakan at preview na isang unit, pagkatapos ay kumpirmahin ang pagpapatakbo. Hinahanap ang naka-save na chart batay sa pagmamay-ari ng account, hindi sa paghahanap ng pangalang gaya ng “Kyle” o “My Chart.” Kailangan ang Personal o Pro para basahin ang mga awtorisadong chart ng ibang tao.

Koneksyon, initialize, ping, tools/list, pagbabasa sa library, pagsusuri ng status at pag-render ng dati nang chart ay hindi gumagastos ng credit. Gumagamit ng eksaktong isang calculation unit ang bagong kalkulasyon ng pangunahing chart; walang pangalawang singil sa pag-render nito.

Paano gumagana ang pagiging mapagkakatiwalaan ng kalkulasyon

Hindi mismo nagkakalkula ng chart ang agent. Bine-validate ng HumanDesign.ai ang petsa, lokasyon, IANA timezone at konteksto ng daylight-saving bago gumamit ng quota, pagkatapos ay ibinabalik ang versioned na resulta mula sa calculation service nito. Nagbabalik ng malinaw na error ang malabong lokasyon at maling input nang hindi gumagastos ng unit. Kung hindi alam ang oras ng kapanganakan, itinatala ng serbisyo na ginamit nito ang lokal na tanghali at nagbababala na maaaring magkaiba ang mga detalyeng sensitibo sa oras.

Ligtas na muling pagsubok ng kalkulasyon

Ang mga MCP tool na gumagamit ng quota generate_chart, generate_composite_chart, at get_transits ay nangangailangan ng idempotencyKey. Gamitin muli ang parehong key at kaparehong na-normalize na argumento para sa isang nilalayong muling pagsubok, at gumamit ng bagong key para sa bagong gawain. Walang dagdag na quota ang katugmang muling pagsubok at maaari nitong muling kalkulahin ang resulta nang deterministiko; hindi ito byte-for-byte na replay ng nakaimbak na tugon. Nangangailangan ng tahasang petsa ang mga MCP transit call para laging tumukoy sa parehong sandali ang muling pagsubok. Maaaring magpadala ang mga direct REST at Agent HTTP client ng Idempotency-Key sa mga sinusuportahang operasyong may hangganan at hindi streaming; opsyonal pa ito habang inilulunsad ang compatibility, kaya hindi madodoble ng mga tawag na wala nito ang transport retry. Tinatanggihan ng Batch at SSE ang mga caller retry key at hindi kasama sa kontratang ito ng retry deduplication.

Pagsubok sa raw protocol

Maaaring mag-initialize at tumawag ng calculation tool nang direkta ang mga developer na gumagamit ng API key:

Initialize

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": {
      "name": "my-agent",
      "version": "1.0.0"
    }
  }
}

Calculation call

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

Piliin ang client mo

Claude · Codex · Cursor · VS Code · Mga download ng plugin

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

Hanapin ang susunod mong sagot.