HumanDesign.aiMCPBuka aplikasi ↗
UNTUK AI ANDADokumentasi
Mula Pantas

Sambungkan ejen anda dalam empat langkah.

Untuk Claude, ChatGPT atau Codex, OAuth ialah sambungan yang disyorkan kerana ia boleh menyediakan alat HumanDesign.ai yang dibenarkan untuk pengguna yang telah log masuk dengan selamat.

1. Tambah endpoint yang dihoskan

Endpoint

https://mcp.humandesign.ai/

Pilih HTTP jauh atau Streamable HTTP. Jangan tambah /mcp sekali lagi: endpoint kanonik ialah akar domain.

2. Sahkan

Gunakan tindakan MCP Authenticate atau Connect pada klien dan lengkapkan log masuk pelayar HumanDesign.ai. Pengguna Claude Code boleh menjalankan claude mcp login human-design-ai ; pengguna Codex boleh menjalankan codex mcp login human_design_ai.

Jika hanya memerlukan enam alat pengiraan/rujukan, kunci API masih tersedia melalui pengesahan Bearer atau X-Api-Key .

3. Temui alat anda

JSON-RPC

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

Penemuan adalah percuma. Keterlihatan alat OAuth mengikut pemberian keupayaan yang diperoleh pelayan, keahlian Free/Individual/Personal/Pro pengguna, peranan ruang kerja, pemilikan dan kelayakan produk. Keterlihatan kunci API mengikut pelan API Free/Creator/Startup/Business yang berasingan.

4. Mulakan dengan carta utama anda

Minta ejen memanggil chart_get_primary . Jika belum ada carta utama, ahli Free, Individual, Personal dan Pro boleh menggunakan chart_generate : semak dahulu butiran kelahiran yang dinormalkan dan pratonton satu unit, kemudian sahkan pelaksanaan. Carta tersimpan dikenal pasti melalui pemilikan akaun, bukan dengan mencari nama seperti “Kyle” atau “My Chart.” Untuk membaca carta orang lain yang dibenarkan, anda memerlukan Personal atau Pro.

Sambungan, initialize, ping, tools/list , bacaan pustaka, semakan status dan paparan carta sedia ada tidak menggunakan kredit. Pengiraan carta utama baharu menggunakan tepat satu unit pengiraan; paparannya tidak mengenakan caj tambahan.

Cara kepercayaan pengiraan berfungsi

Ejen tidak mengira carta sendiri. HumanDesign.ai mengesahkan tarikh, lokasi, zon waktu IANA dan konteks waktu musim panas sebelum kuota digunakan, kemudian mengembalikan hasil berversi daripada perkhidmatan pengiraannya. Lokasi samar dan input tidak sah menghasilkan ralat yang jelas tanpa menggunakan unit. Jika masa lahir tidak diketahui, perkhidmatan merekodkan penggunaan waktu tengah hari tempatan dan memberi amaran bahawa butiran carta sensitif masa mungkin berbeza.

Percubaan semula pengiraan yang selamat

Alat MCP yang menggunakan kuota generate_chart, generate_composite_chart, dan get_transits memerlukan idempotencyKey . Gunakan semula kunci yang sama dengan argumen ternormal yang serupa untuk satu percubaan semula yang dimaksudkan; gunakan kunci baharu untuk kerja baharu. Percubaan semula yang sepadan tidak menggunakan kuota tambahan dan mungkin mengira semula hasil secara deterministik; ia bukan main semula bait demi bait bagi respons tersimpan. Panggilan transit MCP memerlukan tarikh nyata supaya percubaan semula sentiasa merujuk detik yang sama. Klien REST dan Agent HTTP langsung boleh menghantar Idempotency-Key pada operasi bukan strim yang terhad dan disokong; kunci ini masih pilihan dalam pelancaran keserasian, jadi panggilan tanpanya tidak dapat mengesan percubaan semula pengangkutan. Batch dan SSE menolak kunci percubaan semula daripada pemanggil dan tidak termasuk dalam kontrak penduaan percubaan semula ini.

Ujian protokol mentah

Pembangun yang menggunakan kunci API boleh memulakan sesi dan memanggil alat pengiraan secara langsung:

Initialize

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

Panggilan pengiraan

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

Pilih klien anda

Claude · Codex · Cursor · VS Code · Muat turun pemalam

Kembali ke atas ↑Perlukan bantuan? Hubungi sokongan ↗

Cari jawapan anda yang seterusnya.