الربط عبر MCP

اربط المنصة بـ Claude أو ChatGPT أو Cursor واسألها عن بياناتك بالعربي.

جاهز للاستخدام الواجهة البرمجية وخادم MCP اتبنوا وشغالين. اتبع الخطوات تحت وهتقدر تسأل مساعدك الذكي عن المنصة مباشرة.

إيه اللي تقدر تسأله؟

«كام طالب وكام مدرّس على المنصة؟ وفيه كام طلب تسجيل مستني؟»
«مين الطلاب المتعثّرين؟ ومين غاب أكتر من مرة ورا بعض؟»
«إيه أفضل المدرّسين عندي؟»
«وريني الإيرادات آخر ٦ شهور.»
«كام أكاديمية عندي؟ ومين منهم مرخّصة؟»

قبل ما تبدأ

Node.js مثبّت على جهازك (الإصدار ١٨ أو أحدث).
مفتاح الـ API — موجود على الخادم في ملف البيئة تحت Api__McpKey.
ملف الخادم mcp-server/index.mjs من مستودع المشروع.

المفتاح ده زي كلمة السر أي حد معاه المفتاح يقدر يقرأ بيانات المنصة. ما تحطّوش في مكان عام ولا في لقطة شاشة. لو تسرّب، غيّر قيمة Api__McpKey على الخادم وأعد التشغيل — المفتاح القديم يبطل فورًا.

الإعداد — Claude Desktop

افتح ملف الإعدادات:

ويندوز: %APPDATA%Claudeclaude_desktop_config.json
ماك: ~/Library/Application Support/Claude/claude_desktop_config.json

وضيف:

{
  "mcpServers": {
    "future-academy": {
      "command": "node",
      "args": ["C:\path\to\mcp-server\index.mjs"],
      "env": {
        "FA_API_BASE": "https://futureacademy.cc",
        "FA_API_KEY": "ضع-المفتاح-هنا"
      }
    }
  }
}

اقفل البرنامج وافتحه تاني، وهتلاقي أدوات future-academy ظهرت.

الإعداد — Cursor

في .cursor/mcp.json جوه مشروعك (أو الإعدادات العامة) حط نفس المحتوى بالظبط.

الإعداد — ChatGPT

مختلف شوية ChatGPT بيدعم MCP من خلال Developer mode / Connectors، وبيحتاج الخادم يكون متاح على الإنترنت مش على جهازك. الإعداد الحالي بيشتغل محليًا، فلو محتاجه على ChatGPT هنحتاج نعمل نسخة منشورة — كلّمنا ونعملها.

الأدوات المتاحة

الأداة	بترجّع إيه
`fa_overview`	أعداد الطلاب والمدرّسين وأولياء الأمور والكورسات، والطلبات المستنية.
`fa_courses`	الكورسات بأسمائها ومدرّسها وسعرها.
`fa_academies`	الأكاديميات وحالة الترخيص.
`fa_at_risk_students`	الطلاب المتعثّرين ونسبة حضورهم.
`fa_top_courses`	أفضل الكورسات أداءً.
`fa_top_instructors`	أفضل المدرّسين.
`fa_revenue`	الإيرادات شهريًا.

الحدود — مهم تعرفها

قراءة فقط، ومفيش بيانات شخصية

مستحيل يعدّل أو يمسح أي حاجة — مفيش أداة كتابة أصلًا.
مش بيرجّع إيميلات ولا أرقام تليفونات ولا بيانات دفع. الأسماء بس.
ده مقصود: المنصة فيها بيانات قاصرين، وأي حاجة بترجع هنا بتروح لنموذج ذكاء اصطناعي خارجي.

لو مشتغلش

المشكلة	السبب الأرجح
«Not found (404)»	المفتاح غلط، أو مش متظبط على الخادم.
الأدوات مش ظاهرة	مسار الملف في `args` غلط، أو البرنامج محتاج إعادة تشغيل.
«Could not reach»	مفيش إنترنت، أو `FA_API_BASE` مكتوب غلط.