لقد كنت أجرب Discourse MCP ولكني وجدت أن التوثيق الحالي في Meta لاستخدامه لم يتضمن أي شيء خاص بـ Codex CLI، وكان من المحير بعض الشيء معرفة أي أجزاء من التوثيق ستكون قابلة للتطبيق:
- هل هو
npxأمnpm install؟ - ما هي أجزاء الإعداد الخاصة بـ Codex وما هي الخاصة بـ Discourse MCP؟
- أين أضع الإعدادات مثل
read_only: false؟
لذلك، بعد قدر لا بأس به من التجريب، إليك دليل مُختبَر لتثبيت Discourse MCP في Codex CLI، وسأتابع في الأيام القادمة بدليل لـ Claude Code CLI و opencode. إذا كانت هناك عملاء MCP آخرون تود استخدامهم، فأخبرني في الردود وسأحاول المساعدة.
المتطلبات الأساسية:
- تثبيت Node.js (يُوصى بـ 24 LTS)
- تثبيت Codex CLI
- الوصول إلى https://discourse.example.com كمستخدم عادي
من المهم أن ندرك أن هناك ثلاثة مكونات منفصلة هنا:
- منتدى Discourse البعيد، وهو مصدر البيانات والهدف للإجراءات.
- خادم Discourse MCP، وهو أداة مفتوحة المصدر تعمل محليًا تتصل بـ Discourse وتوفر واجهة برمجة تطبيقات (API) لـ Codex للتفاعل مع Discourse. يتم تثبيته كخادم STDIO ويتم تشغيله عند الطلب بواسطة Codex CLI.
- 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:
قم بتشغيل هذا في طرفية (Terminal) (وليس داخل 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 مدرجًا عند تشغيل الأمر ‘slash’ /mcp في Codex CLI.
في Codex CLI، يمكنك أن تطلب من Codex الرجوع إلى هذا المنتدى للحصول على معلومات - خاصة المعلومات التي لديك وصول إليها ولكنها ليست عامة - وهذا سيتحقق من أنه يتصل بك.
تعديل الإعدادات
في مرحلة ما قد ترغب في تعديل الإعدادات لإضافة القدرة على الكتابة إلى Discourse، وستقوم بذلك في إعدادات Discourse.
من المربك أن هناك مكانين يتم فيهما تخزين الإعدادات وبين وثائق Codex ووثائق Discourse، فمن المحير حقًا، خاصة لفهم أي الأجزاء تنتمي إلى Codex CLI وأيها جزء من خادم MCP STDIO نفسه.
هناك ملفان رئيسيان:
-
=CODEX-CONFIG=- هذا هو ملف تكوين Codex CLI، والذي يتضمن إعدادات خادم MCP. -
=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