เชื่อมต่อเอเจนต์ของคุณในสี่ขั้นตอน
สำหรับ Claude, ChatGPT หรือ Codex แนะนำให้เชื่อมต่อด้วย OAuth เพราะสามารถเปิดใช้เครื่องมือ HumanDesign.ai ที่ผู้ใช้ซึ่งลงชื่อเข้าใช้มีสิทธิ์ได้อย่างปลอดภัย
1. เพิ่มปลายทางที่โฮสต์ไว้
Endpoint
https://mcp.humandesign.ai/เลือก remote HTTP หรือ Streamable HTTP อย่าเพิ่ม /mcp อีกครั้ง: ปลายทางมาตรฐานอยู่ที่รากของโดเมน
2. ยืนยันตัวตน
ใช้คำสั่ง Authenticate หรือ Connect ของ MCP ในไคลเอนต์ แล้วเข้าสู่ระบบ HumanDesign.ai ผ่านเบราว์เซอร์ให้เสร็จ ผู้ใช้ Claude Code เรียกใช้ได้ claude mcp login human-design-ai; ผู้ใช้ Codex เรียกใช้ได้ codex mcp login human_design_ai.
หากต้องการเฉพาะเครื่องมือคำนวณและข้อมูลอ้างอิงหกรายการ ยังใช้ API key ผ่าน Bearer หรือ X-Api-Key การยืนยันตัวตน
3. ค้นหาเครื่องมือของคุณ
JSON-RPC
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list",
"params": {}
}การค้นหาเครื่องมือไม่มีค่าใช้จ่าย การมองเห็นเครื่องมือ OAuth เป็นไปตามสิทธิ์ความสามารถที่เซิร์ฟเวอร์กำหนดให้ตามบัญชีสมาชิก บทบาทในพื้นที่ทำงาน ความเป็นเจ้าของ และสิทธิ์ผลิตภัณฑ์ ส่วนการมองเห็นด้วย API key เป็นไปตามแผน API แยกต่างหาก ได้แก่ Free/Creator/Startup/Business
4. เริ่มต้นด้วยแผนผังหลักของคุณ
ขอให้เอเจนต์เรียกใช้ chart_get_primary. หากยังไม่มีแผนผังหลัก สมาชิก Free, Individual, Personal และ Pro ใช้ได้ chart_generate: ตรวจสอบรายละเอียดการเกิดที่ปรับมาตรฐานและตัวอย่างการใช้หนึ่งหน่วยก่อน จากนั้นยืนยันการดำเนินการ ระบบค้นหาแผนผังที่บันทึกไว้ด้วยความเป็นเจ้าของบัญชี ไม่ค้นจากชื่อ เช่น “Kyle” หรือ “My Chart” การอ่านแผนผังของผู้อื่นที่ได้รับอนุญาตต้องใช้ Personal หรือ Pro
การเชื่อมต่อ, initialize, ping, tools/list, การอ่านคลัง การตรวจสอบสถานะ และการแสดงผลแผนผังที่มีอยู่ไม่ใช้เครดิต การคำนวณแผนผังหลักใหม่ใช้หน่วยคำนวณหนึ่งหน่วยพอดี การแสดงผลไม่มีค่าใช้จ่ายเพิ่ม
วิธีการคำนวณที่เชื่อถือได้
เอเจนต์ไม่ได้คำนวณแผนผังเอง HumanDesign.ai ตรวจสอบวันที่ สถานที่ เขตเวลา IANA และบริบทเวลาออมแสงก่อนใช้โควตา จากนั้นส่งผลลัพธ์แบบมีเวอร์ชันจากบริการคำนวณกลับมา สถานที่กำกวมและข้อมูลไม่ถูกต้องจะแสดงข้อผิดพลาดชัดเจนโดยไม่เสียหน่วย หากไม่ทราบเวลาเกิด บริการจะบันทึกว่าใช้เที่ยงวันตามเวลาท้องถิ่นและแจ้งว่ารายละเอียดแผนผังที่ขึ้นกับเวลาอาจแตกต่างกัน
ลองคำนวณซ้ำอย่างปลอดภัย
เครื่องมือ MCP ที่เรียกใช้งาน generate_chart, generate_composite_chart, และ get_transits ต้องมี idempotencyKey. ใช้คีย์เดิมกับอาร์กิวเมนต์ที่ปรับมาตรฐานเหมือนกันสำหรับการลองซ้ำหนึ่งครั้งตามที่ตั้งใจ และใช้คีย์ใหม่สำหรับงานใหม่ การลองซ้ำที่ตรงกันไม่ใช้โควตาเพิ่ม แต่อาจคำนวณผลลัพธ์ใหม่อย่างกำหนดได้ ไม่ใช่การเล่นซ้ำการตอบกลับที่บันทึกไว้แบบไบต์ต่อไบต์ การเรียก MCP สำหรับการเคลื่อนผ่านต้องระบุวันที่อย่างชัดเจน เพื่อให้การลองซ้ำอ้างถึงเวลาเดียวกันเสมอ ไคลเอนต์ REST โดยตรงและ Agent HTTP สามารถส่ง Idempotency-Key สำหรับการดำเนินการที่รองรับ จำกัดขอบเขต และไม่ใช้สตรีม โดยยังเป็นตัวเลือกในช่วงเปิดใช้ความเข้ากันได้ ดังนั้นคำเรียกที่ไม่มีค่านี้จะไม่สามารถตัดคำขอซ้ำจากการลองซ้ำของการเชื่อมต่อได้ Batch และ SSE ปฏิเสธคีย์ลองซ้ำจากผู้เรียก และอยู่นอกข้อตกลงการตัดคำขอซ้ำนี้
ทดสอบโปรโตคอลโดยตรง
นักพัฒนาที่ใช้ API key สามารถเริ่มต้นและเรียกเครื่องมือคำนวณได้โดยตรง:
เริ่มต้นใช้งาน
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": {
"name": "my-agent",
"version": "1.0.0"
}
}
}การเรียกใช้การคำนวณ
{
"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"
}
}
}เลือกไคลเอนต์ของคุณ
Claude · Codex · Cursor · VS Code · ดาวน์โหลดปลั๊กอิน