Hubungkan agen Anda dalam empat langkah.
Untuk Claude, ChatGPT, atau Codex, koneksi OAuth disarankan karena dapat dengan aman membuka alat HumanDesign.ai yang diizinkan oleh pengguna yang masuk.
1. Tambahkan endpoint yang dihosting
Endpoint
https://mcp.humandesign.ai/Pilih HTTP jarak jauh atau Streamable HTTP. Jangan tambahkan /mcp lagi: endpoint standar berada di root domain.
2. Autentikasi
Gunakan tindakan MCP Authenticate atau Connect milik klien dan selesaikan login browser HumanDesign.ai. Pengguna Claude Code dapat menjalankan claude mcp login human-design-ai; pengguna Codex dapat menjalankan codex mcp login human_design_ai.
Jika hanya memerlukan enam alat kalkulasi/referensi, API key tetap tersedia melalui Bearer atau X-Api-Key autentikasi.
3. Temukan alat Anda
JSON-RPC
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list",
"params": {}
}Penemuan alat gratis. Visibilitas alat OAuth mengikuti hak kemampuan yang ditentukan server, keanggotaan Free/Individual/Personal/Pro, peran ruang kerja, kepemilikan, dan hak produk pengguna. Visibilitas API key mengikuti paket API Free/Creator/Startup/Business yang terpisah.
4. Mulai dengan bagan utama Anda
Minta agen memanggil chart_get_primary. Jika belum ada bagan utama, anggota Free, Individual, Personal, dan Pro dapat menggunakan chart_generate: tinjau dahulu detail kelahiran yang dinormalisasi dan pratinjau satu unit, lalu konfirmasikan eksekusi. Bagan tersimpan ditentukan berdasarkan kepemilikan akun, bukan dengan mencari nama seperti “Kyle” atau “My Chart”. Membaca bagan orang lain yang diizinkan memerlukan Personal atau Pro.
Koneksi, initialize, ping, tools/list, pembacaan pustaka, pemeriksaan status, dan penampilan bagan yang sudah ada tidak menggunakan kredit. Perhitungan bagan utama baru menggunakan tepat satu unit kalkulasi; penampilan bagan tidak dikenai biaya kedua.
Cara menjaga keandalan kalkulasi
Agen tidak menghitung bagan sendiri. HumanDesign.ai memvalidasi tanggal, lokasi, zona waktu IANA, dan konteks waktu musim panas sebelum kuota digunakan, lalu mengembalikan hasil berversi dari layanan kalkulasi. Lokasi ambigu dan masukan tidak valid menghasilkan kesalahan yang jelas tanpa menggunakan unit. Jika waktu lahir tidak diketahui, layanan mencatat penggunaan pukul 12.00 waktu setempat dan memperingatkan bahwa detail bagan yang bergantung pada waktu mungkin berbeda.
Percobaan ulang kalkulasi yang aman
Alat MCP yang digunakan generate_chart, generate_composite_chart, dan get_transits memerlukan idempotencyKey. Gunakan kembali key yang sama dengan argumen ternormalisasi identik untuk satu percobaan ulang yang dimaksud, dan gunakan key baru untuk pekerjaan baru. Percobaan ulang yang cocok tidak menggunakan kuota tambahan dan mungkin menghitung ulang secara deterministik; ini bukan pemutaran ulang byte-per-byte dari respons tersimpan. Pemanggilan transit MCP harus menyertakan tanggal eksplisit agar percobaan ulang selalu merujuk momen yang sama. Klien REST langsung dan Agent HTTP dapat mengirim Idempotency-Key pada operasi non-streaming terbatas yang didukung; opsi ini masih tersedia selama peluncuran kompatibilitas, sehingga pemanggilan tanpanya tidak dapat menghilangkan duplikasi percobaan ulang transport. Batch dan SSE menolak key percobaan ulang dari pemanggil dan tidak termasuk dalam kontrak deduplikasi ini.
Pengujian protokol mentah
Pengembang yang menggunakan API key dapat menginisialisasi dan memanggil alat kalkulasi secara langsung:
Inisialisasi
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": {
"name": "my-agent",
"version": "1.0.0"
}
}
}Pemanggilan kalkulasi
{
"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 · Unduhan plugin