إعداد Discourse MCP في واجهة سطر الأوامر لـ OpenAI Codex

ويكي المجتمع المستخدمون
, ,
1

لقد كنت أجرب Discourse MCP ولكني وجدت أن التوثيق الحالي في Meta لاستخدامه لم يتضمن أي شيء لـ Codex CLI، وكان من المحير بعض الشيء معرفة أي أجزاء من التوثيق ستنطبق:

  • هل هو npx أم npm install؟
  • ما هي الأجزاء التي تخص Codex وما هي الأجزاء التي تخص Discourse MCP؟
  • أين أضع الإعدادات مثل read_only: false؟

لذا، بعد الكثير من التجريب، إليك دليل مُختبَر لتثبيت Discourse MCP في Codex CLI، وسأتابع في الأيام القادمة بدليل لـ Claude Code CLI وopencode. إذا كانت هناك عملاء MCP آخرون تود استخدامهم، فأخبرني في الردود وسأحاول المساعدة.

تعديل: 2026.03.13 - لقد كتبت دليلاً لـ opencode الذي يحتوي على تنسيق ملف تكوين مختلف قليلاً لـ MCPs قد يكون مربكًا للبعض.

المتطلبات الأساسية:

من المهم إدراك أن هناك ثلاثة مكونات منفصلة هنا:

  1. منتدى Discourse البعيد، وهو مصدر البيانات والهدف للإجراءات.

  1. خادم Discourse MCP، وهو أداة مفتوحة المصدر تعمل محليًا تتصل بـ Discourse وتوفر واجهة برمجة تطبيقات (API) لـ Codex للتفاعل مع Discourse. يتم تثبيتها كخادم STDIO ويتم تشغيلها عند الطلب بواسطة Codex CLI.

  1. Codex CLI، وهو عميل MCP الذي يتصل بخادم MCP ويوفر الواجهة للتفاعل مع Discourse عبر واجهة برمجة تطبيقات MCP.

1. إنشاء مفتاح API للمستخدم

سيؤدي هذا إلى مصادقتك لدى Discourse وهذه هي الطريقة التي ستحصل بها على مفتاح API الخاص بك. سيقوم npx بتنزيل وتشغيل التعليمات البرمجية، ولا يحتاج أي شيء إلى التثبيت بالمعنى التقليدي.

في الطرفية (terminal)، قم بتشغيل:

npx @discourse/mcp@latest generate-user-api-key \
  --site =DISCOURSE-FORUM= \
  --save-to =MCP-CONFIG=

وافق على موافقة المتصفح وانسخ البيانات المشفرة مرة أخرى، مما يثبت قدرتك على تسجيل الدخول وينشئ مفتاح API يتم حفظه في =MCP-CONFIG= ليستخدمه خادم MCP.

سيحتوي مفتاح API على نفس مستوى الوصول إلى المنتدى الذي لديك كمستخدم.

2. إضافة خادم MCP إلى Codex CLI:

قم بتشغيل هذا في طرفية (وليس داخل Codex CLI نفسه)

codex mcp add discourse \
  -- npx -y @discourse/mcp@latest \
  --profile =MCP-CONFIG=

يتم تثبيته كـ خادم STDIO، لذلك سيتم تشغيله عند الطلب باستخدام npx بواسطة Codex CLI عند بدء تشغيل Codex CLI.

تم تكوينه لاستخدام الملف الشخصي في =MCP-CONFIG= ويكون للقراءة فقط افتراضيًا.

3. أعد تشغيل Codex CLI

أعد تشغيل Codex بالكامل حتى يقوم بإعادة تحميل config.toml والملف الشخصي.

إذا بدأ بدون أخطاء، فلا توجد مشكلات في التكوين ويجب أن ترى خادم MCP مدرجًا عند تشغيل أمر الشرطة المائلة /mcp في Codex CLI.

في Codex CLI، يمكنك أن تطلب من Codex الرجوع إلى Discourse هذا للحصول على معلومات - خاصة المعلومات التي يمكنك الوصول إليها ولكنها ليست عامة - وهذا سيؤكد أنه يتصل بك.

4. تمكين ميزات الكتابة (اختياري)

افتراضيًا، يعمل خادم Discourse MCP في وضع القراءة فقط. لتمكين عمليات الكتابة (إنشاء المشاركات، والمواضيع، والمستخدمين، وما إلى ذلك)، تحتاج إلى إضافة علامتين إلى ملف JSON الشخصي الخاص بك.

قم بتحرير الملف الشخصي لـ Discourse في =MCP-CONFIG= وأضف "read_only": false و "allow_writes": true كأشقاء لمصفوفة auth_pairs:

{
  "read_only": false,
  "allow_writes": true,
  "auth_pairs": [
    {
      "site": "=DISCOURSE-FORUM=",
      "user_api_key": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "user_api_client_id": "discourse-mcp"
    }
  ]
}

مثال:

{
  "read_only": false,
  "allow_writes": true,
  "auth_pairs": [
    {
      "site": "https://meta.discourse.org",
      "user_api_key": "abc123def456ghi789jkl012mno345pqr",
      "user_api_client_id": "discourse-mcp"
    }
  ]
}

بعد إضافة هذه العلامات، أعد تشغيل OpenCode CLI حتى تسري التغييرات. سيسمح خادم MCP الآن بعمليات الكتابة مثل:

  • إنشاء وتحديث المواضيع
  • إنشاء المشاركات والردود
  • إدارة المسودات
  • تحميل الملفات
  • إنشاء الفئات (إذا كان لديك الإذن)
  • إدارة المستخدمين (إذا كان لديك إذن المسؤول)

تحذير: ستستخدم عمليات الكتابة أذونات حساب المستخدم الخاص بك. سيظهر أي محتوى تم إنشاؤه كما لو كنت قد أنشأته يدويًا. استخدم ميزات الكتابة بمسؤولية.

تحرير الإعدادات

في مرحلة ما قد ترغب في تعديل الإعدادات من أجل إضافة القدرة على الكتابة إلى Discourse، وستقوم بذلك في إعدادات Discourse.

من المربك أن هناك مكانين يتم فيهما تخزين الإعدادات وبين وثائق Codex ووثائق Discourse، يكون الأمر مربكًا حقًا، خاصةً فيما يتعلق بتحديد الأجزاء التي تنتمي إلى Codex CLI والأجزاء التي تخص خادم MCP STDIO نفسه.

هناك ملفان رئيسيان:

  1. =CODEX-CONFIG= - هذا هو ملف تكوين Codex CLI، والذي يتضمن إعدادات خادم MCP.

  2. =MCP-CONFIG= - هذا هو الملف الشخصي لخادم Discourse MCP، والذي يتضمن مفتاح API والإعدادات الأخرى للاتصال بـ Discourse.

إعدادات Codex CLI

الإعدادات الخاصة بالاتصال بـ MCP موجودة في =CODEX-CONFIG= ويجب أن تبدو مشابهة لهذا. إذا كنت ترغب في إضافة خيارات إلى خادم MCP، فأضفها هنا.

# =CODEX-CONFIG=
[mcp_servers.discourse]
command = "npx"
args = ["-y", "@discourse/mcp@latest", "--profile", "=MCP-CONFIG="]

توثيق إعدادات Codex MCP Model Context Protocol

إعدادات Discourse MCP

الإعدادات الخاصة بخادم Discourse MCP نفسه موجودة في =CODEX-CONFIG=

# =MCP-CONFIG=
{
  "profiles": [
    {
      "site": "=DISCOURSE-FORUM=",
      "user_api_key": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "user_api_client_id": "discourse-mcp"
    }
  ]
}

مرجع توثيق إعدادات Discourse MCP GitHub - discourse/discourse-mcp: MCP client for Discourse sites · GitHub

3 إعجابات
Discourse MCP is here!
Discourse MCP Setup in OpenCode CLI