חיבור ל‑HumanDesign.ai MCP
לפני שמתחילים
HumanDesign.ai MCP מספק ללקוחות AI תואמים כלי Human Design מובנים. מדריך זה מכסה את קטלוג החישוב והייחוס המשתמש במפתח API. אם הלקוח שלכם תומך בחיבור OAuth של HumanDesign.ai, השתמשו בו כשנדרשת גישה המחוברת לחשבון, כגון נתוני פלטפורמה שמורים; הרשאות OAuth והזמינות נבחרות במהלך הכניסה.
נקודת הקצה הקנונית של MCP היא https://mcp.humandesign.ai/. השתמשו ב POST / עבור בקשות MCP. GET / אינה בדיקת חיבור ומחזירה 405 Method Not Allowed. POST /mcp הוא כינוי תאימות.
הוסיפו את מפתח ה-API בבטחה
השתמשו באחת מכותרות הבקשה הבאות. אל תכניסו מפתח API לכתובת URL או למאגר קוד ואל תדביקו אותו בצ'אט.
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 משותפת אחת; כשלים באימות וכלים שאינם זמינים אינם צורכים יחידות.
קראו לכלי
השתמשו בשם הכלי ובסכמת הקלט שהוחזרו על ידי 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. התשובה המובנית משתמשת במעטפת בעלת גרסה הכוללת version, tool, data, meta, ושדה error אופציונלי.
קטלוג החישוב והייחוס הנוכחי חושף כלים בלבד. אל תצפו להנחיות MCP, למשאבי MCP, לכלי יצירת דוחות, להפעלות שרת או לבלוקי תמונות מפות מתוך הקטלוג הזה.