Sambung kepada HumanDesign.ai MCP
Sebelum bermula
MCP HumanDesign.ai menyediakan alat Human Design berstruktur kepada klien AI yang serasi. Panduan ini merangkumi katalog pengiraan dan rujukan yang menggunakan kunci API. Jika klien anda menyokong sambungan OAuth HumanDesign.ai, gunakan aliran itu apabila memerlukan akses yang disambungkan ke akaun seperti data platform yang disimpan; kebenaran dan ketersediaan OAuth dipilih semasa log masuk.
Titik akhir MCP kanonik ialah https://mcp.humandesign.ai/. Gunakan POST / untuk permintaan MCP. GET / bukan ujian sambungan dan memulangkan 405 Method Not Allowed. POST /mcp ialah alias keserasian.
Tambah kunci API anda dengan selamat
Gunakan salah satu pengepala permintaan ini. Jangan letakkan kunci API dalam URL, masukkannya ke repositori atau tampalkannya dalam sembang.
Authorization: Bearer YOUR_HDAI_API_KEY
atau:
X-Api-Key: YOUR_HDAI_API_KEY
Sambung dan temui alat anda
- Konfigurasikan klien MCP anda dengan
https://mcp.humandesign.ai/. - Hantar
initializedengan versi protokol2025-11-25. - Hantar
notifications/initialized. - Panggil
tools/listdan gunakan hanya alat yang dipulangkan untuk kunci 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 pengiraan. Panggilan tools/call yang berjaya menggunakan satu unit API bersama; ralat pengesahan dan alat yang tidak tersedia tidak menggunakan kuota.
Panggil alat
Gunakan nama alat dan skema input yang dipulangkan oleh tools/list. Contohnya, permintaan carta teras berbentuk 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 berjaya memulangkan ringkasan ringkas yang mudah dibaca, blok teks JSON dan structuredContent. Respons berstruktur menggunakan sampul berversi dengan version, tool, data, meta, serta medan error pilihan.
Katalog pengiraan dan rujukan semasa hanya mendedahkan alat. Jangan jangkakan gesaan MCP, sumber MCP, alat penjanaan laporan, sesi pelayan atau blok imej carta daripada katalog ini.