HumanDesign.aiMCPเปิดแอป ↗
สำหรับ AI ของคุณเอกสารประกอบการใช้งาน
เริ่มต้นอย่างรวดเร็ว

เชื่อมต่อเอเจนต์ของคุณในสี่ขั้นตอน

สำหรับ 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 · ดาวน์โหลดปลั๊กอิน

กลับไปด้านบน ↑ต้องการความช่วยเหลือไหม ติดต่อฝ่ายสนับสนุน ↗

ค้นหาคำตอบถัดไปของคุณ