@agent-native/core 0.98.17 → 0.99.1

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>
 

package/corpus/core/docs/content/locales/ko-KR/external-agents.mdx

@@ -98,7 +98,7 @@ Agent-Native를 사용하려는 호스트에 하나의 원격 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
 ```
 
 호스팅된 모든 앱에는 다음 위치에 도우미 페이지도 있습니다.
-복사 가능한 URL가 있는 `https://&lt;app&gt;/_agent-native/mcp/connect` 및
+복사 가능한 URL가 있는 `https://&lt;app&gt;/mcp/connect` 및
 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 클라이언트의 경우 브라우저에서 앱을 열고 **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 @@ 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 연결을 통해 통화를 중재합니다.
@@ -502,13 +502,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`로 전체 세트를 비활성화하세요.
 
@@ -516,6 +516,17 @@ ChatGPT/Claude 스타일 OAuth 앱 호스트의 경우 검색 표면은 기본
 
 빠른 ChatGPT/Claude 핸드오프를 위해 이상적인 경로는 직접입니다. 아티팩트를 생성하거나 여는 작업을 호출한 다음 MCP 앱이 경로를 시작하도록 합니다. 메일 요청은 `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` 작업을 제공합니다.
@@ -679,7 +690,7 @@ npx @agent-native/core@latest mcp install --client claude-code|claude-code-cli|c
 - **동료** — `~/.cowork/mcp.json`의 동일한 Claude 코드 JSON 모양.
 - **codex** — `~/.codex/config.toml`의 `[mcp_servers.<name>]` 블록.
 
-항목은 기본적으로 실행 중인 로컬 앱의 `/_agent-native/mcp`에 대한 **얇은 stdio 프록시**인 `npx @agent-native/core@latest mcp serve --app <id>`를 실행합니다. 따라서 라이브 액션 레지스트리, 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` 클라이언트 항목을 작성합니다.
+항목은 기본적으로 실행 중인 로컬 앱의 `/mcp`에 대한 **얇은 stdio 프록시**인 `npx @agent-native/core@latest mcp serve --app <id>`를 실행합니다. 따라서 라이브 액션 레지스트리, 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` 클라이언트 항목을 작성합니다.
 
 동반 하위 명령:
 
@@ -703,7 +714,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>" },
     },
   },
@@ -745,7 +756,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`를 통해 해당 토큰을 **취소**할 수 있습니다. 개인 액세스 토큰처럼 취급합니다. 에이전트 클라이언트당 하나씩, 머신이 폐기되면 취소됩니다.
 - 에이전트가 전달한 딥 링크에는 특권 상태가 없습니다. 기록 중심의 `navigate` 쓰기 범위는 항상 **브라우저** 세션으로 지정되며 상담원의 토큰은 아닙니다. 따라서 링크를 터미널이나 채팅 내용에 붙여넣어도 안전합니다.
 

package/corpus/core/docs/content/locales/ko-KR/mcp-clients.mdx

@@ -245,6 +245,34 @@ MCP 도구는 노드 런타임(Cloudflare 작업자 및 기타 에지)에서만
 
 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 +291,7 @@ MCP(모델 컨텍스트 프로토콜) 서버는 에이전트에 Zapier, Cloudfla
 
 실행 중인 MCP 관리자에 핫 리로드를 추가 및 제거합니다. 프로세스를 다시 시작하지 않고 서버를 다시 시작하지 않습니다. 새로운 `mcp__<scope>-<name>__*` 도구는 다음 메시지에서 상담원에게 나타나며 `tool-search`를 통해 검색할 수 있습니다.
 
-HTTPS URL는 모든 곳에서 허용됩니다. 일반 `http://`는 개발 중에 `localhost`에만 허용됩니다. 선택적 인증은 모든 요청에서 `Authorization: Bearer …`를 통해 전송되는 Bearer 토큰으로 들어갑니다.
+HTTPS URL는 모든 곳에서 허용됩니다. 일반 `http://`는 개발 중에 `localhost`에만 허용됩니다. 선택적 인증은 모든 요청에서 `Authorization: Bearer …`를 통해 전송되는 Bearer 토큰으로 들어갑니다. Atlassian Rovo MCP를 포함한 OAuth 전용 공급자는 정적 헤더 대신 공급자의 OAuth 흐름을 사용해야 합니다.
 
 내부적으로 이러한 서버는 `u:<email>:mcp-servers-remote`(개인) 또는 `o:<orgId>:mcp-servers-remote`(팀) 키 아래 프레임워크의 `settings` 테이블에 유지되며 시작 시 `mcp.config.json`와 병합됩니다.
 
@@ -292,7 +320,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 +484,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 클라이언트는 작동하지 않습니다.