@agent-native/core 0.98.17 → 0.99.0

package/corpus/README.md

@@ -27,5 +27,5 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core/corpus
 
 ## Generated Counts
 
-- core files: 2239
-- template files: 5518
+- core files: 2241
+- template files: 5533

package/corpus/core/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @agent-native/core
 
+## 0.99.0
+
+### Minor Changes
+
+- 3c3a59d: Return durable task handles for long-running MCP agent requests and expose
+  grant-checked status polling instead of holding one MCP tool call open for the
+  full agent run.
+
+### Patch Changes
+
+- 3c3a59d: Add Atlassian Rovo MCP to the built-in integration catalog with Jira setup guidance.
+- 3c3a59d: Keep delegated A2A agent runs aligned with interactive prompt context and request-scoped browser access.
+- 3c3a59d: Keep anonymous SSR shells long-cacheable across hosting providers and keep viewer-specific data on client/API paths.
+- 3c3a59d: Add `/mcp` as the canonical public MCP URL while preserving `/_agent-native/mcp` for existing clients.
+
 ## 0.98.17
 
 ### Patch Changes

package/corpus/core/docs/content/actions.mdx

@@ -518,7 +518,7 @@ If your app is an [A2A](/docs/a2a-protocol) peer, other agent-native apps discov
 
 ## Exposing it over MCP {#mcp}
 
-With MCP enabled, your actions show up in the framework's MCP server at `/_agent-native/mcp`. Every caller gets a compact catalog by default — app-facing builtins plus the template-declared app actions — and `tool-search` is always present so any other tool stays reachable on demand. The full action surface is served only on explicit opt-in (`--full-catalog` token or `AGENT_NATIVE_MCP_FULL_CATALOG=1`), and `publicAgent.expose` opts a safe read/ingest tool onto the public surface. See [MCP Protocol](/docs/mcp-protocol) for catalog tiers, auth, and the `mcpApp` resource details.
+With MCP enabled, your actions show up in the framework's MCP server at `/mcp`. Every caller gets a compact catalog by default — app-facing builtins plus the template-declared app actions — and `tool-search` is always present so any other tool stays reachable on demand. The full action surface is served only on explicit opt-in (`--full-catalog` token or `AGENT_NATIVE_MCP_FULL_CATALOG=1`), and `publicAgent.expose` opts a safe read/ingest tool onto the public surface. See [MCP Protocol](/docs/mcp-protocol) for catalog tiers, auth, and the `mcpApp` resource details.
 
 For UI-capable MCP hosts, an action can declare an optional MCP Apps resource via the `mcpApp` field (plus a matching `link`) so capable hosts render the result inline. When `link` and `mcpApp` should point at the same route, `embedRoute()` builds both from one pure path builder:
 

package/corpus/core/docs/content/authentication.mdx

@@ -219,7 +219,7 @@ Configuring these variables never renders a token login page for visitors. Web s
 Every app's MCP endpoint can act as a standard protected MCP resource. OAuth-capable clients can be configured with only the remote MCP URL:
 
 ```text
-https://mail.agent-native.com/_agent-native/mcp
+https://mail.agent-native.com/mcp
 ```
 
 Unauthenticated MCP requests return a `WWW-Authenticate` challenge pointing at `/.well-known/oauth-protected-resource`. The client then discovers the app's OAuth metadata, dynamically registers a public client, opens the app's authorization page, and exchanges an authorization code with PKCE for access and refresh tokens.

package/corpus/core/docs/content/dispatch.mdx

@@ -117,16 +117,16 @@ Dispatch auto-discovers the other apps in your workspace as A2A peers — no man
 
 ### Unified MCP gateway
 
-Dispatch can be the single MCP connector for external agents: add `https://dispatch.agent-native.com/_agent-native/mcp` once in Claude, ChatGPT, Codex, or Cursor, and one authorization reaches every granted workspace app instead of one connector per app. See [External Agents](/docs/external-agents) for the full connect flow, app grants, OAuth, and inline MCP App previews.
+Dispatch can be the single MCP connector for external agents: add `https://dispatch.agent-native.com/mcp` once in Claude, ChatGPT, Codex, or Cursor, and one authorization reaches every granted workspace app instead of one connector per app. See [External Agents](/docs/external-agents) for the full connect flow, app grants, OAuth, and inline MCP App previews.
 
-<Endpoint id="doc-block-7jvtfw" method="POST" path="/_agent-native/mcp" summary="Unified MCP gateway endpoint" 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-7jvtfw" method="POST" path="/mcp" summary="Unified MCP gateway endpoint" 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/external-agents.mdx

@@ -99,7 +99,7 @@ Add one remote MCP connector to the host where you want to use Agent-Native.
 For workspace or cross-app work, use Dispatch:
 
 ```text
-https://dispatch.agent-native.com/_agent-native/mcp
+https://dispatch.agent-native.com/mcp
 ```
 
 Dispatch is the single gateway for Mail, Calendar, Analytics, Brain, and your
@@ -110,12 +110,12 @@ reach all apps or only selected apps. The connected host then gets
 For one intentionally isolated app, use that app directly:
 
 ```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
 ```
 
 Every hosted app also has a helper page at
-`https://&lt;app&gt;/_agent-native/mcp/connect` with the copyable URL and
+`https://&lt;app&gt;/mcp/connect` with the copyable URL and
 host-specific tabs for Claude, ChatGPT, Cursor, Claude Code, Codex, and Other.
 
 ### Claude and ChatGPT OAuth {#oauth}
@@ -238,7 +238,7 @@ Once connected, auth should persist long-term — access tokens last 30 days by
 npx @agent-native/core@latest reconnect https://plan.agent-native.com --client codex
 ```
 
-`reconnect` finds any MCP config entry whose URL ends in `/_agent-native/mcp` for the given host and selected client (matching by URL regardless of connector name), then refreshes or replaces the auth material without touching your installed skills or re-running the full install flow. Pass the base app URL (e.g. `https://plan.agent-native.com`) — the `/_agent-native/mcp` suffix is inferred. Auth and tool loading are per client, so restart/reload that client afterward; Codex needs a new session before newly loaded tools appear.
+`reconnect` finds any MCP config entry whose URL ends in `/mcp` for the given host and selected client (matching by URL regardless of connector name), then refreshes or replaces the auth material without touching your installed skills or re-running the full install flow. Pass the base app URL (e.g. `https://plan.agent-native.com`) — the `/mcp` suffix is inferred. Auth and tool loading are per client, so restart/reload that client afterward; Codex needs a new session before newly loaded tools appear.
 
 In Claude Code, the equivalent UI path is: run `/mcp` and choose **Authenticate** (or **Reconnect**) for the relevant connector.
 
@@ -246,7 +246,7 @@ Never reinstall the skill from scratch just to fix a 401 — `reconnect` is the
 
 ### Connect page fallback {#connect-page-fallback}
 
-For MCP hosts that cannot add a remote OAuth URL directly, open the app in your browser and use its **Connect** affordance (served at `https://&lt;app&gt;/_agent-native/mcp/connect`). While logged in, click **Connect / Authorize**. The page hands you either a one-click deep link that configures a detected agent, or a ready-to-paste `.mcp.json` block:
+For MCP hosts that cannot add a remote OAuth URL directly, open the app in your browser and use its **Connect** affordance (served at `https://&lt;app&gt;/mcp/connect`). While logged in, click **Connect / Authorize**. The page hands you either a one-click deep link that configures a detected agent, or a ready-to-paste `.mcp.json` block:
 
 ```jsonc
 // .mcp.json
@@ -254,7 +254,7 @@ For MCP hosts that cannot add a remote OAuth URL directly, open the app in your
   "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 @@ Hosted agent-native apps also support the standard remote MCP OAuth flow. For cl
 
 ```bash
 claude mcp add --transport http agent-native \
-  https://dispatch.agent-native.com/_agent-native/mcp
+  https://dispatch.agent-native.com/mcp
 ```
 
 This is the same URL-only entry that `npx @agent-native/core@latest connect https://dispatch.agent-native.com --client claude-code` writes for you. Then run `/mcp` in Claude Code and choose **Authenticate**. The client discovers auth from the MCP server's `401 WWW-Authenticate` challenge, fetches `/.well-known/oauth-protected-resource` and `/.well-known/oauth-authorization-server`, dynamically registers a public OAuth client, opens the app's authorization page, and stores the resulting token securely. ChatGPT developer-mode connectors use the same server URL:
 
 ```text
-https://dispatch.agent-native.com/_agent-native/mcp
+https://dispatch.agent-native.com/mcp
 ```
 
 The OAuth flow is authorization-code + PKCE with refresh-token rotation. Access tokens are audience-bound to the exact MCP resource URL and carry the signed user/org identity, so tool calls, `resources/read`, and MCP App iframe-initiated `tools/call` all run through the same `runWithRequestContext` tenant scoping as the existing connect-minted JWT path. The iframe never receives raw OAuth tokens; the host mediates calls through the authenticated MCP connection.
@@ -524,13 +524,13 @@ See [MCP Apps](/docs/mcp-apps) for the full bridge details — transplant vs con
 
 On top of the per-action tools the MCP server exposes a stable verb set, so an external agent has a predictable surface without guessing per-app action names:
 
-| Tool                                               | Side effects | Returns                                                                                     |
-| -------------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------- |
-| `list_apps`                                        | none         | workspace apps + their URLs / running state                                                 |
-| `open_app({ app, view?, path?, params?, embed? })` | none         | a deep link or same-origin route; `embed: true` renders the full app inline where supported |
-| `ask_app({ app, message })`                        | agent loop   | routes a natural-language task to that app's in-app agent (delegates to `ask-agent`)        |
-| `create_workspace_app({ name, template })`         | scaffolds    | a new app booted via the workspace path, plus its running URL + deep link                   |
-| `list_templates`                                   | none         | the allow-listed templates only                                                             |
+| Tool                                               | Side effects | Returns                                                                                                                      |
+| -------------------------------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------- |
+| `list_apps`                                        | none         | workspace apps + their URLs / running state                                                                                  |
+| `open_app({ app, view?, path?, params?, embed? })` | none         | a deep link or same-origin route; `embed: true` renders the full app inline where supported                                  |
+| `ask_app({ app, message, async?, maxWaitMs? })`    | agent loop   | routes a natural-language task to that app's in-app agent; long work returns a durable `taskId` for `ask_app_status` polling |
+| `create_workspace_app({ name, template })`         | scaffolds    | a new app booted via the workspace path, plus its running URL + deep link                                                    |
+| `list_templates`                                   | none         | the allow-listed templates only                                                                                              |
 
 `create_workspace_app` rejects any non-allow-listed template — the public template allow-list in `packages/shared-app-config/templates.ts` is authoritative and CI-guarded; an external agent cannot widen it. A same-named template action overrides a builtin (template-over-core precedence). Disable the whole set with `MCPConfig.builtinCrossAppTools: false`.
 
@@ -538,6 +538,17 @@ The tool and resource catalogs for app hosts are compact by default — see [Cat
 
 For fast ChatGPT/Claude handoffs, the ideal path is direct: call the action that creates or opens the artifact, then let the MCP App launch the route. A Mail request should call `manage_draft` and render the real compose route. A dashboard request should call `open_app({ path, embed: true })` or a dashboard action with `mcpApp` and render the full Analytics route. Calendar, Forms, Content, Slides, Design, and Clips should follow the same pattern with their draft/create/search actions. `list_apps` is useful when the model must choose among granted apps; broad `resources/list`, full-catalog discovery, or `ask_app` delegation should not be the normal route for an obvious UI handoff.
 
+### Long-running agent requests
+
+MCP hosts and gateways do not share one long tool-call timeout; some enforce a
+five-minute ceiling and others are configurable. Do not design an external
+agent integration around a ten-minute blocking `tools/call`. `ask-agent` and
+`ask_app` acknowledge hosted work quickly, then return a durable `taskId` when
+the inline wait expires. Poll with `ask_app_status` using the returned `app`
+and `taskId`; the result includes `pollAfterMs` as a host-friendly interval.
+The task must be created before the first response can time out, so a polling
+URL returned only after a long call is not a reliable recovery contract.
+
 ### Per-app tour {#tour}
 
 Every allow-listed template that produces or lists a navigable resource ships a `link` builder, and the ingest-heavy ones ship a GET + `publicAgent` action so a connected agent can pull live state:
@@ -701,7 +712,7 @@ It provisions a token (a random `ACCESS_TOKEN` into the workspace `.env` for loc
 - **cowork** — the same Claude Code JSON shape in `~/.cowork/mcp.json`.
 - **codex** — an `[mcp_servers.<name>]` block in `~/.codex/config.toml`.
 
-The entry runs `npx @agent-native/core@latest mcp serve --app <id>`, which by default is a **thin stdio proxy** to the running local app's `/_agent-native/mcp` — so the live action registry, HMR, and correct deep links stay the single source of truth. Pass `--standalone` to build the registry in-process instead. When `npx @agent-native/core@latest mcp install` detects a hosted origin (a non-localhost `APP_URL` / `BETTER_AUTH_URL` / `AGENT_NATIVE_MCP_URL` in the workspace `.env`), it writes an `http` client entry pointing at `<origin>/_agent-native/mcp` with a `Bearer` JWT instead of a stdio entry.
+The entry runs `npx @agent-native/core@latest mcp serve --app <id>`, which by default is a **thin stdio proxy** to the running local app's `/mcp` — so the live action registry, HMR, and correct deep links stay the single source of truth. Pass `--standalone` to build the registry in-process instead. When `npx @agent-native/core@latest mcp install` detects a hosted origin (a non-localhost `APP_URL` / `BETTER_AUTH_URL` / `AGENT_NATIVE_MCP_URL` in the workspace `.env`), it writes an `http` client entry pointing at `<origin>/mcp` with a `Bearer` JWT instead of a stdio entry.
 
 Companion subcommands:
 
@@ -725,7 +736,7 @@ You can also write the host's MCP config by hand against any deployed endpoint w
   "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>" },
     },
   },
@@ -767,7 +778,7 @@ Full-app embeds also avoid handing the MCP bearer token to the browser. The MCP
 The fallback hosted `connect` flow never copies the deployment's shared secret. Instead:
 
 - A logged-in browser session mints a **per-user, scoped, revocable** token — an `A2A_SECRET`-signed JWT carrying the caller's `sub` + `org_domain` and a unique `jti`, so every tool run stays tenant-scoped via `runWithRequestContext`.
-- The existing `/_agent-native/mcp` endpoint accepts that token like any other bearer (see [MCP Server](/docs/mcp-protocol)) — no new endpoint, no new transport.
+- The existing `/mcp` endpoint accepts that token like any other bearer (see [MCP Server](/docs/mcp-protocol)) — no new endpoint, no new transport.
 - The same Connect page lists every token you've minted and lets you **revoke** any of them by `jti`. Treat them like personal access tokens: one per agent client, revoke when a machine is decommissioned.
 - The deep link the agent hands back carries no privileged state. The record-focusing `navigate` write is always scoped to the **browser** session, never the agent's token — so a link is safe to paste into a terminal or chat transcript.
 

package/corpus/core/docs/content/locales/ar-SA/actions.mdx

@@ -538,7 +538,7 @@ pnpm action reply-to-email '{"emailId":"thread-123","body":"Thanks!"}'
 
 ## تعريضه على MCP {#mcp}
 
-مع تمكين MCP، تظهر actions في خادم MCP الخاص بالإطار في `/_agent-native/mcp`. يحصل كل متصل على كتالوج مضغوط بشكل افتراضي - عناصر مدمجة تواجه التطبيق بالإضافة إلى التطبيق المعلن عن القالب actions - و`tool-search` موجود دائمًا بحيث تظل أي أداة أخرى قابلة للوصول عند الطلب. يتم تقديم سطح الإجراء الكامل فقط عند الاشتراك الصريح (الرمز المميز `--full-catalog` أو `AGENT_NATIVE_MCP_FULL_CATALOG=1`)، ويختار `publicAgent.expose` أداة قراءة/الاستيعاب الآمنة على السطح العام. راجع [MCP Protocol](/docs/mcp-protocol) للتعرف على طبقات الكتالوج والمصادقة وتفاصيل موارد `mcpApp`.
+مع تمكين MCP، تظهر actions في خادم MCP الخاص بالإطار في `/mcp`. يحصل كل متصل على كتالوج مضغوط بشكل افتراضي - عناصر مدمجة تواجه التطبيق بالإضافة إلى التطبيق المعلن عن القالب actions - و`tool-search` موجود دائمًا بحيث تظل أي أداة أخرى قابلة للوصول عند الطلب. يتم تقديم سطح الإجراء الكامل فقط عند الاشتراك الصريح (الرمز المميز `--full-catalog` أو `AGENT_NATIVE_MCP_FULL_CATALOG=1`)، ويختار `publicAgent.expose` أداة قراءة/الاستيعاب الآمنة على السطح العام. راجع [MCP Protocol](/docs/mcp-protocol) للتعرف على طبقات الكتالوج والمصادقة وتفاصيل موارد `mcpApp`.
 
 بالنسبة للمضيفين MCP القادرين على UI، يمكن للإجراء الإعلان عن مورد MCP Apps الاختياري عبر حقل `mcpApp` (بالإضافة إلى `link` المطابق) بحيث يعرض المضيفون القادرون النتيجة بشكل مضمن. عندما يشير `link` و`mcpApp` إلى نفس المسار، فإن `embedRoute()` يبني كليهما من منشئ مسار خالص واحد:
 

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