Slima MCP

القراءة والكتابة في كتب Slima من Claude / ChatGPT / Cursor / Gemini

إعداد MCP الأول

• 01 ما هو Slima MCP MCP بروتوكول قياسي يسمح لأدوات الذكاء الاصطناعي بقراءة الأنظمة الخارجية والكتابة فيها. Slima MCP يربط Slima بهذه المنظومة.
• 02 Slima MCP مقابل File MCP ثلاث طرق لوصول الذكاء الاصطناعي إلى نصّك. تعرّف على الفرق بين Slima MCP و File MCP و مدرب الذكاء الاصطناعي، واختر الأداة المناسبة لكل مهمة.
• 03 اختيار طريقة الاتصال المناسبة تعتمد طريقة الربط على أداة الذكاء الاصطناعي التي تستخدمها — الأدوات على الويب تستخدم OAuth، والأدوات المحلية تستخدم stdio.

اتصال الويب (OAuth)

• 01 الربط من Claude.ai أبسط الطرق للربط بـ Slima — ثلاث خطوات فقط، دون أي تثبيت. أضِف موصِّلًا مخصصًا وأذِن عبر OAuth.
• 02 الربط من ChatGPT يحتاج ChatGPT خطوة إضافية مقارنة بـ claude.ai: تفعيل Developer Mode أولاً. اتبع الخطوات لإضافة خادم Slima MCP والاتصال عبر OAuth.

الاتصال المحلي (stdio)

• 01 ربط Claude Desktop يستخدم Claude Desktop آلية stdio (وليس OAuth). عدّل ملف الإعداد وشغّل npx -y slima-mcp@0 ثم تحقق من ظهور الأيقونة.
• 02 ربط Cursor Cursor عبارة عن IDE — يستخدم إعداد stdio MCP العام. اتبع الخطوات لإضافة خادم slima ثم اختبر الاتصال.
• 03 توصيل Gemini CLI Gemini CLI: `gemini mcp add slima --command "npx -y slima-mcp@0"`. يستلزم Gemini CLI ≥ 0.4.
• 04 توصيل VS Code يتصل VS Code عبر إضافات MCP. الأكثر شيوعاً: MCP Tools / Continue.

رموز API

• 01 الحصول على SLIMA_API_TOKEN مساران: شغّل `npx slima-mcp@0 auth` (تسجيل دخول عبر المتصفح، يُحفظ في ~/.slima/credentials.json)؛ أو اضبط SLIMA_API_TOKEN يدوياً على جهاز headless / CI.
• 02 مرجع أوامر slima-mcp CLI كل أوامر `slima-mcp` CLI: auth / status / logout / --help / --version. وصف + أمثلة.
• 03 إدارة التطبيقات المرخّصة الحساب ← API tokens / التطبيقات المرخّصة: ترى ما المتصل، وآخر استخدام، وتُلغي بشكل فردي أو جماعي.

الإصدارات والترقيات

• 01 لماذا `slima-mcp@0`: شرح تثبيت الإصدار كل الأمثلة تستخدم `slima-mcp@0` لا `slima-mcp`. الـ `@0` تثبيت للإصدار الرئيسي — يأخذ تلقائياً تصحيحات/إصدارات 0.x الفرعية لكنك تختار يدوياً الانتقال إلى تغييرات 1.0 الكاسرة.
• 02 الترحيل من التثبيت العام إلى `npx` كانت الإصدارات الأقدم تستخدم `npm install -g slima-mcp`. النمط الجديد هو `npx -y slima-mcp@0`. لمَ ترحّل وكيف.
• 03 كيف تعمل إصدارات slima-mcp 0.3.0 (2026-09-09). الخادم لا يحجب العميل القديم أبدًا؛ العميل القديم فقط يملك أدوات أقلّ. كيف تعرف إصدارك وكيف ترقّيه.

مرجع الأدوات

• 01 أدوات إدارة الكتاب (5) يكشف Slima MCP عن خمس أدوات على مستوى الكتاب: create_book / list_books / get_book / get_book_structure / get_writing_stats. مدخلات ومخرجات وأمثلة.
• 02 أدوات الملفات وسائط وسلوك read_file / edit_file / write_file / create_file / delete_file / append_to_file / search_content، وأنواع الملفات التي لا تستطيع هذه المجموعة لمسها.
• 03 أدوات قارئ الذكاء الاصطناعي (2) أداتان في MCP تكشفان عن قارئ بيتا AI: list_personas و analyze_chapter. المدخلات والمخرجات والمقابلة مع القراءة داخل Slima.
• 04 أدوات التحرير المهيكل (update_*) كيف تغيّر أدوات update_* لوحة الإيقاعات أو الخط الزمني أو السيناريو أو خريطة العلاقات أو خريطة العالم: عملية واحدة في كل مرة، وربط بـ op_ref، ودفعة كلٌّ لا يتجزأ.
• 05 أدوات الملاحظات والتعليقات دعْ أداة AI خارجية تقرأ ملاحظاتك وتكتب فيها وتشارك في دورة التعليقات: list_notes / create_note / list_comments / create_comment / resolve_comment / reopen_comment.
• 06 البحث الدلالي مقابل البحث النصي semantic_search يطابق المعنى، و search_content يطابق الكلمات. أي سؤال يخصّ أي أداة، وكيف يُبنى الفهرس.

أنواع الملفات والأذونات

• 01 ما الذي يستطيعه MCP مع كل نوع ملف المصفوفة الكاملة: ملفات النثر تقبل الكتابة الكاملة، والأنواع المهيكلة الخمسة تقبل أدوات حقلية، وأنواع لا تقبل شيئًا منهما — مع قواعد المسارات في كتب استوديو السيناريو القديمة.
• 02 حماية الملفات المهيكلة: كيف تقرأ الرفض ماذا يعني كل من AI_READONLY_FILE_TYPE و SUBSCRIPTION_REQUIRED و INVALID_PATH و FOLDER_NOT_EMPTY، والخطوة الصحيحة أمام كل واحد منها.
• 03 أدوات تسلك سلوكًا مختلفًا مع ملفات بعينها استثناءات read_file و search_content و semantic_search و analyze_chapter و get_writing_stats و create_file و delete_file — وما تفعله أمام كل منها.

متقدم: المخطط والاستضافة الذاتية

• 01 استعلام مخطّط الكتاب عبر المورد المورد `slima://books/{book_token}/schema` في MCP يُعيد قواعد المسارات للقراءة فقط وللكتابة بدقّة — يستخدمه الذكاء الاصطناعي ليعرف إن كان مسار ما قابلاً للكتابة.
• 02 الاستضافة الذاتية على Cloudflare Worker (متقدّم) يعمل خادم Slima MCP على Cloudflare Workers (مفتوح المصدر). يمكنك عمل fork ونشر نسختك وتخصيص OAuth وإضافة middleware.
• 03 الأدلة ومهارات الكتابة get_capabilities وأدلة التشغيل الخاصة بـ Slima ومهارات الكتابة فيه: كيف يسلّم Slima قواعده الخاصة إلى أداة الـ AI عندك.
• 04 دعِ الـ AI يرى خريطة العلاقات view_relationship_map يعيد صورة مع ملخّص مقروء، وهو أفضل من قراءة JSON الخام لملف .map — والردود الأربعة التي ستصادفها.

حل المشكلات

• 01 تعذّر الاتصال: 401 / ترويسة Authorization أكثر فشل اتصال شيوعاً في MCP: 401 Unauthorized. الأسباب: انتهاء صلاحية الرمز / تكوين خاطئ / فشل مسار WWW-Authenticate. خطوات تشخيص.
• 02 انتهت صلاحية الرمز أو يلزم إعادة المصادقة تُصدَر رموز MCP من تسجيل دخول Slima OAuth وتنتهي صلاحيتها دورياً. الانتهاء يعيد 401؛ إعادة المصادقة (تلقائية عبر الويب غالباً) تصلحه. كيف تكتشف / تحدّث.
• 03 رفض الكتابة: ما العمل ماذا يعني كل من AI_READONLY_FILE_TYPE و SUBSCRIPTION_REQUIRED و INVALID_PATH و FOLDER_NOT_EMPTY، وحالة create_file التي تنجح وتترك ملفًا فارغًا.
• 04 متقدّم: تصحيح مسار OAuth مسار OAuth بتسع خطوات: DCR ← authorize ← callback ← token ← mcp. تتبّع الخطوة الفاشلة بـ `wrangler tail` أو curl.