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