@agent-native/core 0.76.5 → 0.76.6

package/corpus/core/docs/content/locales/ar-SA/local-file-mode.md

@@ -0,0 +1,433 @@
+---
+title: "وضع الملف المحلي"
+description: "قم بتشغيل تطبيقات الوكيل الأصلية باستخدام ملفات Markdown وMDX المحلية وملفات الريبو الأخرى كمصدر للحقيقة - بما في ذلك مستندات MDX ذات النمط Obsidian مع المكونات المخصصة."
+---
+
+# وضع الملف المحلي
+
+يتيح وضع الملف المحلي لتطبيق الوكيل الأصلي إرفاق UI العادي وسطح الإجراء
+مباشرة إلى الملفات الموجودة في الريبو أو مساحة العمل. لا يزال التطبيق يبدو وكأنه التطبيق المستضاف
+المنتج، لكن طرق عرض القائمة والمحرر وأدوات الوكيل الخاصة به تقرأ وتكتب الملفات المحلية
+بدلاً من سجلات التطبيقات المدعومة بـ SQL.
+
+التنفيذ الأول موجود في قالب المحتوى: الشريط الجانبي الأيسر هو
+يتم ملؤها من ملفات `.md` و`.mdx` المحلية، ويؤدي تحديد صفحة إلى فتح المعيار
+محرر المحتوى، ويحفظ الحفظ ويكتب مرة أخرى إلى الملف المحدد. نفس الملفات يمكن
+يتم تحريره أيضًا بواسطة Codex أو Claude أو وكيل الشريط الجانبي Agent-Native أو وكيل عادي
+محرر.
+
+بالنسبة للمحتوى، هذا يجعل المنتج يبدو وكأنه سبج مفتوح المصدر لـ MDX:
+تظهر مستنداتك كملفات، بينما يضيف التطبيق محررًا مرئيًا، الوكيل actions،
+نسخ قابلة للمشاركة، ومكونات MDX تفاعلية غنية.
+
+استخدم وضع الملف المحلي عندما تريد سير عمل الريبو الأول:
+
+- مستودع المستندات باستخدام `docs/*.mdx`
+- مدونة تحتوي على `blog/*.mdx`
+- موارد مثل تحديد المواقع أو المراسلة أو ملاحظات الفريق في `resources/*.md`
+- قاعدة معرفية شخصية على طراز Obsidian مع محرر MDX الأكثر ثراءً
+- المستندات التي تحتاج إلى كتل MDX تفاعلية مخصصة تم إنشاؤها من كود React المحلي
+- عناصر التطبيق التي ينبغي أن يسهل على وكلاء البرمجة فحصها وتصحيحها
+
+استخدم وضع قاعدة البيانات عندما تريد تجربة التطبيق التعاوني المستضاف:
+مشاركة متعددة المستخدمين، والأذونات المدعومة SQL، والتعليقات، وسجل الإصدارات، و
+استضافة الإنتاج دون الوصول إلى نظام الملفات المحلي.
+
+## النموذج العقلي
+
+هناك وضعان لمصدر الحقيقة:
+
+| الوضع              | مصدر الحقيقة                                    | الأفضل لـ                                                                          |
+| ------------------ | ----------------------------------------------- | ---------------------------------------------------------------------------------- |
+| وضع قاعدة البيانات | صفوف SQL حتى Drizzle                            | التطبيقات المستضافة والتعاون والمشاركة والتعليقات وسجل الإصدارات                   |
+| وضع الملف المحلي   | ملفات الريبو المعلنة بواسطة `agent-native.json` | سير العمل المحلي/المطور، ومراجعة Git، وتعديلات وكيل الترميز، والمحتوى الأصلي للملف |
+
+يجب أن يظل UI والوكيل actions بنفس الشكل في كلا الوضعين. المحتوى
+لا يزال المحرر يقوم بتحرير المستندات؛ والفرق هو ما إذا كانت هذه المستندات قد تم حلها
+إلى صفوف SQL أو الملفات المحلية.
+
+```an-diagram title="Same actions, two sources of truth" summary="The UI and agent call identical actions in both modes. The action layer decides whether each call resolves to SQL rows or repo files."
+{
+  "html": "<div class=\"diagram-mode\"><div class=\"diagram-col entry\"><div class=\"diagram-node\">Content UI</div><div class=\"diagram-node\">Agent + actions<br><small class=\"diagram-muted\">list/get/update-document</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-row resolve\"><div class=\"diagram-panel\" data-rough><span class=\"diagram-pill accent\">Database mode</span><small class=\"diagram-muted\">SQL rows via Drizzle</small><small class=\"diagram-muted\">hosted · sharing · comments · history</small></div><div class=\"diagram-panel\" data-rough><span class=\"diagram-pill ok\">Local File Mode</span><small class=\"diagram-muted\">repo files via agent-native.json</small><small class=\"diagram-muted\">Git review · coding-agent edits</small></div></div></div>",
+  "css": ".diagram-mode{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-mode .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-mode .diagram-arrow{font-size:22px;line-height:1}.diagram-mode .resolve{display:flex;gap:12px;flex-wrap:wrap}.diagram-mode .diagram-panel{display:flex;flex-direction:column;gap:4px;padding:12px 14px}"
+}
+```
+
+## مثال الريبو
+
+يمكن أن تكون مساحة عمل المحتوى صغيرة مثل هذا:
+
+```an-file-tree title="A Content workspace repo"
+{
+  "entries": [
+    { "path": "agent-native.json", "note": "declares which folders are content roots and their kinds" },
+    { "path": "docs/", "note": "content root — shows in the sidebar as pages" },
+    { "path": "docs/getting-started.mdx" },
+    { "path": "docs/guides/custom-components.mdx" },
+    { "path": "blog/", "note": "content root" },
+    { "path": "blog/launch-post.mdx" },
+    { "path": "resources/", "note": "content root" },
+    { "path": "resources/messaging/positioning.md" },
+    { "path": "components/", "note": "NOT a content root — preview component library MDX can import" },
+    { "path": "components/FrameworkTabs.tsx" },
+    { "path": "components/Callout.tsx" },
+    { "path": "extensions/", "note": "NOT a content root — local extension library (sandboxed widgets)" },
+    { "path": "extensions/doc-status/extension.json" },
+    { "path": "extensions/doc-status/index.html" }
+  ]
+}
+```
+
+في وضع الملف المحلي، يعرض الشريط الجانبي للمحتوى `docs/` و`blog/` و
+أشجار `resources/` كصفحات. يؤدي تحديد `docs/getting-started.mdx` إلى فتح ذلك
+ملف في محرر المحتوى القياسي؛ التحرير في UI يعيد الكتابة إلى
+`docs/getting-started.mdx`.
+
+`components/` ليس جذر محتوى. إنها مكتبة مكونات المعاينة MDX
+يمكن استيراد الملفات أو الرجوع إليها. يمكن للمحرر عرض مكونات MDX محلية بسيطة
+دون مطالبتك باستنساخ تطبيق المحتوى بالكامل أو تفرعه.
+
+`extensions/` ليس جذرًا للمحتوى أيضًا. إنها مكتبة ملحقة محلية:
+أدوات صغيرة في وضع الحماية يمكن عرضها في فتحات التطبيق بينما يبقى مصدرها في
+الريبو.
+
+## تثبيت المحتوى في الريبو
+
+بالنسبة إلى المستندات أو المدونة أو مساحة عمل MDX الموجودة، قم بتثبيت ملفات المحتوى المحلية
+المهارة:
+
+```bash
+npx @agent-native/core@latest skills add content --mode local-files --scope project
+```
+
+يؤدي هذا إلى نسخ مهارة `content` إلى مجلدات مهارات وكيل الريبو والكتابة
+أو يقوم بتحديث `agent-native.json` باستخدام الإعدادات الافتراضية للمحتوى:
+
+- `mode: "local-files"` على مستوى مساحة العمل
+- `apps.content.mode: "local-files"`
+- جذور المحتوى لـ `docs/` و`blog/` و`content/` و`resources/`
+- `components/` لمكونات MDX المحلية
+- `extensions/` لعناصر واجهة المستخدم المحلية
+
+تخبر المهارة المثبتة وكلاء البرمجة باستخدام المحتوى actions
+(`list-documents`, `get-document`, `edit-document`, `update-document`,
+`share-local-file-document`، وملف المكون actions) عند تطبيق محتوى محلي
+أو جسر سطح المكتب Agent Native يعرضهم. إذا لم يتم تشغيل أي جسر، فستتم المهارة
+يعود إلى تعديلات الريبو المباشرة الآمنة مع الحفاظ على المادة الأمامية، والواردات، JSX،
+وMDX غير معروف.
+
+## التكوين
+
+أضف `agent-native.json` إلى الريبو أو جذر مساحة العمل:
+
+```json
+{
+  "version": 1,
+  "apps": {
+    "content": {
+      "mode": "local-files",
+      "roots": [
+        {
+          "name": "Docs",
+          "path": "docs",
+          "kind": "docs",
+          "extensions": [".md", ".mdx"]
+        },
+        {
+          "name": "Blog",
+          "path": "blog",
+          "kind": "blog",
+          "extensions": [".md", ".mdx"]
+        },
+        {
+          "name": "Resources",
+          "path": "resources",
+          "kind": "resources",
+          "extensions": [".md", ".mdx"]
+        }
+      ],
+      "components": "components",
+      "extensions": "extensions",
+      "hide": ["**/_*.md", "**/_*.mdx"]
+    }
+  }
+}
+```
+
+يمكنك أيضًا تمكين الملفات المحلية باستخدام `AGENT_NATIVE_MODE=local-files` أو
+`AGENT_NATIVE_DATA_MODE=local-files`; the manifest is preferred because it
+يوثق عقد المجلد في الريبو نفسه.
+
+## تنسيق ملف المحتوى
+
+يقرأ المحتوى Markdown وMDX. يحتفظ Frontmatter بالبيانات التعريفية للصفحة، والنص الأساسي هو
+المستند القابل للتحرير:
+
+```mdx
+---
+title: "Getting Started"
+icon: "sparkles"
+isFavorite: true
+updatedAt: "2026-06-12T20:00:00.000Z"
+---
+
+# Getting Started
+
+Use <FrameworkTabs value="react" /> to show framework-specific code.
+```
+
+يأتي العنوان من المادة الأمامية `title` في حالة وجوده، وإلا من
+اسم الملف. يحتفظ المحرر بمصدر MDX الذي لا يمكنه تحريره بصريًا بعد، لذا
+تظل عوامل الترميز ومحررات النصوص العادية بمثابة بوابات هروب آمنة.
+
+## مكونات MDX المخصصة
+
+يمكن للمحتوى معاينة المكونات المحلية من المجلد `components` الذي تم تكوينه.
+هذا مخصص لمكونات MDX بنمط المستندات مثل علامات التبويب ووسائل الشرح والحزمة
+قم بتثبيت المقتطفات أو كتل التعليمات البرمجية الخاصة بإطار العمل.
+
+على سبيل المثال، أضف مكونًا تفاعليًا بجوار المحتوى الخاص بك:
+
+```tsx
+// components/ImpactCounter.tsx
+import { useState } from "react";
+
+export function ImpactCounter({
+  label = "points",
+  accent = "blue",
+  featured = false,
+}: {
+  label?: string;
+  accent?: "blue" | "green" | "purple";
+  featured?: boolean;
+}) {
+  const [count, setCount] = useState(3);
+  const accentClass =
+    accent === "green"
+      ? "border-green-300 bg-green-50"
+      : accent === "purple"
+        ? "border-purple-300 bg-purple-50"
+        : "border-blue-300 bg-blue-50";
+
+  return (
+    <div className={`rounded-md border p-4 ${accentClass}`}>
+      <div className="text-sm text-muted-foreground">Launch impact</div>
+      <div className="mt-1 text-3xl font-semibold">
+        {count} {label}
+      </div>
+      {featured ? <div className="mt-1 text-sm">Featured metric</div> : null}
+      <button
+        type="button"
+        className="mt-3 rounded border px-3 py-1 text-sm"
+        onClick={() => setCount((value) => value + 1)}
+      >
+        Add point
+      </button>
+    </div>
+  );
+}
+
+export const ImpactCounterInputs = {
+  label: {
+    type: "string",
+    label: "Metric label",
+    default: "points",
+  },
+  accent: {
+    type: "select",
+    label: "Accent",
+    options: ["blue", "green", "purple"],
+    default: "blue",
+  },
+  featured: {
+    type: "boolean",
+    label: "Featured",
+    default: false,
+  },
+};
+```
+
+ثم استخدمه من أي ملف MDX محلي:
+
+```mdx
+---
+title: "Launch Notes"
+---
+
+# Launch Notes
+
+<ImpactCounter label="wins" />
+```
+
+يكتشف خادم تطوير المحتوى PascalCase المسمى الصادرات وPascalCase الافتراضي
+يتم التصدير من ملفات `.tsx` و`.jsx` و`.ts` و`.js` ضمن `components/`. تلك
+يتم عرض المكونات داخل المحرر وتظهر في قائمة الشرطة المائلة ضمن
+**المكونات المحلية**. يؤدي إدراج شرطة مائلة إلى إنشاء علامة صغيرة مثل
+`<ImpactCounter />`؛ أضف الدعائم في مصدر MDX عند الحاجة.
+
+تنفيذ المكون هو عن قصد إمكانية جسر محلي/سطح المكتب، وليس
+الوصول العادي إلى مجلد المتصفح المستضاف. إذا قمت بفتح `content.agent-native.com`،
+اختر **الملفات المحلية**، واختر مجلدًا في Chrome، حيث يمكن للتطبيق القراءة والكتابة
+الملفات `.md` و`.mdx` من خلال الوصول إلى نظام الملفات في المتصفح API، ولكن
+لا يعرض Chrome مسارًا مطلقًا للمجلد لتجميعه Vite
+`components/*.tsx`. لمعاينة مكونات React المخصصة وإعادة تحميلها بسرعة، قم بتشغيل
+المحتوى محليًا أو استخدم Agent Native Desktop حتى يتمكن الجسر المحلي الموثوق به من
+قم بتسجيل مساحة العمل المختارة باستخدام خادم تطوير المحتوى المحلي. في هذا الوضع،
+عمليات التحرير على ملفات المكونات الموجودة، إعادة التحميل السريع من خلال Vite، وإضافة أو
+تؤدي إزالة ملفات المكونات إلى إعادة تحميل سجل المكونات وقائمة الشرطة المائلة.
+
+يمكن للوكلاء أيضًا العمل مع ملفات المكونات المسجلة. استخدم
+`list-local-component-files` للعثور على معرف مساحة العمل المسجلة، ثم
+`write-local-component-file` لإنشاء أو تحديث `.tsx` أو `.jsx` أو `.ts` أو
+ملفات `.js` ضمن المجلد `components/` الخاص بمساحة العمل. تظل ملفات MDX هي
+مصدر الحقيقة لاستخدام المكونات؛ تظل ملفات المكونات مستودعًا عاديًا
+تمت مراجعة الملفات المصدر باستخدام Git.
+
+إذا قام أحد المكونات بتصدير بيانات التعريف المدخلة، فحدد المكون في المحرر
+يُظهر زر التحرير في الزاوية العلوية اليمنى للمكون. أنواع الإدخال المدعومة
+هي `string`، و`textarea`، و`number`، و`boolean`، و`select`. يكتب النموذج
+مرة أخرى إلى علامة MDX، بحيث تظل الملفات المحلية هي مصدر الحقيقة. ال
+يمكن تصدير البيانات الوصفية بتنسيق `ComponentNameInputs`، `ComponentNameConfig.inputs`،
+`Component.inputs`، أو `agentNative.inputs`.
+
+يمكن معاينة علامات المكونات البسيطة ذات الدعائم الحرفية في السطر:
+
+```mdx
+<FrameworkTabs value="react" />
+
+<Callout type="warning">This setting affects production deploys.</Callout>
+```
+
+يتم الاحتفاظ بتعبيرات JSX المعقدة في المصدر. إذا لم يتمكن المحرر بأمان
+قم بمعاينة خاصية المكون حتى الآن، فهي تعرض عنصرًا نائبًا للتحذير بدلاً من
+إسقاط البيانات بصمت.
+
+## مشاركة الملفات المحلية
+
+لا تتم مشاركة الملفات المحلية مباشرة لأن المستخدمين الآخرين لا يستطيعون قراءة المسار الموجود على
+جهازك. يقوم زر المشاركة في شريط أدوات المحتوى بإنشاء أو تحديث
+نسخة مدعومة بقاعدة بيانات من الملف المحدد، وتنتقل إلى تلك النسخة، وتفتح
+مشاركة عادية منبثقة. يبقى الملف المحلي الأصلي ضمن الملفات المحلية؛
+تظهر نسخة قاعدة البيانات ضمن النسخ المشتركة في وضع الملف المحلي وتستخدم
+النموذج القياسي لمشاركة المستندات.
+
+## الإضافات المحلية
+
+يمكن أيضًا أن يقوم وضع الملف المحلي بتحميل الامتدادات المدعومة بالريبو من الملف الذي تم تكوينه
+مجلد `extensions`. كل ملحق عبارة عن دليل واحد به `extension.json`
+البيان وملف الإدخال HTML:
+
+```text
+extensions/
+  doc-status/
+    extension.json
+    index.html
+```
+
+```json
+{
+  "id": "doc-status",
+  "name": "Doc Status",
+  "description": "Shows metadata for the selected Content file.",
+  "entry": "index.html",
+  "slots": ["content.sidebar.bottom"],
+  "permissions": {
+    "appActions": ["list-documents"],
+    "extensionData": true
+  }
+}
+```
+
+`index.html` هو نفس تنسيق هيكل امتداد Alpine/Tailwind المستخدم في المعتاد
+الامتدادات المدعومة بقاعدة البيانات. عندما يرى تطبيق المحتوى امتدادًا محليًا
+يُعلن عن `content.sidebar.bottom`، ويعرض هذا الامتداد في الجزء السفلي من
+الشريط الجانبي للمحتوى. يمرر المضيف `window.slotContext` مع
+معرف المستند، والعنوان، وبيانات تعريف المصدر، وما إذا كان المحتوى في وضع الملف المحلي.
+
+يقوم التطبيق بمعاينة الإضافات المحلية ولكن يتم تحريرها كملفات. الامتدادات
+هذه الملفات بشارة ملف محلي، ويشير عارض الصفحة الكاملة إلى
+ملف الإدخال. الامتداد المدعوم SQL actions مثل التحديث والحذف والمشاركة و
+لا ينطبق التاريخ؛ استخدم المحرر الخاص بك، Codex، رمز Claude، أو سجل Git لـ
+تغييرات المصدر.
+
+بالنسبة للإصدار 1، تكون الامتدادات المحلية متحفظة عمدًا:
+
+- يمكنهم استخدام `extensionData` لحالة وقت التشغيل الصغيرة الخاصة بهم
+- يمكنهم الاتصال فقط بـ `appAction` المدرجة في `extension.json`
+- تم تعطيل مساعدات SQL الأولية و`extensionFetch` الخارجية
+- تم الإعلان عن أهداف الفتحات في `extension.json`، ولم يتم تثبيتها من خلال SQL
+
+يمنح هذا مساحات العمل المحلية سطحًا إضافيًا شبيهًا بسطح Obsidian دون السماح
+يرث ملف الريبو التعسفي كل إمكانات الامتداد المدعوم بقاعدة البيانات.
+
+## كيفية استخدام التطبيقات لها
+
+يتم تنفيذ وضع الملف المحلي من خلال أدوات المساعدة المحلية لإطار العمل.
+يعلن التطبيق عن جذور أنواع العناصر التي يمتلكها، ثم يقرأها ويكتبها
+من خلال نفس سطح الإجراء الذي يستخدمه UI والوكيل بالفعل.
+
+بالنسبة للمحتوى، فهذا يعني:
+
+- يسرد `list-documents` ملفات `.md` و`.mdx` التي تم تكوينها.
+- يقرأ `get-document` ملفًا محليًا محددًا.
+- يقوم `update-document` بكتابة الملف المحلي المحدد.
+- يقوم `create-document` بإنشاء ملف `.mdx` محلي جديد في المجلد المحدد.
+- يحذف `delete-document` الملف المحلي.
+- يتم تشغيل البحث عبر الملفات المحلية التي تم تكوينها.
+
+لا يعد نقل صفحات الملفات المحلية وإعادة تسميتها وإعادة ترتيبها من المحتوى UI
+معتمد حتى الآن. قم بإجراء تلك العمليات في مساحة العمل أو باستخدام وكيل ترميز؛ ال
+سيعكس الشريط الجانبي للمحتوى شجرة الملفات الناتجة.
+
+يُبقي هذا عقد الوكيل بسيطًا: يمكن للوكيل الاستمرار في استخدام المحتوى actions،
+ويقرر هؤلاء actions ما إذا كان الهدف مدعومًا بـ SQL أو مدعومًا بالملف.
+
+يمكن للتطبيقات الأخرى أن تتبنى نفس النمط مع مرور الوقت. يمكن لتطبيق العروض التقديمية تعيين
+`slides/*.mdx` إلى المجموعات، ويمكن لتطبيق الخطط تعيين `plans/*` لتخطيط المستندات، و
+يمكن لتطبيق لوحات المعلومات تعيين `dashboards/*.mdx` إلى لوحات المعلومات. تلك الخاصة بالتطبيق
+المجلدات عبارة عن اتفاقيات موضوعة فوق نفس عقد المنتج المحلي.
+
+## الملفات المحلية مقابل التصدير/الاستيراد
+
+يحتوي المحتوى على سير عمل ملفين مختلفين:
+
+| سير العمل                    | ماذا يحدث                                                                                                           |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------------------- |
+| تصدير/استيراد `/local-files` | يظل وضع قاعدة البيانات هو مصدر الحقيقة. تعد الملفات بمثابة سطح مزامنة واضح يمكنك تصديره وتحريره ومعاينته واستيراده. |
+| وضع الملف المحلي             | الملفات هي مصدر الحقيقة. يعمل الشريط الجانبي للمحتوى والمحرر مباشرة على الملفات المحلية.                            |
+
+استخدم التصدير/الاستيراد عندما تريد مراجعة الملفات من حين لآخر حول مساحة عمل مستضافة.
+استخدم وضع الملف المحلي عندما يكون الريبو نفسه هو مساحة العمل.
+
+## التاريخ والتعاون
+
+يعتمد وضع الملف المحلي على سجل الملف الأصلي:
+
+- إجراء تغييرات مهمة على Git
+- استخدم طلبات السحب للمراجعة
+- السماح لوكلاء البرمجة بتحرير نفس الملفات مباشرة
+- استخدم اختلافات الملفات العادية لفهم التغييرات
+
+يظل وضع قاعدة البيانات هو الأفضل لميزات التعاون المستضافة مثل
+المشاركة والتعليقات وسجل الإصدارات المدعومة بـ SQL والتحرير المباشر لعدة مستخدمين.
+
+يمكن وضع مزامنة الموفر في أعلى أي من الوضعين. على سبيل المثال، يمكن لمستودع المستندات
+أضف actions الذي يسحب المحتوى من CMS إلى ملفات MDX المحلية أو يدفع المحدد
+الملفات المحلية تعود إلى CMS.
+
+## سلامة الإنتاج
+
+يمنح وضع الملف المحلي التطبيق actions إمكانية الوصول المباشر للكتابة إلى مساحة العمل التي تم تكوينها
+ملفات. وهذا مناسب للتطوير المحلي وملف المستأجر الفردي الموثوق به
+الجسور، ولكنها ليست نموذج أمان الإنتاج الافتراضي.
+
+عند `NODE_ENV=production`، يرفض إطار العمل وضع `local-files` إلا إذا
+المجموعة:
+
+```bash
+AGENT_NATIVE_ALLOW_LOCAL_FILES_IN_PRODUCTION=true
+```
+
+قم بتعيين ذلك فقط لنشر مستأجر واحد موثوق به حيث يمكن لكل من يمكنه استخدامه
+يُسمح للتطبيق بقراءة الملفات التي تم تكوينها وكتابتها. بالنسبة للاستضافة العادية،
+تطبيقات متعددة المستخدمين، استخدم وضع قاعدة البيانات والمشاركة المدعومة SQL.

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

@@ -0,0 +1,147 @@
+---
+title: "تطبيقات MCP"
+description: "قم بتأليف تطبيقات MCP التفاعلية UI وتضمينها داخل Claude وChatGPT والمضيفين المتوافقين الآخرين - باستخدام مسارات التطبيق الحقيقية وجسر التضمين وجسر المضيف API."
+---
+
+# تطبيقات MCP
+
+**هذه الصفحة: UIs المضمّنة في Claude/ChatGPT.** تأليف موارد تطبيق MCP وجسر التضمين الذي يعرض مسار تطبيق حقيقي داخل دردشة مضيف متوافق. هذه الصفحة هي أيضًا الصفحة الرئيسية الوحيدة لـ **مصفوفة دعم العميل** ([below](#client-support)).
+
+| إذا كنت تريد...                                                     | اقرأ                                     |
+| ------------------------------------------------------------------- | ---------------------------------------- |
+| قم بتوصيل وكيل/مضيف خارجي بتطبيقك                                   | [External Agents](/docs/external-agents) |
+| امنح وكيلك المزيد من الأدوات (استخدم خوادم MCP الأخرى)              | [MCP Clients](/docs/mcp-clients)         |
+| إنشاء UI المضمنة التي يتم عرضها في Claude/ChatGPT                   | **هذه الصفحة** — تطبيقات MCP             |
+| مرجع خادم MCP ذو المستوى الأدنى (المصادقة، الأدوات، التثبيت المخصص) | [MCP Protocol](/docs/mcp-protocol)       |
+
+تطبيقات MCP هي امتداد `io.modelcontextprotocol/ui` الرسمي الذي يتيح للمضيفين المتوافقين - Claude وClaude Desktop وChatGPT وVS Code GitHub Copilot وGoose وPostman وMCPJam وCursor - عرض UI التفاعلية في الدردشة. في التطبيقات الأصلية للوكيل، يكون كل تطبيق MCP **مسار React حقيقي**، وليس عنصر واجهة مستخدم عادي منفصل لـ HTML.
+
+داخل الدردشة الخاصة بتطبيق Agent-Native، تفضل [native chat renderers](/docs/native-chat-ui) لعناصر واجهة المستخدم الخاصة بالطرف الأول مثل الجداول والمخططات والنتائج المكتوبة وتكاليف الموافقة. استخدم تطبيقات MCP للمضيف الخارجي/المضيف المضمن UI في Claude، وChatGPT، وCopilot، وCursor، والمضيفين المتوافقين الآخرين، مع الإجراء `link` باعتباره الإجراء الاحتياطي العالمي للارتباط العميق.
+
+## التأليف: تطبيقات MCP الاختيارية UI {#mcp-apps}
+
+بالنسبة للمضيفين الذين يدعمون ملحق MCP Apps، يمكن للإجراء أيضًا الإعلان عن مورد UI المضمّن باستخدام `mcpApp`. يعد هذا تحسينًا تدريجيًا للتدفقات حيث يجب على الوكيل الخارجي أن يقدم للمستخدم سطحًا تفاعليًا بدلاً من النص فقط - على سبيل المثال، مراجعة مسودة بريد إلكتروني، أو تعديل دعوة تقويم، أو الاختيار بين متغيرات لوحة المعلومات التي تم إنشاؤها.
+
+استخدم تطبيق React الحقيقي مع `embedRoute()` أو `embedApp()` عندما يحتاج المستخدم إلى UI. النموذج العقلي بسيط: هدف `link` للإجراء هو أيضًا هدف تضمين تطبيق MCP. اكشف عن العملية كإجراء/أداة عادية، وقم بإرجاع رابط عميق مركّز باستخدام `link`، وأضف `mcpApp.resource = embedApp(...)` بحيث يقوم المضيفون القادرون بتحميل نفس المسار المضمن بدلاً من فتح علامة تبويب جديدة. عندما يجب إنشاء كليهما من نفس المسار، تفضل `embedRoute({ title, openLabel, path })`: فهو برنامج تضمين ملائم يقوم بإرجاع حقول `link` و`mcpApp` المطابقة من استدعاء واحد، بينما `embedApp(...)` هو المورد ذو المستوى الأدنى الذي تقوم بتعيينه إلى `mcpApp.resource` مباشرة.
+
+وهذا يعني أن عمليات تضمين التطبيق الكامل يمكنها فعل أي شيء يمكن أن يفعله المسار بمجرد فتحه: مراجعة مسودة بريد إلكتروني أو تحريرها، أو إظهار بريد وارد/بحث تمت تصفيته، أو فتح حدث تقويم أو مسودة حدث، أو تحميل صفحة ملحق، أو فحص لوحة معلومات التحليلات الكاملة أو التحليل المحفوظ، أو متابعة المجموعة في محرر الشرائح، أو فتح مشروع/محرر تصميم. تفضل معلمات URL/الارتباط العميق وجسر حالة التنقل/التطبيق `/_agent-native/open` الحالي على اختراع بروتوكول الحالة الثانية لتطبيقات MCP.
+
+في حالات نادرة، يكون الهدف الصحيح هو مسار تطبيق مركّز يعرض مكون React مشتركًا واحدًا بدلاً من غلاف التطبيق بالكامل. يعد مسار `/chart` الخاص بـ Analytics هو النموذج: فهو يأخذ حمولة `SqlPanel` مدمجة في URL ويعرض نفس مكون المخطط الذي تستخدمه لوحة المعلومات. لا يزال هذا تطبيقًا مضمنًا، وليس تطبيق HTML MCP عادي. قم بكشفه أو استدعائه من خلال إجراء عادي / `open_app({ path, embed: true })`، واحتفظ بحتمية URL، واترك `embedApp()` يعرض هذا المسار في السطر.
+
+لا تكتب بخط اليد تطبيقات HTML MCP العادية لمرة واحدة للمنتج UI؛ إذا كان الإجراء يحتاج إلى سطح مخصص، فأضف أو أعد استخدام مسار/مكون حقيقي للتطبيق أولاً وقم بتضمين هذا المسار.
+
+```an-diagram title="MCP App embed round-trip" summary="The action's link target is also the embed target. Capable hosts load the same signed app route inline; everyone else falls back to the deep link."
+{
+  "html": "<div class=\"diagram-embed\"><div class=\"diagram-card\" data-rough><strong>Action</strong><small class=\"diagram-muted\">`link` target = MCP App embed target</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\" data-rough><strong>embedApp()</strong><span class=\"diagram-pill accent\">create_embed_session</span><small class=\"diagram-muted\">mints short-lived embed session</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\" data-rough><strong>/_agent-native/embed/start</strong><small class=\"diagram-muted\">exchanges one-time SQL ticket</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\" data-rough><strong>Signed app route</strong><span class=\"diagram-pill ok\">real React route</span><small class=\"diagram-muted\">short-lived browser session</small></div><div class=\"diagram-fallback\"><span class=\"diagram-pill warn\">no MCP Apps support</span><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>&quot;Open in … &rarr;&quot; deep link</div></div></div>",
+"css": ".diagram-embed{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-embed .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:140px}.diagram-embed .diagram-arrow{font-size:22px;line-height:1}.diagram-embed .diagram-fallback{display:flex;flex-direction:column;align-items:center;gap:6px;margin-inline-start:8px}"
+}
+
+```
+
+```ts
+import { embedApp } from "@agent-native/core";
+
+export default defineAction({
+  // ...description, schema, run, link...
+  mcpApp: {
+    resource: embedApp({
+      title: "Review draft",
+      description: "Open the generated draft in the real Mail compose UI.",
+      iframeTitle: "Agent-Native Mail",
+      openLabel: "Open in Mail",
+    }),
+  },
+});
+```
+
+```an-annotated-code title="The mcpApp resource config"
+{
+  "filename": "actions/review-draft.ts",
+  "language": "ts",
+  "code": "import { embedApp } from \"@agent-native/core\";\n\nexport default defineAction({\n  // ...description, schema, run, link...\n  mcpApp: {\n    resource: embedApp({\n      title: \"Review draft\",\n      description: \"Open the generated draft in the real Mail compose UI.\",\n      iframeTitle: \"Agent-Native Mail\",\n      openLabel: \"Open in Mail\",\n    }),\n  },\n});",
+  "annotations": [
+    { "lines": "6", "label": "Progressive enhancement", "note": "`mcpApp.resource` advertises an inline UI for hosts that support the MCP Apps extension. Keep the action's `link` builder too — CLI-only and older hosts ignore the UI metadata and still need the deep link." },
+    { "lines": "7", "label": "Embed = the link target", "note": "`embedApp()` uses the action's `link` as its launch target: it calls `create_embed_session`, exchanges a one-time SQL ticket at `/_agent-native/embed/start`, and navigates the MCP App frame to the same signed app route." },
+    { "lines": "11", "label": "Universal fallback label", "note": "`openLabel` is the visible `\"Open in … →\"` text used as the deep-link escape hatch when a host does not render the inline iframe." }
+  ]
+}
+```
+
+يعلن خادم MCP عن الامتداد `io.modelcontextprotocol/ui`، ويضيف `_meta.ui.resourceUri` بالإضافة إلى `_meta["ui/resourceUri"]` إلى `tools/list`، ويصدر أيضًا بيانات تعريف توافق ChatGPT Apps SDK (`openai/outputTemplate`، عنصر واجهة المستخدم CSP/الوصف/إمكانية الوصول). يعرض HTML حتى `resources/list` و`resources/templates/list` و`resources/read` باستخدام MIME `text/html;profile=mcp-app`. يقوم وكيل stdio بإعادة توجيه معالجات الموارد هذه من التطبيق المباشر، لذلك يرى عملاء سطح المكتب وعملاء CLI نفس الموارد التي يشاهدها عملاء HTTP.
+
+احتفظ بمنشئ `link` الحالي حتى عند إضافة `mcpApp`. عملاء CLI فقط والمضيفون الأقدم وأي مضيف لا يعرض تطبيقات MCP سوف يتجاهلون البيانات التعريفية UI وسيظلون بحاجة إلى رابط `"Open in … →"`. يستخدم `embedApp()` هذا الارتباط كهدف إطلاق، ويستدعي مساعد `create_embed_session` للتطبيق فقط، ويتبادل تذكرة SQL لمرة واحدة في `/_agent-native/embed/start`، ويتنقل إطار تطبيق MCP إلى المسار المستهدف من خلال جلسة متصفح قصيرة الأجل بالإضافة إلى احتياطي حامل لعمليات الجلب من نفس المصدر. `open_app({ app, path, embed: true })` عبارة عن فتحة هروب عامة للمسارات مثل لوحات المعلومات الكاملة، وصناديق البريد الوارد المفلترة، وطرق عرض مسودة التقويم، والتحليلات، وصفحات الإضافات، ويجب استخدامها بحرية عندما يكون التطبيق الكامل هو أوضح سطح للمراجعة/التحرير.
+
+يتضمن `embedApp()` أصل طلب MCP في المورد CSP حتى يتمكن المُشغل من جلب مسار تطبيق الطرف الأول الموقع، عند طلبه صراحةً، وتأطيره. تضيف Dispatch الأصول الدقيقة للتطبيقات الممنوحة إلى مورد `open_app` الخاص بها بحيث يمكن لموصل Dispatch واحد تضمين البريد والتقويم والشرائح والباقي دون السماح بكل أصل HTTPS. قم بتمرير إطار إضافي أو نطاقات موارد فقط لتطبيق MCP المخصص الذي يقوم بالفعل بتضمين مشغل طرف ثالث أو تحميل أصول طرف ثالث.
+
+داخل مسارات `embedApp()` هذه، يكون `sendToAgentChat()` مدركًا للتضمين. يتم ترحيل المطالبات المقدمة تلقائيًا إلى مضيف MCP كـ `ui/update-model-context` بالإضافة إلى `ui/message`، بحيث يمكن للزر الموجود في التطبيق المضمن متابعة محادثة Claude/ChatGPT عن قصد من حالة التطبيق المحددة. يتم إرسال السياق المخفي كسياق نموذجي؛ يبقى دور المستخدم المرئي مجرد مطالبة التطبيق، مما يتجنب موافقة المضيف المخيفة حول مسارات ملفات حالة التطبيق الداخلية. يظل `submit: false` سلوك التعبئة المسبقة/المراجعة المحلي.
+
+## جسر تطبيقات MCP من الدرجة الأولى {#mcp-app-bridge}
+
+تضمينات تطبيق MCP عبارة عن تضمينات للمسار، وليست منتجات صغيرة منفصلة. يبدأ `embedApp()` من هدف `link` للإجراء، وينشئ جلسة تضمين قصيرة الأجل، ويطلق مسار التطبيق الموقع. يمكن لمضيفي MCP Apps القياسيين التنقل في إطار تطبيق MCP نفسه عندما يتمكن المضيف من ترطيب المسار مباشرة.
+
+```an-diagram title="Two host bridge paths, one signed route" summary="Claude transplants the hydrated route and uses the direct ui/_bridge; ChatGPT gets a controlled iframe via window.openai and relays host actions over postMessage. Both point at the same signed app route."
+{
+  "html": "<div class=\"diagram-bridge\"><div class=\"diagram-col\"><div class=\"diagram-card\" data-rough><strong>Claude web</strong><span class=\"diagram-pill accent\">single-frame transplant</span><small class=\"diagram-muted\">hydrates signed app HTML in Claude's iframe, then direct`ui/_` host bridge</small></div><div class=\"diagram-card\" data-rough><strong>ChatGPT web</strong><span class=\"diagram-pill accent\">controlled route iframe</span><small class=\"diagram-muted\">`window.openai`host APIs ·`agentNative.mcpHost.*` postMessage relay</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Same signed app route<br><small class=\"diagram-muted\">normal route + React components</small></div></div>",
+"css": ".diagram-bridge{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-bridge .diagram-col{display:flex;flex-direction:column;gap:12px}.diagram-bridge .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;max-width:300px}.diagram-bridge .diagram-arrow{font-size:22px;line-height:1}.diagram-bridge .diagram-box{padding:16px 18px;text-align:center}"
+}
+
+```
+
+يستخدم الويب Claude مسار زرع إطار واحد: يجلب مستند المورد التطبيق الموقع HTML ويرطبه داخل إطار iframe لتطبيق MCP الخاص بـ Claude لأن Claude لا يسمح بشكل موثوق بإطارات iframe الفرعية المملوكة للتطبيق أو التنقل في الإطارات الخارجية. تحصل شبكة ChatGPT على مسار iframe يمكن التحكم فيه لأن جسر Apps الخاص بها يمنحنا مضيف `window.openai` المستقر API والتحكم في الارتفاع المحدود. تشير جميع المسارات إلى نفس مسار التطبيق الموقع وتعرض المسار العادي ومكونات React. صمم المسارات المضمنة بحيث تؤدي إعادة التحميل باستخدام نفس URL الموقعة إلى إعادة بناء نفس العرض.
+
+بالنسبة إلى `open_app({ embed: true })` لنفس التطبيق، يقوم إطار العمل بإصدار تذكرة بدء التضمين أثناء استدعاء الأداة الأصلية ويخزن البداية الموقعة URL في بيانات تعريف الأداة المخفية. يمكن لـ actions المخصص إرجاع `embedStartUrl` لنفس المسار السريع؛ تقوم طبقة MCP بإزالة URL الحاملة للتذكرة من `structuredContent` المرئية بالنموذج والبيانات الوصفية العادية للارتباط المفتوح. في حالة عدم وجود بداية تضمين URL، يعود المورد إلى مساعد `create_embed_session` الخاص بالتطبيق فقط. يؤدي هذا إلى إبقاء مضيفي الإنتاج الذين يقيدون استدعاءات الأداة التي يبدأها iframe على المسار المباشر دون تسريب جلسة التطبيق لمرة واحدة URLs في النص. إذا قام المستخدم بإعادة فتح محادثة قديمة بعد انتهاء صلاحية تذكرة البدء لمرة واحدة، فسيقوم مسار البداية بإرجاع صفحة تحديث صغيرة ونشر `agentNative.embedSessionExpired` في الغلاف؛ يقوم `embedApp()` بمسح البداية القديمة URL ويصدر تذكرة جديدة عبر `create_embed_session` عندما لا يزال لديه مسار التطبيق الأصلي.
+
+يحصل ChatGPT على مسار توافق مخصص من خلال `window.openai`: يقرأ مستند الإطلاق `toolInput` و`toolOutput` و`toolResponseMetadata` مباشرة، ثم يستدعي `create_embed_session` عبر `window.openai.callTool(...)`. يستخدم مضيفو MCP Apps القياسيون الجسر `ui/*` JSON-RPC. يمكن للمسارات الرطبة مباشرة استدعاء `ui/update-model-context`، و`ui/message`، و`ui/open-link`، و`ui/request-display-mode` من خلال مساعدي الجسر المضيف. يستخدم المسار المزروع لـ Claude نفس الجسر المضيف المباشر `ui/*` بعد الترطيب. عند استخدام ChatGPT أو مسار iframe التشخيصي الصريح، يقوم المجمّع بترحيل نفس المضيف actions عبر طلبات `agentNative.mcpHost.*` postMessage. حافظ على شكل النتيجة متطابقًا لكلا المسارين: قم بإرجاع `link` مركّز ومحتوى منظم موجز.
+
+لا تقم بتعيين `_meta.ui.domain` القياسي لتطبيق URL. تتعامل تطبيقات MCP مع هذا الحقل باعتباره خاصًا بالمضيف: يتحقق Claude من صحة نطاقات وضع الحماية بنمط `{hash}.claudemcpcontent.com`، بينما يستخدم ChatGPT بيانات تعريف `openai/widgetDomain` الخاصة به. احذف `ui.domain` إلا إذا كنت تقوم عمدًا بإصدار قيمة خاصة بالمضيف؛ سيختار المضيف أصل وضع الحماية الافتراضي.
+
+تحتفظ صفحات الامتدادات بوضع الحماية الخاص بها في تضمينات الدردشة MCP دون التنقل في إطار iframe للمسار الثاني. يؤدي الاستخدام العادي للتطبيق إلى عرض `/_agent-native/extensions/:id/render` كإطار iframe فرعي في وضع الحماية. في وضع جسر الدردشة MCP، يعرض إطار العمل نفس مستند الامتداد مثل وضع الحماية `srcDoc` داخل مسار iframe، مع تجنب فشل المضيف `frame-ancestors` / `X-Frame-Options` مع الحفاظ على `sandbox="allow-scripts allow-forms"`.
+
+تمتلك قذيفة المورد حجم المضيف الخارجي. يتم تعيين `embedApp({ height })` افتراضيًا على `560px`، ويربط الصدفة بـ `320-900px`، ويحتفظ بـ `44px` لشريط الأدوات الصغير، وبالتالي فإن منفذ عرض المسار هو `height - 44px`. احتفظ بمسارات التطبيق المضمنة قابلة للتمرير داخليًا واسمح للمشغل بالإبلاغ عن الارتفاع الجوهري المحدد بدلاً من ارتفاع المستند بالكامل؛ وإلا فإن تغيير الحجم التلقائي للمضيف يمكن أن يحول صفحة التطبيق العادية إلى قطعة أثرية طويلة جدًا للدردشة. يؤثر الغلاف المتغير فقط على موارد تطبيق MCP الجديدة واستدعاءات الأدوات الجديدة. يمكن أن تحتفظ إطارات المحادثة ChatGPT/Claude القديمة بسلوك المورد السابق، لذا تحقق من الحجم باستخدام عرض مضمن جديد قبل الحكم على الإصلاح.
+
+### أوضاع التضمين {#embed-modes}
+
+يستخدم Claude مسار زرع الإطار الفردي بشكل افتراضي. يمكنك أيضًا فرضه على المضيفين الآخرين باستخدام `embedMode: "transplant"` أو `frame: "transplant"` عند تصحيح سلوك تحميل الوحدة النمطية للمضيف. يمكنك فرض إطار iframe التشخيصي المتداخل باستخدام `embedMode: "iframe"` أو `renderMode: "iframe"` أو `nested: true` أو `frame: "iframe"`. إذا تم حظر إطار iframe، فإن `embedApp()` يستبدله بخيار احتياطي للتطبيق المفتوح: يمكن للمستخدم إعادة المحاولة مضمنًا، أو فتح جلسة تضمين حديثة من خلال المضيف، أو استخدام المسار المرئي URL. اجعل هدف الإجراء `link` مفيدًا في حد ذاته لأنه لا يزال بمثابة فتحة الهروب العالمية.
+
+عند اختبار Claude من خلال ngrok، استخدم إصدار الإنتاج (`npx @agent-native/core@latest build` ثم `npx @agent-native/core@latest start`) أو معاينة/إنتاج منشور URL. يعمل مسار الزرع أحادي الإطار Claude مع قطع أصول الإنتاج؛ يمكن حماية وحدات تطوير Vite الخام مثل `/app/root.tsx` من خلال مصادقة التطبيق وفشل عمليات الاستيراد الديناميكية من أصل مورد Claude.
+
+## الجسر المضيف API {#host-bridge}
+
+الجسر المضيف صغير عن عمد:
+
+| الوضع                 | نوع الرسالة                           | استخدمه من أجل                                 |
+| --------------------- | ------------------------------------- | ---------------------------------------------- |
+| مسار المضيف المباشر   | `ui/update-model-context`             | السياق المخفي للنموذج المضيف                   |
+| مسار المضيف المباشر   | `ui/message`                          | انشر تحول مستخدم مرئي إلى المضيف               |
+| مسار المضيف المباشر   | `ui/open-link`                        | افتح تطبيقًا خارجيًا أو URL عبر المضيف         |
+| مسار المضيف المباشر   | `ui/request-display-mode`             | اطلب `inline` أو `fullscreen` أو `pip`         |
+| زرع Claude            | `ui/*`                                | نفس الجسر المضيف المباشر بعد الترطيب           |
+| مسار ChatGPT / iframe | `agentNative.mcpHostContext`          | الموضوع، اللغة، النظام الأساسي المضيف، الأبعاد |
+| مسار ChatGPT / iframe | `agentNative.embeddedAppReady`        | تأكد من تحميل مسار iframe                      |
+| مسار ChatGPT / iframe | `agentNative.mcpHost.*` / `.response` | ترحيل المجمع لطلبات المضيف                     |
+
+يمكن للمسارات المضمنة استخدام `updateMcpAppModelContext()` و`openMcpAppHostLink()` و`requestMcpAppDisplayMode()` و`getMcpAppHostContext()` و`useMcpAppHostContext()` من `@agent-native/core/client`. يستخدم `sendToAgentChat()` نفس المسار من عمليات تضمين التطبيق الكامل للمطالبات المقدمة تلقائيًا.
+
+وضع العرض هو أفضل جهد. يُبلغ `McpAppRenderer` داخل التطبيق حاليًا عن سياق مضيف ويب مضمن ووضع عرض مضمن فقط؛ قد تستجيب المضيفات الخارجية لطلبات العرض الأكبر حجمًا، أو تتجاهلها، أو ترد بخطأ في الوضع غير المدعوم. اجعل المسار المضمن قابلاً للاستخدام دائمًا.
+
+## دعم العملاء والتخزين المؤقت {#client-support}
+
+تتضمن قائمة عملاء MCP Apps الرسمية الحالية Claude وClaude Desktop وVS Code GitHub Copilot وGoose وPostman وMCPJam وChatGPT وCursor؛ لا يزال دعم المضيف يختلف حسب الخطة وقناة الإصدار وإصدار العميل، لذا تحقق من [MCP extension support matrix](https://modelcontextprotocol.io/extensions/client-matrix). تتوفر تطبيقات ChatGPT المخصصة MCP من خلال وضع المطور لمساحات عمل Business وEnterprise/Edu على الويب ChatGPT؛ راجع ملاحظات OpenAI على [developer mode and MCP apps](https://help.openai.com/en/articles/12584461-developer-mode-and-full-mcp-apps-in-chatgpt-beta).
+
+لا يزال Claude Code وCodex وعملاء CLI/محرر التعليمات البرمجية الآخرين يتلقون نفس الموارد وبيانات التعريف عندما يدعمون تطبيقات MCP، ولكن يتم معاملتهم كمضيفين للارتباط الخارجي إلا إذا قمت بالتحقق من عرض iframe المضمن في هذا السطح المحدد. يظل الرابط العميق هو الحل الاحتياطي الموثوق به عندما يختار المضيف عدم عرض إطار iframe. من الناحية العملية، يجب تأليف كل تطبيق أصلي للوكيل باستخدام كليهما: تطبيقات MCP للمراجعة/التحرير المضمن في الأجهزة المضيفة القادرة، و`link` للعودة الشاملة إلى التطبيق الكامل.
+
+يمكن لـ Claude وChatGPT تخزين البيانات التعريفية للأداة والموارد لموصل مخصص موجود. بعد تغيير البيانات التعريفية لتطبيق MCP، تحقق من خلال استدعاء أداة جديدة؛ إذا كان المضيف لا يزال يستخدم الواصف القديم، فأعد توصيل موصل Claude أو أعد فحص/مراجعة موصل ChatGPT حتى يتم تحديث الكتالوج. إذا سجل Claude تحذيرًا بشأن `_meta.ui.csp` أو `_meta.ui.permissions` الموجود في واصف الأداة بعد النشر، فإن هذا الموصل يستخدم بيانات تعريف قديمة: احذف/أعد توصيل موصل Claude وابدأ محادثة جديدة.
+
+## الاختبار {#testing}
+
+اختبر تطبيقات MCP باستخدام التركيبات خفيفة الوزن حول `embedApp()` و`McpAppRenderer`؛ فهي تغطي CSP وسياق المضيف وتشغيل التطبيق وسلوك الرسائل الجسرية دون الحاجة إلى مضيف خارجي حقيقي. عند التحقق من صحة الويب ChatGPT أو Claude، قم بتشغيل استدعاء أداة جديد بعد تغيير الصدفة وقياس إطار iframe المرئي. قد تستمر الإطارات التي تم عرضها مسبقًا في نفس المحادثة في إظهار الارتفاع المخزن مؤقتًا أو سلوك التشغيل.
+
+## ذات صلة {#related}
+
+- [External Agents](/docs/external-agents) — توصيل Claude وChatGPT وCodex وCursor بالتطبيقات المستضافة؛ مصفوفة توافق التطبيقات MCP؛ طبقات الكتالوج؛ روابط عميقة.
+- [MCP Protocol](/docs/mcp-protocol) — خادم MCP المثبت تلقائيًا والمصادقة والأدوات و`ask-agent`.
+- [Actions](/docs/actions) — `defineAction`، منشئ `link`، `publicAgent`.
+
+```
+
+```