HumanDesign.aiPersonalافتح التطبيق ↗
لأجلكمركز المساعدة

الاتصال بـ HumanDesign.ai MCP

APIآخر تحديث في 28 أغسطس 2026دقيقتان للقراءة

قبل البدء

يوفر HumanDesign.ai MCP أدوات منظمة لتصميم الإنسان لعملاء الذكاء الاصطناعي المتوافقين. يغطي هذا الدليل كتالوج الحساب والمرجع الذي يستخدم مفتاح 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

اتصل واكتشف الأدوات المتاحة

  1. أعد إعداد عميل MCP باستخدام https://mcp.humandesign.ai/.
  2. أرسل initialize مع إصدار البروتوكول 2025-11-25.
  3. أرسل notifications/initialized.
  4. استدعِ 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 أو أدوات إنشاء التقارير أو جلسات الخادم أو كتل صور المخططات في هذا الكتالوج.

العودة إلى الأعلى ↑هل تحتاج إلى مساعدة؟ تواصل مع الدعم ↗

اعثر على إجابتك التالية.