@agent-native/core 0.98.16 → 0.99.0

package/docs/content/locales/zh-CN/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 是邮件、日历、分析、Brain 和您的单一网关
@@ -109,12 +109,12 @@ Dispatch 是邮件、日历、分析、Brain 和您的单一网关
 对于一个有意隔离的应用，请直接使用该应用：
 
 ```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 代码、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` 查找给定主机和选定客户端的 URL 以 `/_agent-native/mcp` 结尾的任何 MCP 配置条目（通过 URL 进行匹配，无论连接器名称如何），然后刷新或替换身份验证材料，而无需触及已安装的 skills 或重新运行完整安装流程。传递基本应用程序 URL（例如 `https://plan.agent-native.com`） - 推断出 `/_agent-native/mcp` 后缀。身份验证和工具加载是针对每个客户端的，因此之后重新启动/重新加载该客户端； Codex 在新加载的工具出现之前需要一个新会话。
+`reconnect` 查找给定主机和选定客户端的 URL 以 `/mcp` 结尾的任何 MCP 配置条目（通过 URL 进行匹配，无论连接器名称如何），然后刷新或替换身份验证材料，而无需触及已安装的 skills 或重新运行完整安装流程。传递基本应用程序 URL（例如 `https://plan.agent-native.com`） - 推断出 `/mcp` 后缀。身份验证和工具加载是针对每个客户端的，因此之后重新启动/重新加载该客户端； Codex 在新加载的工具出现之前需要一个新会话。
 
 在Claude代码中，等效的UI路径是：运行`/mcp`并为相关连接器选择**身份验证**（或**重新连接**）。
 
@@ -245,7 +245,7 @@ npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --clien
 
 ### 连接页面后备 {#connect-page-fallback}
 
-对于无法直接添加远程 OAuth URL 的 MCP 客户端，请在浏览器中打开应用程序并使用其 **Connect** 功能（在 `https://&lt;app&gt;/_agent-native/mcp/connect` 上提供）。登录后，单击“**连接/授权**”。该页面为您提供一个配置检测到的代理的一键深层链接，或一个可立即粘贴的 `.mcp.json` 块：
+对于无法直接添加远程 OAuth URL 的 MCP 客户端，请在浏览器中打开应用程序并使用其 **Connect** 功能（在 `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
 ```
 
 这与 `npx @agent-native/core@latest connect https://dispatch.agent-native.com --client claude-code` 为您编写的仅 URL 条目相同。然后在Claude代码中运行`/mcp`并选择**验证**。客户端从 MCP 服务器的 `401 WWW-Authenticate` 挑战中发现身份验证，获取 `/.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 应用程序 iframe 启动的 `tools/call` 都通过与现有连接铸造的 JWT 路径相同的 `runWithRequestContext` 租户范围运行。 iframe 从不接收原始 OAuth 令牌；主机通过经过身份验证的 MCP 连接来调解呼叫。
@@ -499,13 +499,13 @@ CSP 和沙箱权限等安全元数据存在于资源中
 
 在每个操作工具之上，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` 禁用整个设置。
 
@@ -513,6 +513,10 @@ CSP 和沙箱权限等安全元数据存在于资源中
 
 对于快速 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`。使用返回的 `app` 和 `taskId` 通过 `ask_app_status` 进行轮询；结果中包含 `pollAfterMs`，作为对主机友好的轮询间隔。任务必须在第一次响应超时之前就已创建，因此仅在长时间调用之后才返回的轮询 URL 并不是可靠的恢复约定。
+
 ### 每应用游览 {#tour}
 
 每个生成或列出可导航资源的允许列表模板都会附带一个 `link` 构建器，而摄取量大的模板会附带一个 GET + `publicAgent` 操作，以便连接的代理可以提取实时状态：
@@ -676,7 +680,7 @@ npx @agent-native/core@latest mcp install --client claude-code|claude-code-cli|c
 - **cowork** — `~/.cowork/mcp.json` 中相同的 Claude 代码 JSON 形状。
 - **codex** — `~/.codex/config.toml` 中的 `[mcp_servers.<name>]` 区块。
 
-该条目运行 `npx @agent-native/core@latest mcp serve --app <id>`，默认情况下，它是正在运行的本地应用程序的 `/_agent-native/mcp` 的 **瘦 stdio 代理** - 因此，实时操作注册表、HMR 和正确的深层链接仍然是单一事实来源。通过 `--standalone` 来在进程中构建注册表。当 `npx @agent-native/core@latest mcp install` 检测到托管源（工作区 `.env` 中的非本地主机 `APP_URL` / `BETTER_AUTH_URL` / `AGENT_NATIVE_MCP_URL`）时，它会写入指向 `<origin>/_agent-native/mcp` 的 `http` 客户端条目，并使用 `Bearer` JWT 而不是 stdio 条目。
+该条目运行 `npx @agent-native/core@latest mcp serve --app <id>`，默认情况下，它是正在运行的本地应用程序的 `/mcp` 的 **瘦 stdio 代理** - 因此，实时操作注册表、HMR 和正确的深层链接仍然是单一事实来源。通过 `--standalone` 来在进程中构建注册表。当 `npx @agent-native/core@latest mcp install` 检测到托管源（工作区 `.env` 中的非本地主机 `APP_URL` / `BETTER_AUTH_URL` / `AGENT_NATIVE_MCP_URL`）时，它会写入指向 `<origin>/mcp` 的 `http` 客户端条目，并使用 `Bearer` JWT 而不是 stdio 条目。
 
 配套子命令：
 
@@ -700,7 +704,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>" },
     },
   },
@@ -742,7 +746,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)） - 没有新端点，没有新传输。
 - 同一个 Connect 页面列出了您铸造的每个代币，并允许您通过 `jti` **撤销**其中任何代币。将它们视为个人访问令牌：每个代理客户端一个，在机器退役时撤销。
 - 代理返还的深层链接不带有特权状态。以记录为中心的 `navigate` 写入始终限于 **浏览器** 会话，而不是代理的令牌 - 因此可以安全地将链接粘贴到终端或聊天记录中。
 

package/docs/content/locales/zh-CN/mcp-clients.mdx

@@ -245,6 +245,29 @@ MCP 工具仅在 Node 运行时激活 - Cloudflare Workers 和其他边缘
 
 MCP（模型上下文协议）服务器为您的代理提供新的能力 - 例如连接到 Zapier、Cloudflare、Composio 或您公司的内部工具。连接后，代理可以像使用内置工具一样使用这些工具。
 
+预设 ID 包括 `context7`、`sentry`、`notion`、`semgrep`、`linear`、
+`atlassian`、`supabase`、`neon` 和 `stripe`。
+
+### Atlassian / Jira
+
+Atlassian 预设使用 Atlassian Rovo MCP 的 OAuth 2.1 端点
+`https://mcp.atlassian.com/v1/mcp/authv2`，并提供 Jira 和 Confluence
+工具。创建 Jira 工单需要具备允许写入 Jira 的 Atlassian 权限；用户仍然只能
+看到其 Atlassian 帐户有权访问的项目和内容。
+
+Atlassian 组织管理员可以控制是否允许 OAuth 客户端连接。连接之前，管理员可能
+需要将应用的实际 HTTPS 源添加到 **Atlassian Administration → Rovo →
+Rovo MCP server → Domains** 下的受信任域列表，并在 **Permissions** 中启用
+所需的 **Read**、**Write** 和 **Search** 权限。该域必须是 Agent-Native
+应用实际运行的主机；除非 `https://builder.io/**` 是部署的实际源，否则不要将其
+复制到其他部署。请参阅 Atlassian 的 [Rovo MCP 设置指南](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/)。
+
+目录会提供端点和设置指导。通用设置表单会存储端点和可选的加密标头，但无法取代
+Atlassian 的交互式 OAuth 同意流程。当 Atlassian 要求交互式 OAuth 时，请使用
+支持 OAuth 的 MCP 客户端或运行时。如果提供商或运行时支持静态 Bearer 令牌，
+请遵循其批准的密钥管理流程，切勿将令牌粘贴到提示词或已提交的配置中。
+
 ### 如何连接远程MCP服务器
 
 1. **服务器名称** - 供您自己参考的简短标签（例如“zapier”、“slack-tools”）。
@@ -263,7 +286,7 @@ MCP（模型上下文协议）服务器为您的代理提供新的能力 - 例
 
 在正在运行的 MCP 管理器中添加和删除热重载 — 无需重新启动进程，也无需重新启动服务器。新的 `mcp__<scope>-<name>__*` 工具将在下一条消息中向客服人员显示，并且可通过 `tool-search` 进行搜索。
 
-HTTPS URL 在任何地方都被接受； plain `http://` 在开发过程中仅允许用于 `localhost`。可选的身份验证作为不记名令牌在每个请求上通过 `Authorization: Bearer …` 发送。
+HTTPS URL 在任何地方都被接受； plain `http://` 在开发过程中仅允许用于 `localhost`。可选的身份验证作为不记名令牌在每个请求上通过 `Authorization: Bearer …` 发送。仅支持 OAuth 的提供商（包括 Atlassian Rovo MCP）必须使用提供商的 OAuth 流程，而不能使用静态标头。
 
 在底层，这些服务器以 `u:<email>:mcp-servers-remote`（个人）或 `o:<orgId>:mcp-servers-remote`（团队）键保存在框架的 `settings` 表中，并在启动时与 `mcp.config.json` 合并。
 
@@ -292,7 +315,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 +479,7 @@ Reports which configured servers connected, the total live tool count, the merge
 
 个别 MCP 服务器故障永远不会导致代理关闭：
 
-- 配置错误的 `command` → 服务器被跳过，其错误出现在 `errors.<server-id>` 下的 `/mcp/status` 中，而其他所有服务器继续工作。
+- 配置错误的 `command` → 服务器被跳过，其错误出现在 `errors.<server-id>` 下的 `/_agent-native/mcp/status` 中，而其他所有服务器继续工作。
 - `node_modules` 中缺少 MCP SDK → 所有 MCP 功能都会被跳过并出现警告；代理聊天可以使用零 MCP 工具继续工作。
 - 在边缘运行时中运行 → MCP 客户端是无操作的。
 

package/docs/content/locales/zh-CN/mcp-protocol.mdx

@@ -22,7 +22,7 @@ MCP 是用于将 AI 工具连接到外部功能的标准协议。当您部署代
 
 关键概念：
 
-- **自动安装** — 每个应用都免费获得 `/_agent-native/mcp`，无需设置
+- **自动安装** — 每个应用都免费获得 `/mcp`，无需设置
 - **Streamable HTTP** — 在标准 HTTP (POST + SSE) 上使用现代 MCP 传输
 - **相同的 actions** — 为代理聊天和 A2A 提供支持的完全相同的操作注册表
 - **`ask-agent` 工具** — 一种元工具，可委托给完整代理循环来执行复杂任务
@@ -41,7 +41,7 @@ MCP 是用于将 AI 工具连接到外部功能的标准协议。当您部署代
   </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 是用于将 AI 工具连接到外部功能的标准协议。当您部署代
 | **最适合**   | 调用您的应用的外部工具                                              | 代理间通信                             |
 | **协议**     | 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 是用于将 AI 工具连接到外部功能的标准协议。当您部署代
 对于建议的单命令设置，请使用 [External Agents](/docs/external-agents)。如果您为支持 OAuth 的客户端手写 MCP 配置，请将您的应用添加为不带静态标头的远程 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
 任何支持 Streamable HTTP 传输的 MCP 客户端都可以连接。端点是：
 
 ```
-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-1mrk9b2" 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-1mrk9b2" 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` 元工具。这会向应用程序的 AI 代理发送一条自然语言消息并返回响应。
 
+托管 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
+  }
+}
+```
+
+代理运行与交互式聊天相同的循环 - 它可以调用多个工具、推理上下文并生成深思熟虑的响应。尚未完成的任务会返回包含 `taskId`、`status`、`pollAfterMs` 的 JSON，以及：
+
+```json
+{
+  "poll": {
+    "tool": "ask_app_status",
+    "arguments": { "app": "mail", "taskId": "task_123" }
   }
 }
 ```
 
-代理运行与交互式聊天相同的循环 - 它可以调用多个工具、推理上下文并生成深思熟虑的响应。
+使用这些参数调用 `ask_app_status` 进行轮询，直到任务达到终态。Dispatch 中应用自持的 `ask_app` 使用相同的持久任务和状态约定，在提交和轮询时都会检查所选应用的授权。
 
 ## 身份验证 {#authentication}
 
@@ -233,7 +247,7 @@ MCP 端点支持标准远程 MCP OAuth 以及现有的不记名令牌后备：
 对于支持 OAuth 的 MCP 主机，配置不带静态标头的远程服务器 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-bp55uo" 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/zh-CN/plan-plugin.mdx

@@ -12,7 +12,7 @@ Agent-Native **Plan** 应用以一个可安装的 bundle 提供。一次安装
 一次安装即可为您提供：
 
 - **三个 skills** — `/visual-plan`（规范入口点）、`/visual-recap` 和 `/visualize-repo`。
-- **计划 MCP 连接器** — 针对 `https://plan.agent-native.com` 上的托管应用程序进行注册（MCP 端点 `https://plan.agent-native.com/_agent-native/mcp`，服务器名称 `plan`）。
+- **计划 MCP 连接器** — 针对 `https://plan.agent-native.com` 上的托管应用程序进行注册（MCP 端点 `https://plan.agent-native.com/mcp`，服务器名称 `plan`）。
 
 <Diagram id="doc-block-xt4mmz" title={"三条路线，一揽子"} summary={"通用 CLI、Claude Code 插件和 Codex 插件都会安装同一组 Plan skills 以及托管的 Plan 连接器。"}>
 
@@ -41,7 +41,7 @@ Agent-Native **Plan** 应用以一个可安装的 bundle 提供。一次安装
   <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>
@@ -249,7 +249,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，为 Codex 运行 `npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex`，或者与您的目标 `--client` 运行相同的命令，则将其合并为规范的 `plan` 名称。
 

package/docs/content/locales/zh-CN/server.mdx

@@ -265,7 +265,7 @@ export default runMigrations(
 | `/_agent-native/extensions/*`    | 运行时扩展和扩展代理（旧别名：`/_agent-native/tools/*`） |
 | `/_agent-native/integrations/*`  | 消息传递/webhook 集成                                    |
 | `/_agent-native/a2a`             | 代理到代理 JSON-RPC                                      |
-| `/_agent-native/mcp`             | MCP端点                                                  |
+| `/mcp`                           | MCP端点                                                  |
 | `/_agent-native/onboarding/*`    | 设置清单                                                 |
 | `/_agent-native/observability/*` | 跟踪、反馈、评估、实验                                   |
 | `/_agent-native/file-upload`     | 文件上传提供程序端点                                     |
@@ -460,4 +460,4 @@ const handler = createProductionAgentHandler({
 - [**数据库**](/docs/database) — 自定义路由和 actions 都会导入的 `getDb()`/`schema` 模式
 - [**安全**](/docs/security#access-guards) — `accessFilter`/`assertAccess` 和完整的数据作用域模型
 - [**消息传递**](/docs/messaging) — 入站 webhook 的标准集成队列模式
-- [**MCP 协议**](/docs/mcp-protocol) — 此服务器自动挂载的 `/_agent-native/mcp` 端点
+- [**MCP 协议**](/docs/mcp-protocol) — 此服务器自动挂载的 `/mcp` 端点

package/docs/content/locales/zh-CN/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/zh-CN/template-assets.mdx

@@ -487,7 +487,7 @@ Codex、Claude 代码和 Claude 桌面代码应被视为链接输出主机
 ### 开发者：分发应用技能
 
 资产应用技能的应用 ID为 `assets` 并托管 MCP URL
-`https://assets.agent-native.com/_agent-native/mcp`.
+`https://assets.agent-native.com/mcp`.
 
 ```bash
 # 最简单的托管安装：导出的技能说明加上 MCP 连接器。

package/docs/content/locales/zh-CN/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 服务器列表。另外，对于 Claude、ChatGPT 和其他应访问多个工作区应用的主机，Dispatch 自己的 `/_agent-native/mcp` 端点是推荐的外部 MCP 连接器。
+- **MCP 集线器模式。** Dispatch 仍然可以充当工作区的 [MCP hub](/docs/mcp-clients#hub)，因此工作区中的每个其他应用程序都会拉取相同的组织范围 MCP 服务器列表。另外，对于 Claude、ChatGPT 和其他应访问多个工作区应用的主机，Dispatch 自己的 `/mcp` 端点是推荐的外部 MCP 连接器。
 
 ## 梦想 {#dreams}
 

package/docs/content/locales/zh-CN/template-plan.mdx

@@ -110,7 +110,7 @@ npx @agent-native/core@latest skills add visual-plan
 
 如果您使用的是直接接受 MCP 连接器 URL 的基于聊天的主机
 （而不是 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) 以了解特定于客户端的设置。
 
 身份验证是在设置时进行一次性浏览器登录 - 这是有意为之的
 是让代理持续存在并共享其生成的计划的原因。授权是什么
@@ -249,7 +249,7 @@ vscode://builder.agent-native/open?url=<encoded-plan-url>
   跨设备或团队审核）需要登录。Google 登录会在以下情况出现
   标准 Google OAuth 环境变量已配置。
 
-托管计划连接器位于 `https://plan.agent-native.com/_agent-native/mcp`。
+托管计划连接器位于 `https://plan.agent-native.com/mcp`。
 切勿将共享机密放入技能文件中。
 
 ## 本地文件隐私模式 {#local-files}
@@ -447,7 +447,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/zh-TW/actions.mdx

@@ -536,7 +536,7 @@ JSON 輸入是代理和複雜物件的首選形狀。標誌是
 
 ## 透過 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` 資源詳細資訊。
 
 對於支援 UI 的 MCP 主機，操作可以透過 `mcpApp` 欄位（加上匹配的 `link`）聲明可選的 MCP Apps 資源，以便有能力的主機行內渲染結果。當 `link` 和 `mcpApp` 應指向同一路由時，`embedRoute()` 從一個純路徑建置器建置兩者：
 

package/docs/content/locales/zh-TW/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 請求返回指向 `/.well-known/oauth-protected-resource` 的 `WWW-Authenticate` 質詢。然後，用戶端發現應用程式的 OAuth 中繼資料，動態註冊公開用戶端，開啟應用程式的授權頁面，並與 PKCE 交換授權程式碼以取得存取和重新整理權杖。

package/docs/content/locales/zh-TW/dispatch.mdx

@@ -113,16 +113,16 @@ Dispatch 自動發現工作區中的其他應用程式作為 A2A 對等體 - 無
 
 ### 統一 MCP 閘道
 
-Dispatch 可以是外部代理的單一 MCP 連線器：在 Claude、ChatGPT、Codex 或 Cursor 中新增一次 `https://dispatch.agent-native.com/_agent-native/mcp`，一次授權可到達每個授予的工作區應用程式，而不是每個應用程式一個連線器。請參閱 [External Agents](/docs/external-agents) 了解完整的連線流程、應用程式授權、OAuth 和行內 MCP 應用程式預覽。
+Dispatch 可以是外部代理的單一 MCP 連線器：在 Claude、ChatGPT、Codex 或 Cursor 中新增一次 `https://dispatch.agent-native.com/mcp`，一次授權可到達每個授予的工作區應用程式，而不是每個應用程式一個連線器。請參閱 [External Agents](/docs/external-agents) 了解完整的連線流程、應用程式授權、OAuth 和行內 MCP 應用程式預覽。
 
-<Endpoint id="doc-block-1ht5rye" 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-1ht5rye" 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/zh-TW/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 是郵件、行事曆、分析、Brain 和您的單一閘道
@@ -109,12 +109,12 @@ Dispatch 是郵件、行事曆、分析、Brain 和您的單一閘道
 對於一個有意隔離的應用，請直接使用該應用：
 
 ```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 程式碼、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` 尋找給定主機和選定用戶端的 URL 以 `/_agent-native/mcp` 結尾的任何 MCP 設定條目（透過 URL 進行匹配，無論連線器名稱如何），然後重新整理或替換驗證材料，而無需觸及已安裝的 skills 或重新執行完整安裝流程。傳遞基本應用程式 URL（例如 `https://plan.agent-native.com`） - 推斷出 `/_agent-native/mcp` 後綴。驗證和工具載入是針對每個用戶端的，因此之後重新啟動/重新載入該用戶端； Codex 在新載入的工具出現之前需要一個新工作階段。
+`reconnect` 尋找給定主機和選定用戶端的 URL 以 `/mcp` 結尾的任何 MCP 設定條目（透過 URL 進行匹配，無論連線器名稱如何），然後重新整理或替換驗證材料，而無需觸及已安裝的 skills 或重新執行完整安裝流程。傳遞基本應用程式 URL（例如 `https://plan.agent-native.com`） - 推斷出 `/mcp` 後綴。驗證和工具載入是針對每個用戶端的，因此之後重新啟動/重新載入該用戶端； Codex 在新載入的工具出現之前需要一個新工作階段。
 
 在 Claude 程式碼中，等效的 UI 路徑是：執行`/mcp`並為相關連線器選取**驗證**（或**重新連線**）。
 
@@ -245,7 +245,7 @@ npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --clien
 
 ### 連線頁面後備 {#connect-page-fallback}
 
-對於無法直接新增遠端 OAuth URL 的 MCP 用戶端，請在瀏覽器中開啟應用程式並使用其 **Connect** 功能（在 `https://&lt;app&gt;/_agent-native/mcp/connect` 上提供）。登入後，點選“**連線/授權**”。該頁面為您提供一個設定偵測到的代理的一鍵深層連結，或一個可立即貼上的 `.mcp.json` 塊：
+對於無法直接新增遠端 OAuth URL 的 MCP 用戶端，請在瀏覽器中開啟應用程式並使用其 **Connect** 功能（在 `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
 ```
 
 這與 `npx @agent-native/core@latest connect https://dispatch.agent-native.com --client claude-code` 為您編寫的僅 URL 條目相同。然後在 Claude 程式碼中執行`/mcp`並選取**驗證**。用戶端從 MCP 伺服器的 `401 WWW-Authenticate` 質詢中發現驗證，取得 `/.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 應用程式 iframe 啟動的 `tools/call` 都透過與現有連線鑄造的 JWT 路徑相同的 `runWithRequestContext` 租戶範圍執行。 iframe 從不接收原始 OAuth 權杖；主機透過經過驗證的 MCP 連線來調解呼叫。
@@ -499,13 +499,13 @@ CSP 和沙箱權限等安全中繼資料存在於資源中
 
 在每個操作工具之上，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` 停用整個設定。
 
@@ -513,6 +513,10 @@ CSP 和沙箱權限等安全中繼資料存在於資源中
 
 對於快速 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`。請使用傳回的 `app` 與 `taskId` 呼叫 `ask_app_status` 進行輪詢；結果包含 `pollAfterMs` 作為對主機友善的輪詢間隔。任務必須在第一次回應逾時之前就已建立，因此僅在長時間呼叫後才傳回輪詢網址並非可靠的復原機制。
+
 ### 每應用游覽 {#tour}
 
 每個生成或列出可導覽資源的允許清單範本都會附帶一個 `link` 建置器，而攝取量大的範本會附帶一個 GET + `publicAgent` 操作，以便連線的代理可以擷取即時狀態：
@@ -676,7 +680,7 @@ npx @agent-native/core@latest mcp install --client claude-code|claude-code-cli|c
 - **cowork** — `~/.cowork/mcp.json` 中相同的 Claude 程式碼 JSON 形狀。
 - **codex** — `~/.codex/config.toml` 中的 `[mcp_servers.<name>]` 區塊。
 
-該條目執行 `npx @agent-native/core@latest mcp serve --app <id>`，預設情況下，它是正在執行的本機應用程式的 `/_agent-native/mcp` 的 **瘦 stdio 代理** - 因此，即時操作註冊表、HMR 和正確的深層連結仍然是單一事實來源。透過 `--standalone` 來在行程中建置註冊表。當 `npx @agent-native/core@latest mcp install` 偵測到託管來源（工作區 `.env` 中的非本機主機 `APP_URL` / `BETTER_AUTH_URL` / `AGENT_NATIVE_MCP_URL`）時，它會寫入指向 `<origin>/_agent-native/mcp` 的 `http` 用戶端條目，並使用 `Bearer` JWT 而不是 stdio 條目。
+該條目執行 `npx @agent-native/core@latest mcp serve --app <id>`，預設情況下，它是正在執行的本機應用程式的 `/mcp` 的 **瘦 stdio 代理** - 因此，即時操作註冊表、HMR 和正確的深層連結仍然是單一事實來源。透過 `--standalone` 來在行程中建置註冊表。當 `npx @agent-native/core@latest mcp install` 偵測到託管來源（工作區 `.env` 中的非本機主機 `APP_URL` / `BETTER_AUTH_URL` / `AGENT_NATIVE_MCP_URL`）時，它會寫入指向 `<origin>/mcp` 的 `http` 用戶端條目，並使用 `Bearer` JWT 而不是 stdio 條目。
 
 配套子指令：
 
@@ -700,7 +704,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>" },
     },
   },
@@ -742,7 +746,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)） - 沒有新端點，沒有新傳輸。
 - 同一個 Connect 頁面列出了您鑄造的每個代幣，並允許您透過 `jti` **撤銷**其中任何代幣。將它們視為個人存取權杖：每個代理用戶端一個，在機器退役時撤銷。
 - 代理返還的深層連結不帶有特權狀態。以紀錄為中心的 `navigate` 寫入始終限於 **瀏覽器** 工作階段，而不是代理的權杖 - 因此可以安全地將連結貼上到終端或聊天紀錄中。