خادم MCP الإداري

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

هذه الصفحة عامة حتى تتمكن أدوات الذكاء الاصطناعي من قراءة شرح الإعداد. نقطة نهاية MCP نفسها تبقى مخصصة للمسؤولين فقط وتتطلب مفتاح Bearer صالح ومحدد الصلاحيات.

صفحة الشرح العامة:

https://esportscommunity.net/docs/admin-mcp

نقطة النهاية

الإنتاج:

https://esportscommunity.net/api/mcp

التطوير المحلي:

http://localhost:3000/api/mcp

الترويسات المطلوبة:

Authorization: Bearer <ec_mcp_live_...>
Content-Type: application/json
Accept: application/json, text/event-stream

يتم رفض مصفوفات JSON-RPC batch عمدا. أرسل طلب MCP واحدا في كل مرة.

إنشاء مفتاح

1. سجل الدخول إلى لوحة التحكم بحسابك الإداري.
2. افتح /admin/mcp.
3. أنشئ مفتاحا لحساب ديسكورد المسجل حاليا.
4. اختر الأدوات وأصغر نطاق مفيد من الألعاب أو المنصات الإعلامية.
5. انسخ مفتاح ec_mcp_live_… الذي يتم إنشاؤه فورا.

يظهر المفتاح الكامل مرة واحدة فقط. قاعدة البيانات تحفظ فقط SHA-256 hash، وبادئة قصيرة، وبيانات المالك، والنطاقات، والطوابع الزمنية، وحالة الإلغاء. يستطيع المسؤولون محدودو النطاق إنشاء وإلغاء مفاتيحهم فقط، بينما يستطيع المسؤولون الأعلى عرض وإلغاء كل المفاتيح.

الأدوات

يتضمن MCP الإداري كل أدوات القراءة العامة، لذلك لا يحتاج المسؤولون إلى إضافة MCP العام بشكل منفصل. الأدوات المتاحة دائما تعمل مع أي مفتاح MCP إداري صالح. الأدوات التي تتطلب اختيارها تحتاج إلى منح صريح في المفتاح.

• get_site_overview (تتطلب اختيارها في المفتاح): يعرض أعداد الموقع والبوت، وقد تتضمن المكالمات الإدارية سياقا من لوحة التحكم حسب الصلاحيات.
• list_games (متاحة دائما): يعرض دليل الألعاب العام حسب اللغة.
• get_admin_capabilities (متاحة دائما): يعرض الأدوات المتاحة لهذا المفتاح ومعرفات الألعاب والقنوات الإعلامية وقنوات البث التي يمكنه استخدامها.
• search_news (تتطلب اختيارها في المفتاح): يبحث في الأخبار المنشورة للعامة أو في أخبار الإدارة الظاهرة ضمن نطاق المفتاح.
• get_tournament_status (تتطلب اختيارها في المفتاح): يعرض المباريات والترتيب لبطولة واحدة متتبعة.
• list_tournaments (متاحة دائما): يعرض ملخصات البطولات العامة النشطة.
• get_ewc_club_summary (تتطلب اختيارها في المفتاح): يعرض نقاط أندية EWC والألعاب المتأهلة والانتصارات وبيانات المناطق.
• get_ewc_club_standings (متاحة دائما): يعرض ترتيب بطولة أندية EWC الرسمي من آخر نسخة محفوظة.
• list_co_streams (متاحة دائما): يعرض مجموعات البثوث المشتركة العامة مع المباشر أولا.
• search_teams (متاحة دائما): يبحث في دليل الفرق العام باستخدام حقول عامة آمنة.
• search_players (متاحة دائما): يبحث في دليل اللاعبين العام باستخدام حقول عامة آمنة.
• get_public_ewc_leaderboard (متاحة دائما): يعرض لوحة توقعات EWC العامة الحالية.
• list_admin_queue (تتطلب اختيارها في المفتاح): يعرض التعليقات المبلغ عنها التي تحتاج إلى مراجعة إدارية.
• create_news_draft (تتطلب اختيارها في المفتاح): ينشئ مسودة خبر في لعبة أو قناة إعلامية مسموح بها، ويتطلب idempotencyKey لإعادة المحاولة بأمان، ولا ينشر مباشرة أبدا.
• update_stream_channel (تتطلب اختيارها في المفتاح): يحدث صفوف البث المشترك المسموح بها، ويتطلب idempotencyKey لإعادة المحاولة بأمان.

كل عملية كتابة ناجحة تسجل إدخالا في سجل تدقيق الإدارة باستخدام actor id بالشكل mcp:<key-id>:<owner-discord-id>.

مثال سير عمل

1. استدع get_admin_capabilities.
2. اختر slug لعبة أو قناة إعلامية أو id قناة بث مسموحا به من الاستجابة.
3. استدع create_news_draft أو update_stream_channel باستخدام المورد المسموح.

إعداد العميل

استخدم إعداد Streamable HTTP MCP الأصلي عندما يدعمه العميل.

للعملاء الذين يدعمون stdio فقط، مثل بعض إعدادات Claude Code أو Cursor أو VS Code أو Codex، استخدم mcp-remote:

{
  "mcpServers": {
    "esports-community-admin": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://esportscommunity.net/api/mcp",
        "--header",
        "Authorization: Bearer <MCP_KEY>"
      ]
    }
  }
}

لإعداد Codex عبر config.toml باستخدام stdio:

[mcp_servers.esports-community-admin]
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://esportscommunity.net/api/mcp",
  "--header",
  "Authorization: Bearer <MCP_KEY>",
]

لإصدارات Codex التي تدعم Streamable HTTP بشكل مباشر، ضع المفتاح الخام في متغير بيئة ثم أشر إلى اسم المتغير:

[mcp_servers.esports_community]
enabled = true
url = "https://esportscommunity.net/api/mcp"
bearer_token_env_var = "ESPORTS_COMMUNITY_MCP_TOKEN"

يجب أن يحتوي ESPORTS_COMMUNITY_MCP_TOKEN على مفتاح ec_mcp_live_… الخام، بدون Bearer.

أعد تشغيل عميل MCP بعد تغيير الإعدادات.

ملاحظات الأمان

• يستطيع المسؤولون إنشاء مفاتيح MCP لحسابهم المسجل فقط.
• يستطيع المسؤولون محدودو النطاق اختيار النطاقات المخصصة لهم فقط.
• يستطيع المسؤولون الأعلى عرض وإلغاء كل مفاتيح MCP.
• اجعل نطاق المفتاح على أصغر مجموعة أدوات أو ألعاب أو منصات مفيدة.
• تعامل مع مفاتيح MCP مثل بيانات اعتماد الإدارة.
• لا تلصق المفاتيح الحقيقية في لقطات الشاشة أو commits أو تعليقات issues أو prompts مشتركة.
• ألغ المفاتيح القديمة بعد تدويرها.