Terhubung ke HumanDesign.ai MCP
Sebelum memulai
HumanDesign.ai MCP menyediakan alat Human Design terstruktur bagi klien AI yang kompatibel. Panduan ini membahas katalog kalkulasi dan referensi yang menggunakan API key. Jika klien Anda mendukung koneksi OAuth HumanDesign.ai, gunakan alur itu untuk akses yang terhubung ke akun, seperti data platform tersimpan; izin dan ketersediaan OAuth dipilih saat masuk.
Endpoint MCP standar adalah https://mcp.humandesign.ai/. Gunakan POST / untuk permintaan MCP. GET / bukan pengujian koneksi dan mengembalikan 405 Method Not Allowed. POST /mcp adalah alias kompatibilitas.
Tambahkan API key Anda dengan aman
Gunakan salah satu header permintaan berikut. Jangan letakkan API key di URL, commit ke repositori, atau tempelkan ke obrolan.
Authorization: Bearer YOUR_HDAI_API_KEY
atau:
X-Api-Key: YOUR_HDAI_API_KEY
Hubungkan dan temukan alat Anda
- Konfigurasikan klien MCP Anda dengan
https://mcp.humandesign.ai/. - Kirim
initializedengan versi protokol2025-11-25. - Kirim
notifications/initialized. - Panggil
tools/listdan hanya gunakan alat yang dikembalikan untuk key Anda.
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": { "name": "your-client", "version": "1.0.0" }
}
}
Panggilan penemuan seperti initialize, ping, dan tools/list tidak menggunakan kuota kalkulasi. Pemanggilan yang berhasil tools/call menggunakan satu unit API bersama; kesalahan validasi dan alat yang tidak tersedia tidak.
Panggil alat
Gunakan nama alat dan skema masukan yang dikembalikan oleh tools/list. Contohnya, permintaan bagan inti memiliki bentuk seperti ini:
{
"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"
}
}
}
Baca hasilnya
Panggilan yang berhasil mengembalikan ringkasan singkat yang mudah dibaca, blok teks JSON, dan structuredContent. Respons terstruktur menggunakan envelope berversi dengan version, tool, data, meta, dan opsional error bidang.
Katalog kalkulasi/referensi saat ini hanya menyediakan tools. Jangan mengharapkan prompt MCP, resource MCP, alat pembuatan laporan, sesi server, atau blok gambar bagan dari katalog ini.