@agent-native/core 0.98.17 → 0.99.1

package/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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>
 

package/corpus/core/docs/content/locales/de-DE/external-agents.mdx

@@ -98,7 +98,7 @@ Fügen Sie einen Remote-MCP-Connector zum Host hinzu, auf dem Sie Agent-Native v
 Für arbeitsplatz- oder app-übergreifendes Arbeiten verwenden Sie Dispatch:
 
 ```text
-https://dispatch.agent-native.com/_agent-native/mcp
+https://dispatch.agent-native.com/mcp
 ```
 
 Dispatch ist das einzige Gateway für Mail, Kalender, Analytics, Brain und Ihr
@@ -109,12 +109,12 @@ Erreichen Sie alle Apps oder nur ausgewählte Apps. Der verbundene Host erhält
 Für eine absichtlich isolierte App verwenden Sie diese App direkt:
 
 ```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
 ```
 
 Jede gehostete App verfügt auch über eine Hilfsseite unter
-`https://&lt;app&gt;/_agent-native/mcp/connect` mit dem kopierbaren URL und
+`https://&lt;app&gt;/mcp/connect` mit dem kopierbaren URL und
 hostspezifische Registerkarten für Claude, ChatGPT, Cursor, Claude-Code, Codex und Andere.
 
 ### Claude und ChatGPT OAuth {#oauth}
@@ -238,7 +238,7 @@ Sobald die Verbindung hergestellt ist, sollte die Authentifizierung langfristig
 npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex
 ```
 
-`reconnect` findet jeden MCP-Konfigurationseintrag, dessen URL auf `/_agent-native/mcp` für den angegebenen Host und ausgewählten Client endet (Übereinstimmung mit URL unabhängig vom Connector-Namen), und aktualisiert oder ersetzt dann das Authentifizierungsmaterial, ohne Ihren installierten skills zu berühren oder den vollständigen Installationsablauf erneut auszuführen. Übergeben Sie die Basis-App URL (z. B. `https://plan.agent-native.com`) – das Suffix `/_agent-native/mcp` wird abgeleitet. Authentifizierung und Tool-Laden erfolgen pro Client. Starten Sie diesen Client daher anschließend neu bzw. laden Sie ihn neu. Codex benötigt eine neue Sitzung, bevor neu geladene Tools angezeigt werden.
+`reconnect` findet jeden MCP-Konfigurationseintrag, dessen URL auf `/mcp` für den angegebenen Host und ausgewählten Client endet (Übereinstimmung mit URL unabhängig vom Connector-Namen), und aktualisiert oder ersetzt dann das Authentifizierungsmaterial, ohne Ihren installierten skills zu berühren oder den vollständigen Installationsablauf erneut auszuführen. Übergeben Sie die Basis-App URL (z. B. `https://plan.agent-native.com`) – das Suffix `/mcp` wird abgeleitet. Authentifizierung und Tool-Laden erfolgen pro Client. Starten Sie diesen Client daher anschließend neu bzw. laden Sie ihn neu. Codex benötigt eine neue Sitzung, bevor neu geladene Tools angezeigt werden.
 
 Im Claude-Code lautet der entsprechende UI-Pfad: Führen Sie `/mcp` aus und wählen Sie **Authentifizieren** (oder **Erneut verbinden**) für den relevanten Connector.
 
@@ -246,7 +246,7 @@ Installieren Sie den Skill niemals von Grund auf neu, nur um einen 401 zu behebe
 
 ### Connect-Seiten-Fallback {#connect-page-fallback}
 
-Für MCP-Clients, die keinen Remote-OAuth URL direkt hinzufügen können, öffnen Sie die App in Ihrem Browser und nutzen Sie das **Connect**-Angebot (bereitgestellt unter `https://&lt;app&gt;/_agent-native/mcp/connect`). Klicken Sie im angemeldeten Zustand auf **Verbinden / Autorisieren**. Auf der Seite erhalten Sie entweder einen One-Click-Deep-Link, der einen erkannten Agenten konfiguriert, oder einen zum Einfügen bereiten `.mcp.json`-Block:
+Für MCP-Clients, die keinen Remote-OAuth URL direkt hinzufügen können, öffnen Sie die App in Ihrem Browser und nutzen Sie das **Connect**-Angebot (bereitgestellt unter `https://&lt;app&gt;/mcp/connect`). Klicken Sie im angemeldeten Zustand auf **Verbinden / Autorisieren**. Auf der Seite erhalten Sie entweder einen One-Click-Deep-Link, der einen erkannten Agenten konfiguriert, oder einen zum Einfügen bereiten `.mcp.json`-Block:
 
 ```jsonc
 // .mcp.json
@@ -254,7 +254,7 @@ Für MCP-Clients, die keinen Remote-OAuth URL direkt hinzufügen können, öffne
   "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>" },
     },
   },
@@ -271,13 +271,13 @@ Gehostete agentennative Apps unterstützen auch den Standard-Remote-Flow MCP OAu
 
 ```bash
 claude mcp add --transport http agent-native \
-  https://dispatch.agent-native.com/_agent-native/mcp
+  https://dispatch.agent-native.com/mcp
 ```
 
 Dies ist derselbe Nur-URL-Eintrag, den `npx @agent-native/core@latest connect https://dispatch.agent-native.com --client claude-code` für Sie schreibt. Führen Sie dann `/mcp` im Claude-Code aus und wählen Sie **Authentifizieren**. Der Client erkennt die Authentifizierung anhand der `401 WWW-Authenticate`-Challenge des MCP-Servers, ruft `/.well-known/oauth-protected-resource` und `/.well-known/oauth-authorization-server` ab, registriert dynamisch einen öffentlichen OAuth-Client, öffnet die Autorisierungsseite der App und speichert das resultierende Token sicher. ChatGPT-Entwicklermodus-Konnektoren verwenden denselben Server URL:
 
 ```text
-https://dispatch.agent-native.com/_agent-native/mcp
+https://dispatch.agent-native.com/mcp
 ```
 
 Der OAuth-Fluss besteht aus Autorisierungscode + PKCE mit Aktualisierungstokenrotation. Zugriffstoken sind an die genaue MCP-Ressource URL zielgruppengebunden und tragen die signierte Benutzer-/Organisationsidentität, sodass Toolaufrufe, `resources/read` und MCP App-Iframe-initiiertes `tools/call` alle denselben `runWithRequestContext`-Mandantenbereich durchlaufen wie der vorhandene Connect-Minted-JWT-Pfad. Der Iframe empfängt niemals rohe OAuth-Token; Der Host vermittelt Anrufe über die authentifizierte MCP-Verbindung.
@@ -502,13 +502,13 @@ Siehe [MCP Apps](/docs/mcp-apps) für die vollständigen Bridge-Details – Tran
 
 Zusätzlich zu den Tools pro Aktion stellt der MCP-Server einen stabilen Verbsatz bereit, sodass ein externer Agent eine vorhersehbare Oberfläche hat, ohne die Aktionsnamen pro App erraten zu müssen:
 
-| Werkzeug                                           | Nebenwirkungen  | Retouren                                                                                                                              |
-| -------------------------------------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
-| `list_apps`                                        | keine           | Workspace-Apps + ihre URLs/Ausführungsstatus                                                                                          |
-| `open_app({ app, view?, path?, params?, embed? })` | keine           | ein Deep Link oder eine Route mit demselben Ursprung; `embed: true` rendert die vollständige App inline, sofern dies unterstützt wird |
-| `ask_app({ app, message })`                        | Agentenschleife | leitet eine Aufgabe in natürlicher Sprache an den In-App-Agenten dieser App weiter (delegiert an `ask-agent`)                         |
-| `create_workspace_app({ name, template })`         | Gerüste         | Eine neue App, die über den Workspace-Pfad gestartet wurde, plus die Ausführung von URL + Deep Link                                   |
-| `list_templates`                                   | keine           | Nur die auf der Zulassungsliste aufgeführten Vorlagen                                                                                 |
+| Werkzeug                                           | Nebenwirkungen  | Retouren                                                                                                                                                                                         |
+| -------------------------------------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `list_apps`                                        | keine           | Workspace-Apps + ihre URLs/Ausführungsstatus                                                                                                                                                     |
+| `open_app({ app, view?, path?, params?, embed? })` | keine           | ein Deep Link oder eine Route mit demselben Ursprung; `embed: true` rendert die vollständige App inline, sofern dies unterstützt wird                                                            |
+| `ask_app({ app, message, async?, maxWaitMs? })`    | Agentenschleife | leitet eine Aufgabe in natürlicher Sprache an den In-App-Agenten dieser App weiter; bei länger laufender Arbeit wird eine dauerhafte `taskId` für das Polling mit `ask_app_status` zurückgegeben |
+| `create_workspace_app({ name, template })`         | Gerüste         | Eine neue App, die über den Workspace-Pfad gestartet wurde, plus die Ausführung von URL + Deep Link                                                                                              |
+| `list_templates`                                   | keine           | Nur die auf der Zulassungsliste aufgeführten Vorlagen                                                                                                                                            |
 
 `create_workspace_app` lehnt alle nicht auf der Zulassungsliste aufgeführten Vorlagen ab – die öffentliche Zulassungsliste für Vorlagen in `packages/shared-app-config/templates.ts` ist maßgeblich und CI-geschützt; ein externer Agent kann es nicht erweitern. Eine gleichnamige Vorlagenaktion überschreibt eine integrierte Aktion (Vorrang der Vorlage vor dem Kern). Deaktivieren Sie das gesamte Set mit `MCPConfig.builtinCrossAppTools: false`.
 
@@ -516,6 +516,10 @@ Die Tool- und Ressourcenkataloge für App-Hosts sind standardmäßig kompakt –
 
 Für schnelle ChatGPT/Claude-Übergaben ist der ideale Pfad direkt: Rufen Sie die Aktion auf, die das Artefakt erstellt oder öffnet, und lassen Sie dann die MCP-App die Route starten. Eine Mail-Anfrage sollte `manage_draft` aufrufen und die tatsächliche Verfassen-Route rendern. Eine Dashboard-Anfrage sollte `open_app({ path, embed: true })` oder eine Dashboard-Aktion mit `mcpApp` aufrufen und die vollständige Analytics-Route rendern. Kalender, Formulare, Inhalte, Folien, Design und Clips sollten beim Entwerfen/Erstellen/Suchen dem gleichen Muster folgen actions. `list_apps` ist nützlich, wenn das Modell zwischen verfügbaren Apps wählen muss; Breites `resources/list`, vollständige Katalogerkennung oder `ask_app`-Delegierung sollten nicht der normale Weg für eine offensichtliche UI-Übergabe sein.
 
+### Lang laufende Agent-Anfragen
+
+MCP-Hosts und -Gateways teilen sich kein einheitliches Zeitlimit für Tool-Aufrufe; manche erzwingen eine Obergrenze von fünf Minuten, andere sind konfigurierbar. Planen Sie eine externe Agentenintegration nicht um einen zehnminütigen, blockierenden `tools/call` herum. `ask-agent` und `ask_app` bestätigen gehostete Arbeit schnell und geben dann eine dauerhafte `taskId` zurück, sobald die Inline-Wartezeit abläuft. Fragen Sie mit `ask_app_status` unter Verwendung der zurückgegebenen `app` und `taskId` ab; das Ergebnis enthält `pollAfterMs` als host-freundliches Intervall. Die Aufgabe muss erstellt werden, bevor die erste Antwort in ein Timeout laufen kann – eine Polling-URL, die erst nach einem langen Aufruf zurückgegeben wird, ist kein zuverlässiger Recovery-Vertrag.
+
 ### Tour pro App {#tour}
 
 Jede Vorlage auf der Zulassungsliste, die eine navigierbare Ressource erstellt oder auflistet, liefert einen `link`-Builder, und die aufnahmeintensiven Vorlagen liefern eine GET + `publicAgent`-Aktion, damit ein verbundener Agent den Live-Status abrufen kann:
@@ -679,7 +683,7 @@ Es stellt ein Token bereit (ein zufälliges `ACCESS_TOKEN` im Arbeitsbereich `.e
 - **cowork** – die gleiche Form des Claude-Codes JSON in `~/.cowork/mcp.json`.
 - **codex** – ein `[mcp_servers.<name>]`-Block in `~/.codex/config.toml`.
 
-Der Eintrag führt `npx @agent-native/core@latest mcp serve --app <id>` aus, der standardmäßig ein **Thin-Stdio-Proxy** für den `/_agent-native/mcp` der laufenden lokalen App ist – daher bleiben die Live-Action-Registrierung HMR und korrekte Deep-Links die einzige Quelle der Wahrheit. Übergeben Sie stattdessen `--standalone`, um die Registrierung im Prozess zu erstellen. Wenn `npx @agent-native/core@latest mcp install` einen gehosteten Ursprung erkennt (einen nicht-lokalen Host `APP_URL` / `BETTER_AUTH_URL` / `AGENT_NATIVE_MCP_URL` im Arbeitsbereich `.env`), schreibt es einen `http`-Clienteintrag, der auf `<origin>/_agent-native/mcp` zeigt, mit einem `Bearer` JWT anstelle eines stdio-Eintrags.
+Der Eintrag führt `npx @agent-native/core@latest mcp serve --app <id>` aus, der standardmäßig ein **Thin-Stdio-Proxy** für den `/mcp` der laufenden lokalen App ist – daher bleiben die Live-Action-Registrierung HMR und korrekte Deep-Links die einzige Quelle der Wahrheit. Übergeben Sie stattdessen `--standalone`, um die Registrierung im Prozess zu erstellen. Wenn `npx @agent-native/core@latest mcp install` einen gehosteten Ursprung erkennt (einen nicht-lokalen Host `APP_URL` / `BETTER_AUTH_URL` / `AGENT_NATIVE_MCP_URL` im Arbeitsbereich `.env`), schreibt es einen `http`-Clienteintrag, der auf `<origin>/mcp` zeigt, mit einem `Bearer` JWT anstelle eines stdio-Eintrags.
 
 Companion-Unterbefehle:
 
@@ -703,7 +707,7 @@ Sie können die MCP-Clientkonfiguration auch manuell für jeden bereitgestellten
   "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>" },
     },
   },
@@ -745,7 +749,7 @@ Vollständige App-Einbettungen vermeiden außerdem die Übergabe des MCP-Bearer-
 Der als Fallback gehostete `connect`-Fluss kopiert niemals das gemeinsame Geheimnis der Bereitstellung. Stattdessen:
 
 - Eine angemeldete Browsersitzung prägt ein **pro Benutzer gültiges, widerrufbares** Token – ein `A2A_SECRET`-signiertes JWT mit dem `sub` + `org_domain` des Aufrufers und einem eindeutigen `jti`, sodass jede Tool-Ausführung über `runWithRequestContext` mandantenabhängig bleibt.
-- Der vorhandene `/_agent-native/mcp`-Endpunkt akzeptiert dieses Token wie jeder andere Träger (siehe [MCP Protocol](/docs/mcp-protocol)) – kein neuer Endpunkt, kein neuer Transport.
+- Der vorhandene `/mcp`-Endpunkt akzeptiert dieses Token wie jeder andere Träger (siehe [MCP Protocol](/docs/mcp-protocol)) – kein neuer Endpunkt, kein neuer Transport.
 - Auf der gleichen Connect-Seite werden alle von Ihnen geprägten Token aufgelistet und Sie können diese bis `jti` **widerrufen**. Behandeln Sie sie wie persönliche Zugriffstoken: eines pro Agent-Client, widerrufen, wenn eine Maschine außer Betrieb genommen wird.
 - Der Deep Link, den der Agent zurückgibt, weist keinen privilegierten Status auf. Der datensatzfokussierende `navigate`-Schreibvorgang ist immer auf die **Browsersitzung** beschränkt, niemals auf das Token des Agenten – ein Link kann also sicher in ein Terminal oder ein Chat-Transkript eingefügt werden.
 

package/corpus/core/docs/content/locales/de-DE/mcp-clients.mdx

@@ -245,6 +245,38 @@ Das bedeutet, dass Benutzer, die die Claude-in-Chrome-Erweiterung installiert ha
 
 MCP-Server (Model Context Protocol) geben Ihrem Agenten neue Fähigkeiten – wie die Verbindung zu Zapier, Cloudflare, Composio oder den internen Tools Ihres Unternehmens. Sobald die Verbindung hergestellt ist, kann der Agent diese Tools genauso verwenden wie die integrierten.
 
+Die Preset-IDs sind `context7`, `sentry`, `notion`, `semgrep`, `linear`,
+`atlassian`, `supabase`, `neon` und `stripe`.
+
+### Atlassian / Jira
+
+Das Atlassian-Preset verwendet den OAuth-2.1-Endpunkt von Atlassian Rovo MCP,
+`https://mcp.atlassian.com/v1/mcp/authv2`, und stellt Tools für Jira und
+Confluence bereit. Zum Erstellen von Jira-Tickets sind Atlassian-Berechtigungen
+erforderlich, die Schreibzugriffe in Jira abdecken. Benutzer sehen weiterhin
+nur die Projekte und Inhalte, die ihr Atlassian-Konto zulässt.
+
+Administratoren einer Atlassian-Organisation können steuern, ob ein OAuth-Client
+eine Verbindung herstellen darf. Vor dem Verbinden muss ein Administrator
+möglicherweise den tatsächlichen HTTPS-Ursprung der App unter **Atlassian
+Administration → Rovo → Rovo MCP server → Domains** zur Liste der
+vertrauenswürdigen Domains hinzufügen und unter **Permissions** die erforderlichen
+Berechtigungen **Read**, **Write** und **Search** aktivieren. Die Domain muss der
+Host sein, auf dem die agent-native-App ausgeführt wird. Übernehmen Sie
+`https://builder.io/**` nicht für eine andere Bereitstellung, sofern dies nicht
+deren tatsächlicher Ursprung ist. Weitere Informationen finden Sie im
+[Rovo-MCP-Einrichtungsleitfaden von Atlassian](https://developer.atlassian.com/cloud/rovo-mcp/guides/getting-started/)
+und in den [Administratorsteuerelementen](https://support.atlassian.com/security-and-access-policies/docs/control-atlassian-rovo-mcp-server-settings/).
+
+Der Katalog stellt den Endpunkt und Einrichtungshinweise bereit. Das allgemeine
+Einstellungsformular speichert den Endpunkt und optionale verschlüsselte Header;
+es ersetzt nicht den interaktiven OAuth-Zustimmungsablauf von Atlassian. Verwenden
+Sie einen OAuth-fähigen MCP-Client oder eine entsprechende Laufzeit, wenn
+Atlassian interaktives OAuth erfordert. Wenn der Anbieter oder die Laufzeit ein
+statisches Bearer-Token unterstützt, folgen Sie dem dafür vorgesehenen Verfahren
+zur Verwaltung von Secrets und fügen Sie Tokens niemals in Prompts oder
+committete Konfigurationen ein.
+
 ### So verbinden Sie einen Remote-MCP-Server
 
 1. **Servername** – eine kurze Bezeichnung für Ihre eigene Referenz (z. B. „zapier“, „slack-tools“).
@@ -263,7 +295,7 @@ Zwei Bereiche werden unterstützt:
 
 Fügt Hot-Reload zum laufenden MCP-Manager hinzu und entfernt es – kein Neustart des Prozesses und kein Neustart des Servers. Die neuen `mcp__<scope>-<name>__*`-Tools werden dem Agenten in der nächsten Nachricht angezeigt und können über `tool-search` durchsucht werden.
 
-HTTPS URLs werden überall akzeptiert; einfaches `http://` ist während der Entwicklung nur für `localhost` zulässig. Die optionale Authentifizierung erfolgt als Bearer-Token, das bei jeder Anfrage über `Authorization: Bearer …` gesendet wird.
+HTTPS URLs werden überall akzeptiert; einfaches `http://` ist während der Entwicklung nur für `localhost` zulässig. Die optionale Authentifizierung erfolgt als Bearer-Token, das bei jeder Anfrage über `Authorization: Bearer …` gesendet wird. Anbieter, die ausschließlich OAuth unterstützen, darunter Atlassian Rovo MCP, erfordern anstelle eines statischen Headers den OAuth-Ablauf des Anbieters.
 
 Unter der Haube werden diese Server in der `settings`-Tabelle des Frameworks unter dem Schlüssel `u:<email>:mcp-servers-remote` (Persönlich) oder `o:<orgId>:mcp-servers-remote` (Team) gespeichert und beim Start mit `mcp.config.json` zusammengeführt.
 
@@ -292,7 +324,9 @@ Dispatch ist der herkömmliche Hub – er koordiniert bereits alle Apps.
   <div class="diagram-panel center" data-rough>
     <span class="diagram-pill accent">Dispatch hub</span
     ><small class="diagram-muted">MCP-Server mit Organisationsscope</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 +488,7 @@ Verwenden Sie dies, um Onboarding-Hinweise „claude-in-chrome erkannt – Ihr A
 
 Einzelne MCP-Serverausfälle führen nie zum Ausfall des Agenten:
 
-- Ein falsch konfigurierter `command` → der Server wird übersprungen, sein Fehler erscheint in `/mcp/status` unter `errors.<server-id>` und alle anderen Server funktionieren weiterhin.
+- Ein falsch konfigurierter `command` → der Server wird übersprungen, sein Fehler erscheint in `/_agent-native/mcp/status` unter `errors.<server-id>` und alle anderen Server funktionieren weiterhin.
 - MCP SDK fehlt in `node_modules` → alle MCP-Funktionen werden mit einer Warnung übersprungen; Der Agenten-Chat funktioniert weiterhin ohne MCP-Tools.
 - Laufen in einer Edge-Laufzeit → MCP-Client ist ein No-Op.