@agent-native/core 0.98.17 → 0.99.0

package/corpus/core/docs/content/locales/ja-JP/external-agents.mdx

@@ -98,7 +98,7 @@ Agent-Native を使用するホストにリモート MCP コネクタを 1 つ
 ワークスペースまたはクロスアプリ作業の場合は、Dispatch を使用します。
 
 ```text
-https://dispatch.agent-native.com/_agent-native/mcp
+https://dispatch.agent-native.com/mcp
 ```
 
 Dispatch は、メール、カレンダー、分析、脳、そしてあなたの
@@ -109,12 +109,12 @@ Dispatch は、メール、カレンダー、分析、脳、そしてあなた
 意図的に分離された 1 つのアプリの場合、そのアプリを直接使用します。
 
 ```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 で一致) について、URL が `/_agent-native/mcp` で終わる MCP 構成エントリを検索し、インストールされている skills に手を触れたり、完全なインストール フローを再実行したりすることなく、認証マテリアルを更新または置換します。ベースアプリ URL (例: `https://plan.agent-native.com`) を渡します — `/_agent-native/mcp` サフィックスが推測されます。認証とツールの読み込みはクライアントごとに行われるため、後でそのクライアントを再起動/再読み込みします。 Codex は、新しくロードされたツールが表示される前に、新しいセッションが必要です。
+`reconnect` は、指定されたホストおよび選択されたクライアント (コネクタ名に関係なく、URL で一致) について、URL が `/mcp` で終わる MCP 構成エントリを検索し、インストールされている skills に手を触れたり、完全なインストール フローを再実行したりすることなく、認証マテリアルを更新または置換します。ベースアプリ URL (例: `https://plan.agent-native.com`) を渡します — `/mcp` サフィックスが推測されます。認証とツールの読み込みはクライアントごとに行われるため、後でそのクライアントを再起動/再読み込みします。 Codex は、新しくロードされたツールが表示される前に、新しいセッションが必要です。
 
 Claude コードでは、同等の UI パスは次のとおりです: `/mcp` を実行し、関連するコネクタに対して **認証** (または **再接続**) を選択します。
 
@@ -245,7 +245,7 @@ Claude コードでは、同等の UI パスは次のとおりです: `/mcp` を
 
 ### ページのフォールバック接続 {#connect-page-fallback}
 
-リモート OAuth URL を直接追加できない MCP クライアントの場合は、ブラウザでアプリを開いて、**接続** アフォーダンス (`https://&lt;app&gt;/_agent-native/mcp/connect` で提供) を使用します。ログインした状態で、**接続 / 認証** をクリックします。このページでは、検出されたエージェントを構成するワンクリックのディープ リンク、またはすぐに貼り付けられる `.mcp.json` ブロックのいずれかを提供します。
+リモート OAuth URL を直接追加できない MCP クライアントの場合は、ブラウザでアプリを開いて、**接続** アフォーダンス (`https://&lt;app&gt;/mcp/connect` で提供) を使用します。ログインした状態で、**接続 / 認証** をクリックします。このページでは、検出されたエージェントを構成するワンクリックのディープ リンク、またはすぐに貼り付けられる `.mcp.json` ブロックのいずれかを提供します。
 
 ```jsonc
 // .mcp.json
@@ -253,7 +253,7 @@ Claude コードでは、同等の UI パスは次のとおりです: `/mcp` を
   "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 @@ Claude コードでは、同等の UI パスは次のとおりです: `/mcp` を
 
 ```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 にオーディエンス バインドされ、署名されたユーザー/組織 ID を保持するため、ツール呼び出し、`resources/read`、および MCP アプリ iframe で開始された `tools/call` はすべて、既存の接続ミント JWT パスと同じ `runWithRequestContext` テナント スコープを通じて実行されます。 iframe は生の OAuth トークンを受信しません。ホストは、認証された MCP 接続を通じて通話を仲介します。
@@ -500,13 +500,13 @@ ChatGPT/Claude スタイルの OAuth アプリ ホストの場合、検出サー
 
 アクションごとのツールに加えて、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? })`    | エージェント ループ | 自然言語タスクをそのアプリのアプリ内エージェントにルーティングします。長時間の処理では、`ask_app_status` でポーリングするための永続的な `taskId` を返します |
+| `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 @@ ChatGPT/Claude スタイルの OAuth アプリ ホストの場合、検出サー
 
 高速 ChatGPT/Claude ハンドオフの場合、理想的なパスは直接パスです。アーティファクトを作成または開くアクションを呼び出してから、MCP アプリにルートを起動させます。 Mail リクエストは `manage_draft` を呼び出し、実際の作成ルートをレンダリングする必要があります。ダッシュボード リクエストでは、`open_app({ path, embed: true })` を呼び出すか、`mcpApp` を使用してダッシュボード アクションを呼び出し、完全な Analytics ルートをレンダリングする必要があります。カレンダー、フォーム、コンテンツ、スライド、デザイン、クリップは、下書き/作成/検索 actions と同じパターンに従う必要があります。 `list_apps` は、モデルが許可されたアプリの中から選択する必要がある場合に便利です。広範な `resources/list`、フルカタログ検出、または `ask_app` 委任は、明らかな UI ハンドオフの通常のルートであってはなりません。
 
+### 長時間実行されるエージェント リクエスト
+
+MCP ホストとゲートウェイは、単一の長いツール呼び出しタイムアウトを共有していません。5 分の上限を課すものもあれば、設定可能なものもあります。10 分間ブロックする `tools/call` を前提に外部エージェント連携を設計しないでください。 `ask-agent` と `ask_app` はホストされている処理をすぐに確認応答し、インライン待機が期限切れになると永続的な `taskId` を返します。返された `app` と `taskId` を使用して `ask_app_status` でポーリングしてください。結果にはホストにとって扱いやすい間隔として `pollAfterMs` が含まれます。タスクは最初のレスポンスがタイムアウトする前に作成されている必要があるため、長い呼び出しの後にのみ返されるポーリング URL は信頼できる復旧手段ではありません。
+
 ### アプリごとのツアー {#tour}
 
 ナビゲート可能なリソースを生成またはリストする許可リストに登録されたすべてのテンプレートには `link` ビルダーが同梱されており、取り込みが多いテンプレートには GET + `publicAgent` アクションが同梱されているため、接続されたエージェントはライブ状態を取得できます。
@@ -677,7 +681,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`) を検出すると、stdio エントリの代わりに、`Bearer` JWT を持つ `<origin>/_agent-native/mcp` を指す `http` クライアント エントリを書き込みます。
+このエントリは `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`) を検出すると、stdio エントリの代わりに、`Bearer` JWT を持つ `<origin>/mcp` を指す `http` クライアント エントリを書き込みます。
 
 コンパニオンサブコマンド:
 
@@ -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` フローは、展開の共有秘密をコピーしません。代わりに:
 
 - ログインしたブラウザ セッションは、**ユーザーごとのスコープ指定された取り消し可能な** トークン (呼び出し元の `sub` + `org_domain` および一意の `jti` を保持する `A2A_SECRET` 署名付き JWT) を生成するため、すべてのツールの実行は `runWithRequestContext` を介してテナント スコープのままになります。
-- 既存の `/_agent-native/mcp` エンドポイントは、他のベアラーと同様にそのトークンを受け入れます ([MCP Protocol](/docs/mcp-protocol) を参照)。新しいエンドポイントや新しいトランスポートはありません。
+- 既存の `/mcp` エンドポイントは、他のベアラーと同様にそのトークンを受け入れます ([MCP Protocol](/docs/mcp-protocol) を参照)。新しいエンドポイントや新しいトランスポートはありません。
 - 同じ接続ページには、作成したすべてのトークンがリストされ、`jti` によってそれらのトークンを**取り消す**ことができます。それらを個人用アクセス トークンのように扱います。エージェント クライアントごとに 1 つ、マシンが廃止されると取り消されます。
 - エージェントが返すディープリンクには特権状態はありません。レコードに焦点を当てた `navigate` 書き込みは常に **ブラウザ** セッションにスコープされ、エージェントのトークンにはスコープされません。そのため、リンクをターミナルまたはチャット記録に安全に貼り付けることができます。
 

package/corpus/core/docs/content/locales/ja-JP/mcp-clients.mdx

@@ -246,6 +246,35 @@ MCP ツールはノード ランタイムでのみ有効になります — Clou
 
 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 クライアントまたはランタイムを
+使用してください。プロバイダーまたはランタイムが静的ベアラー トークンに
+対応している場合は、承認済みのシークレット管理手順に従い、プロンプトや
+コミット対象の設定にトークンを貼り付けないでください。
+
 ### リモート MCP サーバーに接続する方法
 
 1. **サーバー名** — 独自の参照用の短いラベル (例: "zapier"、"slack-tools")。
@@ -264,7 +293,7 @@ MCP (モデル コンテキスト プロトコル) サーバーは、Zapier、Cl
 
 実行中の MCP マネージャーにホットリロードを追加および削除します。プロセスの再起動やサーバーの再起動はありません。新しい `mcp__<scope>-<name>__*` ツールは次のメッセージでエージェントに表示され、`tool-search` 経由で検索できます。
 
-HTTPS URL はどこでも受け入れられます。プレーン `http://` は、開発中に `localhost` に対してのみ許可されます。オプションの認証は、リクエストごとに `Authorization: Bearer …` 経由で送信されるベアラー トークンとして入力されます。
+HTTPS URL はどこでも受け入れられます。プレーン `http://` は、開発中に `localhost` に対してのみ許可されます。オプションの認証は、リクエストごとに `Authorization: Bearer …` 経由で送信されるベアラー トークンとして入力されます。Atlassian Rovo MCP を含む OAuth 専用プロバイダーでは、静的ヘッダーではなく、プロバイダーの OAuth フローを使用する必要があります。
 
 内部では、これらのサーバーはキー `u:<email>:mcp-servers-remote` (個人) または `o:<orgId>:mcp-servers-remote` (チーム) の下でフレームワークの `settings` テーブルに保存され、起動時に `mcp.config.json` とマージされます。
 
@@ -293,7 +322,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>
@@ -455,7 +486,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` に表示され、他のすべてのサーバーは引き続き動作します。
 - MCP SDK が `node_modules` にありません → すべての MCP 機能が警告とともにスキップされます。エージェント チャットは、MCP ツールを使用しなくても機能し続けます。
 - エッジ ランタイムで実行 → MCP クライアントは何もしません。
 

package/corpus/core/docs/content/locales/ja-JP/mcp-protocol.mdx

@@ -22,7 +22,7 @@ MCP は、AI ツールを外部機能に接続するための標準プロトコ
 
 重要な概念:
 
-- **自動マウント** — すべてのアプリは無料で `/_agent-native/mcp` を入手でき、セットアップは必要ありません
+- **自動マウント** — すべてのアプリは無料で `/mcp` を入手でき、セットアップは必要ありません
 - **ストリーミング可能な 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 コード、カーソル、Codex、Cowork、およびその他の MCP ホスト | その他のエージェントネイティブ アプリ                |
 | **実行**           | 直接ツール呼び出し (追加の LLM なし)                                               | 完全なエージェント ループ (LLM 推論)                 |
 
@@ -105,7 +105,7 @@ MCP は、AI ツールを外部機能に接続するための標準プロトコ
 推奨される 1 つのコマンド セットアップでは、[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
 ストリーミング可能な 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-14spw6g" 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-14spw6g" 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 リクエストは境界のあるインライン待機を使用するため、長時間のエージェント ループが 1 つの `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-isdrqb" title={"OAuth 検出フロー"} summary={"401 によって検出、登録、PKCE による承認→トークン交換が開始されます。 Bearer トークンは、対象者に限定され、スコープが設定されています。"}>
 
@@ -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/ja-JP/plan-plugin.mdx

@@ -12,7 +12,7 @@ Agent-Native **Plan** アプリは、1 つのインストール可能なバン
 1 回のインストールで次のことが可能になります:
 
 - **3 つの 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-istfxt" title={"3つのルート、1つのバンドル"} summary={"ユニバーサル CLI、Claude Code プラグイン、Codex プラグインはいずれも、同じ Plan skills とホスト型 Plan コネクタをインストールします。"}>
 
@@ -43,7 +43,7 @@ Agent-Native **Plan** アプリは、1 つのインストール可能なバン
   <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 フローを実行します。インストールと認証を一緒に行う 1 つのコマンドを使用する場合、またはローカル ファイルまたはセルフホスト モードが必要な場合は、上記のユニバーサル 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 フローを実行します。インストールと認証を一緒に行う 1 つのコマンドを使用する場合、またはローカル ファイルまたはセルフホスト モードが必要な場合は、上記のユニバーサル CLI ルートは Codex (`npx @agent-native/core@latest skills add visual-plan --client codex`) にも機能します。
 
 > **古いインストール:** 構成に同じ URL を指す `agent-native-plans` エントリがまだある場合、Codex に対して `npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex` を実行するか、ターゲット `--client` で同じコマンドを実行すると、それが正規の `plan` 名に統合されます。
 

package/corpus/core/docs/content/locales/ja-JP/server.mdx

@@ -269,7 +269,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`     | ファイル アップロード プロバイダー エンドポイント                             |
@@ -463,4 +463,4 @@ const handler = createProductionAgentHandler({
 - [**Database**](/docs/database) — カスタムルートと Actions の両方がインポートする `getDb()`/`schema` パターン
 - [**Security**](/docs/security#access-guards) — `accessFilter`/`assertAccess` と完全なデータスコープモデル
 - [**Messaging**](/docs/messaging) — 受信 Webhook の標準的な統合キューパターン
-- [**MCP Protocol**](/docs/mcp-protocol) — このサーバーが自動的にマウントする `/_agent-native/mcp` エンドポイント
+- [**MCP Protocol**](/docs/mcp-protocol) — このサーバーが自動的にマウントする `/mcp` エンドポイント

package/corpus/core/docs/content/locales/ja-JP/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/ja-JP/template-assets.mdx

@@ -493,7 +493,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/corpus/core/docs/content/locales/ja-JP/template-dispatch.mdx

@@ -123,7 +123,7 @@ Dispatch は、管理者と運用担当者がワークスペースの稼働を
   生のシークレットをコピーせずにアクセスをディスパッチします。アプリ固有のソース
   設定は、プロバイダーを使用するアプリ内に残ります。
 - **1 つの MCP コネクタを公開します。** 追加
-  Claude、ChatGPT の `https://dispatch.agent-native.com/_agent-native/mcp`
+  Claude、ChatGPT の `https://dispatch.agent-native.com/mcp`
   Codex、カーソル、または別の MCP ホストから、どのワークスペース アプリを選択するかを選択します。
   コネクタは、Dispatch の **エージェント** ページからアクセスできます。直接アプリ URL を使用する
   そのホストを 1 つのアプリに分離する必要がある場合のみ。
@@ -304,7 +304,7 @@ _内部での仕組み (開発者向け)。_
   ]}
 />
 
-- **MCP ハブ モード。** Dispatch は引き続きワークスペースの [MCP hub](/docs/mcp-clients#hub) として機能できるため、ワークスペース内の他のすべてのアプリは同じ組織スコープの MCP サーバー リストを取得します。これとは別に、Dispatch 独自の `/_agent-native/mcp` エンドポイントは、複数のワークスペース アプリに接続する必要がある Claude、ChatGPT、およびその他のホストに推奨される外部 MCP コネクタです。
+- **MCP ハブ モード。** Dispatch は引き続きワークスペースの [MCP hub](/docs/mcp-clients#hub) として機能できるため、ワークスペース内の他のすべてのアプリは同じ組織スコープの MCP サーバー リストを取得します。これとは別に、Dispatch 独自の `/mcp` エンドポイントは、複数のワークスペース アプリに接続する必要がある Claude、ChatGPT、およびその他のホストに推奨される外部 MCP コネクタです。
 
 ## 夢 {#dreams}
 

package/corpus/core/docs/content/locales/ja-JP/template-plan.mdx

@@ -116,7 +116,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) を参照してください。
 
 認証はセットアップ時に 1 回限りのブラウザ サインインです。これは意図されたものであり、
 により、エージェントは永続化し、生成した計画を共有できるようになります。なんという認証
@@ -255,7 +255,7 @@ Codex、Claude コード、Markdown、または貼り付けられたプランが
   クロスデバイスまたはチームでのレビュー）にはサインインが必要です。Google サインインは次の場合に表示されます。
   標準の Google OAuth 環境変数が設定されています。
 
-ホストされたプラン コネクタは `https://plan.agent-native.com/_agent-native/mcp` にあります。
+ホストされたプラン コネクタは `https://plan.agent-native.com/mcp` にあります。
 スキル ファイルには共有シークレットを決して入れないでください。
 
 ## ローカル ファイル プライバシー モード {#local-files}
@@ -453,7 +453,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/ko-KR/actions.mdx

@@ -536,7 +536,7 @@ JSON 입력은 에이전트 및 복합 개체에 선호되는 모양입니다.
 
 ## MCP를 통해 노출 {#mcp}
 
-MCP를 활성화하면 actions가 프레임워크의 MCP 서버 `/_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. 전체 작업 표면은 명시적인 선택(`--full-catalog` 토큰 또는 `AGENT_NATIVE_MCP_FULL_CATALOG=1`)에서만 제공되며 `publicAgent.expose`는 공개 표면에서 안전한 읽기/수집 도구를 선택합니다. 카탈로그 계층, 인증 및 `mcpApp` 리소스 세부정보는 [MCP Protocol](/docs/mcp-protocol)를 참조하세요.
+MCP를 활성화하면 actions가 프레임워크의 MCP 서버 `/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. 전체 작업 표면은 명시적인 선택(`--full-catalog` 토큰 또는 `AGENT_NATIVE_MCP_FULL_CATALOG=1`)에서만 제공되며 `publicAgent.expose`는 공개 표면에서 안전한 읽기/수집 도구를 선택합니다. 카탈로그 계층, 인증 및 `mcpApp` 리소스 세부정보는 [MCP Protocol](/docs/mcp-protocol)를 참조하세요.
 
 UI 지원 MCP 호스트의 경우 작업은 `mcpApp` 필드(및 일치하는 `link`)를 통해 선택적 MCP 앱 리소스를 선언할 수 있으므로 지원 호스트는 결과를 인라인으로 렌더링합니다. `link` 및 `mcpApp`가 동일한 경로를 가리켜야 하는 경우 `embedRoute()`는 하나의 순수 경로 빌더에서 두 가지를 모두 빌드합니다.
 

package/corpus/core/docs/content/locales/ko-KR/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/corpus/core/docs/content/locales/ko-KR/dispatch.mdx

@@ -113,16 +113,16 @@ Dispatch는 작업 공간의 다른 앱을 A2A 피어로 자동 검색합니다.
 
 ### 통합 MCP 게이트웨이
 
-디스패치는 외부 에이전트를 위한 단일 MCP 커넥터일 수 있습니다. Claude, ChatGPT, Codex 또는 커서에 `https://dispatch.agent-native.com/_agent-native/mcp`를 한 번 추가하면 앱당 하나의 커넥터 대신 하나의 인증이 부여된 모든 작업 영역 앱에 도달합니다. 전체 연결 흐름, 앱 부여, OAuth 및 인라인 MCP 앱 미리보기는 [External Agents](/docs/external-agents)를 참조하세요.
+디스패치는 외부 에이전트를 위한 단일 MCP 커넥터일 수 있습니다. Claude, ChatGPT, Codex 또는 커서에 `https://dispatch.agent-native.com/mcp`를 한 번 추가하면 앱당 하나의 커넥터 대신 하나의 인증이 부여된 모든 작업 영역 앱에 도달합니다. 전체 연결 흐름, 앱 부여, OAuth 및 인라인 MCP 앱 미리보기는 [External Agents](/docs/external-agents)를 참조하세요.
 
-<Endpoint id="doc-block-j0rg0r" 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-j0rg0r" 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>