เชื่อมต่อกับ HumanDesign.ai MCP
ก่อนเริ่มต้น
HumanDesign.ai MCP มอบเครื่องมือ Human Design แบบมีโครงสร้างให้ไคลเอนต์ AI ที่รองรับ คู่มือนี้ครอบคลุมแค็ตตาล็อกการคำนวณและข้อมูลอ้างอิงที่ใช้ API key หากไคลเอนต์ของคุณรองรับการเชื่อมต่อ HumanDesign.ai OAuth ให้ใช้ขั้นตอนนั้นเมื่อต้องการเข้าถึงที่เชื่อมกับบัญชี เช่น ข้อมูลแพลตฟอร์มที่บันทึกไว้ ระบบจะเลือกสิทธิ์และความพร้อมใช้งานของ OAuth ระหว่างเข้าสู่ระบบ
MCP endpoint มาตรฐานคือ https://mcp.humandesign.ai/. ใช้ POST / สำหรับคำขอ MCP GET / ไม่ใช่การทดสอบการเชื่อมต่อและจะส่งคืน 405 Method Not Allowed. POST /mcp เป็น alias เพื่อความเข้ากันได้
เพิ่ม API key อย่างปลอดภัย
ใช้ส่วนหัวคำขอรายการใดรายการหนึ่งต่อไปนี้ ห้ามใส่ API key ใน URL บันทึกลงใน repository หรือวางลงในแชต
Authorization: Bearer YOUR_HDAI_API_KEY
หรือ:
X-Api-Key: YOUR_HDAI_API_KEY
เชื่อมต่อและค้นพบเครื่องมือที่ใช้ได้
- กำหนดค่าไคลเอนต์ MCP โดยใช้
https://mcp.humandesign.ai/. - ส่ง
initializeโดยใช้เวอร์ชันโปรโตคอล2025-11-25. - ส่ง
notifications/initialized. - เรียกใช้
tools/listและใช้เฉพาะเครื่องมือที่ส่งคืนสำหรับคีย์ของคุณ
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": { "name": "your-client", "version": "1.0.0" }
}
}
คำขอค้นพบ เช่น initialize, ping, และ tools/list จะไม่ใช้โควตาการคำนวณ การเรียกใช้ tools/call จะใช้หน่วย API ร่วมกัน 1 หน่วย ส่วนข้อผิดพลาดจากการตรวจสอบและเครื่องมือที่ไม่พร้อมใช้งานจะไม่ใช้หน่วย
เรียกใช้เครื่องมือ
ใช้ชื่อเครื่องมือและสคีมาอินพุตที่ส่งคืนโดย tools/list. ตัวอย่างเช่น คำขอแผนภูมิหลักมีรูปแบบดังนี้:
{
"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"
}
}
}
อ่านผลลัพธ์
การเรียกใช้ที่สำเร็จจะส่งคืนสรุปที่อ่านง่าย บล็อกข้อความ JSON และ structuredContent. การตอบกลับแบบมีโครงสร้างใช้ envelope ที่มีเวอร์ชัน พร้อม version, tool, data, meta, และ error ฟิลด์
แค็ตตาล็อกการคำนวณและข้อมูลอ้างอิงปัจจุบันมีเฉพาะเครื่องมือเท่านั้น อย่าคาดหวังว่าจะมีพรอมป์ต์ MCP, ทรัพยากร MCP, เครื่องมือสร้างรายงาน, เซสชันเซิร์ฟเวอร์ หรือบล็อกรูปภาพแผนภูมิจากแค็ตตาล็อกนี้