การยืนยันตัวตน
OAuth สำหรับบัญชีของคุณ API key สำหรับการคำนวณ
Human Design MCP รองรับข้อมูลรับรองสองประเภทที่มีสิทธิ์แตกต่างกันโดยตั้งใจ เลือก OAuth สำหรับเครื่องมือบัญชี HumanDesign.ai ส่วนตัว หรือเลือก API key สำหรับพื้นผิวการคำนวณและข้อมูลอ้างอิงแบบเดิม
OAuth ของ HumanDesign.ai
- เพิ่ม
https://mcp.humandesign.ai/เป็นเซิร์ฟเวอร์ MCP แบบ Streamable HTTP ระยะไกล โดยไม่ต้องมี authorization header แบบคงที่ - ใช้ปุ่ม Authenticate, Connect, ของไคลเอนต์
/mcp, หรือการเข้าสู่ระบบ MCP - ลงชื่อเข้าใช้ผ่านหน้า HumanDesign.ai ที่มีแบรนด์ แล้วตรวจสอบขอบเขตบัญชีที่เลือกและความสามารถที่มี
- เชื่อมต่อใหม่หลังเปลี่ยนสมาชิก บทบาทในพื้นที่ทำงาน สิทธิ์การใช้งาน หรือการอนุญาต
สิทธิ์ OAuth จะถูกจำกัดตามสมาชิกและความเป็นเจ้าของเสมอ บัญชี Free และ Individual สร้าง บันทึก ดู และแสดงผลแผนผังหลักของตนเองได้ ส่วน Individual ยังดูการใช้งานบัญชีได้ ต้องใช้ Personal หรือ Pro เพื่อเข้าถึงแผนผังของผู้อื่นที่ได้รับอนุญาตและฟีเจอร์แพลตฟอร์มที่กว้างขึ้น
การเข้าถึงการคำนวณด้วย API key
API key แบบ Bearer และ X-Api-Key ยังรองรับเครื่องมือคำนวณและข้อมูลอ้างอิงทั้งหกรายการ แต่ไม่เปิดเผยข้อมูลบัญชี คลัง รายงาน หรือ Builder
Authorization: Bearer $HDAI_API_KEY
# or
X-Api-Key: $HDAI_API_KEYความปลอดภัยของข้อมูลรับรอง
- ไคลเอนต์ MCP และบริการอนุญาตสิทธิ์จะจัดการ OAuth token อย่าวาง token ลงในพรอมป์ต์หรือไฟล์ซอร์ส
- จัดเก็บ API key ใน environment variable หรือที่เก็บ secret ที่มีการปกป้อง
- ห้ามบันทึก authorization header, refresh token, API key, URL ของแอสเซ็ตที่ลงนาม หรือผลแผนผังส่วนตัวที่มีโครงสร้าง
- ยกเลิกการเชื่อมต่อหรือเคลียร์การยืนยันตัวตน MCP เพื่อเพิกถอนสิทธิ์ที่มอบหมาย
- จัดการ API key และการใช้งานตามแผนการคำนวณที่ my.humandesign.ai.
ข้อผิดพลาดในการยืนยันตัวตน
| โค้ด | ความหมาย | การดำเนินการ |
|---|---|---|
401 | ไม่มีข้อมูลรับรอง รูปแบบไม่ถูกต้อง หมดอายุ หรือถูกเพิกถอน | ให้ไคลเอนต์เข้าสู่ระบบ OAuth อีกครั้ง หรือคืนค่าการตั้งค่า API key ที่ได้รับการปกป้อง |
403 | ต้นทาง การให้สิทธิ์ ความเป็นสมาชิก บทบาท ความเป็นเจ้าของ หรือสิทธิ์การใช้งานถูกปฏิเสธ | ตรวจสอบขอบเขตบัญชี และเชื่อมต่อใหม่หลังได้รับอนุมัติให้เปลี่ยนสิทธิ์การเข้าถึง |
429 | ใช้โควตาการคำนวณหรือขีดจำกัดอัตราการใช้งานเพื่อความปลอดภัยแล้ว | ตรวจสอบการใช้งาน อย่าลองซ้ำถี่เกินไป |