@agent-native/core 0.76.5 → 0.76.6

package/corpus/core/docs/content/locales/ar-SA/mcp-clients.md

@@ -0,0 +1,330 @@
+---
+title: "عملاء MCP"
+description: "قم بتوصيل تطبيق الوكيل الأصلي بخوادم MCP المحلية (clude-in-chrome، ونظام الملفات، والكاتب المسرحي، وما إلى ذلك) حتى يحصل الوكيل على أدواته."
+---
+
+# عملاء MCP
+
+**هذه الصفحة: امنح وكيلك المزيد من الأدوات.** قم بتوجيه تطبيق الوكيل الأصلي إلى خوادم MCP - المحلية أو البعيدة - حتى تظهر أدواته في دردشة الوكيل. هذا هو اتجاه _client_، الصورة المعكوسة لـ [MCP Protocol](/docs/mcp-protocol) (مما يجعل تطبيقك MCP _server_).
+
+| إذا كنت تريد...                                                     | اقرأ                                     |
+| ------------------------------------------------------------------- | ---------------------------------------- |
+| قم بتوصيل وكيل/مضيف خارجي بتطبيقك                                   | [External Agents](/docs/external-agents) |
+| امنح وكيلك المزيد من الأدوات (استخدم خوادم MCP الأخرى)              | **هذه الصفحة** — عملاء MCP               |
+| إنشاء UI المضمنة التي يتم عرضها في Claude/ChatGPT                   | [MCP Apps](/docs/mcp-apps)               |
+| مرجع خادم MCP ذو المستوى الأدنى (المصادقة، الأدوات، التثبيت المخصص) | [MCP Protocol](/docs/mcp-protocol)       |
+
+باستخدام ملف تكوين واحد، يتمكن كل تطبيق وكيل أصلي في مساحة العمل الخاصة بك من الوصول إلى الأدوات التي توفرها خوادم MCP على جهازك: `claude-in-chrome` لأتمتة المتصفح، و`@modelcontextprotocol/server-filesystem` لقراءة الملفات، و`@playwright/mcp` لاختبار المتصفح، وأي شيء آخر يتحدث MCP.
+
+يمكنك أيضًا استخدام [connect remote (HTTP) MCP servers at runtime](#remote-via-ui) — مستخدمون فرديون أو مؤسسات بأكملها — دون تعديل ملف التكوين.
+
+يتم تحليل كل مصدر في وقت تشغيل واحد **مدير MCP**، وكل أداة يتعلمها يتم وضعها في سجل أدوات الوكيل تحت بادئة `mcp__<server-id>__<tool>` مقاومة للتصادم — يمكن البحث فيها عن طريق النية من خلال `tool-search`.
+
+```an-diagram title="Client direction: many sources, one tool registry" summary="Config files, env, and runtime UI all merge into the MCP manager; its tools appear prefixed and tool-searchable alongside your app's actions. This is the mirror of the server direction."
+{
+  "html": "<div class=\"mcp-merge\"><div class=\"diagram-col sources\"><div class=\"diagram-box\" data-rough>Workspace <code>mcp.config.json</code><br><small class=\"diagram-muted\">shared across apps</small></div><div class=\"diagram-box\" data-rough>App-root <code>mcp.config.json</code><br><small class=\"diagram-muted\">per-app override</small></div><div class=\"diagram-box\" data-rough><code>MCP_SERVERS</code> env<br><small class=\"diagram-muted\">CI / production</small></div><div class=\"diagram-box\" data-rough>Remote via settings UI<br><small class=\"diagram-muted\">personal &amp; org scope</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">MCP manager</span><small class=\"diagram-muted\">merge &middot; hot-reload</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col out\"><div class=\"diagram-node\">Agent tool registry<br><small class=\"diagram-muted\"><code>mcp__&lt;server-id&gt;__&lt;tool&gt;</code></small></div><div class=\"diagram-node\"><code>tool-search</code><br><small class=\"diagram-muted\">discover by intent</small></div></div></div>",
+  "css": ".mcp-merge{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.mcp-merge .diagram-col{display:flex;flex-direction:column;gap:8px}.mcp-merge .center{display:flex;flex-direction:column;align-items:center;gap:4px}.mcp-merge .diagram-arrow{font-size:22px;line-height:1}.mcp-merge code{font-size:.85em}"
+}
+```
+
+> الاتجاه المعاكس - جعل _your_ app خادم MCP يستهلكه المضيفون الآخرون - موجود في [MCP Protocol](/docs/mcp-protocol) و[External Agents](/docs/external-agents).
+
+## متصفح مدمج وإمكانات استخدام الكمبيوتر {#built-in-capabilities}
+
+يتضمن Agent-native أدوات تبديل للتطوير المحلي لخوادم MCP الشائعة من stdio.
+يتم إيقاف تشغيلها افتراضيًا ويمكن تمكينها لكل مستخدم أو لكل مؤسسة فقط
+عندما يكون التطبيق قيد التشغيل محليًا. يتم تخطي الإنتاج وأوقات التشغيل المستضافة بدون خادم
+هذه العناصر المضمنة حتى في حالة وجود صفوف الإعدادات القديمة، وموارد مساحة العمل
+لا تعرضها الشجرة كموارد `mcp-servers/*.json` الافتراضية.
+
+| القدرة               | معرف الخادم       | الأمر                                                                   |
+| -------------------- | ----------------- | ----------------------------------------------------------------------- |
+| أدوات تطوير Chrome   | `chrome-devtools` | `npx -y chrome-devtools-mcp@latest --autoConnect --no-usage-statistics` |
+| متصفح الكاتب المسرحي | `playwright`      | `npx -y @playwright/mcp@latest`                                         |
+| استخدام الكمبيوتر    | `computer-use`    | `npx -y computer-use-mcp@latest`                                        |
+
+يمكن تمكين قدرة متصفح واحدة فقط في نطاق ما في المرة الواحدة. يؤدي تمكين Chrome DevTools إلى تعطيل Playwright لنفس المستخدم أو المؤسسة، كما يؤدي تمكين Playwright إلى تعطيل Chrome DevTools.
+
+استخدام الكمبيوتر هو نظام التشغيل macOS فقط. وفي الأنظمة الأساسية الأخرى، يتم إدراجه على أنه غير متاح ويتم تخطيه حتى إذا كان صف الإعداد القديم يحتوي عليه.
+
+يستخدم Chrome DevTools `--autoConnect` بشكل افتراضي. يرتبط ذلك بمثيل Chrome المؤهل قيد التشغيل؛ ولا يقوم بإنشاء ملف تعريف متصفح معزول أو تسجيل الدخول إلى الملف الشخصي العادي للمستخدم نيابةً عنك. يتطلب Chrome 144+ مع تمكين تصحيح الأخطاء عن بعد. يمكن إضافة التكوين اليدوي `browser-url` لاحقًا عندما يحتاج النشر إلى نقطة نهاية محددة لتصحيح الأخطاء.
+
+يتم الاحتفاظ بالمكونات الإضافية في جدول `settings` الخاص بإطار العمل ضمن `u:<email>:mcp-builtin-capabilities` للتبديلات الشخصية و`o:<orgId>:mcp-builtin-capabilities` لتبديلات الفريق. عند تمكينها، يتم دمجها في مدير MCP لوقت التشغيل بنفس تنسيق الرؤية المحدد مثل الخوادم البعيدة، على سبيل المثال `mcp__user_<emailhash>_playwright__*` أو `mcp__org_<orgId>_chrome-devtools__*`.
+
+### ملاحظات الإعداد التي تواجه المستخدم
+
+استخدم نسخة إعداد موجزة وصريحة للمكونات الإضافية الحساسة:
+
+- **يتم ربط Chrome DevTools** بهدف تصحيح أخطاء Chrome قيد التشغيل. أخبر المستخدمين
+  مخصص لاختبار المتصفح والتحقق من تسجيل الدخول، وهو
+  قد يتطلب تمكين تصحيح الأخطاء عن بعد في Chrome قبل ظهور الأدوات.
+- **الكاتب المسرحي** يقوم بتشغيل متصفح معزول. أوصي به من أجل الحتمية
+  سؤال وجواب عندما لا يكون الملف الشخصي المباشر للمستخدم في Chrome مطلوبًا.
+- **استخدام الكمبيوتر** يمكنه تشغيل التطبيقات المحلية. قم بإيقاف تشغيله افتراضيًا، اشرح
+  مطالبات تسجيل شاشة نظام التشغيل MacOS وإمكانية الوصول، واسأل قبل التقاطها
+  actions الحساسة مثل عمليات الشراء أو التغييرات المالية أو تغييرات الحساب.
+
+### نقاط النهاية المضمنة
+
+| الطريقة | المسار                       | الغرض                                                                        |
+| ------- | ---------------------------- | ---------------------------------------------------------------------------- |
+| GET     | `/_agent-native/mcp/builtin` | سرد الإمكانات المضمنة والنطاقات الممكّنة والمعرفات المدمجة والحالة المباشرة. |
+| POST    | `/_agent-native/mcp/builtin` | تحديث النطاق. الجسم: `{ scope, enabledIds }` أو `{ scope, id, enabled }`.    |
+
+## إضافة خادم MCP محلي {#adding-a-server}
+
+قم بإنشاء `mcp.config.json` على جذر مساحة العمل لديك (أو على جذر تطبيق فردي - يفوز جذر مساحة العمل عند وجودهما معًا):
+
+```jsonc
+{
+  "$schema": "https://agent-native.com/schema/mcp.config.json",
+  "servers": {
+    "claude-in-chrome": {
+      "command": "claude-in-chrome-mcp",
+      "args": [],
+      "env": { "LOG_LEVEL": "info" },
+    },
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@playwright/mcp@latest"],
+    },
+    "filesystem": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@modelcontextprotocol/server-filesystem@latest",
+        "/Users/me/projects",
+      ],
+    },
+  },
+}
+```
+
+الشكل صغير: خريطة `servers` مرتبطة بمعرف الخادم، حيث يكون كل إدخال إما مشغل stdio (`command` + `args` + `env` اختياري) أو إدخال `{ "type": "http", "url", "headers" }` عن بعد.
+
+```an-annotated-code title="mcp.config.json, annotated"
+{
+  "filename": "mcp.config.json",
+  "language": "jsonc",
+  "code": "{\n  \"$schema\": \"https://agent-native.com/schema/mcp.config.json\",\n  \"servers\": {\n    \"claude-in-chrome\": {\n      \"command\": \"claude-in-chrome-mcp\",\n      \"args\": [],\n      \"env\": { \"LOG_LEVEL\": \"info\" }\n    },\n    \"filesystem\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-filesystem@latest\", \"/Users/me/projects\"]\n    }\n  }\n}",
+  "annotations": [
+    { "lines": "3", "label": "Server id", "note": "The key becomes the tool prefix: this server's tools surface as `mcp__claude-in-chrome__*` in the agent's registry, so they can't collide with your template's actions." },
+    { "lines": "4-6", "label": "stdio launcher", "note": "`command` + `args` spawn a local binary. Stdio servers are intended for **local development** — they are a no-op in edge runtimes." },
+    { "lines": "6", "label": "Process env", "note": "Optional `env` is passed to the spawned process. Keep secrets out of committed config; prefer `MCP_SERVERS` or the settings UI for tokens." }
+  ]
+}
+```
+
+عند بدء التطبيق التالي، سترى:
+
+```
+[mcp-client] loaded config from /path/to/mcp.config.json (3 server(s))
+[mcp-client] connected to claude-in-chrome: 12 tools
+[mcp-client] connected to playwright: 9 tools
+[mcp-client] connected to filesystem: 4 tools
+```
+
+يتم تسجيل الأدوات في سجل أدوات الوكيل بالبادئة `mcp__<server-id>__<tool-name>` حتى لا تتعارض مع actions للقالب الخاص بك. تم تضمينها أيضًا في `tool-search`، بحيث يمكن للوكلاء اكتشاف إمكانات MCP المتصلة حديثًا عن طريق النية بدلاً من الحاجة إلى الاسم البادئ الدقيق مقدمًا.
+
+## أسبقية التكوين {#precedence}
+
+يتم حل تكوين MCP بهذا الترتيب، وتفوز المباراة الأولى:
+
+1. **جذر مساحة العمل `mcp.config.json`** — تم اكتشافه عبر `agent-native.workspaceCore` في `package.json`. تتم مشاركتها عبر كل تطبيق في مساحة العمل.
+2. **App-root `mcp.config.json`** — يتم التجاوز لكل تطبيق إذا كنت لا تريد توفر خادم MCP في كل تطبيق.
+3. **`MCP_SERVERS` env var** — سلسلة JSON بنفس الشكل، لـ CI/الإنتاج حيث لا يكون للملف معنى.
+
+## نشر الإنتاج: `MCP_SERVERS` {#mcp-servers-env}
+
+بالنسبة لعمليات نشر الإنتاج، فضل خوادم HTTP MCP البعيدة وقم بتعيين التكوين الكامل
+الشكل (أو خريطة الخادم الداخلية) كمتغير بيئة:
+
+```bash
+MCP_SERVERS='{"servers":{"zapier":{"type":"http","url":"https://mcp.example.com/mcp","headers":{"Authorization":"Bearer paste-token-value-here"}}}}'
+```
+
+تم تحليل `MCP_SERVERS` كـ JSON، لذا لم يتم توسيع العناصر النائبة `${...}`
+داخل السلسلة. إذا قمت بتخزين الرمز المميز في سر آخر، فقم بتوسيعه قبل
+كتابة قيمة JSON النهائية.
+
+تنتج خوادم Stdio MCP ثنائيات محلية وهي مخصصة للتطوير المحلي.
+يتم تنشيط أدوات MCP فقط في أوقات تشغيل Node — Cloudflare Workers والحواف الأخرى
+تتخطى الأهداف MCP بصمت وتستمر في عمل بقية التطبيق
+عادة.
+
+## الاكتشاف التلقائي: `claude-in-chrome` {#autodetect}
+
+إذا كان لديك **لا** `mcp.config.json` وكان الملف الثنائي `claude-in-chrome-mcp` موجودًا على `PATH` (أو في موقع التثبيت المعروف `~/.claude-in-chrome/bin/claude-in-chrome-mcp`)، فسيقوم الوكيل الأصلي بتسجيله تلقائيًا كخادم MCP افتراضي. اضبط `AGENT_NATIVE_DISABLE_MCP_AUTODETECT=1` على إلغاء الاشتراك.
+
+يعني هذا أن المستخدمين الذين قاموا بتثبيت ملحق claude-in-chrome سيحصلون على التحكم في المتصفح عبر كل تطبيق أصلي للوكيل يفتحونه دون أي تغييرات في التكوين.
+
+## خوادم MCP البعيدة عبر إعدادات UI {#remote-via-ui}
+
+تمنح خوادم MCP (نموذج سياق البروتوكول) وكيلك قدرات جديدة - مثل الاتصال بـ Zapier، أو Cloudflare، أو Composio، أو الأدوات الداخلية لشركتك. بمجرد الاتصال، يمكن للوكيل استخدام هذه الأدوات تمامًا مثل الأدوات المدمجة فيه.
+
+### كيفية الاتصال بخادم MCP البعيد
+
+1. **اسم الخادم** — تسمية قصيرة للرجوع إليها (على سبيل المثال، "zapier"، "slack-tools").
+2. **URL** — نقطة النهاية HTTPS التي قدمها لك موفر خادم MCP (على سبيل المثال، `https://mcp.zapier.com/s/abc123/mcp`). يتم العثور على هذا عادةً في لوحة تحكم الموفر أو مستندات التكامل.
+3. **الوصف** (اختياري) — ملاحظة حول ما يفعله هذا الخادم.
+4. **الرؤوس** — بيانات اعتماد المصادقة التي يتطلبها الخادم، واحدة في كل سطر. تحتاج معظم الخوادم إلى رأس `Authorization`. مثال: `Authorization: Bearer sk-your-key-here`. ستخبرك مستندات الموفر بما يجب وضعه هنا.
+
+انقر فوق **اختبار** للتحقق من الاتصال قبل الحفظ. إذا نجحت، سترى عدد الأدوات المتاحة. انقر **اتصال** لإضافته.
+
+### النطاق الشخصي مقابل نطاق المؤسسة
+
+يتم دعم نطاقين:
+
+- **شخصي** — فقط المستخدم الذي سجل الدخول هو الذي يحصل على الأدوات. يتم تخزينه كإعداد لنطاق المستخدم.
+- **الفريق** — يحصل كل فرد في المؤسسة النشطة على الأدوات. يمكن للمالكين والمشرفين إضافة؛ يرى الأعضاء القائمة للقراءة فقط. تم تخزينه كإعداد نطاق مؤسسي.
+
+يضيف ويزيل التحميل السريع إلى مدير MCP قيد التشغيل - لا إعادة تشغيل للعملية، ولا إعادة تشغيل للخادم. تظهر أدوات `mcp__<scope>-<name>__*` الجديدة للوكيل في الرسالة التالية ويمكن البحث فيها عبر `tool-search`.
+
+يتم قبول HTTPS URL في كل مكان؛ يُسمح فقط بـ `http://` العادي لـ `localhost` أثناء التطوير. يتم إدخال المصادقة الاختيارية كرمز مميز لحامل يتم إرساله عبر `Authorization: Bearer …` عند كل طلب.
+
+تحت الغطاء، تظل هذه الخوادم موجودة في جدول `settings` الخاص بإطار العمل تحت المفتاح `u:<email>:mcp-servers-remote` (شخصي) أو `o:<orgId>:mcp-servers-remote` (فريق) ويتم دمجها مع `mcp.config.json` عند بدء التشغيل.
+
+### نقاط نهاية HTTP
+
+| الطريقة | المسار                                                | الغرض                                                               |
+| ------- | ----------------------------------------------------- | ------------------------------------------------------------------- |
+| GET     | `/_agent-native/mcp/servers`                          | قم بإدراج خوادم المؤسسة الشخصية للمستخدم الحالي مع الحالة المباشرة. |
+| POST    | `/_agent-native/mcp/servers`                          | إضافة خادم. الجسم: `{ scope, name, url, headers?, description? }`.  |
+| DELETE  | `/_agent-native/mcp/servers/:id?scope=user\|org`      | قم بإزالة الخادم وأعد تكوين المدير.                                 |
+| POST    | `/_agent-native/mcp/servers/:id/test?scope=user\|org` | التشغيل التجريبي لأدوات الاتصال + القائمة الخاصة بالخادم الحالي.    |
+| POST    | `/_agent-native/mcp/servers/test`                     | قم بتشغيل URL بشكل تعسفي قبل الاستمرار. الجسم: `{ url, headers? }`. |
+
+لا تزال خوادم Stdio محظورة خارج أوقات تشغيل Node، لكن خوادم HTTP MCP البعيدة تعمل في أي بيئة مع `fetch` - بما في ذلك إصدارات إنتاج سطح المكتب.
+
+## خوادم MCP المشتركة عبر المحور {#hub}
+
+إذا كانت مساحة العمل الخاصة بك تقوم بتشغيل العديد من تطبيقات الوكيل الأصلية (على سبيل المثال، الإرسال + البريد + المقاطع)، فيمكنك تكوين تطبيق **واحد** كمركز وجعل الآخرين يسحبون خوادم MCP ذات النطاق المؤسسي تلقائيًا. لا يوجد نسخ ولصق لكل تطبيق لرموز URL والرموز المميزة لحاملها. راجع [Multi-App Workspace](/docs/multi-app-workspace) للتعرف على النهج الأساسي باستخدام موارد MCP لمساحة عمل Dispatch.
+
+Dispatch هو المركز التقليدي - فهو ينسق بالفعل عبر التطبيقات.
+
+```an-diagram title="Hub model: one app serves org-scope MCP servers" summary="Dispatch holds the org-scope MCP servers; consumer apps pull and merge them as mcp__hub_<orgId>_<name>__*. Only org-scope rows are shared — personal credentials stay put."
+{
+  "html": "<div class=\"mcp-hub\"><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">Dispatch hub</span><small class=\"diagram-muted\">org-scope MCP servers</small><small class=\"diagram-muted\"><code>GET /mcp/hub/servers</code></small></div><div class=\"diagram-col arrows\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div></div><div class=\"diagram-col consumers\"><div class=\"diagram-box\" data-rough>Mail<br><small class=\"diagram-muted\"><code>mcp__hub_&lt;orgId&gt;_&lt;name&gt;__*</code></small></div><div class=\"diagram-box\" data-rough>Clips<br><small class=\"diagram-muted\">pull + merge each ~60s</small></div></div></div><p class=\"diagram-muted note\">Bearer-gated by <code>AGENT_NATIVE_MCP_HUB_TOKEN</code>. Personal (user-scope) servers are never re-exposed.</p>",
+  "css": ".mcp-hub{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.mcp-hub .center{display:flex;flex-direction:column;align-items:center;gap:4px}.mcp-hub .diagram-col{display:flex;flex-direction:column;gap:10px}.mcp-hub .arrows .diagram-arrow{font-size:22px;line-height:1}.mcp-hub .note{margin:8px 0 0;font-size:.85em}.mcp-hub code{font-size:.85em}"
+}
+```
+
+بالنسبة لإعدادات مساحة العمل الجديدة، تفضل **إرسال موارد مساحة العمل MCP** عندما
+تريد نفس نموذج منح كل التطبيقات مقابل التطبيقات المحددة الذي تستخدمه مساحة العمل skills،
+التعليمات والموارد المرجعية. أضف مورد مساحة عمل باستخدام:
+
+```json
+{
+  "type": "http",
+  "url": "https://example.com/mcp",
+  "headers": {
+    "Authorization": "Bearer ${keys.MCP_SERVER_TOKEN}"
+  },
+  "description": "Shared MCP tools for workspace apps"
+}
+```
+
+احفظه تحت `mcp-servers/<name>.json` بالنوع `mcp-server`. كل التطبيقات
+يتم تحميل الموارد بواسطة كل تطبيق مساحة عمل؛ يتم تحميل الموارد المحددة فقط في
+التطبيقات ذات منحة Dispatch النشطة. يتم حل العناصر النائبة السرية من التطبيق
+متجر سري، لذا ضع الرموز المميزة لحاملها في Dispatch Vault وقم بالإشارة إليها
+باستخدام `${keys.NAME}` بدلاً من تخزينها في نص المورد.
+
+تقوم التطبيقات بتحديث تكوين MCP المدمج الخاص بها مرة واحدة تقريبًا كل دقيقة، لذا فهو مورد مركزي
+تسري عمليات التحرير ومنح التغييرات وعمليات الإزالة دون النشر. تعيين
+`AGENT_NATIVE_MCP_CONFIG_REFRESH_MS=0` لتعطيل تحديث الخلفية، أو
+اضبطها على قيمة لا تقل عن `5000` مللي ثانية لضبط الفاصل الزمني.
+
+يظل الوضع المحوري الأقدم أدناه مفيدًا لـ "مشاركة كل نطاق مؤسسة MCP" الخشنة
+إعدادات الخادم من Dispatch" وعمليات النشر التي تستخدم MCP بالفعل
+إعدادات UI كمصدر للحقيقة.
+
+### 1. قم بتمكين خدمة المركز على تطبيق المركز (الإرسال)
+
+قم بتعيين env var في نشر الإرسال:
+
+```bash
+AGENT_NATIVE_MCP_HUB_TOKEN=<a-long-random-secret>
+```
+
+تقوم Dispatch الآن بتثبيت `GET /_agent-native/mcp/hub/servers` الذي يُرجع كل خادم MCP على مستوى المؤسسة مُخزن في جدول `settings` الخاص به، مع رؤوس URL + الكاملة، والتي تمت مصادقتها بواسطة الرمز المميز.
+
+### 2. قم بتوجيه التطبيقات المستهلكة إلى المركز
+
+تعيين على كل مستهلك (بريد، مقاطع، أي شيء):
+
+```bash
+AGENT_NATIVE_MCP_HUB_URL=https://dispatch.acme.com
+AGENT_NATIVE_MCP_HUB_TOKEN=<the-same-secret>
+```
+
+عند بدء التشغيل، يقوم كل مستهلك بسحب قائمة خوادم المحور ودمجها في مدير MCP الخاص به. تظهر الأدوات للوكيل باسم `mcp__hub_<orgId>_<name>__*` — وهي مختلفة عن `mcp__org_…` المحلي الخاص بالمستهلك، لذلك لا يوجد تعارض.
+
+### 3. ما تتم مشاركته
+
+تتم مشاركة خوادم **org-scope** فقط. تظل خوادم نطاق المستخدم (الشخصي) مع المستخدم الذي أضافها - لا يعيد المركز أبدًا الكشف عن بيانات الاعتماد الشخصية عبر التطبيقات.
+
+تتضمن استجابات المحور رؤوس المصادقة الكاملة (الرموز المميزة لحاملها، وما إلى ذلك). النقل هو HTTPS، وتتطلب نقطة النهاية السر المشترك، ولا تُرجع سوى صفوف نطاق المؤسسة - تعامل مع الرمز المميز URL + للمركز مثل بيانات اعتماد قاعدة البيانات.
+
+### 4. إعادة التحميل السريع مقابل إعادة التشغيل
+
+يضيف UI المحلي إمكانية إعادة التحميل السريع لكل تطبيق عبر `McpClientManager.reconfigure()` - دون إعادة التشغيل. يتم التقاط الخوادم ذات المصدر المحوري من خلال نفس التحديث الدوري للخلفية (حوالي 60 ثانية، يمكن ضبطه أو تعطيله عبر `AGENT_NATIVE_MCP_CONFIG_REFRESH_MS`) الذي يستخدمه مسار موارد مساحة العمل، لذلك يتم نشر التغييرات التي تم إجراؤها في Dispatch إلى جميع تطبيقات المستهلك في غضون دقيقة تقريبًا دون إعادة التشغيل. بالإضافة إلى ذلك، فإن أي تغيير محلي في تطبيق المستهلك يؤدي فورًا إلى إعادة تكوين ذلك التطبيق.
+
+### ملخص نقاط النهاية
+
+| الطريقة | المسار                           | الغرض                                                                                                                        |
+| ------- | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| GET     | `/_agent-native/mcp/hub/servers` | خدمة جميع خوادم نطاق المؤسسة ببيانات الاعتماد الكاملة (بوابة حاملة، يتم تثبيتها فقط عند تعيين `AGENT_NATIVE_MCP_HUB_TOKEN`). |
+| GET     | `/_agent-native/mcp/hub/status`  | إرجاع `{ serving, consuming, hubUrl }` لبطاقة الإعدادات UI.                                                                  |
+
+## مسار الحالة {#status-route}
+
+يكشف كل تطبيق عن `GET /_agent-native/mcp/status` للأدوات والإعداد:
+
+```an-api
+{
+  "method": "GET",
+  "path": "/_agent-native/mcp/status",
+  "summary": "MCP client status for tooling and onboarding",
+  "description": "Reports which configured servers connected, the total live tool count, the merged prefixed tool list, and any per-server connection errors. Use it to build \"detected — your agent can now drive X\" hints or to debug connection problems.",
+  "responses": [
+    {
+      "status": "200",
+      "description": "Configured vs connected servers, tool inventory, and per-server errors.",
+      "example": "{\n  \"configuredServers\": [\"claude-in-chrome\", \"playwright\"],\n  \"connectedServers\": [\"claude-in-chrome\", \"playwright\"],\n  \"totalTools\": 21,\n  \"tools\": [\n    {\n      \"source\": \"claude-in-chrome\",\n      \"name\": \"mcp__claude-in-chrome__navigate\",\n      \"description\": \"Navigate the browser to a URL\"\n    }\n  ],\n  \"errors\": {}\n}"
+    }
+  ]
+}
+```
+
+```json
+{
+  "configuredServers": ["claude-in-chrome", "playwright"],
+  "connectedServers": ["claude-in-chrome", "playwright"],
+  "totalTools": 21,
+  "tools": [
+    {
+      "source": "claude-in-chrome",
+      "name": "mcp__claude-in-chrome__navigate",
+      "description": "Navigate the browser to a URL"
+    }
+  ],
+  "errors": {}
+}
+```
+
+استخدم هذا لإنشاء "تم اكتشاف claude-in-chrome - يمكن لوكيلك الآن توجيه تلميحات إعداد Chrome" أو تصحيح مشكلات اتصال MCP.
+
+## أوضاع الفشل {#failures}
+
+لا تؤدي حالات فشل خادم MCP الفردية إلى إزالة الوكيل مطلقًا:
+
+- تم تكوين `command` بشكل خاطئ → تم تخطي الخادم، ويظهر خطأه في `/mcp/status` ضمن `errors.<server-id>`، ويستمر كل خادم آخر في العمل.
+- MCP SDK مفقود من `node_modules` → تم تخطي جميع وظائف MCP مع تحذير؛ تستمر دردشة الوكيل في العمل بدون أدوات MCP.
+- التشغيل في وقت تشغيل الحافة ← عميل MCP غير متاح.
+
+سيتم تشغيل Agent-Native دائمًا؛ تهيئة MCP المعطلة تعني عددًا أقل من الأدوات.
+
+## الأمان {#security}
+
+تعمل أدوات MCP على جهازك بأي أذونات تتمتع بها العملية الناتجة. تعامل مع `mcp.config.json` مثل أي قائمة أخرى من الملفات التنفيذية التي ترغب في السماح للوكيل بقيادةها. تظهر الأدوات من خوادم MCP في حلقة استخدام أداة الوكيل تمامًا مثل actions الخاص بالقالب الخاص بك، لذا تأكد من ثقتك في كل خادم تقوم بتكوينه.

package/corpus/core/docs/content/locales/ar-SA/mcp-protocol.md

@@ -0,0 +1,279 @@
+---
+title: "بروتوكول MCP"
+description: "اكشف عن تطبيق الوكيل الأصلي كخادم MCP عن بعد حتى تتمكن Claude وChatGPT وClaude Code وCursor وأدوات الذكاء الاصطناعي الأخرى من الاتصال بـ actions لتطبيقك مباشرة."
+---
+
+# بروتوكول MCP
+
+**هذه الصفحة: مرجع خادم MCP ذي المستوى الأدنى.** كيف يكشف كل تطبيق أصلي للوكيل عن actions الخاص به عبر MCP - نقطة النهاية المثبتة تلقائيًا، وأوضاع المصادقة، وسطح `tools/call` / `ask-agent`، والتثبيت المخصص. يمكنك الوصول إليه عندما تحتاج إلى الأجزاء الداخلية للخادم؛ لتوصيل المضيف، ابدأ بـ [External Agents](/docs/external-agents).
+
+| إذا كنت تريد...                                                     | اقرأ                                     |
+| ------------------------------------------------------------------- | ---------------------------------------- |
+| قم بتوصيل وكيل/مضيف خارجي بتطبيقك                                   | [External Agents](/docs/external-agents) |
+| امنح وكيلك المزيد من الأدوات (استخدم خوادم MCP الأخرى)              | [MCP Clients](/docs/mcp-clients)         |
+| إنشاء UI المضمنة التي يتم عرضها في Claude/ChatGPT                   | [MCP Apps](/docs/mcp-apps)               |
+| مرجع خادم MCP ذو المستوى الأدنى (المصادقة، الأدوات، التثبيت المخصص) | **هذه الصفحة** — بروتوكول MCP            |
+
+يكشف كل تطبيق أصلي للوكيل تلقائيًا عن خادم MCP (بروتوكول سياق النموذج) عن بعد، لذلك يمكن لأدوات الذكاء الاصطناعي الخارجية مثل Claude وتطبيقات ChatGPT المخصصة MCP ورمز Claude وCursor وCodex وVS Code GitHub Copilot اكتشاف actions الخاص بتطبيقك واستدعاءه مباشرةً — بدون تعليمات برمجية إضافية مطلوب. إذا كان هدفك هو _ربط_ أحد هؤلاء المضيفين بتطبيق مستضاف، فإن [External Agents](/docs/external-agents) يغطي موصل Dispatch الفردي الموصى به، وتطبيقات URL، وOAuth، وMCP المضمنة، وUI، والروابط العميقة. توثق هذه الصفحة ما يكمن تحت ذلك.
+
+## نظرة عامة {#overview}
+
+MCP هو البروتوكول القياسي لتوصيل أدوات الذكاء الاصطناعي بالإمكانات الخارجية. عندما تقوم بنشر تطبيق وكيل أصلي، فإنه يقوم تلقائيًا بتثبيت نقطة نهاية MCP إلى جانب نقطة نهاية A2A الحالية. يمكن لأي عميل متوافق مع MCP الاتصال بأدوات تطبيقك واستخدامها.
+
+المفاهيم الأساسية:
+
+- **يتم التثبيت تلقائيًا** — يحصل كل تطبيق على `/_agent-native/mcp` مجانًا، دون الحاجة إلى أي إعداد
+- **HTTP** قابل للبث\*\* — يستخدم نقل MCP الحديث عبر HTTP القياسي (POST + SSE)
+- **نفس actions** — نفس سجل الإجراءات الذي يدعم دردشة الوكيل وA2A
+- **أداة `ask-agent`** — أداة تعريفية تقوم بتفويض حلقة الوكيل الكاملة للمهام المعقدة
+- **تطبيقات MCP** — يمكن لـ actions الإعلان عن موارد UI التفاعلية من خلال ملحق `io.modelcontextprotocol/ui` الرسمي
+- **جهاز التحكم عن بعد القياسي MCP OAuth** — اكتشاف OAuth 2.1، تسجيل العميل الديناميكي، رمز التفويض + PKCE، تدوير رمز التحديث
+- **الرجوع الاحتياطي لمصادقة الحامل** — يستخدم `ACCESS_TOKEN` أو `ACCESS_TOKENS` أو JWTs المتصلة للعملاء الذين لا يمكنهم تشغيل OAuth
+
+```an-diagram title="Your app as an MCP server" summary="External hosts connect over Streamable HTTP. Each action is one tool; ask-agent delegates to the full agent loop."
+{
+  "html": "<div class=\"diagram-mcp\"><div class=\"diagram-col\"><div class=\"diagram-node\">Claude</div><div class=\"diagram-node\">ChatGPT</div><div class=\"diagram-node\">Cursor · Codex</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel\"><span class=\"diagram-pill accent\">POST /_agent-native/mcp</span><small class=\"diagram-muted\">Streamable HTTP</small><small class=\"diagram-muted\">initialize &rarr; tools/list &rarr; tools/call</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\" data-rough>each action<br><small class=\"diagram-muted\">= one tool</small></div><div class=\"diagram-box\" data-rough>ask-agent<br><small class=\"diagram-muted\">&rarr; full agent loop</small></div></div></div>",
+  "css": ".diagram-mcp{display:flex;align-items:center;gap:16px;flex-wrap:wrap}.diagram-mcp .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-mcp .diagram-panel{display:flex;flex-direction:column;align-items:center;gap:4px}.diagram-mcp .diagram-arrow{font-size:20px;line-height:1}"
+}
+```
+
+## MCP ضد A2A {#mcp-vs-a2a}
+
+تم تثبيت كلا البروتوكولين تلقائيًا. استخدم ما يناسب حالة الاستخدام الخاصة بك:
+
+|                   | MCP                                                                     | A2A                                            |
+| ----------------- | ----------------------------------------------------------------------- | ---------------------------------------------- |
+| **الأفضل لـ**     | أدوات خارجية تتصل بتطبيقك                                               | الاتصال من وكيل إلى وكيل                       |
+| **البروتوكول**    | MCP HTTP قابل للبث                                                      | JSON-RPC 2.0                                   |
+| **اكتشاف الأداة** | `tools/list`                                                            | بطاقة الوكيل في `/.well-known/agent-card.json` |
+| **نقطة النهاية**  | `/_agent-native/mcp`                                                    | `/_agent-native/a2a`                           |
+| **بدعم من**       | Claude، ChatGPT، Claude Code، Cursor، Codex، Cowork، ومضيفو MCP الآخرون | تطبيقات أخرى خاصة بالوكيل                      |
+| **التنفيذ**       | استدعاءات الأداة المباشرة (بدون LLM إضافية)                             | حلقة الوكيل الكاملة (استدلال LLM)              |
+
+يمكنك أيضًا استخدام أداة `ask-agent` MCP للحصول على أفضل ما في العالمين - يمكنك تسميتها من Claude Code والسماح لوكيل تطبيقك بالتفكير في المهام المعقدة.
+
+## التكوين اليدوي للعميل MCP {#manual-config}
+
+للحصول على الإعداد الموصى به لأمر واحد، استخدم [External Agents](/docs/external-agents). إذا كنت تكتب يدويًا تهيئة MCP لعميل يدعم OAuth، فأضف تطبيقك كخادم MCP بعيد بدون رؤوس ثابتة:
+
+```bash
+claude mcp add --transport http mail https://mail.example.com/_agent-native/mcp
+```
+
+أو اكتب الإدخال يدويًا في `.mcp.json` (نطاق المشروع) أو `~/.claude.json` (نطاق المستخدم):
+
+```jsonc
+// .mcp.json
+{
+  "mcpServers": {
+    "mail": {
+      "type": "http",
+      "url": "https://mail.example.com/_agent-native/mcp",
+    },
+  },
+}
+```
+
+ثم قم بتشغيل `/mcp` في رمز Claude واختر **Authenticate**. بالنسبة للعملاء الذين لا يمكنهم تنفيذ MCP OAuth عن بعد، استخدم صفحة الاتصال أو إدخال الرمز المميز لحامل ثابت مع `headers.Authorization`. بمجرد المصادقة، يمكنك استخدام أدوات تطبيقك بشكل طبيعي:
+
+```
+> draft an email to John about the Q3 report
+
+Claude Code calls: draft-email(to: "john@example.com", subject: "Q3 Report", body: "...")
+```
+
+## الاتصال من عملاء MCP الآخرين {#other-clients}
+
+يمكن لأي عميل MCP يدعم النقل HTTP القابل للتدفق الاتصال. نقطة النهاية هي:
+
+```
+POST https://your-app.example.com/_agent-native/mcp
+```
+
+يدعم الخادم مصافحة MCP القياسية: `initialize` → `initialized` → `tools/list` → `tools/call`.
+
+```an-api title="MCP endpoint" summary="The auto-mounted Streamable HTTP endpoint every agent-native app exposes."
+{
+  "method": "POST",
+  "path": "/_agent-native/mcp",
+  "summary": "MCP Streamable HTTP endpoint",
+  "description": "Auto-mounted on every app. Speaks the standard MCP handshake (`initialize` → `initialized` → `tools/list` → `tools/call`) plus `resources/list`, `resources/templates/list`, and `resources/read` when an action declares `mcpApp`. Each action maps to one tool; `ask-agent` delegates to the full agent loop.",
+  "auth": "Standard remote MCP OAuth (Bearer access token), connect-minted JWT, or static ACCESS_TOKEN/ACCESS_TOKENS",
+  "params": [
+    { "name": "Authorization", "in": "header", "type": "string", "required": false, "description": "Bearer access token. Required except for loopback local-dev probes." },
+    { "name": "method", "in": "body", "type": "string", "required": true, "description": "MCP method, e.g. initialize, tools/list, tools/call." }
+  ],
+  "request": {
+    "contentType": "application/json",
+    "example": "{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"method\": \"tools/call\",\n  \"params\": {\n    \"name\": \"ask-agent\",\n    \"arguments\": { \"message\": \"Summarize Q3 signups by source\" }\n  }\n}"
+  },
+  "responses": [
+    { "status": "200", "description": "MCP result (POST + SSE)." },
+    { "status": "401", "description": "Unauthenticated — responds with a WWW-Authenticate header pointing at OAuth discovery." }
+  ]
+}
+```
+
+إذا أعلن أحد الإجراءات عن `mcpApp`، فإن الخادم يعلن أيضًا عن ملحق تطبيقات MCP الرسمي (`io.modelcontextprotocol/ui`) ويدعم `resources/list`، و`resources/templates/list`، و`resources/read` لمورد التطبيق. يمكن للمضيفين الذين يعرضون تطبيقات MCP إظهار UI المضمنة؛ لا يزال بإمكان المضيفين الذين لا يستخدمون الأداة الاتصال بالأداة واستخدام البديل للارتباط العميق. يجب أن يستخدم منتج UI `embedApp()` بحيث يكون السطح المضمن هو مسار تطبيق React الحقيقي، أو مسار مركّز يعرض مكون React مشترك مثل مخطط Analytics، وليس تنفيذ HTML عادي منفصل. يصدر الخادم كلاً من بيانات تعريف تطبيقات MCP القياسية وبيانات تعريف توافق ChatGPT Apps SDK حتى يتمكن المضيفون القادرون على التطبيق من العثور على نفس مورد `ui://`. تتضمن مصفوفة الامتداد الرسمية الحالية Claude، وClaude Desktop، وVS Code GitHub Copilot، وGoose، وPostman، وMCPJam، وChatGPT، وCursor؛ يختلف دعم المضيف حسب الإصدار والخطة، لذا استخدم [External Agents MCP Apps notes](/docs/external-agents#mcp-apps-compatibility) للحصول على إرشادات موجهة للمستخدم.
+
+### جسر تضمين التطبيق MCP {#mcp-app-embed-bridge}
+
+`embedApp()` هو مساعد تطبيق URL الأول MCP ذو المستوى المنخفض: فهو يطلق تطبيقًا موقعًا
+توجيه مضمّن من خلال عملية الزرع (Claude)، أو إطار متحكم فيه (ChatGPT)، أو مباشر
+التنقل، يتوسط المضيف actions عبر جسر `ui/*` JSON-RPC (و
+`agentNative.mcpHost.*` ترحيل postMessage لمسار الإطار المتحكم فيه)، و
+يثبت ارتفاع غلاف المورد بحيث لا يتم عرض مسار التطبيق الكامل كـ
+أداة دردشة كبيرة الحجم.
+
+راجع [MCP Apps](/docs/mcp-apps#mcp-app-bridge) للحصول على تفاصيل الجسر المضمن بالكامل - الزرع مقابل الإطار المتحكم فيه، وجداول `ui/*` وpostMessage، و`create_embed_session` / `embedStartUrl`، وCSP وقواعد المجال، وتضمين الامتداد `srcDoc`، وتثبيت الارتفاع، وعميل الجسر المضيف API.
+
+## الأدوات {#tools}
+
+يحصل كل متصل على **كتالوج مضغوط بشكل افتراضي** (التطبيق المعلن عن القالب actions بالإضافة إلى المكونات المدمجة للتطبيقات المشتركة)، مع عرض سطح الإجراء الكامل فقط عند الاشتراك الصريح و`tool-search` متاح دائمًا للوصول إلى الباقي. راجع [External Agents → Catalog tiers](/docs/external-agents#catalog-tiers) للحصول على الشرح الكامل.
+
+يتم ربط كل إجراء مباشرةً بأداة MCP واحدة:
+
+| خاصية الإجراء      | خاصية الأداة MCP |
+| ------------------ | ---------------- |
+| `tool.description` | `description`    |
+| `tool.parameters`  | `inputSchema`    |
+| اسم الإجراء        | اسم الأداة       |
+
+عند وجود `mcpApp`، يتضمن إدخال الأداة أيضًا `_meta.ui.resourceUri` و`_meta["ui/resourceUri"]` و`_meta["openai/outputTemplate"]`، ويتم إرجاع المورد `ui://` المقابل كـ `text/html;profile=mcp-app`.
+
+### أداة `ask-agent` {#ask-agent}
+
+بالإضافة إلى أدوات العمل الفردية، يتضمن كل خادم MCP أداة تعريف `ask-agent`. يؤدي هذا إلى إرسال رسالة باللغة الطبيعية إلى وكيل الذكاء الاصطناعي للتطبيق وإرجاع الرد.
+
+استخدم `ask-agent` للمهام المعقدة التي تستفيد من منطق الوكيل وسياقه:
+
+```json
+{
+  "name": "ask-agent",
+  "arguments": {
+    "message": "Draft a follow-up email to the Q3 planning thread with John, summarizing the action items we discussed"
+  }
+}
+```
+
+يُدير الوكيل نفس الحلقة مثل الدردشة التفاعلية — يمكنه استدعاء أدوات متعددة، والتفكير في السياق، وتقديم استجابة مدروسة.
+
+## المصادقة {#authentication}
+
+تدعم نقطة النهاية MCP MCP OAuth القياسي عن بعد بالإضافة إلى البديل الحالي للرمز المميز لحامله:
+
+| الوضع                                | كيفية العمل                                                                                                  |
+| ------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
+| قياسي MCP OAuth                      | يكتشف العميل المصادقة من `WWW-Authenticate`، ويسجل، ويشغل PKCE، ويرسل `Authorization: Bearer <access-token>` |
+| ربط JWT                              | `npx @agent-native/core@latest connect` / تقوم صفحة الاتصال بإصدار JWT قابل للإلغاء لكل مستخدم               |
+| `ACCESS_TOKEN`                       | الرمز المميز لحامله الثابت — يرسل العميل `Authorization: Bearer <token>`                                     |
+| `ACCESS_TOKENS`                      | قائمة مفصولة بفواصل من الرموز المميزة لحاملها الثابتة الصالحة                                                |
+| `A2A_SECRET`                         | المصادقة المستندة إلى JWT - يتم التحقق من الرموز المميزة تشفيرًا                                             |
+| _(لم يتم ضبط أي شيء، الاسترجاع فقط)_ | لا توجد مصادقة مطلوبة لتحقيقات التطوير المحلية                                                               |
+
+بالنسبة للمضيفين MCP القادرين على OAuth، قم بتكوين الخادم البعيد URL بدون رؤوس ثابتة:
+
+```bash
+claude mcp add --transport http agent-native https://dispatch.agent-native.com/_agent-native/mcp
+```
+
+يتلقى أول طلب MCP غير مصادق عليه:
+
+```http
+HTTP/1.1 401 Unauthorized
+WWW-Authenticate: Bearer resource_metadata="https://dispatch.agent-native.com/.well-known/oauth-protected-resource", scope="mcp:read mcp:write mcp:apps"
+```
+
+اكتشاف نقاط النهاية:
+
+| نقطة النهاية                              | الغرض                                       |
+| ----------------------------------------- | ------------------------------------------- |
+| `/.well-known/oauth-protected-resource`   | البيانات التعريفية للموارد المحمية RFC 9728 |
+| `/.well-known/oauth-authorization-server` | البيانات التعريفية لخادم التخويل OAuth      |
+| `/_agent-native/mcp/oauth/register`       | التسجيل الديناميكي للعميل العام             |
+| `/_agent-native/mcp/oauth/authorize`      | تخويل المتصفح + الموافقة                    |
+| `/_agent-native/mcp/oauth/token`          | منح رمز التفويض ورمز التحديث                |
+
+```an-diagram title="OAuth discovery flow" summary="A 401 kicks off discovery, registration, and a PKCE authorize → token exchange. The Bearer token is audience-bound and scoped."
+{
+  "html": "<div class=\"diagram-oauth\"><div class=\"diagram-box\" data-rough>first request<br><small class=\"diagram-muted\">no token</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill warn\">401 · WWW-Authenticate</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel\"><span class=\"diagram-pill\">/.well-known/oauth-protected-resource</span><span class=\"diagram-pill\">/.well-known/oauth-authorization-server</span><small class=\"diagram-muted\">discover</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-pill\">register</div><div class=\"diagram-pill\">authorize (PKCE)</div><div class=\"diagram-pill\">token</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Bearer access token<br><small class=\"diagram-muted\">audience-bound · mcp:read / write / apps</small></div></div>",
+  "css": ".diagram-oauth{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-oauth .diagram-panel{display:flex;flex-direction:column;align-items:center;gap:4px}.diagram-oauth .diagram-col{display:flex;flex-direction:column;gap:6px}.diagram-oauth .diagram-arrow{font-size:20px;line-height:1}"
+}
+```
+
+رموز الوصول المميزة هي JWTs موقعة وجمهورها هو مورد MCP الدقيق URL. يقبل الخادم فقط الرموز المميزة الصادرة لنفسه ويطبق النطاقات قبل أدوات الإدراج/الاتصال:
+
+| النطاق      | يسمح                                   |
+| ----------- | -------------------------------------- |
+| `mcp:read`  | actions للقراءة فقط                    |
+| `mcp:write` | تحور actions و`ask-agent`              |
+| `mcp:apps`  | موارد تطبيقات MCP (موارد `ui://` HTML) |
+
+يتم تخزين الرموز المميزة للتحديث فقط على هيئة تجزئات ويتم تدويرها عند كل تحديث. يقوم `npx @agent-native/core@latest connect` بكتابة إدخال OAuth URL فقط لعملاء Claude Code بشكل افتراضي؛ احتفظ بصفحة الاتصال، و`npx @agent-native/core@latest connect --token <token>`، وتكوين الحامل الثابت لوكيل stdio المحلي، والعملاء الأقدم، وتدفقات الطوارئ/تصحيح الأخطاء.
+
+## إعداد MCP مخصص {#custom-setup}
+
+يتم تثبيت خادم MCP تلقائيًا بواسطة البرنامج الإضافي لدردشة الوكيل. بالنسبة لمعظم التطبيقات، لا توجد حاجة إلى أي تكوين. إذا كنت بحاجة إلى سلوك مخصص، فيمكنك تثبيته يدويًا في مكون إضافي للخادم:
+
+```ts
+// server/plugins/mcp.ts
+import { mountMCP } from "@agent-native/core/mcp";
+import { autoDiscoverActions } from "@agent-native/core/server";
+
+export default defineNitroPlugin(async (nitro) => {
+  const actions = await autoDiscoverActions(import.meta.url);
+
+  mountMCP(nitro, {
+    name: "My App",
+    description: "Custom MCP server",
+    actions,
+    // Optional: provide ask-agent handler
+    askAgent: async (message) => {
+      // Your custom agent logic
+      return "Response";
+    },
+    // Optional: override the route prefix (default "/_agent-native")
+    // routePrefix: "/_agent-native",
+  });
+});
+```
+
+## مثال: التحليلات من كود Claude {#example}
+
+لديك تطبيق تحليلات منشور على `analytics.example.com`. من كود Claude:
+
+```bash
+claude mcp add --transport http analytics https://analytics.example.com/_agent-native/mcp
+```
+
+أو أضفه يدويًا في `.mcp.json`:
+
+```jsonc
+// .mcp.json
+{
+  "mcpServers": {
+    "analytics": {
+      "type": "http",
+      "url": "https://analytics.example.com/_agent-native/mcp",
+    },
+  },
+}
+```
+
+الآن في كود Claude:
+
+```
+> How many signups did we get last week?
+
+Claude Code calls: run-query(sql: "SELECT count(*) FROM signups WHERE created_at > now() - interval '7 days'")
+→ "1,247 signups last week"
+```
+
+لمزيد من التحليل المعقد:
+
+```
+> Ask the analytics agent to prepare a full breakdown of Q3 signups by source, with trends
+
+Claude Code calls: ask-agent(message: "Prepare a full breakdown of Q3 signups by source, with trends")
+→ The analytics agent runs multiple queries, reasons about the data, and returns a formatted report
+```