חברו את הסוכן שלכם בארבעה שלבים.
עבור Claude, ChatGPT או Codex, מומלץ להתחבר באמצעות OAuth, משום שהוא יכול לחשוף בבטחה את כלי HumanDesign.ai המותרים למשתמש המחובר.
1. הוסיפו את נקודת הקצה המתארחת
נקודת קצה
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 דרך אימות Bearer או X-Api-Key אימות.
3. גלו את הכלים שלכם
JSON-RPC
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list",
"params": {}
}הגילוי בחינם. הנראות של כלי OAuth פועלת לפי הרשאות היכולת שגוזר השרת עבור המשתמש, חברות Free/Individual/Personal/Pro, תפקיד בסביבת עבודה, בעלות וזכאויות מוצר. הנראות באמצעות מפתח API פועלת לפי תוכניות ה-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 יכולים לבצע אתחול ולקרוא לכלי חישוב ישירות:
אתחול
{
"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 · הורדות תוספים