اربط وكيلك في أربع خطوات.
بالنسبة إلى Claude أو ChatGPT أو Codex، يُوصى بالاتصال عبر OAuth لأنه يتيح بأمان أدوات HumanDesign.ai المسموح بها للمستخدم المسجل.
1. أضف نقطة النهاية المستضافة
نقطة النهاية
https://mcp.humandesign.ai/اختر 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» أو «مخططي». ويتطلب قراءة مخططات الآخرين المصرح بها اشتراك 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 · تنزيلات الإضافات