المصادقة
OAuth لحسابك. ومفاتيح API للحسابات.
يدعم Human Design MCP عمدًا نوعين من بيانات الاعتماد بصلاحيات مختلفة. اختر OAuth لأدوات حساب HumanDesign.ai الخاصة، واختر مفتاح API لواجهة الحساب والمراجع الأصلية.
OAuth الخاص بـ HumanDesign.ai
- أضف
https://mcp.humandesign.ai/كخادم MCP بعيد يعمل عبر Streamable HTTP دون ترويسة تفويض ثابتة. - استخدم إجراء Authenticate أو Connect
/mcpأو تسجيل الدخول إلى MCP لدى العميل. - سجّل الدخول من صفحة HumanDesign.ai ذات العلامة التجارية وراجع حدود الحساب المحددة والإمكانات المتاحة.
- أعد الاتصال بعد تغيير العضوية أو دور مساحة العمل أو الاستحقاق أو التفويض.
يظل وصول OAuth مقيدًا بالعضوية والملكية. ويمكن لحسابات Free وIndividual إنشاء مخططها الأساسي وحفظه وعرضه ورسمه؛ كما تتيح Individual الاطلاع على استخدام الحساب. ويلزم Personal أو Pro للوصول إلى مخططات الآخرين المصرح بها وميزات المنصة الأوسع.
الوصول إلى الحساب باستخدام مفتاح API
مفاتيح API بنمط Bearer و X-Api-Key لا تزال مدعومة لأدوات الحساب والمراجع الست. ولا تتيح بيانات الحساب أو المكتبة أو التقارير أو Builder.
Authorization: Bearer $HDAI_API_KEY
# or
X-Api-Key: $HDAI_API_KEYأمان بيانات الاعتماد
- يتولى عميل MCP وخدمة التفويض معالجة رموز OAuth؛ لا تلصقها أبدًا في المطالبات أو ملفات المصدر.
- خزّن مفاتيح API في متغير بيئة أو مخزن أسرار محمي.
- لا تسجل أبدًا ترويسات التفويض أو رموز التحديث أو مفاتيح API أو عناوين URL الموقعة للموارد أو نتائج المخططات الخاصة المنظمة.
- افصل الموصل أو امسح مصادقة MCP لإلغاء الوصول المفوض.
- أدر مفاتيح API واستخدام خطة الحساب على my.humandesign.ai.
أخطاء المصادقة
| الرمز | المعنى | الإجراء |
|---|---|---|
401 | بيانات الاعتماد مفقودة أو غير صالحة التنسيق أو منتهية الصلاحية أو ملغاة | أعد تسجيل الدخول عبر OAuth لدى العميل أو استعد إعداد مفتاح API المحمي. |
403 | تم رفض المصدر أو منح الإمكانات أو العضوية أو الدور أو الملكية أو الاستحقاق | راجع حدود الحساب وأعد الاتصال بعد تغيير وصول معتمد. |
429 | تم بلوغ حصة الحساب أو حد معدل الاستخدام الآمن | راجع الاستخدام ولا تكرر المحاولة بسرعة. |