@intlayer/docs 5.5.11 → 5.6.0

package/docs/ar/intlayer_with_vite+solid.md

@@ -14,6 +14,7 @@ slugs:
   - doc
   - environment
   - vite-and-solid
+# applicationTemplate: https://github.com/aymericzip/intlayer-vite-solid-template
 ---
 
 # البدء في التدويل (i18n) باستخدام Intlayer و Vite و Solid
@@ -43,17 +44,17 @@ slugs:
 
 ```bash packageManager="npm"
 npm install intlayer solid-intlayer
-npm install --save-dev vite-intlayer
+npm install vite-intlayer --save-dev
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer solid-intlayer
-pnpm add --save-dev vite-intlayer
+pnpm add vite-intlayer --save-dev
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer solid-intlayer
-yarn add --save-dev vite-intlayer
+yarn add vite-intlayer --save-dev
 ```
 
 - **intlayer**

package/docs/ar/intlayer_with_vite+svelte.md

@@ -14,6 +14,7 @@ slugs:
   - doc
   - environment
   - vite-and-svelte
+# applicationTemplate: https://github.com/aymericzip/intlayer-vite-svelte-template
 ---
 
 # البدء في التدويل (i18n) باستخدام Intlayer و Vite و Svelte
@@ -43,17 +44,17 @@ slugs:
 
 ```bash packageManager="npm"
 npm install intlayer svelte-intlayer
-npm install --save-dev vite-intlayer
+npm install vite-intlayer --save-dev
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer svelte-intlayer
-pnpm add --save-dev vite-intlayer
+pnpm add vite-intlayer --save-dev
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer svelte-intlayer
-yarn add --save-dev vite-intlayer
+yarn add vite-intlayer --save-dev
 ```
 
 - **intlayer**

package/docs/ar/intlayer_with_vite+vue.md

@@ -14,6 +14,7 @@ slugs:
   - doc
   - environment
   - vite-and-vue
+applicationTemplate: https://github.com/aymericzip/intlayer-vite-vue-template
 ---
 
 # البدء في التدويل (i18n) باستخدام Intlayer و Vite و Vue
@@ -41,17 +42,17 @@ slugs:
 
 ```bash packageManager="npm"
 npm install intlayer vue-intlayer
-npm install --save-dev vite-intlayer
+npm install vite-intlayer --save-dev
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer vue-intlayer
-pnpm add --save-dev vite-intlayer
+pnpm add vite-intlayer --save-dev
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer vue-intlayer
-yarn add --save-dev vite-intlayer
+yarn add vite-intlayer --save-dev
 ```
 
 - **intlayer**
@@ -954,7 +955,7 @@ import RouterLink from "@components/RouterLink.vue";
 
 > لرؤية كيفية إعلان محتوى Markdown باستخدام حزمة `intlayer`، راجع [توثيق markdown](https://github.com/aymericzip/intlayer/tree/main/docs/ar/dictionary/markdown.md).
 
-```ts filename="main.ts"
+```ts fileName="main.ts"
 import MarkdownIt from "markdown-it";
 import { createApp, h } from "vue";
 import { installIntlayer, installIntlayerMarkdown } from "vue-intlayer";

package/docs/ar/mcp_server.md

@@ -1,48 +1,75 @@
 ---
 createdAt: 2025-06-07
-updatedAt: 2025-06-07
+updatedAt: 2025-07-11
 title: توثيق خادم MCP
 description: استكشف ميزات وإعداد خادم MCP لتحسين إدارة وتشغيل الخادم الخاص بك.
 keywords:
   - خادم MCP
   - إدارة الخادم
   - تحسين
-  - إنتلاير
-  - توثيق
-  - إعداد
-  - ميزات
+  - Intlayer
+  - التوثيق
+  - الإعداد
+  - الميزات
 slugs:
   - doc
   - mcp-server
 ---
 
-# خادم MCP الخاص بإنتلاير
+# خادم Intlayer MCP
 
-يقدم **خادم MCP (بروتوكول سياق النموذج) الخاص بإنتلاير** مساعدة مدعومة بالذكاء الاصطناعي داخل بيئة التطوير المتكاملة (IDE) مصممة خصيصًا لنظام إنتلاير البيئي. تم تصميمه لبيئات المطورين الحديثة مثل **Cursor**، و**مساحة عمل GitHub Copilot**، وأي بيئة تطوير متكاملة تدعم بروتوكول MCP، حيث يوفر هذا الخادم دعمًا سياقيًا وفوريًا بناءً على إعداد مشروعك.
+يوفر **خادم Intlayer MCP (بروتوكول سياق النموذج)** مساعدة مدعومة بالذكاء الاصطناعي لبيئات التطوير المتكاملة (IDE) مصممة خصيصًا لنظام Intlayer.
 
-## لماذا تستخدم خادم MCP الخاص بإنتلاير؟
+## أين يمكنني استخدامه؟
 
-بتمكين خادم MCP الخاص بإنتلاير في بيئة التطوير المتكاملة لديك، ستحصل على:
+- في بيئات التطوير الحديثة مثل **Cursor**، **VS Code**، وأي بيئة تطوير متكاملة تدعم بروتوكول MCP.
+- على مساعد الذكاء الاصطناعي المفضل لديك مثل **Claude Desktop**، **Gemini**، **ChatGPT**، وغيرها.
 
-- **تكامل ذكي مع واجهة الأوامر (CLI)**
-  الوصول إلى أوامر واجهة الأوامر الخاصة بإنتلاير وتشغيلها مباشرة من واجهة بيئة التطوير المتكاملة الخاصة بك. يمكنك عرض القائمة الكاملة للأوامر والخيارات في [توثيق واجهة أوامر إنتلاير](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_cli.md).
+## لماذا تستخدم خادم Intlayer MCP؟
 
-- **توثيق واعٍ للسياق**
-  يقوم خادم MCP بتحميل وعرض التوثيق الذي يتوافق مع إصدار إنتلاير الذي تستخدمه في مشروعك. هذا يضمن أن تكون اقتراحات الكود، وخيارات الأوامر، والتفسيرات دائمًا محدثة وذات صلة.
+بتمكين خادم Intlayer MCP في بيئة التطوير المتكاملة الخاصة بك، يمكنك الوصول إلى:
 
-- **تطوير بمساعدة الذكاء الاصطناعي**
-  مع اقتراحات واعية للسياق في المشروع وإكمال تلقائي، يمكن للمساعد الذكي شرح كودك، أو التوصية باستخدام واجهة الأوامر (CLI)، أو اقتراح كيفية استخدام ميزات محددة من إنتلاير بناءً على ملفاتك الحالية.
+- **توثيق مدرك للسياق**
+  يقوم خادم MCP بتحميل وعرض توثيق Intlayer. لتسريع إعدادك، وترحيلاتك، وما إلى ذلك.
+  هذا يضمن أن اقتراحات الكود، وخيارات الأوامر، والتفسيرات تكون دائمًا محدثة وذات صلة.
 
-- **خفيف الوزن وإعداد فوري**
-  لا حاجة لصيانة الخادم أو تثبيت ثقيل. فقط قم بتكوين ملف `.cursor/mcp.json` أو ملف تكوين MCP المعادل وأنت جاهز للانطلاق.
+- **تكامل ذكي لأوامر CLI**
+  الوصول إلى أوامر Intlayer CLI وتشغيلها مباشرة من واجهة بيئة التطوير المتكاملة الخاصة بك. باستخدام خادم MCP، يمكنك السماح لمساعد الذكاء الاصطناعي الخاص بك بتشغيل أوامر مثل `intlayer dictionaries build` لتحديث القواميس الخاصة بك، أو `intlayer dictionaries fill` لملء الترجمات المفقودة.
+
+  > عرض القائمة الكاملة للأوامر والخيارات في [توثيق Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_cli.md).
+
+## الخادم المحلي (stdio) مقابل الخادم البعيد (SSE)
+
+يمكن استخدام خادم MCP بطريقتين:
+
+- الخادم المحلي (stdio)
+- الخادم البعيد (SSE)
+
+### الخادم المحلي (stdio) (موصى به)
+
+توفر Intlayer حزمة NPM يمكن تثبيتها محليًا على جهازك. يمكن تثبيتها في بيئة التطوير المتكاملة المفضلة لديك، مثل VS Code، Cursor، وكذلك تطبيق المساعد المحلي الخاص بك، مثل ChatGPT، Claude Desktop، إلخ.
+
+هذا الخادم هو الطريقة الموصى بها لاستخدام خادم MCP. حيث يدمج جميع ميزات خادم MCP، بما في ذلك أدوات CLI.
+
+### الخادم البعيد (SSE)
+
+يمكن أيضًا استخدام خادم MCP عن بُعد، باستخدام طريقة النقل SSE. يستضيف هذا الخادم Intlayer، وهو متاح على https://mcp.intlayer.org. يمكن الوصول إلى هذا الخادم علنًا، بدون أي مصادقة، وهو مجاني للاستخدام.
+
+لاحظ أن الخادم البعيد لا يدمج أدوات CLI، الإكمال التلقائي بالذكاء الاصطناعي، إلخ. الخادم البعيد مخصص فقط للتفاعل مع الوثائق لمساعدة مساعد الذكاء الاصطناعي الخاص بك في نظام Intlayer البيئي.
+
+> بسبب تكاليف استضافة الخادم، لا يمكن ضمان توفر الخادم البعيد. نحن نحد من عدد الاتصالات المتزامنة. نوصي باستخدام طريقة النقل للخادم المحلي (stdio) للحصول على تجربة أكثر موثوقية.
 
 ---
 
-## إعداد Cursor
+## الإعداد في Cursor
+
+اتبع [الوثائق الرسمية](https://docs.cursor.com/context/mcp) لتكوين خادم MCP في Cursor.
 
 في جذر مشروعك، أضف ملف التكوين التالي `.cursor/mcp.json`:
 
-```json
+### الخادم المحلي (stdio) (موصى به)
+
+```json fileName=".cursor/mcp.json"
 {
   "mcpServers": {
     "intlayer": {
@@ -53,19 +80,36 @@ slugs:
 }
 ```
 
-هذا يخبر بيئة التطوير المتكاملة (IDE) الخاصة بك بتشغيل خادم MCP الخاص بـ Intlayer باستخدام `npx`، مما يضمن أنه يستخدم دائمًا أحدث إصدار متاح ما لم تقم بتثبيته يدويًا.
+### الخادم البعيد (SSE)
+
+للاتصال بخادم Intlayer MCP البعيد باستخدام أحداث الخادم المرسلة (SSE)، يمكنك تكوين عميل MCP الخاص بك للاتصال بالخدمة المستضافة.
+
+```json fileName=".cursor/mcp.json"
+{
+  "mcpServers": {
+    "intlayer": {
+      "url": "https://mcp.intlayer.org",
+      "transport": "sse"
+    }
+  }
+}
+```
+
+هذا يخبر بيئة التطوير المتكاملة (IDE) الخاصة بك بتشغيل خادم Intlayer MCP باستخدام `npx`، مما يضمن دائمًا استخدام أحدث إصدار متاح ما لم تقم بتثبيته.
 
 ---
 
-## إعداد VS Code
+## الإعداد في VS Code
 
-لاستخدام خادم Intlayer MCP مع VS Code، تحتاج إلى تكوينه في إعدادات مساحة العمل أو إعدادات المستخدم.
+اتبع [الوثائق الرسمية](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) لتكوين خادم MCP في VS Code.
 
-### تكوين مساحة العمل
+لاستخدام خادم Intlayer MCP مع VS Code، تحتاج إلى تكوينه في إعدادات مساحة العمل أو إعدادات المستخدم الخاصة بك.
 
-أنشئ ملف `.vscode/mcp.json` في جذر مشروعك:
+### الخادم المحلي (stdio) (موصى به)
 
-```json
+قم بإنشاء ملف `.vscode/mcp.json` في جذر مشروعك:
+
+```json fileName=".vscode/mcp.json"
 {
   "servers": {
     "intlayer": {
@@ -77,98 +121,88 @@ slugs:
 }
 ```
 
-### استخدام خادم MCP في VS Code
-
-1. **تفعيل وضع الوكيل**: افتح عرض الدردشة (⌃⌘I على ماك، Ctrl+Alt+I على ويندوز/لينكس) واختر وضع **Agent** من القائمة المنسدلة.
+### الخادم البعيد (SSE)
 
-2. **الوصول إلى الأدوات**: انقر على زر **الأدوات** لعرض أدوات Intlayer المتاحة. يمكنك اختيار أو إلغاء اختيار أدوات محددة حسب الحاجة.
+للاتصال بخادم Intlayer MCP البعيد باستخدام أحداث الخادم المرسلة (SSE)، يمكنك تكوين عميل MCP الخاص بك للاتصال بالخدمة المستضافة.
 
-3. **الإشارة المباشرة إلى الأدوات**: قم بالإشارة إلى الأدوات مباشرة في مطالباتك بكتابة `#` متبوعًا باسم الأداة.
-
-4. **تأكيد الأداة**: بشكل افتراضي، سيطلب VS Code تأكيدًا قبل تشغيل الأدوات. استخدم خيارات زر **متابعة** لتأكيد الأدوات تلقائيًا للجلسة الحالية، أو مساحة العمل، أو لجميع الاستدعاءات المستقبلية.
-
-### إدارة الخادم
-
-- قم بتشغيل **MCP: قائمة الخوادم** من لوحة الأوامر لعرض الخوادم المكونة
-- ابدأ، أوقف، أو أعد تشغيل خادم Intlayer MCP حسب الحاجة
-- عرض سجلات الخادم لاستكشاف الأخطاء وإصلاحها عن طريق اختيار الخادم واختيار **عرض الإخراج**
-
-لمزيد من المعلومات التفصيلية حول تكامل VS Code MCP، راجع [التوثيق الرسمي لـ VS Code MCP](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).
+```json fileName=".vscode/mcp.json"
+{
+  "servers": {
+    "intlayer": {
+      "url": "https://mcp.intlayer.org",
+      "type": "sse"
+    }
+  }
+}
+```
 
 ---
 
-## استخدام خادم MCP عبر واجهة الأوامر
-
-يمكنك أيضًا تشغيل خادم Intlayer MCP مباشرة من سطر الأوامر للاختبار، وتصحيح الأخطاء، أو التكامل مع أدوات أخرى.
-
-### تثبيت خادم MCP
-
-أولاً، قم بتثبيت حزمة خادم MCP عالميًا أو استخدمها عبر npx:
-
-```bash
-# التثبيت عالميًا
-npm install -g @intlayer/mcp
+## الإعداد في ChatGPT
 
-# أو الاستخدام مباشرة مع npx (موصى به)
-npx @intlayer/mcp
-```
+### الخادم البعيد (SSE)
 
-### بدء الخادم
+اتبع [الوثائق الرسمية](https://platform.openai.com/docs/mcp#test-and-connect-your-mcp-server) لتكوين خادم MCP في ChatGPT.
 
-لتشغيل خادم MCP مع أداة المفتش للتصحيح والاختبار:
+1. انتقل إلى [لوحة التحكم](https://platform.openai.com/prompts)
+2. انقر على `+ إنشاء`
+3. انقر على `الأدوات (إنشاء أو +)`
+4. حدد `خادم MCP`
+5. انقر على `إضافة جديد`
+6. املأ الحقول التالية:
 
-```bash
-# استخدام أمر البدء المدمج
-npm run start
+   - الرابط: `https://mcp.intlayer.org`
+   - التسمية: `خادم Intlayer MCP`
+   - الاسم: `intlayer-mcp-server`
+   - المصادقة: `بدون`
 
-# أو مباشرة مع npx
-npx @modelcontextprotocol/inspector npx @intlayer/mcp
-```
+7. انقر على "حفظ"
 
-سيؤدي هذا إلى تشغيل خادم MCP مع واجهة المفتش التي تتيح لك:
+---
 
-- اختبار اتصالات بروتوكول MCP
-- تصحيح استجابات الخادم
-- التحقق من صحة تنفيذ الأدوات والموارد
-- مراقبة أداء الخادم
+## الإعداد في Claude Desktop
 
-### استخدام التطوير
+اتبع [الوثائق الرسمية](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server) لتكوين خادم MCP في Claude Desktop.
 
-لأغراض التطوير والاختبار، يمكنك تشغيل الخادم في أوضاع مختلفة:
+مسار ملف التكوين:
 
-```bash
-# البناء والبدء في وضع التطوير
-npm run dev
+- macOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 
-# التشغيل بتكوين مخصص
-node dist/cjs/index.cjs
+### الخادم المحلي (stdio) (موصى به)
 
-# اختبار وظائف الخادم
-npm test
+```json fileName="claude_desktop_config.json"
+{
+  "mcpServers": {
+    "intlayer": {
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
 ```
 
-سيكشف الخادم عن أدوات وموارد خاصة بـ Intlayer يمكن لأي عميل متوافق مع MCP استخدامها، وليس فقط Cursor أو بيئات التطوير المتكاملة الأخرى.
-
 ---
 
-## نظرة عامة على الميزات
-
-| الميزة           | الوصف                                                                  |
-| ---------------- | ---------------------------------------------------------------------- |
-| دعم CLI          | تشغيل أوامر `intlayer`، الحصول على تلميحات الاستخدام والمعاملات مباشرة |
-| الوثائق المرقمة  | الكشف التلقائي وتحميل الوثائق المطابقة لإصدار Intlayer الحالي          |
-| الإكمال التلقائي | اقتراحات ذكية للأوامر والتكوين أثناء الكتابة                           |
-| جاهز للإضافات    | متوافق مع بيئات التطوير المتكاملة والأدوات التي تدعم معيار MCP         |
+## استخدام خادم MCP عبر سطر الأوامر
 
----
+يمكنك أيضًا تشغيل خادم Intlayer MCP مباشرة من سطر الأوامر للاختبار أو التصحيح أو التكامل مع أدوات أخرى.
 
-## روابط مفيدة
+```bash
+# التثبيت بشكل عام
+npm install -g @intlayer/mcp
 
-- [توثيق CLI الخاص بـ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_cli.md)
-- [مستودع Intlayer على GitHub](https://github.com/aymericzip/intlayer)
+# أو الاستخدام مباشرة مع npx (موصى به)
+npx @intlayer/mcp
+```
 
 ---
 
-## تاريخ الوثائق
+## تاريخ الوثيقة
 
-- 5.5.10 - 2025-06-29: بداية التاريخ
+| الإصدار | التاريخ    | التغييرات                    |
+| ------- | ---------- | ---------------------------- |
+| 5.5.12  | 2025-07-11 | إضافة إعداد ChatGPT          |
+| 5.5.12  | 2025-07-10 | إضافة إعداد Claude Desktop   |
+| 5.5.12  | 2025-07-10 | إضافة نقل SSE والخادم البعيد |
+| 5.5.10  | 2025-06-29 | بدء السجل                    |

package/docs/de/intlayer_CMS.md

@@ -16,6 +16,7 @@ slugs:
   - doc
   - concept
   - cms
+youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 ---
 
 # Intlayer Content Management System (CMS) Dokumentation