@agent-native/core 0.98.17 → 0.99.1

package/docs/content/locales/ar-SA/authentication.mdx

@@ -219,7 +219,7 @@ ACCESS_TOKENS=token1,token2,token3
 يمكن أن تعمل نقطة نهاية MCP لكل تطبيق كمورد MCP قياسي محمي. يمكن تكوين العملاء القادرين على OAuth باستخدام MCP URL البعيد فقط:
 
 ```text
-https://mail.agent-native.com/_agent-native/mcp
+https://mail.agent-native.com/mcp
 ```
 
 تقوم طلبات MCP غير المصادق عليها بإرجاع تحدي `WWW-Authenticate` الذي يشير إلى `/.well-known/oauth-protected-resource`. يكتشف العميل بعد ذلك بيانات تعريف OAuth الخاصة بالتطبيق، ويسجل عميلًا عامًا ديناميكيًا، ويفتح صفحة ترخيص التطبيق، ويتبادل رمز التفويض مع PKCE للوصول إلى الرموز المميزة وتحديثها.

package/docs/content/locales/ar-SA/dispatch.mdx

@@ -113,16 +113,16 @@ Dispatch هو التطبيق المركزي الذي يقع أمام كل تطب
 
 ### بوابة MCP الموحدة
 
-يمكن أن يكون Dispatch هو موصل MCP الفردي للوكلاء الخارجيين: قم بإضافة `https://dispatch.agent-native.com/_agent-native/mcp` مرة واحدة في Claude أو ChatGPT أو Codex أو Cursor، وسيصل تخويل واحد إلى كل تطبيق مساحة عمل ممنوح بدلاً من موصل واحد لكل تطبيق. راجع [External Agents](/docs/external-agents) للاطلاع على تدفق الاتصال الكامل ومنح التطبيقات وOAuth ومعاينات تطبيقات MCP المضمنة.
+يمكن أن يكون Dispatch هو موصل MCP الفردي للوكلاء الخارجيين: قم بإضافة `https://dispatch.agent-native.com/mcp` مرة واحدة في Claude أو ChatGPT أو Codex أو Cursor، وسيصل تخويل واحد إلى كل تطبيق مساحة عمل ممنوح بدلاً من موصل واحد لكل تطبيق. راجع [External Agents](/docs/external-agents) للاطلاع على تدفق الاتصال الكامل ومنح التطبيقات وOAuth ومعاينات تطبيقات MCP المضمنة.
 
-<Endpoint id="doc-block-11r2r6y" method="POST" path="/_agent-native/mcp" summary={"نقطة نهاية البوابة الموحدة MCP"} auth="Standard remote MCP OAuth, handled by the framework. The granted-app set scopes which workspace apps the connector can reach." responses={[
+<Endpoint id="doc-block-11r2r6y" method="POST" path="/mcp" summary={"نقطة نهاية البوابة الموحدة MCP"} auth="Standard remote MCP OAuth, handled by the framework. The granted-app set scopes which workspace apps the connector can reach." responses={[
   {
     "status": "200",
     "description": "MCP JSON-RPC response — tools, resources, and MCP App UI resources aggregated across granted workspace apps."
   }
 ]}>
 
-The single MCP connector URL external agents add (e.g. `https://dispatch.agent-native.com/_agent-native/mcp`). One authorization here reaches every **granted** workspace app instead of wiring one connector per app. App grants, OAuth, and inline MCP App previews are covered in [External Agents](/docs/external-agents).
+The single MCP connector URL external agents add (e.g. `https://dispatch.agent-native.com/mcp`). One authorization here reaches every **granted** workspace app instead of wiring one connector per app. App grants, OAuth, and inline MCP App previews are covered in [External Agents](/docs/external-agents).
 
 </Endpoint>
 

package/docs/content/locales/ar-SA/external-agents.mdx

@@ -98,7 +98,7 @@ search: "Claude ChatGPT Claude الكود Codex المؤشر Claude Cowork MCP
 للعمل في مساحة العمل أو عبر التطبيقات، استخدم Dispatch:
 
 ```text
-https://dispatch.agent-native.com/_agent-native/mcp
+https://dispatch.agent-native.com/mcp
 ```
 
 Dispatch هو البوابة الوحيدة للبريد والتقويم والتحليلات والعقل و
@@ -109,12 +109,12 @@ Dispatch هو البوابة الوحيدة للبريد والتقويم وال
 بالنسبة إلى تطبيق واحد معزول عمدًا، استخدم هذا التطبيق مباشرةً:
 
 ```text
-https://mail.agent-native.com/_agent-native/mcp
-https://<your-app>.agent-native.com/_agent-native/mcp
+https://mail.agent-native.com/mcp
+https://<your-app>.agent-native.com/mcp
 ```
 
 يحتوي كل تطبيق مستضاف أيضًا على صفحة مساعدة على
-`https://&lt;app&gt;/_agent-native/mcp/connect` مع URL القابل للنسخ و
+`https://&lt;app&gt;/mcp/connect` مع URL القابل للنسخ و
 علامات التبويب الخاصة بالمضيف لـ Claude، وChatGPT، والمؤشر، وClaude Code، وCodex، وغيرها.
 
 ### Claude وChatGPT OAuth {#oauth}
@@ -237,7 +237,7 @@ npx @agent-native/core@latest connect https://mail.agent-native.com
 npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex
 ```
 
-يبحث `reconnect` عن أي إدخال تكوين MCP ينتهي URL بـ `/_agent-native/mcp` للمضيف المحدد والعميل المحدد (المطابقة بواسطة URL بغض النظر عن اسم الموصل)، ثم يقوم بتحديث مادة المصادقة أو استبدالها دون لمس skills المثبت أو إعادة تشغيل تدفق التثبيت الكامل. تمرير التطبيق الأساسي URL (على سبيل المثال، `https://plan.agent-native.com`) - يتم استنتاج لاحقة `/_agent-native/mcp`. يتم تحميل المصادقة والأداة لكل عميل، لذا قم بإعادة تشغيل/إعادة تحميل هذا العميل بعد ذلك؛ يحتاج Codex إلى جلسة جديدة قبل ظهور الأدوات المحملة حديثًا.
+يبحث `reconnect` عن أي إدخال تكوين MCP ينتهي URL بـ `/mcp` للمضيف المحدد والعميل المحدد (المطابقة بواسطة URL بغض النظر عن اسم الموصل)، ثم يقوم بتحديث مادة المصادقة أو استبدالها دون لمس skills المثبت أو إعادة تشغيل تدفق التثبيت الكامل. تمرير التطبيق الأساسي URL (على سبيل المثال، `https://plan.agent-native.com`) - يتم استنتاج لاحقة `/mcp`. يتم تحميل المصادقة والأداة لكل عميل، لذا قم بإعادة تشغيل/إعادة تحميل هذا العميل بعد ذلك؛ يحتاج Codex إلى جلسة جديدة قبل ظهور الأدوات المحملة حديثًا.
 
 في Claude Code، مسار UI المكافئ هو: تشغيل `/mcp` واختيار **مصادقة** (أو **إعادة الاتصال**) للموصل ذي الصلة.
 
@@ -245,7 +245,7 @@ npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --clien
 
 ### ربط الصفحة الاحتياطية {#connect-page-fallback}
 
-بالنسبة لعملاء MCP الذين لا يمكنهم إضافة OAuth URL عن بعد مباشرةً، افتح التطبيق في متصفحك واستخدم تكلفة **الاتصال** (المقدمة في `https://&lt;app&gt;/_agent-native/mcp/connect`). أثناء تسجيل الدخول، انقر فوق **الاتصال / التفويض**. تمنحك الصفحة إما رابطًا عميقًا بنقرة واحدة يقوم بتكوين الوكيل المكتشف، أو كتلة `.mcp.json` جاهزة للصقه:
+بالنسبة لعملاء MCP الذين لا يمكنهم إضافة OAuth URL عن بعد مباشرةً، افتح التطبيق في متصفحك واستخدم تكلفة **الاتصال** (المقدمة في `https://&lt;app&gt;/mcp/connect`). أثناء تسجيل الدخول، انقر فوق **الاتصال / التفويض**. تمنحك الصفحة إما رابطًا عميقًا بنقرة واحدة يقوم بتكوين الوكيل المكتشف، أو كتلة `.mcp.json` جاهزة للصقه:
 
 ```jsonc
 // .mcp.json
@@ -253,7 +253,7 @@ npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --clien
   "mcpServers": {
     "mail": {
       "type": "http",
-      "url": "https://mail.agent-native.com/_agent-native/mcp",
+      "url": "https://mail.agent-native.com/mcp",
       "headers": { "Authorization": "Bearer <minted-token>" },
     },
   },
@@ -270,13 +270,13 @@ npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --clien
 
 ```bash
 claude mcp add --transport http agent-native \
-  https://dispatch.agent-native.com/_agent-native/mcp
+  https://dispatch.agent-native.com/mcp
 ```
 
 هذا هو نفس الإدخال URL فقط الذي يكتبه لك `npx @agent-native/core@latest connect https://dispatch.agent-native.com --client claude-code`. ثم قم بتشغيل `/mcp` في رمز Claude واختر **Authenticate**. يكتشف العميل المصادقة من تحدي `401 WWW-Authenticate` الخاص بخادم MCP، ويجلب `/.well-known/oauth-protected-resource` و`/.well-known/oauth-authorization-server`، ويسجل عميل OAuth العام ديناميكيًا، ويفتح صفحة ترخيص التطبيق، ويخزن الرمز المميز الناتج بشكل آمن. تستخدم موصلات وضع المطور ChatGPT نفس الخادم URL:
 
 ```text
-https://dispatch.agent-native.com/_agent-native/mcp
+https://dispatch.agent-native.com/mcp
 ```
 
 تدفق OAuth هو رمز التفويض + PKCE مع تدوير رمز التحديث. رموز الوصول مرتبطة بالجمهور بمورد MCP الدقيق URL وتحمل هوية المستخدم/المؤسسة الموقعة، لذا فإن استدعاءات الأدوات، `resources/read`، وMCP App iframe `tools/call` كلها تعمل من خلال نفس نطاق المستأجر `runWithRequestContext` مثل مسار JWT الحالي المتصل. لا يتلقى إطار iframe رموز OAuth الأولية أبدًا؛ يتوسط المضيف المكالمات من خلال اتصال MCP المصادق عليه.
@@ -500,13 +500,13 @@ Claude Code calls: manage-draft(to: "john@example.com", subject: "Q3 Report", bo
 
 علاوة على أدوات تنفيذ الإجراء، يعرض خادم MCP مجموعة أفعال ثابتة، بحيث يتمتع الوكيل الخارجي بسطح يمكن التنبؤ به دون تخمين أسماء الإجراءات لكل تطبيق:
 
-| الأداة                                             | الآثار الجانبية | المرتجعات                                                                                  |
-| -------------------------------------------------- | --------------- | ------------------------------------------------------------------------------------------ |
-| `list_apps`                                        | لا شيء          | تطبيقات مساحة العمل + URL/حالة التشغيل                                                     |
-| `open_app({ app, view?, path?, params?, embed? })` | لا شيء          | رابط عميق أو مسار من نفس المصدر؛ يعرض `embed: true` التطبيق الكامل مضمنًا حيث يكون مدعومًا |
-| `ask_app({ app, message })`                        | حلقة الوكيل     | توجيه مهمة باللغة الطبيعية إلى الوكيل داخل التطبيق لذلك التطبيق (المفوض إلى `ask-agent`)   |
-| `create_workspace_app({ name, template })`         | السقالات        | تطبيق جديد تم تشغيله عبر مسار مساحة العمل، بالإضافة إلى URL قيد التشغيل + رابط عميق        |
-| `list_templates`                                   | لا شيء          | النماذج المسموح بها فقط                                                                    |
+| الأداة                                             | الآثار الجانبية | المرتجعات                                                                                                                       |
+| -------------------------------------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| `list_apps`                                        | لا شيء          | تطبيقات مساحة العمل + URL/حالة التشغيل                                                                                          |
+| `open_app({ app, view?, path?, params?, embed? })` | لا شيء          | رابط عميق أو مسار من نفس المصدر؛ يعرض `embed: true` التطبيق الكامل مضمنًا حيث يكون مدعومًا                                      |
+| `ask_app({ app, message, async?, maxWaitMs? })`    | حلقة الوكيل     | توجيه مهمة باللغة الطبيعية إلى الوكيل داخل التطبيق لذلك التطبيق؛ تُرجع المهام الطويلة `taskId` دائمًا لاستطلاع `ask_app_status` |
+| `create_workspace_app({ name, template })`         | السقالات        | تطبيق جديد تم تشغيله عبر مسار مساحة العمل، بالإضافة إلى URL قيد التشغيل + رابط عميق                                             |
+| `list_templates`                                   | لا شيء          | النماذج المسموح بها فقط                                                                                                         |
 
 يرفض `create_workspace_app` أي قالب غير مدرج في القائمة المسموح بها - القائمة المسموح بها للقالب العام في `packages/shared-app-config/templates.ts` موثوقة ومحمية بواسطة CI؛ ولا يمكن لعامل خارجي توسيعه. يتجاوز إجراء القالب الذي يحمل نفس الاسم الإجراء المدمج (أسبقية القالب على المركز الأساسي). قم بتعطيل المجموعة بأكملها باستخدام `MCPConfig.builtinCrossAppTools: false`.
 
@@ -514,6 +514,10 @@ Claude Code calls: manage-draft(to: "john@example.com", subject: "Q3 Report", bo
 
 بالنسبة لعمليات التسليم السريعة لـ ChatGPT/Claude، يكون المسار المثالي مباشرًا: اتصل بالإجراء الذي ينشئ القطعة الأثرية أو يفتحها، ثم اسمح لتطبيق MCP بتشغيل المسار. يجب أن يستدعي طلب البريد `manage_draft` ويقدم مسار الإنشاء الحقيقي. يجب أن يستدعي طلب لوحة المعلومات `open_app({ path, embed: true })` أو إجراء لوحة المعلومات باستخدام `mcpApp` ويقدم مسار Analytics الكامل. يجب أن يتبع التقويم والنماذج والمحتوى والشرائح والتصميم والمقاطع نفس النمط مع المسودة/الإنشاء/البحث في actions. يكون `list_apps` مفيدًا عندما يتعين على النموذج الاختيار من بين التطبيقات الممنوحة؛ لا ينبغي أن يكون `resources/list` واسع النطاق، أو اكتشاف الكتالوج الكامل، أو تفويض `ask_app` هو المسار الطبيعي لعملية تسليم UI الواضحة.
 
+### الطلبات الوكيلية طويلة الأمد
+
+لا تشترك مضيفات وبوابات MCP في مهلة زمنية واحدة طويلة لاستدعاء الأداة؛ يفرض بعضها حدًا أقصى مدته خمس دقائق بينما يكون بعضها الآخر قابلاً للتكوين. لا تصمم تكامل الوكيل الخارجي بالاعتماد على استدعاء `tools/call` محظور لمدة عشر دقائق. يقر كل من `ask-agent` و`ask_app` بالعمل المستضاف بسرعة، ثم يُرجعان `taskId` دائمًا عند انتهاء مهلة الانتظار المضمّن. استطلع باستخدام `ask_app_status` مستخدمًا `app` و`taskId` المُرجعين؛ وتتضمن النتيجة `pollAfterMs` كفاصل زمني ملائم للمضيف. يجب إنشاء المهمة قبل أن تنتهي مهلة الاستجابة الأولى، لذا فإن رابط الاستطلاع الذي يُرجع فقط بعد استدعاء طويل ليس عقد استرداد يمكن الاعتماد عليه.
+
 ### جولة لكل تطبيق {#tour}
 
 يقوم كل قالب مدرج في القائمة المسموح بها ينتج موردًا قابلاً للملاحة أو يسرده بشحن أداة إنشاء `link`، وتقوم القوالب ذات الاستيعاب الثقيل بشحن إجراء GET + `publicAgent` حتى يتمكن الوكيل المتصل من سحب الحالة المباشرة:
@@ -677,7 +681,7 @@ npx @agent-native/core@latest mcp install --client claude-code|claude-code-cli|c
 - **العمل المشترك** — نفس شكل الرمز Claude JSON في `~/.cowork/mcp.json`.
 - **codex** — كتلة `[mcp_servers.<name>]` في `~/.codex/config.toml`.
 
-يعمل الإدخال على تشغيل `npx @agent-native/core@latest mcp serve --app <id>`، وهو افتراضيًا ** وكيل stdio رفيع ** إلى `/_agent-native/mcp` للتطبيق المحلي قيد التشغيل - لذا يظل سجل الإجراء المباشر، HMR، والروابط العميقة الصحيحة المصدر الوحيد للحقيقة. قم بتمرير `--standalone` لإنشاء التسجيل قيد التشغيل بدلاً من ذلك. عندما يكتشف `npx @agent-native/core@latest mcp install` أصلًا مستضافًا (مضيف غير محلي `APP_URL` / `BETTER_AUTH_URL` / `AGENT_NATIVE_MCP_URL` في مساحة العمل `.env`)، فإنه يكتب إدخال عميل `http` يشير إلى `<origin>/_agent-native/mcp` باستخدام `Bearer` JWT بدلاً من إدخال stdio.
+يعمل الإدخال على تشغيل `npx @agent-native/core@latest mcp serve --app <id>`، وهو افتراضيًا ** وكيل stdio رفيع ** إلى `/mcp` للتطبيق المحلي قيد التشغيل - لذا يظل سجل الإجراء المباشر، HMR، والروابط العميقة الصحيحة المصدر الوحيد للحقيقة. قم بتمرير `--standalone` لإنشاء التسجيل قيد التشغيل بدلاً من ذلك. عندما يكتشف `npx @agent-native/core@latest mcp install` أصلًا مستضافًا (مضيف غير محلي `APP_URL` / `BETTER_AUTH_URL` / `AGENT_NATIVE_MCP_URL` في مساحة العمل `.env`)، فإنه يكتب إدخال عميل `http` يشير إلى `<origin>/mcp` باستخدام `Bearer` JWT بدلاً من إدخال stdio.
 
 الأوامر الفرعية المصاحبة:
 
@@ -701,7 +705,7 @@ npx @agent-native/core@latest mcp install --client claude-code|claude-code-cli|c
   "mcpServers": {
     "analytics": {
       "type": "http",
-      "url": "https://analytics.agent-native.com/_agent-native/mcp",
+      "url": "https://analytics.agent-native.com/mcp",
       "headers": { "Authorization": "Bearer <ACCESS_TOKEN-or-JWT>" },
     },
   },
@@ -743,7 +747,7 @@ npx @agent-native/core@latest connect prod --apps mail,calendar,analytics --clie
 لا يقوم تدفق `connect` المستضاف الاحتياطي بنسخ السر المشترك للنشر مطلقًا. بدلاً من ذلك:
 
 - تقوم جلسة المتصفح التي تم تسجيل الدخول بإصدار رمز مميز **لكل مستخدم، محدد النطاق، قابل للإلغاء** — `A2A_SECRET` موقع JWT يحمل `sub` + `org_domain` للمتصل و`jti` فريد من نوعه، بحيث تظل كل أداة يتم تشغيلها ضمن نطاق المستأجر عبر `runWithRequestContext`.
-- تقبل نقطة النهاية `/_agent-native/mcp` الحالية هذا الرمز المميز مثل أي حامل آخر (راجع [MCP Protocol](/docs/mcp-protocol)) - لا توجد نقطة نهاية جديدة ولا نقل جديد.
+- تقبل نقطة النهاية `/mcp` الحالية هذا الرمز المميز مثل أي حامل آخر (راجع [MCP Protocol](/docs/mcp-protocol)) - لا توجد نقطة نهاية جديدة ولا نقل جديد.
 - تدرج نفس صفحة الاتصال كل الرموز المميزة التي قمت بسكها وتتيح لك **إلغاء** أيًا منها بواسطة `jti`. تعامل معها مثل رموز الوصول الشخصية: واحدة لكل عميل وكيل، ويتم إبطالها عند إيقاف تشغيل الجهاز.
 - لا يحمل الرابط العميق الذي يعيده الوكيل أي حالة مميزة. يتم دائمًا تحديد نطاق كتابة `navigate` التي تركز على السجل على جلسة **المتصفح**، وليس الرمز المميز للوكيل أبدًا — لذلك يكون الرابط آمنًا للصقه في محطة طرفية أو نص دردشة.
 

package/docs/content/locales/ar-SA/mcp-clients.mdx

@@ -245,6 +245,32 @@ MCP_SERVERS='{"servers":{"zapier":{"type":"http","url":"https://mcp.example.com/
 
 تمنح خوادم MCP (نموذج سياق البروتوكول) وكيلك قدرات جديدة - مثل الاتصال بـ Zapier، أو Cloudflare، أو Composio، أو الأدوات الداخلية لشركتك. بمجرد الاتصال، يمكن للوكيل استخدام هذه الأدوات تمامًا مثل الأدوات المدمجة فيه.
 
+معرّفات الإعدادات المسبقة هي `context7` و`sentry` و`notion` و`semgrep` و`linear`
+و`atlassian` و`supabase` و`neon` و`stripe`.
+
+### Atlassian / Jira
+
+يستخدم إعداد Atlassian المسبق نقطة نهاية OAuth 2.1 الخاصة بـ Atlassian Rovo MCP،
+`https://mcp.atlassian.com/v1/mcp/authv2`، ويوفّر أدوات Jira وConfluence.
+يتطلب إنشاء تذاكر Jira أذونات Atlassian التي تشمل عمليات الكتابة في Jira؛
+ولا يرى المستخدم سوى المشاريع والمحتوى المسموح بهما لحسابه على Atlassian.
+
+يمكن لمسؤولي مؤسسات Atlassian التحكم في السماح لعميل OAuth بالاتصال.
+قبل الاتصال، قد يحتاج المسؤول إلى إضافة أصل HTTPS الفعلي للتطبيق إلى قائمة
+النطاقات الموثوقة ضمن **Atlassian Administration → Rovo →
+Rovo MCP server → Domains**، وتمكين أذونات **Read** و**Write** و**Search**
+المطلوبة ضمن **Permissions**. يجب أن يكون النطاق هو المضيف الذي يعمل عليه
+تطبيق agent-native؛ لا تنسخ `https://builder.io/**` إلى عملية نشر أخرى إلا إذا
+كان ذلك هو أصلها الفعلي. راجع [دليل إعداد Rovo MCP من Atlassian](https://developer.atlassian.com/cloud/rovo-mcp/guides/getting-started/)
+و[عناصر تحكم المسؤول](https://support.atlassian.com/security-and-access-policies/docs/control-atlassian-rovo-mcp-server-settings/).
+
+يوفّر الكتالوج نقطة النهاية وإرشادات الإعداد. يخزّن نموذج الإعدادات العام نقطة
+النهاية والرؤوس المشفّرة الاختيارية؛ ولا يحل محل تدفق موافقة OAuth التفاعلي
+الخاص بـ Atlassian. استخدم عميل MCP أو بيئة تشغيل تدعم OAuth عندما يتطلب
+Atlassian مصادقة OAuth التفاعلية. إذا كان الموفّر أو بيئة التشغيل يدعم رمز
+Bearer ثابتًا، فاتبع مسار إدارة الأسرار المعتمد لديه، ولا تلصق الرموز أبدًا
+في المطالبات أو الإعدادات الملتزم بها.
+
 ### كيفية الاتصال بخادم MCP البعيد
 
 1. **اسم الخادم** — تسمية قصيرة للرجوع إليها (على سبيل المثال، "zapier"، "slack-tools").
@@ -263,7 +289,7 @@ MCP_SERVERS='{"servers":{"zapier":{"type":"http","url":"https://mcp.example.com/
 
 يضيف ويزيل التحميل السريع إلى مدير MCP قيد التشغيل - لا إعادة تشغيل للعملية، ولا إعادة تشغيل للخادم. تظهر أدوات `mcp__<scope>-<name>__*` الجديدة للوكيل في الرسالة التالية ويمكن البحث فيها عبر `tool-search`.
 
-يتم قبول HTTPS URL في كل مكان؛ يُسمح فقط بـ `http://` العادي لـ `localhost` أثناء التطوير. يتم إدخال المصادقة الاختيارية كرمز مميز لحامل يتم إرساله عبر `Authorization: Bearer …` عند كل طلب.
+يتم قبول HTTPS URL في كل مكان؛ يُسمح فقط بـ `http://` العادي لـ `localhost` أثناء التطوير. يتم إدخال المصادقة الاختيارية كرمز مميز لحامل يتم إرساله عبر `Authorization: Bearer …` عند كل طلب. يتطلب الموفّرون الذين يدعمون OAuth فقط، بما في ذلك Atlassian Rovo MCP، تدفق OAuth الخاص بالموفّر بدلاً من رأس ثابت.
 
 تحت الغطاء، تظل هذه الخوادم موجودة في جدول `settings` الخاص بإطار العمل تحت المفتاح `u:<email>:mcp-servers-remote` (شخصي) أو `o:<orgId>:mcp-servers-remote` (فريق) ويتم دمجها مع `mcp.config.json` عند بدء التشغيل.
 
@@ -292,7 +318,9 @@ Dispatch هو المركز التقليدي - فهو ينسق بالفعل عب
   <div class="diagram-panel center" data-rough>
     <span class="diagram-pill accent">Dispatch hub</span
     ><small class="diagram-muted">خوادم MCP على نطاق المؤسسة</small
-    ><small class="diagram-muted"><code>GET /mcp/hub/servers</code></small>
+    ><small class="diagram-muted"
+      ><code>GET /_agent-native/mcp/hub/servers</code></small
+    >
   </div>
   <div class="diagram-col arrows">
     <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
@@ -454,7 +482,7 @@ Reports which configured servers connected, the total live tool count, the merge
 
 لا تؤدي حالات فشل خادم MCP الفردية إلى إزالة الوكيل مطلقًا:
 
-- تم تكوين `command` بشكل خاطئ → تم تخطي الخادم، ويظهر خطأه في `/mcp/status` ضمن `errors.<server-id>`، ويستمر كل خادم آخر في العمل.
+- تم تكوين `command` بشكل خاطئ → تم تخطي الخادم، ويظهر خطأه في `/_agent-native/mcp/status` ضمن `errors.<server-id>`، ويستمر كل خادم آخر في العمل.
 - MCP SDK مفقود من `node_modules` → تم تخطي جميع وظائف MCP مع تحذير؛ تستمر دردشة الوكيل في العمل بدون أدوات MCP.
 - التشغيل في وقت تشغيل الحافة ← عميل MCP غير متاح.
 

package/docs/content/locales/ar-SA/mcp-protocol.mdx

@@ -22,7 +22,7 @@ MCP هو البروتوكول القياسي لتوصيل أدوات الذكا
 
 المفاهيم الأساسية:
 
-- **يتم التثبيت تلقائيًا** — يحصل كل تطبيق على `/_agent-native/mcp` مجانًا، دون الحاجة إلى أي إعداد
+- **يتم التثبيت تلقائيًا** — يحصل كل تطبيق على `/mcp` مجانًا، دون الحاجة إلى أي إعداد
 - **HTTP** قابل للبث\*\* — يستخدم نقل MCP الحديث عبر HTTP القياسي (POST + SSE)
 - **نفس actions** — نفس سجل الإجراءات الذي يدعم دردشة الوكيل وA2A
 - **أداة `ask-agent`** — أداة تعريفية تقوم بتفويض حلقة الوكيل الكاملة للمهام المعقدة
@@ -41,7 +41,7 @@ MCP هو البروتوكول القياسي لتوصيل أدوات الذكا
   </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
+    <span class="diagram-pill accent">POST /mcp</span
     ><small class="diagram-muted">Streamable HTTP</small
     ><small class="diagram-muted"
       >initialize &rarr; tools/list &rarr; tools/call</small
@@ -94,7 +94,7 @@ MCP هو البروتوكول القياسي لتوصيل أدوات الذكا
 | **الأفضل لـ**     | أدوات خارجية تتصل بتطبيقك                                               | الاتصال من وكيل إلى وكيل                       |
 | **البروتوكول**    | MCP HTTP قابل للبث                                                      | JSON-RPC 2.0                                   |
 | **اكتشاف الأداة** | `tools/list`                                                            | بطاقة الوكيل في `/.well-known/agent-card.json` |
-| **نقطة النهاية**  | `/_agent-native/mcp`                                                    | `/_agent-native/a2a`                           |
+| **نقطة النهاية**  | `/mcp`                                                                  | `/_agent-native/a2a`                           |
 | **بدعم من**       | Claude، ChatGPT، Claude Code، Cursor، Codex، Cowork، ومضيفو MCP الآخرون | تطبيقات أخرى خاصة بالوكيل                      |
 | **التنفيذ**       | استدعاءات الأداة المباشرة (بدون LLM إضافية)                             | حلقة الوكيل الكاملة (استدلال LLM)              |
 
@@ -105,7 +105,7 @@ MCP هو البروتوكول القياسي لتوصيل أدوات الذكا
 للحصول على الإعداد الموصى به لأمر واحد، استخدم [External Agents](/docs/external-agents). إذا كنت تكتب يدويًا تهيئة MCP لعميل يدعم OAuth، فأضف تطبيقك كخادم MCP بعيد بدون رؤوس ثابتة:
 
 ```bash
-claude mcp add --transport http mail https://mail.example.com/_agent-native/mcp
+claude mcp add --transport http mail https://mail.example.com/mcp
 ```
 
 أو اكتب الإدخال يدويًا في `.mcp.json` (نطاق المشروع) أو `~/.claude.json` (نطاق المستخدم):
@@ -116,7 +116,7 @@ claude mcp add --transport http mail https://mail.example.com/_agent-native/mcp
   "mcpServers": {
     "mail": {
       "type": "http",
-      "url": "https://mail.example.com/_agent-native/mcp",
+      "url": "https://mail.example.com/mcp",
     },
   },
 }
@@ -135,12 +135,12 @@ Claude Code calls: draft-email(to: "john@example.com", subject: "Q3 Report", bod
 يمكن لأي عميل MCP يدعم النقل HTTP القابل للتدفق الاتصال. نقطة النهاية هي:
 
 ```
-POST https://your-app.example.com/_agent-native/mcp
+POST https://your-app.example.com/mcp
 ```
 
 يدعم الخادم مصافحة MCP القياسية: `initialize` → `initialized` → `tools/list` → `tools/call`.
 
-<Endpoint id="doc-block-17mmuo8" title={"MCP نقطة النهاية"} summary={"نقطة نهاية Streamable HTTP المثبتة تلقائيًا والتي يكشفها كل تطبيق أصلي للوكيل."} method="POST" path="/_agent-native/mcp" summary={"MCP نقطة النهاية HTTP القابلة للبث"} auth="Standard remote MCP OAuth (Bearer access token), connect-minted JWT, or static ACCESS_TOKEN/ACCESS_TOKENS" params={[
+<Endpoint id="doc-block-17mmuo8" title={"MCP نقطة النهاية"} summary={"نقطة نهاية Streamable HTTP المثبتة تلقائيًا والتي يكشفها كل تطبيق أصلي للوكيل."} method="POST" path="/mcp" summary={"MCP نقطة النهاية HTTP القابلة للبث"} auth="Standard remote MCP OAuth (Bearer access token), connect-minted JWT, or static ACCESS_TOKEN/ACCESS_TOKENS" params={[
   {
     "name": "Authorization",
     "in": "header",
@@ -204,18 +204,32 @@ Auto-mounted on every app. Speaks the standard MCP handshake (`initialize` → `
 
 بالإضافة إلى أدوات العمل الفردية، يتضمن كل خادم MCP أداة تعريف `ask-agent`. يؤدي هذا إلى إرسال رسالة باللغة الطبيعية إلى وكيل الذكاء الاصطناعي للتطبيق وإرجاع الرد.
 
+تستخدم طلبات MCP المستضافة انتظارًا مضمّنًا محدودًا حتى لا تُبقي حلقة وكيل طويلة استدعاء `tools/call` واحدًا مفتوحًا حتى انتهاء مهلة العميل أو البوابة. تبدأ الوسيطة الاختيارية `async` المهمة الدائمة وتُرجع فورًا؛ وبدونها، ينتظر الخادم لفترة قصيرة إتمامًا سريعًا ثم يُرجع معرّف مهمة عند تبقّي المزيد من العمل. يبلغ الحد الأقصى للانتظار المستضاف 25 ثانية.
+
 استخدم `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"
+    "message": "Draft a follow-up email to the Q3 planning thread with John, summarizing the action items we discussed",
+    "async": true
+  }
+}
+```
+
+يُدير الوكيل نفس الحلقة مثل الدردشة التفاعلية — يمكنه استدعاء أدوات متعددة، والتفكير في السياق، وتقديم استجابة مدروسة. تُرجع المهمة غير المكتملة JSON يحتوي على `taskId` و`status` و`pollAfterMs`، بالإضافة إلى:
+
+```json
+{
+  "poll": {
+    "tool": "ask_app_status",
+    "arguments": { "app": "mail", "taskId": "task_123" }
   }
 }
 ```
 
-يُدير الوكيل نفس الحلقة مثل الدردشة التفاعلية — يمكنه استدعاء أدوات متعددة، والتفكير في السياق، وتقديم استجابة مدروسة.
+استدعِ `ask_app_status` بتلك الوسيطات حتى تصل المهمة إلى حالة نهائية. يستخدم `ask_app` المملوك للتطبيق في Dispatch نفس عقد المهمة الدائمة والحالة، مع التحقق من صلاحية التطبيق المحدد عند كل من الإرسال والاستطلاع.
 
 ## المصادقة {#authentication}
 
@@ -233,7 +247,7 @@ Auto-mounted on every app. Speaks the standard MCP handshake (`initialize` → `
 بالنسبة للمضيفين MCP القادرين على OAuth، قم بتكوين الخادم البعيد URL بدون رؤوس ثابتة:
 
 ```bash
-claude mcp add --transport http agent-native https://dispatch.agent-native.com/_agent-native/mcp
+claude mcp add --transport http agent-native https://dispatch.agent-native.com/mcp
 ```
 
 يتلقى أول طلب MCP غير مصادق عليه:
@@ -249,9 +263,9 @@ WWW-Authenticate: Bearer resource_metadata="https://dispatch.agent-native.com/.w
 | ----------------------------------------- | ------------------------------------------- |
 | `/.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`          | منح رمز التفويض ورمز التحديث                |
+| `/mcp/oauth/register`                     | التسجيل الديناميكي للعميل العام             |
+| `/mcp/oauth/authorize`                    | تخويل المتصفح + الموافقة                    |
+| `/mcp/oauth/token`                        | منح رمز التفويض ورمز التحديث                |
 
 <Diagram id="doc-block-7e3ku8" title={"OAuth تدفق الاكتشاف"} summary={"يبدأ 401 عملية الاكتشاف والتسجيل وتفويض PKCE → تبادل الرمز المميز. الرمز المميز لحامله مرتبط بالجمهور ومحدد النطاق."}>
 
@@ -351,7 +365,7 @@ export default defineNitroPlugin(async (nitro) => {
 لديك تطبيق تحليلات منشور على `analytics.example.com`. من كود Claude:
 
 ```bash
-claude mcp add --transport http analytics https://analytics.example.com/_agent-native/mcp
+claude mcp add --transport http analytics https://analytics.example.com/mcp
 ```
 
 أو أضفه يدويًا في `.mcp.json`:
@@ -362,7 +376,7 @@ claude mcp add --transport http analytics https://analytics.example.com/_agent-n
   "mcpServers": {
     "analytics": {
       "type": "http",
-      "url": "https://analytics.example.com/_agent-native/mcp",
+      "url": "https://analytics.example.com/mcp",
     },
   },
 }

package/docs/content/locales/ar-SA/plan-plugin.mdx

@@ -12,7 +12,7 @@ description: "قم بتثبيت مهارات Agent-Native Plan (/visual-plan، /
 تمنحك عملية التثبيت الواحدة ما يلي:
 
 - **ثلاث skills** — `/visual-plan` (نقطة الدخول الأساسية)، و`/visual-recap`، و`/visualize-repo`.
-- **موصل Plan MCP** — مسجل في التطبيق المستضاف على `https://plan.agent-native.com` (نقطة نهاية MCP `https://plan.agent-native.com/_agent-native/mcp`، اسم الخادم `plan`).
+- **موصل Plan MCP** — مسجل في التطبيق المستضاف على `https://plan.agent-native.com` (نقطة نهاية MCP `https://plan.agent-native.com/mcp`، اسم الخادم `plan`).
 
 <Diagram id="doc-block-10bw7bb" title={"ثلاث طرق، حزمة واحدة"} summary={"يقوم كل من CLI العام ومكوّن Claude Code ومكوّن Codex بتثبيت مهارات Plan نفسها بالإضافة إلى موصل Plan المستضاف."}>
 
@@ -43,7 +43,7 @@ description: "قم بتثبيت مهارات Agent-Native Plan (/visual-plan، /
   <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
   <div class="diagram-box">
     Plan MCP connector<br /><small class="diagram-muted"
-      >plan.agent-native.com/_agent-native/mcp</small
+      >plan.agent-native.com/mcp</small
     >
   </div>
 </div>
@@ -251,7 +251,7 @@ codex plugin add agent-native-visual-plans@agent-native-apps
 codex mcp login plan   # OAuth في المتصفح
 ```
 
-بعد التثبيت، **ابدأ سلسلة Codex جديدة** حتى يتم تحميل الأدوات skills وMCP في الجلسة. يشحن البرنامج المساعد موصل URL فقط (`[mcp_servers.plan]` → `https://plan.agent-native.com/_agent-native/mcp`)؛ يقوم `codex mcp login plan` بتشغيل التدفق OAuth. يعمل مسار CLI العالمي أعلاه أيضًا مع Codex (`npx @agent-native/core@latest skills add visual-plan --client codex`) إذا كنت تفضل أمرًا واحدًا يتم تثبيته والمصادقة عليه معًا، أو عندما تريد الملفات المحلية أو وضع الاستضافة الذاتية.
+بعد التثبيت، **ابدأ سلسلة Codex جديدة** حتى يتم تحميل الأدوات skills وMCP في الجلسة. يشحن البرنامج المساعد موصل URL فقط (`[mcp_servers.plan]` → `https://plan.agent-native.com/mcp`)؛ يقوم `codex mcp login plan` بتشغيل التدفق OAuth. يعمل مسار CLI العالمي أعلاه أيضًا مع Codex (`npx @agent-native/core@latest skills add visual-plan --client codex`) إذا كنت تفضل أمرًا واحدًا يتم تثبيته والمصادقة عليه معًا، أو عندما تريد الملفات المحلية أو وضع الاستضافة الذاتية.
 
 > **عمليات التثبيت الأقدم:** إذا كان التكوين الخاص بك لا يزال يحتوي على إدخال `agent-native-plans` يشير إلى نفس URL، أو تشغيل `npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex` لـ Codex، أو نفس الأمر مع هدفك `--client`، فسيتم دمجه في اسم `plan` المتعارف عليه.
 

package/docs/content/locales/ar-SA/server.mdx

@@ -269,7 +269,7 @@ export default runMigrations(
 | `/_agent-native/extensions/*`    | امتدادات وقت التشغيل ووكيل الامتداد (الاسم المستعار القديم: `/_agent-native/tools/*`) |
 | `/_agent-native/integrations/*`  | عمليات تكامل المراسلة/الخطاف التلقائي على الويب                                       |
 | `/_agent-native/a2a`             | من وكيل إلى وكيل JSON-RPC                                                             |
-| `/_agent-native/mcp`             | نقطة نهاية MCP                                                                        |
+| `/mcp`                           | نقطة نهاية MCP                                                                        |
 | `/_agent-native/onboarding/*`    | قائمة التحقق من الإعداد                                                               |
 | `/_agent-native/observability/*` | التتبعات والملاحظات والتقييمات والتجارب                                               |
 | `/_agent-native/file-upload`     | نقطة نهاية موفر تحميل الملفات                                                         |
@@ -465,4 +465,4 @@ const handler = createProductionAgentHandler({
 - [**قاعدة البيانات**](/docs/database) — نمط `getDb()`/`schema` الذي تستورده المسارات المخصصة والإجراءات
 - [**الأمان**](/docs/security#access-guards) — `accessFilter`/`assertAccess` ونموذج تحديد نطاق البيانات الكامل
 - [**المراسلة**](/docs/messaging) — نمط قائمة انتظار التكامل القياسي للـ webhooks الواردة
-- [**بروتوكول MCP**](/docs/mcp-protocol) — نقطة النهاية `/_agent-native/mcp` التي يثبّتها هذا الخادم تلقائيًا
+- [**بروتوكول MCP**](/docs/mcp-protocol) — نقطة النهاية `/mcp` التي يثبّتها هذا الخادم تلقائيًا

package/docs/content/locales/ar-SA/skills-guide.mdx

@@ -313,7 +313,7 @@ scope: dev
   "id": "assets",
   "hosted": {
     "url": "https://assets.agent-native.com",
-    "mcpUrl": "https://assets.agent-native.com/_agent-native/mcp"
+    "mcpUrl": "https://assets.agent-native.com/mcp"
   },
   "mcp": { "serverName": "agent-native-assets" },
   "skills": [

package/docs/content/locales/ar-SA/template-assets.mdx

@@ -491,7 +491,7 @@ import { EmbeddedApp } from "@agent-native/embedding";
 ### المطور: توزيع مهارة التطبيق
 
 تحتوي مهارة تطبيق الأصول على معرف التطبيق `assets` وتستضيف MCP URL
-`https://assets.agent-native.com/_agent-native/mcp`.
+`https://assets.agent-native.com/mcp`.
 
 ```bash
 # أسهل تثبيت مستضاف: تعليمات المهارات المصدرة بالإضافة إلى موصل MCP.

package/docs/content/locales/ar-SA/template-dispatch.mdx

@@ -123,7 +123,7 @@ Dispatch هو **مستوى التحكم في مساحة العمل**. في حي
   إمكانية الوصول للإرسال دون نسخ الأسرار الأولية. المصدر الخاص بالتطبيق
   يظل التكوين في التطبيق الذي يستخدم الموفر.
 - **كشف موصل MCP واحد.** إضافة
-  `https://dispatch.agent-native.com/_agent-native/mcp` في Claude، ChatGPT،
+  `https://dispatch.agent-native.com/mcp` في Claude، ChatGPT،
   Codex أو Cursor أو مضيف MCP آخر، ثم اختر تطبيقات مساحة العمل التي سيتم تشغيلها
   من صفحة **الوكلاء** الخاصة بـ Dispatch. استخدم التطبيق المباشر URL
   فقط عندما يجب عزل هذا المضيف لتطبيق واحد.
@@ -304,7 +304,7 @@ _كيفية العمل تحت الغطاء (للمطورين)._
   ]}
 />
 
-- **وضع المحور MCP.** لا يزال بإمكان Dispatch العمل كـ [MCP hub](/docs/mcp-clients#hub) لمساحة العمل، لذا فإن كل تطبيق آخر في مساحة العمل يسحب نفس قائمة خوادم MCP ذات النطاق المؤسسي. بشكل منفصل، نقطة نهاية `/_agent-native/mcp` الخاصة بـ Dispatch هي موصل MCP الخارجي الموصى به لـ Claude وChatGPT والمضيفين الآخرين الذين يجب أن يصلوا إلى تطبيقات مساحة عمل متعددة.
+- **وضع المحور MCP.** لا يزال بإمكان Dispatch العمل كـ [MCP hub](/docs/mcp-clients#hub) لمساحة العمل، لذا فإن كل تطبيق آخر في مساحة العمل يسحب نفس قائمة خوادم MCP ذات النطاق المؤسسي. بشكل منفصل، نقطة نهاية `/mcp` الخاصة بـ Dispatch هي موصل MCP الخارجي الموصى به لـ Claude وChatGPT والمضيفين الآخرين الذين يجب أن يصلوا إلى تطبيقات مساحة عمل متعددة.
 
 ## الأحلام {#dreams}
 

package/docs/content/locales/ar-SA/template-plan.mdx

@@ -114,7 +114,7 @@ npx @agent-native/core@latest skills add visual-plan
 
 إذا كنت تستخدم مضيفًا يستند إلى الدردشة ويقبل موصل MCP URLs مباشرةً
 (بدلاً من عميل تم تكوينه بواسطة CLI)، قم بتوصيل موصل الخطط المستضاف على
-`https://plan.agent-native.com/_agent-native/mcp` — راجع [MCP Clients](/docs/mcp-clients) للتعرف على الإعداد الخاص بالعميل.
+`https://plan.agent-native.com/mcp` — راجع [MCP Clients](/docs/mcp-clients) للتعرف على الإعداد الخاص بالعميل.
 
 المصادقة عبارة عن تسجيل دخول إلى المتصفح لمرة واحدة عند الإعداد — وهذا هو المقصود، وهو كذلك
 هو ما يتيح للوكيل الاستمرار ومشاركة الخطط التي ينشئها. ما المصادقة
@@ -253,7 +253,7 @@ vscode://builder.agent-native/open?url=<encoded-plan-url>
   المراجعة عبر الأجهزة أو الفريق) تسجيل الدخول. وسيظهر تسجيل الدخول إلى Google عندما
   تم تكوين vars env القياسي لـ Google OAuth.
 
-موصل الخطط المستضاف موجود في `https://plan.agent-native.com/_agent-native/mcp`.
+موصل الخطط المستضاف موجود في `https://plan.agent-native.com/mcp`.
 لا تضع الأسرار المشتركة أبدًا في ملفات المهارات.
 
 ## وضع خصوصية الملفات المحلية {#local-files}
@@ -452,7 +452,7 @@ pnpm dev
 تستخدم المهارة المدعومة بالتطبيق المستضاف:
 
 - التطبيق: `https://plan.agent-native.com`
-- MCP: `https://plan.agent-native.com/_agent-native/mcp`
+- MCP: `https://plan.agent-native.com/mcp`
 
 يكون القالب المحلي مفيدًا عند تطوير الخطط نفسها، أو اختبار الثبات المحلي، أو تشغيل سطح مراجعة مستضاف ذاتيًا بالكامل.
 

package/docs/content/locales/de-DE/actions.mdx

@@ -540,7 +540,7 @@ Wenn Ihre App ein [A2A](/docs/a2a-protocol)-Peer ist, erkennen andere agentennat
 
 ## Es über MCP verfügbar machen {#mcp}
 
-Wenn MCP aktiviert ist, wird Ihr actions auf dem MCP-Server des Frameworks unter `/_agent-native/mcp` angezeigt. Jeder Anrufer erhält standardmäßig einen kompakten Katalog – App-orientierte integrierte Apps sowie die in der Vorlage deklarierte App actions – und `tool-search` ist immer vorhanden, sodass jedes andere Tool bei Bedarf erreichbar bleibt. Die vollständige Aktionsoberfläche wird nur bei explizitem Opt-in bereitgestellt (`--full-catalog`-Token oder `AGENT_NATIVE_MCP_FULL_CATALOG=1`), und `publicAgent.expose` wählt ein sicheres Lese-/Aufnahmetool für die öffentliche Oberfläche aus. Siehe [MCP Protocol](/docs/mcp-protocol) für Katalogstufen, Authentifizierung und die `mcpApp`-Ressourcendetails.
+Wenn MCP aktiviert ist, wird Ihr actions auf dem MCP-Server des Frameworks unter `/mcp` angezeigt. Jeder Anrufer erhält standardmäßig einen kompakten Katalog – App-orientierte integrierte Apps sowie die in der Vorlage deklarierte App actions – und `tool-search` ist immer vorhanden, sodass jedes andere Tool bei Bedarf erreichbar bleibt. Die vollständige Aktionsoberfläche wird nur bei explizitem Opt-in bereitgestellt (`--full-catalog`-Token oder `AGENT_NATIVE_MCP_FULL_CATALOG=1`), und `publicAgent.expose` wählt ein sicheres Lese-/Aufnahmetool für die öffentliche Oberfläche aus. Siehe [MCP Protocol](/docs/mcp-protocol) für Katalogstufen, Authentifizierung und die `mcpApp`-Ressourcendetails.
 
 Für UI-fähige MCP-Hosts kann eine Aktion eine optionale MCP-Apps-Ressource über das `mcpApp`-Feld (plus ein passendes `link`) deklarieren, sodass fähige Hosts das Ergebnis inline rendern. Wenn `link` und `mcpApp` auf die gleiche Route zeigen sollen, erstellt `embedRoute()` beide aus einem reinen Pfad-Builder:
 

package/docs/content/locales/de-DE/authentication.mdx

@@ -219,7 +219,7 @@ Durch die Konfiguration dieser Variablen wird niemals eine Token-Anmeldeseite f
 Der MCP-Endpunkt jeder App kann als standardmäßig geschützte MCP-Ressource fungieren. OAuth-fähige Clients können nur mit dem Remote-MCP URL:
 
 ```text
-https://mail.agent-native.com/_agent-native/mcp
+https://mail.agent-native.com/mcp
 ```
 
 Nicht authentifizierte MCP-Anfragen geben eine `WWW-Authenticate`-Herausforderung zurück, die auf `/.well-known/oauth-protected-resource` verweist. Der Client erkennt dann die OAuth-Metadaten der App, registriert dynamisch einen öffentlichen Client, öffnet die Autorisierungsseite der App und tauscht einen Autorisierungscode mit PKCE für Zugriffs- und Aktualisierungstoken aus.

package/docs/content/locales/de-DE/dispatch.mdx

@@ -113,16 +113,16 @@ Dispatch erkennt die anderen Apps in Ihrem Arbeitsbereich automatisch als A2A-Pe
 
 ### Einheitliches MCP-Gateway
 
-Dispatch kann der einzelne MCP-Connector für externe Agenten sein: Fügen Sie `https://dispatch.agent-native.com/_agent-native/mcp` einmal in Claude, ChatGPT, Codex oder Cursor hinzu, und eine Autorisierung erreicht jede gewährte Workspace-App anstelle eines Connectors pro App. Den vollständigen Verbindungsablauf, App-Zuschüsse, OAuth und Inline-MCP-App-Vorschauen finden Sie unter [External Agents](/docs/external-agents).
+Dispatch kann der einzelne MCP-Connector für externe Agenten sein: Fügen Sie `https://dispatch.agent-native.com/mcp` einmal in Claude, ChatGPT, Codex oder Cursor hinzu, und eine Autorisierung erreicht jede gewährte Workspace-App anstelle eines Connectors pro App. Den vollständigen Verbindungsablauf, App-Zuschüsse, OAuth und Inline-MCP-App-Vorschauen finden Sie unter [External Agents](/docs/external-agents).
 
-<Endpoint id="doc-block-1gi4v43" method="POST" path="/_agent-native/mcp" summary="Einheitlicher MCP-Gateway-Endpunkt" auth="Standard remote MCP OAuth, handled by the framework. The granted-app set scopes which workspace apps the connector can reach." responses={[
+<Endpoint id="doc-block-1gi4v43" method="POST" path="/mcp" summary="Einheitlicher MCP-Gateway-Endpunkt" auth="Standard remote MCP OAuth, handled by the framework. The granted-app set scopes which workspace apps the connector can reach." responses={[
   {
     "status": "200",
     "description": "MCP JSON-RPC response — tools, resources, and MCP App UI resources aggregated across granted workspace apps."
   }
 ]}>
 
-The single MCP connector URL external agents add (e.g. `https://dispatch.agent-native.com/_agent-native/mcp`). One authorization here reaches every **granted** workspace app instead of wiring one connector per app. App grants, OAuth, and inline MCP App previews are covered in [External Agents](/docs/external-agents).
+The single MCP connector URL external agents add (e.g. `https://dispatch.agent-native.com/mcp`). One authorization here reaches every **granted** workspace app instead of wiring one connector per app. App grants, OAuth, and inline MCP App previews are covered in [External Agents](/docs/external-agents).
 
 </Endpoint>