REST API¶

الواجهة الأساسية هي MCP على /mcp. تتوفر أيضًا REST surface لفحوصات الصحة وروابط الملفات وبعض عمليات الخدمة.

الصحة¶

GET /healthz

يعيد حالة صحة الخادم ومعلومات الحالة الأساسية.

POST /mcp

نقطة Streamable HTTP MCP endpoint يستخدمها ChatGPT وغيره من MCP client.

تستخدم استدعاءات أدوات REST envelopes موحّدة للنجاح والأخطاء. تعيد أخطاء التحقق payloads منظمة تحتوي ok: false بدلاً من استثناءات framework الخام.

يتوفر سجل Skills الثابت أيضاً عبر REST:

GET  /tools/skill_list
POST /tools/skill_load       {"name": "debugging"}
POST /tools/skill_read  {"name": "debugging", "path": "checklist.md"}

تظهر تغييرات مجلدات Skill في الاستدعاء التالي ولا تغيّر قائمة أدوات MCP.

يقدّم تطبيق HTTP المدمج تنزيلات الملفات المرمّزة. الروابط هي bearer URL مع TTL وحد أقصى اختياري لعدد التنزيلات ودعم الإلغاء.

ينبغي استخدام OAuth في عمليات النشر العامة. يمكن تفعيل localhost bypass للتطوير، لكن الوصول العام دون مصادقة غير آمن.