عميلك، متصل بأي خادم MCP.
يأتي Hoody Agent مزوّداً بعميل Model Context Protocol جاهز للإنتاج. اتصل بـ GitHub وSlack وJira والأدوات الداخلية دون كتابة محوّل واحد.
stdio محلي + StreamableHTTP / SSE بعيد · OAuth للخوادم المصادق عليها · تأكيد العمليات الهدّامة
# POST against your agent container
$ curl -X POST https://PROJECT-CONTAINER-agent-1.SERVER.containers.hoody.com/api/v1/agent/mcp/servers \
-H "Content-Type: application/json" \
-d '{ "name": "linear", "enabled": true }'
<< 201 Created
{ "id": "srv_...", "name": "linear", "status": "connecting" }— العميل يستدعي listTools() على كل خادم متصل عند البدء. الأدوات الجديدة تظهر في جولة الاستدلال التالية.
POST واحد. تظهر الأدوات.
يستدعي العميل listTools() على كل خادم MCP متصل. مهما يُرجع الخادم — نظام ملفات، قاعدة بيانات، GitHub — يُضاف فوراً إلى فهرس الأدوات.
1. سجّل خادماً
أرسل POST إلى /api/v1/agent/mcp/servers مع اسم وعلامة تمكين. Hoody يحلّ الخادم ويبدأ الاتصال.
2. اكتشف الأدوات
يستدعي عميل MCP دالة listTools() على الخادم. المخطط ديناميكي — لا حاجة لإعلان مسبق.
3. دمج مع الأدوات الأصيلة
تنضم الأدوات المُكتشفة إلى مجموعة الأدوات المدمجة للعميل. يمكن لنفس الطلب الوصول إلى أداة GitHub وأداة نظام ملفات ونقطة نهاية Exec.
4. استدعاء بالسلامة
العمليات الهدّامة — كتابة الملفات والتعديلات على API الخارجي — تتطلب تأكيداً صريحاً. يتوقف العميل ويعرض الإجراء.
GET/api/v1/agent/mcp/servers
أربع قدرات تهم.
عميل MCP صغير لكن ذو رأي واضح. كل ميزة موجودة لأن العميل يجب أن يظل موثوقاً في الإنتاج.
اكتشاف الأدوات الديناميكي
لا قائمة ثابتة. يسأل العميل كل خادم متصل عمّا يقدّمه، فيتطور فهرس الأدوات مع الخوادم.
بروتوكولات محلية + بعيدة
stdio للخوادم المحلية التي تعمل بجانب العميل، StreamableHTTP + SSE للخوادم البعيدة عبر الشبكة.
مصادقة OAuth
تدفق OAuth كامل للخوادم البعيدة المصادق عليها — اتصل بخادم GitHub MCP أو Google Drive MCP أو أي أداة مؤمّنة بهوية.
الاستدعاء بأولوية السلامة
استدعاءات الأدوات الهدّامة تتطلب تأكيداً قبل التنفيذ. يتوقف العميل ويعرض الإجراء ويتوقع رداً.
أي عميل MCP يتوصل.
وكيل Hoody يتحدث MCP مع الخوادم الخارجية — اسقط عنوان URL للخادم أو أمر stdio في الوكيل وستكون أدواته ملكك في الدور التالي. اتصل عبر سجل MCP الرسمي أو كتالوج المجتمع أو أدوات داخلية خاصة بك.
Claude Desktop
عميل MCP المرجعي لـ Anthropic — أضف إعداد الخادم وتظهر أدوات Hoody في شريط أدوات Claude.
Cursor
بيئة تطوير متكاملة أصيلة للذكاء الاصطناعي مع دعم كامل لـ MCP — الوصول إلى الملفات والطرفية والتنفيذ وكل شيء عبر إعداد واحد.
Cline
عميل برمجة مستقل في VS Code — يقرأ ويكتب عبر حاويات Hoody عبر MCP.
Windsurf
بيئة التطوير العاملية لـ Codeium — أدوات MCP تنضم مباشرة إلى تدفقات Cascade.
Continue.dev
مساعد برمجة ذكاء اصطناعي مفتوح المصدر — تكامل أولي MCP، أحضر نموذجك الخاص.
Hoody Agent + DIY
اكتب عميل MCP الخاص بك ضد نفس البروتوكول — أو استخدم العميل المدمج في hoody-agent.
{
"mcpServers": {
"hoody": {
"url": "https://CONTAINER.SERVER.containers.hoody.com/mcp",
"auth": { "type": "oauth" }
}
}
}البروتوكول مفتوح — كل عميل أعلاه يصل إلى نفس سطح الأدوات، بدون محوّلات من المزود.
استدعاء أداة واحد، من البداية للنهاية.
يطلب العميل الأدوات، يختار واحدة، يستدعيها، يقرأ النتيجة. الخطوات الأربع هي بروتوكول MCP.
الاكتشاف
يستدعي العميل listTools() على كل خادم MCP متصل. يُرجع كل خادم مخطط أدواته — لا تهيئة جانب العميل مطلوبة.
الاختيار
يستدل النموذج على وصف الأدوات ويختار الأنسب للخطوة الحالية. لا توجيه يدوي مطلوب.
الاستدعاء
ينطلق الاستدعاء كرسالة MCP. يتولى عميل Hoody النقل (stdio / HTTP / SSE) وتمرير المصادقة.
التأمل
يصل رد JSON مكتوب النوع. يقرأه العميل ويكمل — أصبح استدعاء الأداة الناجح مجرد خطوة أخرى في السلسلة.
→ listTools()
← [ { name: "read_file", schema: {...} },
{ name: "write_file", schema: {...} },
{ name: "run_shell", schema: {...} }, ... ]
→ callTool("read_file", { path: "/hoody/storage/readme.md" })
← { content: "# Project readme\n\nSee ..." }
→ callTool("run_shell", { cmd: "pytest tests/" })
⟳ requires confirmation — destructive-op gate
← { exitCode: 0, stdout: "... 42 passed ..." }العملاء لا يرسلون عمليات هدّامة بصمت.
MCP يكشف أدوات حادة — كتابة الملفات وتنفيذ الصدفة وتعديلات API. يفرض عميل Hoody ثلاثة طبقات دفاعية.
تأكيد العمليات الهدّامة
أي استدعاء أداة يكتب أو يحذف أو ينفّذ تأثيرات جانبية خارجية يتوقف للحصول على موافقة صريحة.
OAuth للخوادم البعيدة
خوادم MCP البعيدة تصادق عبر تدفق OAuth كامل — GitHub وSlack وJira وأي أداة مؤمّنة بهوية.
قائمة بيضاء لكل خادم
كل خادم MCP يُسجَّل صراحةً عبر POST /agent/mcp/servers. الخوادم غير المعتمدة لا يمكنها الاتصال.
مسار تدقيق كامل
كل استدعاء أداة (اكتشاف، استدعاء، نتيجة) يُسجَّل عبر Hoody Proxy. قابل للمراجعة والتصدير والربط بعمليات المحاسبة.
تعامل مع عالم MCP.
أي خادم متوافق مع MCP — من السجل الرسمي أو المجتمع أو أدواتك الداخلية — يتوصل بنفس الطريقة.
رسائل وقنوات والتراسل مع الفريق
التذاكر والسبرينتات وتحديثات الحالة
خادم مرجعي رسمي (ملفات محلية)
استعلامات للقراءة فقط على قاعدة بيانات حقيقية
بحث الويب دون استخلاص
أتمتة المتصفح في الخلفية
اكتب خادم MCP حول أي سطح REST / gRPC تشغّله بالفعل
أمثلة يمكن توصيلها اليوم. خوادم MCP جديدة تظهر كل أسبوع؛ هذه القائمة غير مشفّرة في النظام.
POST واحد يبعد عن مزيد من الأدوات.
أطلق حاوية Hoody Agent، أرسل POST لخادم MCP الذي تريده، وسيكون متاحاً في جولة الاستدلال التالية.
راجع أيضاً — /platform/ai-gateway لطبقة النموذج، /platform/control-plane لـ API الحوكمة، /kit/agent للتوثيق الكامل للعميل.