من ملفات مشروعك إلى أسئلة تستحق الإجابة.

١. ثبّت الأداة في مجلد مستقل

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

node --version
npm init -y
npm install --ignore-scripts --no-audit --no-fund "/absolute/downloads/azizme-saudi-hosting-review-0.1.0-beta.2.tgz"

التثبيت يجلب الاعتماديات المثبتة الإصدارات من npm؛ الفحص بعد التثبيت لا يحتاج إلى شبكة أو مفتاح مزود ذكاء اصطناعي.

٢. استعرض النطاق، ثم افحص

node "/absolute/tool/node_modules/@azizme/saudi-hosting-review/dist/cli.js" list --root "/absolute/project"
node "/absolute/tool/node_modules/@azizme/saudi-hosting-review/dist/cli.js" inspect --root "/absolute/project" --locale ar --format markdown

استخدم --format json لملف منقح تقرؤه في العارض. خيارات الحفظ الآمن والملفات المستبعدة وحدود الفحص موضحة في README. نتيجة الفحص لا تثبت مواقع الإنتاج أو النسخ أو العقود.

لإضافة حقائق المكونات، انسخ examples/scope-input.unknown.json من الحزمة المثبتة إلى مجلد عمل خاص خارج مشروع التطبيق، وحدّث وصف الخدمة وجردها. أبقِ المواقع غير المثبتة مجهولة؛ القالب لا يُعدّ دليلاً. ثم أضف إلى أمر inspect: --scope-input "/private/review/scope-input.json"

٣. اربط مساعدك المحلي عند الحاجة

في مشروع Codex الموثوق الذي اخترته، ادمج المقطع التالي في .codex/config.toml بعد استبدال المسارات. لا تستبدل إعداداً موجوداً. هذا الربط خاص بالمشروع؛ لا يغيّر الموقع إعدادات مساعدك أو يطلق عملية محلية.

[mcp_servers.saudi-hosting-review]
command = "node"
args = ["/absolute/tool/node_modules/@azizme/saudi-hosting-review/dist/server.js", "--root", "/absolute/project"]
startup_timeout_sec = 30
tool_timeout_sec = 20
enabled = true

تحقق من الاتصال عبر /mcp. إذا كان العميل يستخدم إصدار Node مختلفاً، ضع المسار المطلق لـ Node.js 22 أو أحدث بدلاً من node. أمر codex mcp add بديل يغيّر إعداد المستخدم العام؛ استخدمه فقط إذا أردت ذلك النطاق.

في Claude Code، ادمج قالب examples/claude.mcp.json في .mcp.json للمشروع، ثم راجع موافقة الاتصال داخل العميل. لا يربط تثبيت المهارة خادم MCP تلقائياً.

توثيق Codex الرسمي لـ MCP · اختُبر اكتشاف الأدوات والفحص والتقرير عبر عميل Codex الفعلي دون استدعاء نموذج. تحقّق Claude Code من بنية المهارة واكتشف إعداد المشروع؛ تبقى موافقته واستخدام النموذج خطوات للمستخدم. تفاصيل الاختبار في الدليل.