إجابات واضحة حول خادم MCP المباشر.
نقطة النهاية الأساسية لنقل MCP هي العنوان الجذر https://mcp.humandesign.ai/. أما الجهة المعتمدة للحسابات فتبقى HumanDesign.ai API.
ما هو Human Design MCP؟
إنه الواجهة الرسمية البعيدة للوكلاء من HumanDesign.ai. ويمكن لعملاء الذكاء الاصطناعي المتوافقين استخدام أدوات الحساب المرتبط بالعضوية عبر OAuth، أو استخدام أدوات الحساب والمراجع الستة عبر مفتاح API.
هل هذه خدمة حساب Human Design منفصلة؟
لا. تفوض MCP وAgent HTTP وREST وHumanDesign.ai حساب المخططات إلى الخدمة المعتمدة نفسها. ويتيح OAuth ومفاتيح API إمكانات مختلفة، لكن إصدارات الحساب وقرارات الحصص تظل مركزية.
ما الذي يجعل بيانات المخطط موثوقة؟
تتحقق الخدمة من بيانات الميلاد والموقع والمنطقة الزمنية وفق IANA وسياق التوقيت الصيفي قبل الحساب، وتعيد نتيجة منظمة ذات إصدار محدد، وترفض المدخلات الملتبسة أو غير الصالحة قبل تحصيل أي رصيد. كما يُوجَّه الوكلاء إلى عدم تقريب حسابات المخطط.
كيف ينبغي للوكلاء تنسيق تاريخ الميلاد ووقته؟
باعتباره التوقيت المحلي كما أظهرته الساعة في مكان الميلاد، دون Z أو إزاحة عن UTC، مع تمرير المنطقة الزمنية منفصلة في حقل timezone بصيغة معرف IANA. تعني القيمة "birthDateTime": "1990-05-15T14:30:00" مع "timezone": "America/New_York" الثانية والنصف ظهرًا في نيويورك. والقيمة التي تتضمن Z أو إزاحة لا تحدد وحدها توقيت الساعة المحلية، كما أن المنطقة التي تُفسر فيها القيمة تغير المخطط. لا تحوّل وقت الميلاد إلى UTC قبل إرساله.
يرسل عميلي Z أو إزاحة UTC. هل سيسبب ذلك مشكلة؟
ليس بعد. يمرر MCP القيمة، ولا يزال API يقبلها ويقرأها باعتبارها UTC، مع الإشارة إلى إيقافها في استجابته. وسيتوقف قبول هذه القيم في موعد سيُعلن عنه مسبقًا. ويُعد التبديل إلى توقيت محلي مجرد من اللاحقة مع منطقة زمنية وفق IANA هو التغيير الآمن، كما يصحح المخطط لمن لم تكن قيمته تعني UTC فعلًا.
كم عدد أدوات الحساب؟
ست أدوات: resolve_timezone وgenerate_chart وgenerate_composite_chart وget_reference_item وget_transits وsearch_celebrities. ويضيف OAuth فهرس حساب منفصلًا تُفلتر عناصره بحسب العضوية والملكية والدور ومنح الإمكانات المشتقة من الخادم والاستحقاقات.
ما العملاء الذين يمكنهم الاتصال؟
يمكن لأي عميل MCP متوافق يستخدم Streamable HTTP الاتصال. وتتضمن الوثائق أدلة إرشادية لـ Claude وChatGPT وCodex وCursor وVS Code.
ما الذي يستهلك حصة الحساب؟
تستهلك كل من generate_chart وgenerate_composite_chart وget_transits وحدة واحدة عند وصول طلب تم التحقق من صحته إلى الحساب. أما resolve_timezone وget_reference_item وsearch_celebrities وinitialize وping وtools/list والمدخلات غير الصالحة والوصول المرفوض وقراءات المكتبة وفحوص الحالة وعرض مخطط موجود فلا تستهلك شيئًا.
كيف تعمل إعادة المحاولات الآمنة للحساب؟
تتطلب أدوات MCP الثلاث التي تستهلك رصيدًا قيمة idempotencyKey ثابتة. أعد استخدامها فقط مع الوسائط الموحدة نفسها لمحاولة الإعادة المقصودة. لا تستهلك المطابقة حصة إضافية وقد تعيد الحساب بصورة حتمية؛ لكنها لا تعيد استجابة مخزنة مطابقة بايتًا ببايت. كما تتطلب طلبات عبور MCP تاريخًا صريحًا.
هل يستطيع عضو HumanDesign.ai في الخطة المجانية إنشاء مخطط؟
نعم. يتيح OAuth للعضو المجاني معاينة مخططه الأساسي وتأكيده وإنشاءه وحفظه وعرضه ورسمه. ويستهلك الحساب الجديد وحدة واحدة بالضبط، ولا يضيف العرض أي رسوم ثانية.
هل يمكنه إنشاء مخططات مركبة؟
يمكن لواجهة الحساب باستخدام مفتاح API إنشاء مخطط مركب جديد لشخصين. أما حسابات OAuth المؤهلة فيمكنها استرداد المخططات المركبة المحفوظة والمصرح بها وعرضها. ويفرض الخادم دائمًا حدود الملكية والعضوية.
ماذا يحدث إذا تعذر عرض الصورة ضمن الصفحة؟
يتحقق الخادم من ملف PNG أو SVG قبل تأكيد النجاح، كما يعيد رابط تنزيل آمنًا قصير الأجل كخيار بديل.
أين أدير الوصول والفوترة؟
سجّل الدخول إلى HumanDesign.ai لإدارة عضوية المنصة والوصول إلى الحساب، أو إلى my.humandesign.ai لإدارة مفاتيح API واستخدام خطة API والفوترة.
هل تحتاج إلى مساعدة بشأن الحساب؟ تفضل بزيارة my.humandesign.ai.