@agent-native/core 0.98.17 → 0.99.0

package/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/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 클라이언트는 작동하지 않습니다.
 

package/docs/content/locales/ko-KR/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 도구를 외부 기능에 연결하기 위한 표준 프로토콜입
 권장되는 단일 명령 설정의 경우 [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-6peopk" title={"MCP 엔드포인트"} summary={"모든 에이전트 기반 앱이 노출하는 자동 탑재 스트리밍 가능 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-6peopk" title={"MCP 엔드포인트"} summary={"모든 에이전트 기반 앱이 노출하는 자동 탑재 스트리밍 가능 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,39 @@ 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 +254,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 +270,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-6e3pyn" title={"OAuth 검색 흐름"} summary={"401은 검색, 등록 및 PKCE 승인 → 토큰 교환을 시작합니다. Bearer 토큰은 대상에 국한되며 범위가 지정됩니다."}>
 
@@ -351,7 +372,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 +383,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/ko-KR/plan-plugin.mdx

@@ -12,7 +12,7 @@ Agent-Native **Plan** 앱은 설치 가능한 하나의 번들로 제공됩니
 한 번의 설치로 다음을 얻을 수 있습니다:
 
 - **3개의 skills** — `/visual-plan`(표준 진입점), `/visual-recap`, `/visualize-repo`.
-- **Plan MCP 커넥터** — `https://plan.agent-native.com`(MCP 엔드포인트 `https://plan.agent-native.com/_agent-native/mcp`, 서버 이름 `plan`)에서 호스팅된 앱에 대해 등록되었습니다.
+- **Plan MCP 커넥터** — `https://plan.agent-native.com`(MCP 엔드포인트 `https://plan.agent-native.com/mcp`, 서버 이름 `plan`)에서 호스팅된 앱에 대해 등록되었습니다.
 
 <Diagram id="doc-block-u395er" title={"세 가지 경로, 하나의 번들"} summary={"범용 CLI, Claude Code 플러그인, Codex 플러그인은 모두 동일한 Plan skills와 호스팅된 Plan 커넥터를 설치합니다."}>
 
@@ -43,7 +43,7 @@ Agent-Native **Plan** 앱은 설치 가능한 하나의 번들로 제공됩니
   <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
   <div class="diagram-box">
     Plan MCP connector<br /><small class="diagram-muted"
-      >plan.agent-native.com/_agent-native/mcp</small
+      >plan.agent-native.com/mcp</small
     >
   </div>
 </div>
@@ -251,7 +251,7 @@ codex plugin add agent-native-visual-plans@agent-native-apps
 codex mcp login plan   # 브라우저의 OAuth
 ```
 
-설치 후 **새 Codex 스레드를 시작**하여 skills 및 MCP 도구가 세션에 로드되도록 합니다. 플러그인은 URL 전용 커넥터(`[mcp_servers.plan]` → `https://plan.agent-native.com/_agent-native/mcp`)를 제공합니다. `codex mcp login plan`는 OAuth 흐름을 실행합니다. 위의 범용 CLI 경로는 함께 설치하고 인증하는 하나의 명령을 선호하거나 로컬 파일 또는 자체 호스팅 모드를 원하는 경우 Codex(`npx @agent-native/core@latest skills add visual-plan --client codex`)에도 작동합니다.
+설치 후 **새 Codex 스레드를 시작**하여 skills 및 MCP 도구가 세션에 로드되도록 합니다. 플러그인은 URL 전용 커넥터(`[mcp_servers.plan]` → `https://plan.agent-native.com/mcp`)를 제공합니다. `codex mcp login plan`는 OAuth 흐름을 실행합니다. 위의 범용 CLI 경로는 함께 설치하고 인증하는 하나의 명령을 선호하거나 로컬 파일 또는 자체 호스팅 모드를 원하는 경우 Codex(`npx @agent-native/core@latest skills add visual-plan --client codex`)에도 작동합니다.
 
 > **이전 설치:** 구성에 여전히 동일한 URL를 가리키는 `agent-native-plans` 항목이 있거나 Codex에 대해 `npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex`를 실행하거나 대상 `--client`와 동일한 명령을 실행하는 경우 이를 표준 `plan` 이름으로 통합합니다.
 

package/docs/content/locales/ko-KR/server.mdx

@@ -267,7 +267,7 @@ export default runMigrations(
 | `/_agent-native/extensions/*`    | 런타임 확장 및 확장 프록시(레거시 별칭: `/_agent-native/tools/*`) |
 | `/_agent-native/integrations/*`  | 메시징/웹훅 통합                                                  |
 | `/_agent-native/a2a`             | 에이전트 간 JSON-RPC                                              |
-| `/_agent-native/mcp`             | MCP 엔드포인트                                                    |
+| `/mcp`                           | MCP 엔드포인트                                                    |
 | `/_agent-native/onboarding/*`    | 설정 체크리스트                                                   |
 | `/_agent-native/observability/*` | 추적, 피드백, 평가, 실험                                          |
 | `/_agent-native/file-upload`     | 파일 업로드 공급자 엔드포인트                                     |
@@ -463,4 +463,4 @@ const handler = createProductionAgentHandler({
 - [**Database**](/docs/database) — 사용자 지정 경로와 작업이 모두 가져오는 `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/docs/content/locales/ko-KR/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/ko-KR/template-assets.mdx

@@ -495,7 +495,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/ko-KR/template-dispatch.mdx

@@ -123,7 +123,7 @@ description: "Dispatch는 중앙 받은 편지함, 앱 간 오케스트레이션
   원시 비밀을 복사하지 않고 액세스를 디스패치합니다. 앱별 소스
   구성은 공급자를 사용하는 앱에 유지됩니다.
 - **MCP 커넥터 1개를 노출합니다.** 추가
-  Claude, ChatGPT의 `https://dispatch.agent-native.com/_agent-native/mcp`,
+  Claude, ChatGPT의 `https://dispatch.agent-native.com/mcp`,
   Codex, 커서 또는 다른 MCP 호스트를 선택한 다음 어떤 작업 공간 앱을 선택하세요
   커넥터는 Dispatch의 **Agents** 페이지에서 연결할 수 있습니다. 다이렉트 앱 URL 사용
   해당 호스트를 하나의 앱으로 격리해야 하는 경우에만
@@ -304,7 +304,7 @@ _내부적으로 작동하는 방식(개발자용)._
   ]}
 />
 
-- **MCP 허브 모드.** 디스패치는 여전히 작업 영역의 [MCP hub](/docs/mcp-clients#hub) 역할을 할 수 있으므로 작업 영역의 다른 모든 앱은 동일한 조직 범위 MCP 서버 목록을 가져옵니다. 이와 별도로 Dispatch의 자체 `/_agent-native/mcp` 엔드포인트는 Claude, ChatGPT 및 여러 작업 공간 앱에 연결해야 하는 기타 호스트에 권장되는 외부 MCP 커넥터입니다.
+- **MCP 허브 모드.** 디스패치는 여전히 작업 영역의 [MCP hub](/docs/mcp-clients#hub) 역할을 할 수 있으므로 작업 영역의 다른 모든 앱은 동일한 조직 범위 MCP 서버 목록을 가져옵니다. 이와 별도로 Dispatch의 자체 `/mcp` 엔드포인트는 Claude, ChatGPT 및 여러 작업 공간 앱에 연결해야 하는 기타 호스트에 권장되는 외부 MCP 커넥터입니다.
 
 ## 꿈 {#dreams}
 

package/docs/content/locales/ko-KR/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 @@ Codex, Claude 코드, Markdown 또는 붙여넣은 계획이 이미 존재하는
   교차 기기 또는 팀 검토)에는 로그인이 필요합니다. Google 로그인은 다음 경우에 나타납니다
   표준 Google OAuth 환경 변수가 구성되었습니다.
 
-호스팅된 Plans 커넥터는 `https://plan.agent-native.com/_agent-native/mcp`에 있습니다.
+호스팅된 Plans 커넥터는 `https://plan.agent-native.com/mcp`에 있습니다.
 스킬 파일에 공유 비밀을 절대 넣지 마세요.
 
 ## 로컬 파일 개인정보 보호 모드 {#local-files}
@@ -448,7 +448,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/pt-BR/actions.mdx

@@ -540,7 +540,7 @@ Se seu aplicativo for um par [A2A](/docs/a2a-protocol), outros aplicativos nativ
 
 ## Expondo-o sobre MCP {#mcp}
 
-Com MCP ativado, seu actions aparece no servidor MCP da estrutura em `/_agent-native/mcp`. Cada chamador recebe um catálogo compacto por padrão – recursos integrados voltados para o aplicativo mais o aplicativo declarado por modelo actions – e o `tool-search` está sempre presente para que qualquer outra ferramenta permaneça acessível sob demanda. A superfície de ação completa é veiculada apenas com aceitação explícita (token `--full-catalog` ou `AGENT_NATIVE_MCP_FULL_CATALOG=1`), e `publicAgent.expose` opta por uma ferramenta de leitura/ingestão segura na superfície pública. Consulte [MCP Protocol](/docs/mcp-protocol) para níveis de catálogo, autenticação e detalhes do recurso `mcpApp`.
+Com MCP ativado, seu actions aparece no servidor MCP da estrutura em `/mcp`. Cada chamador recebe um catálogo compacto por padrão – recursos integrados voltados para o aplicativo mais o aplicativo declarado por modelo actions – e o `tool-search` está sempre presente para que qualquer outra ferramenta permaneça acessível sob demanda. A superfície de ação completa é veiculada apenas com aceitação explícita (token `--full-catalog` ou `AGENT_NATIVE_MCP_FULL_CATALOG=1`), e `publicAgent.expose` opta por uma ferramenta de leitura/ingestão segura na superfície pública. Consulte [MCP Protocol](/docs/mcp-protocol) para níveis de catálogo, autenticação e detalhes do recurso `mcpApp`.
 
 Para hosts MCP compatíveis com UI, uma ação pode declarar um recurso opcional de aplicativos MCP por meio do campo `mcpApp` (mais um `link` correspondente) para que hosts compatíveis renderizem o resultado in-line. Quando `link` e `mcpApp` devem apontar para a mesma rota, `embedRoute()` constrói ambos a partir de um construtor de caminho puro:
 

package/docs/content/locales/pt-BR/authentication.mdx

@@ -219,7 +219,7 @@ A configuração dessas variáveis ​​nunca renderiza uma página de login de
 O endpoint MCP de cada aplicativo pode atuar como um recurso MCP protegido padrão. Clientes compatíveis com OAuth podem ser configurados apenas com o MCP remoto URL:
 
 ```text
-https://mail.agent-native.com/_agent-native/mcp
+https://mail.agent-native.com/mcp
 ```
 
 Solicitações MCP não autenticadas retornam um desafio `WWW-Authenticate` apontando para `/.well-known/oauth-protected-resource`. O cliente então descobre os metadados OAuth do aplicativo, registra dinamicamente um cliente público, abre a página de autorização do aplicativo e troca um código de autorização com PKCE para tokens de acesso e atualização.

package/docs/content/locales/pt-BR/dispatch.mdx

@@ -113,16 +113,16 @@ O Dispatch descobre automaticamente os outros aplicativos em seu espaço de trab
 
 ### Gateway MCP unificado
 
-O Dispatch pode ser o único conector MCP para agentes externos: adicione `https://dispatch.agent-native.com/_agent-native/mcp` uma vez em Claude, ChatGPT, Codex ou Cursor, e uma autorização atinge cada aplicativo de espaço de trabalho concedido em vez de um conector por aplicativo. Consulte [External Agents](/docs/external-agents) para ver o fluxo de conexão completo, concessões de aplicativos, OAuth e visualizações de aplicativos in-line MCP.
+O Dispatch pode ser o único conector MCP para agentes externos: adicione `https://dispatch.agent-native.com/mcp` uma vez em Claude, ChatGPT, Codex ou Cursor, e uma autorização atinge cada aplicativo de espaço de trabalho concedido em vez de um conector por aplicativo. Consulte [External Agents](/docs/external-agents) para ver o fluxo de conexão completo, concessões de aplicativos, OAuth e visualizações de aplicativos in-line MCP.
 
-<Endpoint id="doc-block-lgsyj9" method="POST" path="/_agent-native/mcp" summary="Ponto de extremidade do gateway MCP unificado" 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-lgsyj9" method="POST" path="/mcp" summary="Ponto de extremidade do gateway MCP unificado" 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>