Skip to content

BuilderIO/agent-native / packages/core/docs

agent-native-docs

Unverified

How to look up version-matched Agent-Native framework docs and source in node_modules. Use before coding against @agent-native/core APIs or advanced features.

FileKindSize
AGENTS.mdmarkdown6.0 KB
SKILL.mdskill md2.2 KB
content/a2a-protocol.mdxmarkdown37.6 KB
content/actions-access-control.mdxmarkdown28.9 KB
content/actions-advanced.mdxmarkdown13.1 KB
content/actions-agent-tools.mdxmarkdown5.6 KB
content/actions-defining.mdxmarkdown31.2 KB
content/actions-other-surfaces.mdxmarkdown10.3 KB
content/actions-overview.mdxmarkdown8.3 KB
content/actions-run-context.mdxmarkdown9.1 KB
content/add-ui-to-your-agent.mdxmarkdown5.0 KB
content/administered-deployments.mdxmarkdown7.7 KB
content/agent-mentions.mdxmarkdown10.2 KB
content/agent-native-config.mdxmarkdown34.9 KB
content/agent-native-toolkit.mdxmarkdown17.3 KB
content/agent-resources.mdxmarkdown27.0 KB
content/agent-surfaces.mdxmarkdown33.8 KB
content/agent-teams.mdxmarkdown13.4 KB
content/agent-web-surfaces.mdxmarkdown10.7 KB
content/agentkit.mdxmarkdown14.0 KB
content/audit-log.mdxmarkdown14.3 KB
content/authentication.mdxmarkdown30.7 KB
content/automation-connectors.mdxmarkdown7.8 KB
content/automations.mdxmarkdown26.7 KB
content/aws-amplify.mdxmarkdown10.7 KB
content/aws-lambda.mdxmarkdown13.9 KB
content/aws-rds.mdxmarkdown1.7 KB
content/azure-postgresql.mdxmarkdown1.8 KB
content/azure-static-web-apps.mdxmarkdown9.1 KB
content/blueprint-installer.mdxmarkdown6.3 KB
content/cli-adapters.mdxmarkdown5.7 KB
content/client-advanced.mdxmarkdown13.1 KB
content/client-agent-chat.mdxmarkdown17.7 KB
content/client-data.mdxmarkdown19.3 KB
content/client-entry-points.mdxmarkdown1.2 KB
content/client-overview.mdxmarkdown10.6 KB
content/client-routing.mdxmarkdown5.7 KB
content/client-sync-internals.mdxmarkdown5.2 KB
content/cloneable-saas.mdxmarkdown16.6 KB
content/cloud-sql.mdxmarkdown2.3 KB
content/cloudflare.mdxmarkdown8.3 KB
content/code-agents-ui.mdxmarkdown26.6 KB
content/components.mdxmarkdown42.9 KB
content/context-awareness.mdxmarkdown24.9 KB
content/create-with-an-agent.mdxmarkdown8.8 KB
content/creating-templates.mdxmarkdown21.6 KB
content/cross-app-connect-design.mdxmarkdown8.4 KB
content/cross-app-sso.mdxmarkdown8.7 KB
content/custom-design-system.mdxmarkdown17.3 KB
content/data-programs.mdxmarkdown25.0 KB
content/decisions.mdxmarkdown7.9 KB
content/deno-deploy.mdxmarkdown7.2 KB
content/deploy-an-app.mdxmarkdown5.0 KB
content/deployment-environment-variables.mdxmarkdown16.3 KB
content/deployment.mdxmarkdown11.3 KB
content/dispatch.mdxmarkdown18.6 KB
content/docker.mdxmarkdown8.1 KB
content/docs-components.mdxmarkdown28.9 KB
content/doctor.mdxmarkdown21.3 KB
content/drafts/clips-experimental-features.mdmarkdown5.4 KB
content/drop-in-agent.mdxmarkdown16.0 KB
content/durable-background-runs.mdxmarkdown13.8 KB
content/durable-resume.mdxmarkdown10.0 KB
content/embedding-sdk.mdxmarkdown31.3 KB
content/environment-variables.mdxmarkdown29.9 KB
content/evals.mdxmarkdown12.4 KB
content/extensions.mdxmarkdown34.8 KB
content/external-agents-catalog.mdxmarkdown40.5 KB
content/external-agents.mdxmarkdown29.3 KB
content/file-uploads.mdxmarkdown10.7 KB
content/generative-ui.mdxmarkdown10.8 KB
content/getting-started-actions.mdxmarkdown2.7 KB
content/getting-started-pages.mdxmarkdown2.6 KB
content/getting-started.mdxmarkdown7.2 KB
content/harness-agents.mdxmarkdown16.9 KB
content/http-api.mdxmarkdown20.9 KB
content/integrations.mdxmarkdown33.8 KB
content/internationalization.mdxmarkdown6.2 KB
content/key-concepts.mdxmarkdown30.6 KB
content/koyeb.mdxmarkdown7.3 KB
content/locales/ar-SA/a2a-protocol.mdxmarkdown48.5 KB
content/locales/ar-SA/actions-access-control.mdxmarkdown40.8 KB
content/locales/ar-SA/actions-advanced.mdxmarkdown16.3 KB
content/locales/ar-SA/actions-agent-tools.mdxmarkdown8.1 KB
content/locales/ar-SA/actions-defining.mdxmarkdown42.2 KB
content/locales/ar-SA/actions-other-surfaces.mdxmarkdown14.5 KB
content/locales/ar-SA/actions-overview.mdxmarkdown11.3 KB
content/locales/ar-SA/actions-run-context.mdxmarkdown11.1 KB
content/locales/ar-SA/add-ui-to-your-agent.mdxmarkdown3.7 KB
content/locales/ar-SA/administered-deployments.mdxmarkdown6.4 KB
content/locales/ar-SA/agent-mentions.mdxmarkdown11.8 KB
content/locales/ar-SA/agent-native-toolkit.mdxmarkdown17.3 KB
content/locales/ar-SA/agent-resources.mdxmarkdown36.8 KB
content/locales/ar-SA/agent-surfaces.mdxmarkdown48.4 KB
content/locales/ar-SA/agent-teams.mdxmarkdown18.5 KB
content/locales/ar-SA/agent-web-surfaces.mdxmarkdown14.3 KB
content/locales/ar-SA/audit-log.mdxmarkdown15.9 KB
content/locales/ar-SA/authentication.mdxmarkdown39.8 KB
content/locales/ar-SA/automations.mdxmarkdown31.3 KB
content/locales/ar-SA/aws-amplify.mdxmarkdown14.9 KB
content/locales/ar-SA/aws-lambda.mdxmarkdown18.9 KB
content/locales/ar-SA/aws-rds.mdxmarkdown319 B
content/locales/ar-SA/azure-postgresql.mdxmarkdown344 B
content/locales/ar-SA/azure-static-web-apps.mdxmarkdown12.4 KB
content/locales/ar-SA/blueprint-installer.mdxmarkdown8.4 KB
content/locales/ar-SA/cli-adapters.mdxmarkdown6.7 KB
content/locales/ar-SA/client-advanced.mdxmarkdown17.8 KB
content/locales/ar-SA/client-agent-chat.mdxmarkdown23.0 KB
content/locales/ar-SA/client-data.mdxmarkdown23.8 KB
content/locales/ar-SA/client-entry-points.mdxmarkdown1.6 KB
content/locales/ar-SA/client-overview.mdxmarkdown13.9 KB
content/locales/ar-SA/client-routing.mdxmarkdown7.2 KB
content/locales/ar-SA/client-sync-internals.mdxmarkdown7.3 KB
content/locales/ar-SA/cloneable-saas.mdxmarkdown23.2 KB
content/locales/ar-SA/cloud-sql.mdxmarkdown317 B
content/locales/ar-SA/cloudflare.mdxmarkdown11.9 KB
content/locales/ar-SA/code-agents-ui.mdxmarkdown34.2 KB
content/locales/ar-SA/components.mdxmarkdown51.5 KB
content/locales/ar-SA/context-awareness.mdxmarkdown33.1 KB
content/locales/ar-SA/create-with-an-agent.mdxmarkdown12.2 KB
content/locales/ar-SA/creating-templates.mdxmarkdown26.8 KB
content/locales/ar-SA/cross-app-connect-design.mdxmarkdown1.5 KB
content/locales/ar-SA/cross-app-sso.mdxmarkdown9.7 KB
content/locales/ar-SA/custom-design-system.mdxmarkdown21.6 KB
content/locales/ar-SA/data-programs.mdxmarkdown33.3 KB
content/locales/ar-SA/decisions.mdxmarkdown9.1 KB
content/locales/ar-SA/deno-deploy.mdxmarkdown10.1 KB
content/locales/ar-SA/deploy-an-app.mdxmarkdown7.1 KB
content/locales/ar-SA/deployment-environment-variables.mdxmarkdown21.3 KB
content/locales/ar-SA/deployment.mdxmarkdown13.9 KB
content/locales/ar-SA/dispatch.mdxmarkdown27.3 KB
content/locales/ar-SA/docker.mdxmarkdown11.3 KB
content/locales/ar-SA/doctor.mdxmarkdown3.4 KB
content/locales/ar-SA/drop-in-agent.mdxmarkdown20.8 KB
content/locales/ar-SA/durable-resume.mdxmarkdown15.4 KB
content/locales/ar-SA/embedding-sdk.mdxmarkdown41.3 KB
content/locales/ar-SA/evals.mdxmarkdown13.3 KB
content/locales/ar-SA/extensions.mdxmarkdown34.0 KB
content/locales/ar-SA/external-agents.mdxmarkdown89.3 KB
content/locales/ar-SA/file-uploads.mdxmarkdown13.4 KB
content/locales/ar-SA/getting-started-actions.mdxmarkdown3.2 KB
content/locales/ar-SA/getting-started-pages.mdxmarkdown3.2 KB
content/locales/ar-SA/getting-started.mdxmarkdown9.7 KB
content/locales/ar-SA/harness-agents.mdxmarkdown22.3 KB
content/locales/ar-SA/internationalization.mdxmarkdown8.2 KB
content/locales/ar-SA/key-concepts.mdxmarkdown42.0 KB
content/locales/ar-SA/koyeb.mdxmarkdown10.2 KB
content/locales/ar-SA/mcp-apps.mdxmarkdown33.7 KB
content/locales/ar-SA/mcp-clients.mdxmarkdown35.0 KB
content/locales/ar-SA/mcp-protocol.mdxmarkdown27.6 KB
content/locales/ar-SA/messaging.mdxmarkdown59.2 KB
content/locales/ar-SA/multi-app-workspace.mdxmarkdown36.2 KB
content/locales/ar-SA/multi-tenancy.mdxmarkdown7.5 KB
content/locales/ar-SA/native-chat-ui.mdxmarkdown21.3 KB
content/locales/ar-SA/neon.mdxmarkdown244 B
content/locales/ar-SA/netlify.mdxmarkdown15.2 KB
content/locales/ar-SA/node-docker.mdxmarkdown878 B
content/locales/ar-SA/node-js.mdxmarkdown8.4 KB
content/locales/ar-SA/notifications.mdxmarkdown16.2 KB
content/locales/ar-SA/observability.mdxmarkdown45.2 KB
content/locales/ar-SA/observational-memory.mdxmarkdown10.9 KB
content/locales/ar-SA/onboarding.mdxmarkdown16.9 KB
content/locales/ar-SA/organizations-teams-permissions.mdxmarkdown5.9 KB
content/locales/ar-SA/package-lifecycle.mdxmarkdown3.0 KB
content/locales/ar-SA/plan-plugin.mdxmarkdown23.0 KB
content/locales/ar-SA/portal.mdxmarkdown636 B
content/locales/ar-SA/postgres.mdxmarkdown487 B
content/locales/ar-SA/pr-visual-recap.mdxmarkdown53.9 KB
content/locales/ar-SA/privacy-and-data-rights.mdxmarkdown6.2 KB
content/locales/ar-SA/processors.mdxmarkdown8.7 KB
content/locales/ar-SA/progress.mdxmarkdown10.7 KB
content/locales/ar-SA/pure-agent-apps.mdxmarkdown5.0 KB
content/locales/ar-SA/real-time-collaboration.mdxmarkdown55.6 KB
content/locales/ar-SA/recorder.mdxmarkdown16.7 KB
content/locales/ar-SA/recurring-jobs.mdxmarkdown23.8 KB
content/locales/ar-SA/render.mdxmarkdown11.2 KB
content/locales/ar-SA/sandbox-adapters.mdxmarkdown18.0 KB
content/locales/ar-SA/security.mdxmarkdown31.5 KB
content/locales/ar-SA/server-database.mdxmarkdown27.6 KB
content/locales/ar-SA/server-middleware.mdxmarkdown7.9 KB
content/locales/ar-SA/server-overview.mdxmarkdown12.2 KB
content/locales/ar-SA/server-plugins.mdxmarkdown9.1 KB
content/locales/ar-SA/server-routes.mdxmarkdown14.3 KB
content/locales/ar-SA/sharing.mdxmarkdown28.6 KB
content/locales/ar-SA/skills-guide.mdxmarkdown27.0 KB
content/locales/ar-SA/ssr-caching.mdxmarkdown7.4 KB
content/locales/ar-SA/supabase.mdxmarkdown264 B
content/locales/ar-SA/syncing-template-changes.mdxmarkdown11.7 KB
content/locales/ar-SA/telemetry.mdxmarkdown21.9 KB
content/locales/ar-SA/template-analytics.mdxmarkdown26.4 KB
content/locales/ar-SA/template-assets.mdxmarkdown31.9 KB
content/locales/ar-SA/template-brain.mdxmarkdown29.7 KB
content/locales/ar-SA/template-calendar-agent.mdxmarkdown10.2 KB
content/locales/ar-SA/template-calendar-developers.mdxmarkdown33.4 KB
content/locales/ar-SA/template-calendar-features.mdxmarkdown14.4 KB
content/locales/ar-SA/template-calendar-integrations.mdxmarkdown6.2 KB
content/locales/ar-SA/template-calendar.mdxmarkdown4.4 KB
content/locales/ar-SA/template-chat-agent.mdxmarkdown4.7 KB
content/locales/ar-SA/template-chat-developers.mdxmarkdown31.3 KB
content/locales/ar-SA/template-chat-features.mdxmarkdown9.9 KB

content/locales/ar-SA/mcp-apps.mdx

View on GitHub
---
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` باعتباره الإجراء الاحتياطي العالمي للارتباط العميق.

## امتدادات إضافات OpenAI {#openai-plugin-extensions}

تضيف OpenAI Plugin Extensions نقاط تشغيل إلى جانب أدوات MCP التي يستدعيها النموذج. عند تفعيل تطبيقات MCP المضمنة، تعلن أداة `open_app` المشتركة عن نقطة دخول في الشريط الجانبي العام وأخرى في اللوحة الجانبية للمحادثة. يستدعيها ChatGPT باستخدام `{}`، ويفتح Core الصفحة الرئيسية للتطبيق الحالي كتطبيق MCP مضمن. لا تحتاج التطبيقات التي تستخدم خادم MCP المشترك إلى تسجيل فردي. راجع [دليل OpenAI Plugin Extensions](https://developers.openai.com/plugins/build/extensions) و[مواصفة MCP Extensions](https://github.com/openai/mcp-extensions/blob/main/docs/spec.md).

يمكن للأزرار داخل التطبيق المضمن استدعاء `sendToAgentChat(...)` لمتابعة المحادثة. يرسل Core الحالة المحددة عبر `ui/update-model-context` مع `annotations.audience: ["assistant"]`، ثم يرسل المطالبة الظاهرة عبر `ui/message`. تغطي نقاط الدخول المشتركة التشغيل العام وتشغيل المحادثة؛ أما عارضات الملفات وإشارات المُركّب وغيرها من الامتدادات المتخصصة فتحتاج إلى عقود إدخال خاصة بالتطبيق.

في المضيفات الأقدم، لا يمكن لـ Core استخدام البديل النصي إلا إذا لم يتضمن الطلب سياقًا محددًا أو منظمًا وكان كل المحتوى قابلًا للتمثيل كنص، وتضمنت كل قائمة `annotations.audience` للنص المُرسل القيمتين `assistant` و`user`. بخلاف ذلك، أو إذا رفض المضيف تحديث السياق، تُعيد `sendToAgentChat(...)` القيمة `false`.

## التأليف: تطبيقات 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؛ إذا كان الإجراء يحتاج إلى سطح مخصص، فأضف أو أعد استخدام مسار/مكون حقيقي للتطبيق أولاً وقم بتضمين هذا المسار.

<Diagram id="doc-block-1hvnsjj" title={"MCP تضمين التطبيق ذهابًا وإيابًا"} summary={"هدف الارتباط الخاص بالإجراء هو أيضًا هدف التضمين. يقوم المضيفون القادرون بتحميل نفس مسار التطبيق الموقع بشكل مضمّن؛ يعود الجميع إلى الرابط العميق."}>

```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">يتبادل تذكرة SQL لمرة واحدة</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">مسار React حقيقي</span
    ><small class="diagram-muted">short-lived browser session</small>
  </div>
  <div class="diagram-fallback">
    <span class="diagram-pill warn">لا يوجد دعم MCP Apps</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;
}
```

</Diagram>

```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",
    }),
  },
});
```

<AnnotatedCode
  id="doc-block-1k85d0n"
  title={"تكوين موارد mcpApp"}
  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: "التحسين التدريجي",
      note: "يعلن `mcpApp.resource` عن UI مضمن للمضيفين الذين يدعمون ملحق MCP Apps. احتفظ بمنشئ الإجراء `link` أيضًا - CLI - فقط والمضيفون الأقدم يتجاهلون البيانات التعريفية UI وما زالوا بحاجة إلى الرابط العميق.",
    },
    {
      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: "تسمية احتياطية عالمية",
      note: '`openLabel` هو النص المرئي `"Open in … →"` المستخدم كمسار خروج للرابط العميق عندما لا يعرض المضيف 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 نفسه عندما يتمكن المضيف من ترطيب المسار مباشرة.

<Diagram id="doc-block-1cj04tu" title={"مساران للجسر المضيف، وطريق واحد موقّع"} summary={"يقوم كلود بزرع المسار المائي ويستخدم ui/_bridge المباشر؛ يحصل ChatGPT على إطار iframe يتم التحكم فيه عبر window.openai ويقوم بترحيل إجراءات المضيف عبر postMessage. كلاهما يشيران إلى نفس مسار التطبيق الموقع."}>

```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"
        >يروي HTML التطبيق الموقع داخل iframe في Claude، ثم جسر مضيف `ui/_`
        مباشر</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"
      >مسار عادي + مكونات React</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;
}
```

</Diagram>

يستخدم الويب 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 القديمة بسلوك المورد السابق، لذا تحقق من الحجم باستخدام عرض مضمن جديد قبل الحكم على الإصلاح. عندما يمتلك المضيف الإطار (لوحة جانبية، أو عرض ملء الشاشة أو صورة داخل صورة، أو `containerDimensions.height`)، تملأ الصدفة الإطار بالكامل بدلاً من ذلك وتتوقف عن الإبلاغ عن ارتفاع جوهري. عنصر الدليل (تطبيقات إضافات ChatGPT وCodex) هو محرر يعيش داخل لوحة المضيف، لذلك يملأ الإطار دائمًا. وعندما يحدد المضيف حجم اللوحة اعتمادًا على الارتفاع الذي يبلغ عنه العنصر فقط (اللوحات الجانبية في Codex وChatGPT تعرض تلميحًا صغيرًا `containerDimensions.maxHeight` وليس ارتفاعًا)، يبلغ الغلاف عن ارتفاع شاشة العارض بدلًا من ارتفاع محتوى التطبيق.

### أوضاع التضمين {#embed-modes}

يستخدم Claude مسار زرع الإطار الفردي بشكل افتراضي. يمكنك أيضًا فرضه على المضيفين الآخرين باستخدام `embedMode: "transplant"` أو `frame: "transplant"` عند تصحيح سلوك تحميل الوحدة النمطية للمضيف. يمكنك فرض إطار iframe التشخيصي المتداخل باستخدام `embedMode: "iframe"` أو `renderMode: "iframe"` أو `nested: true` أو `frame: "iframe"`. إذا تم حظر إطار iframe، فإن `embedApp()` يستبدله بخيار احتياطي للتطبيق المفتوح: يمكن للمستخدم إعادة المحاولة مضمنًا، أو فتح جلسة تضمين حديثة من خلال المضيف، أو استخدام المسار المرئي URL. اجعل هدف الإجراء `link` مفيدًا في حد ذاته لأنه لا يزال بمثابة فتحة الهروب العالمية.

عند اختبار Claude من خلال ngrok، استخدم إصدار الإنتاج (`pnpm 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 على الويب وسطح المكتب والهاتف، بالإضافة إلى علامة تبويب [Code](https://github.com/anthropics/claude-code/issues/103809) في Claude Desktop؛ ChatGPT; VS Code GitHub Copilot (1.109+); Microsoft 365 Copilot; Cursor (2.6+); Goose; Postman; MCPJam; Codex Desktop (26.616+); T3 Code (Codex). يختلف الدعم حسب الخطة وقناة الإصدار وإصدار العميل؛ راجع [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 وCowork وCode على claude.ai وفي Codex CLI. [لا يعلن Cowork عن دعم MCP Apps حتى الآن، وقد يؤدي استخدامه على الموصل نفسه إلى اختفاء التطبيقات المضمنة في Chat حتى تعيد توصيل الموصل.](https://github.com/anthropics/claude-code/issues/103924) يظل الرابط العميق هو الحل الاحتياطي الموثوق به عندما يختار المضيف عدم عرض إطار iframe. من الناحية العملية، يجب تأليف كل تطبيق أصلي للوكيل باستخدام كليهما: تطبيقات MCP للمراجعة/التحرير المضمن في الأجهزة المضيفة القادرة، و`link` للعودة الشاملة إلى التطبيق الكامل.

يمكن لـ Claude وChatGPT تخزين البيانات التعريفية للأداة والموارد لموصل مخصص موجود. بعد تغيير البيانات التعريفية لتطبيق MCP، تحقق من خلال استدعاء أداة جديدة؛ إذا كان المضيف لا يزال يستخدم الواصف القديم، فأعد توصيل موصل Claude أو أعد فحص/مراجعة موصل ChatGPT حتى يتم تحديث الكتالوج. إذا سجل Claude تحذيرًا بشأن `_meta.ui.csp` أو `_meta.ui.permissions` الموجود في واصف الأداة بعد النشر، فإن هذا الموصل يستخدم بيانات تعريف قديمة: احذف/أعد توصيل موصل Claude وابدأ محادثة جديدة.

## من يحصل على البطاقات {#who-gets-cards}

لا يحصل تطبيق الدردشة المتصل على بطاقات MCP App (بيانات الأداة الوصفية `_meta.ui` وموارد `ui://` الخاصة بها) إلا عندما يكون الشخص الذي سجّل التطبيق دخوله باسمه قد شغّل مختبر **بطاقات التطبيق في تطبيقات الدردشة** من الإعدادات → المختبرات. يكون المختبر متوقفًا افتراضيًا، ولا ينطبق اختيار كل شخص إلا على اتصالاته الخاصة. بعد تغييره، أعد ربط التطبيق في تطبيق الدردشة حتى يعيد تحميل قائمة الأدوات. عندما يكون المختبر متوقفًا، تُرجع الأدوات نتائج عادية مع روابط `link` العميقة. تحصل الاتصالات التي لم تسجّل الدخول باسم شخص على نتائج عادية أيضًا: رمز `ACCESS_TOKEN` مشترك من دون `AGENT_NATIVE_OWNER_EMAIL`، أو كيان خدمة، أو خادم stdio مستقل.

يحصل كتالوج دليل تطبيقات ChatGPT (`/mcp/directory`) وعملاء Agent-Native الأصليون الذين يرسلون الترويسة `x-agent-native-mcp-inline-apps` على البطاقات سواء كان المختبر مشغّلًا أم لا. لم تعد متغيرات البيئة `AGENT_NATIVE_MCP_APPS_INLINE` و`AGENT_NATIVE_MCP_APPS_INLINE_ALLOW_EMAILS` تُقرأ؛ وإذا عُيّن أي منهما، يسجّل الخادم تحذيرًا واحدًا.

## الاختبار {#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-overview) — `defineAction`، منشئ `link`، `publicAgent`.

```

```
rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).Stars: 198kUpdated Claude CodeCodexUnverifiedInstall
doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.Stars: 198kUpdated Claude CodeCodexVerifiedInstall