Autentikasi
OAuth untuk akun Anda. API key untuk kalkulasi.
Human Design MCP sengaja mendukung dua jenis kredensial dengan kewenangan berbeda. Pilih OAuth untuk alat akun HumanDesign.ai pribadi; pilih API key untuk antarmuka kalkulasi/referensi awal.
OAuth HumanDesign.ai
- Tambahkan
https://mcp.humandesign.ai/sebagai server MCP Streamable HTTP jarak jauh tanpa authorization header statis. - Gunakan tindakan Authenticate atau Connect milik klien
/mcp, atau tindakan login MCP. - Masuk melalui halaman HumanDesign.ai resmi dan tinjau batas akun yang dipilih serta kemampuan yang tersedia.
- Sambungkan ulang setelah perubahan keanggotaan, peran ruang kerja, hak penggunaan, atau otorisasi.
Akses OAuth selalu dibatasi oleh keanggotaan dan kepemilikan. Akun Free dan Individual dapat membuat, menyimpan, melihat, dan menampilkan bagan utama milik sendiri; Individual juga mencakup tampilan penggunaan akun. Personal atau Pro diperlukan untuk melihat bagan orang lain yang diizinkan dan menggunakan fitur platform yang lebih luas.
Akses kalkulasi dengan API key
API key Bearer dan X-Api-Key tetap didukung untuk enam alat kalkulasi/referensi. Alat tersebut tidak membuka data akun, pustaka, laporan, atau Builder.
Authorization: Bearer $HDAI_API_KEY
# or
X-Api-Key: $HDAI_API_KEYKeamanan kredensial
- Token OAuth ditangani oleh klien MCP dan layanan otorisasi; jangan pernah menempelkannya ke prompt atau file sumber.
- Simpan API key dalam variabel lingkungan atau penyimpanan secret yang terlindungi.
- Jangan pernah mencatat authorization header, refresh token, API key, URL aset bertanda tangan, atau hasil bagan privat terstruktur.
- Putuskan konektor atau hapus autentikasi MCP untuk mencabut akses yang didelegasikan.
- Kelola API key dan penggunaan paket kalkulasi di my.humandesign.ai.
Kesalahan autentikasi
| Kode | Makna | Tindakan |
|---|---|---|
401 | Kredensial tidak ada, format salah, kedaluwarsa, atau dicabut | Jalankan kembali login OAuth klien atau pulihkan pengaturan API key yang terlindungi. |
403 | Asal, hak kemampuan, keanggotaan, peran, kepemilikan, atau hak penggunaan ditolak | Tinjau batas akun; sambungkan ulang setelah perubahan akses disetujui. |
429 | Kuota kalkulasi habis atau batas laju demi keamanan tercapai | Tinjau penggunaan; jangan mencoba ulang terlalu cepat. |