@agent-native/core 0.98.17 → 0.99.1

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

package/corpus/core/docs/content/locales/pt-BR/external-agents.mdx

@@ -98,7 +98,7 @@ Adicione um conector MCP remoto ao host onde você deseja usar Agent-Native.
 Para trabalho em espaço de trabalho ou entre aplicativos, use Dispatch:
 
 ```text
-https://dispatch.agent-native.com/_agent-native/mcp
+https://dispatch.agent-native.com/mcp
 ```
 
 Dispatch é o gateway único para Mail, Calendar, Analytics, Brain e seu
@@ -109,12 +109,12 @@ alcançar todos os aplicativos ou apenas aplicativos selecionados. O host conect
 Para um aplicativo intencionalmente isolado, use-o diretamente:
 
 ```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
 ```
 
 Todo aplicativo hospedado também tem uma página auxiliar em
-`https://&lt;app&gt;/_agent-native/mcp/connect` com o URL copiável e
+`https://&lt;app&gt;/mcp/connect` com o URL copiável e
 guias específicas do host para Claude, ChatGPT, Cursor, Código Claude, Codex e Outros.
 
 ### Claude e ChatGPT OAuth {#oauth}
@@ -238,7 +238,7 @@ Uma vez conectado, a autenticação deve persistir por longo prazo – os tokens
 npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex
 ```
 
-`reconnect` encontra qualquer entrada de configuração MCP cujo URL termina em `/_agent-native/mcp` para o host fornecido e o cliente selecionado (correspondente a URL, independentemente do nome do conector) e, em seguida, atualiza ou substitui o material de autenticação sem tocar no skills instalado ou executar novamente o fluxo de instalação completo. Passe o aplicativo base URL (por exemplo, `https://plan.agent-native.com`) — o sufixo `/_agent-native/mcp` é inferido. A autenticação e o carregamento da ferramenta são por cliente, portanto, reinicie/recarregue esse cliente posteriormente; Codex precisa de uma nova sessão antes que as ferramentas recém-carregadas apareçam.
+`reconnect` encontra qualquer entrada de configuração MCP cujo URL termina em `/mcp` para o host fornecido e o cliente selecionado (correspondente a URL, independentemente do nome do conector) e, em seguida, atualiza ou substitui o material de autenticação sem tocar no skills instalado ou executar novamente o fluxo de instalação completo. Passe o aplicativo base URL (por exemplo, `https://plan.agent-native.com`) — o sufixo `/mcp` é inferido. A autenticação e o carregamento da ferramenta são por cliente, portanto, reinicie/recarregue esse cliente posteriormente; Codex precisa de uma nova sessão antes que as ferramentas recém-carregadas apareçam.
 
 No código Claude, o caminho UI equivalente é: execute `/mcp` e escolha **Autenticar** (ou **Reconectar**) para o conector relevante.
 
@@ -246,7 +246,7 @@ Nunca reinstale a habilidade do zero apenas para consertar um 401 — `reconnect
 
 ### Conectar substituto de página {#connect-page-fallback}
 
-Para clientes MCP que não podem adicionar um OAuth URL remoto diretamente, abra o aplicativo em seu navegador e use seu recurso **Connect** (servido em `https://&lt;app&gt;/_agent-native/mcp/connect`). Enquanto estiver logado, clique em **Conectar/Autorizar**. A página fornece um link direto de um clique que configura um agente detectado ou um bloco `.mcp.json` pronto para colar:
+Para clientes MCP que não podem adicionar um OAuth URL remoto diretamente, abra o aplicativo em seu navegador e use seu recurso **Connect** (servido em `https://&lt;app&gt;/mcp/connect`). Enquanto estiver logado, clique em **Conectar/Autorizar**. A página fornece um link direto de um clique que configura um agente detectado ou um bloco `.mcp.json` pronto para colar:
 
 ```jsonc
 // .mcp.json
@@ -254,7 +254,7 @@ Para clientes MCP que não podem adicionar um OAuth URL remoto diretamente, abra
   "mcpServers": {
     "mail": {
       "type": "http",
-      "url": "https://mail.agent-native.com/_agent-native/mcp",
+      "url": "https://mail.agent-native.com/mcp",
       "headers": { "Authorization": "Bearer <minted-token>" },
     },
   },
@@ -271,13 +271,13 @@ Os aplicativos nativos do agente hospedado também suportam o fluxo remoto padr
 
 ```bash
 claude mcp add --transport http agent-native \
-  https://dispatch.agent-native.com/_agent-native/mcp
+  https://dispatch.agent-native.com/mcp
 ```
 
 Esta é a mesma entrada somente URL que `npx @agent-native/core@latest connect https://dispatch.agent-native.com --client claude-code` escreve para você. Em seguida, execute `/mcp` no código Claude e escolha **Autenticar**. O cliente descobre a autenticação do desafio `401 WWW-Authenticate` do servidor MCP, busca `/.well-known/oauth-protected-resource` e `/.well-known/oauth-authorization-server`, registra dinamicamente um cliente OAuth público, abre a página de autorização do aplicativo e armazena o token resultante com segurança. Os conectores de modo de desenvolvedor ChatGPT usam o mesmo servidor URL:
 
 ```text
-https://dispatch.agent-native.com/_agent-native/mcp
+https://dispatch.agent-native.com/mcp
 ```
 
 O fluxo OAuth é código de autorização + PKCE com rotação de token de atualização. Os tokens de acesso são vinculados ao público ao recurso MCP exato URL e carregam a identidade assinada do usuário/organização, portanto, as chamadas de ferramenta, `resources/read` e `tools/call` iniciado por iframe do aplicativo MCP são executados por meio do mesmo escopo de locatário `runWithRequestContext` que o caminho JWT criado por conexão existente. O iframe nunca recebe tokens OAuth brutos; o host medeia as chamadas por meio da conexão MCP autenticada.
@@ -502,13 +502,13 @@ Consulte [MCP Apps](/docs/mcp-apps) para obter todos os detalhes da ponte: trans
 
 Além das ferramentas por ação, o servidor MCP expõe um conjunto de verbos estável, para que um agente externo tenha uma superfície previsível sem adivinhar os nomes das ações por aplicativo:
 
-| Ferramenta                                         | Efeitos colaterais | Devoluções                                                                                                        |
-| -------------------------------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------- |
-| `list_apps`                                        | nenhum             | aplicativos de espaço de trabalho + seus URLs/estado de execução                                                  |
-| `open_app({ app, view?, path?, params?, embed? })` | nenhum             | um link direto ou rota de mesma origem; `embed: true` renderiza o aplicativo completo in-line onde houver suporte |
-| `ask_app({ app, message })`                        | loop de agente     | encaminha uma tarefa em linguagem natural para o agente no aplicativo desse aplicativo (delega para `ask-agent`)  |
-| `create_workspace_app({ name, template })`         | andaimes           | um novo aplicativo inicializado pelo caminho do espaço de trabalho, além de URL em execução + link direto         |
-| `list_templates`                                   | nenhum             | somente os modelos permitidos                                                                                     |
+| Ferramenta                                         | Efeitos colaterais | Devoluções                                                                                                                                                            |
+| -------------------------------------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `list_apps`                                        | nenhum             | aplicativos de espaço de trabalho + seus URLs/estado de execução                                                                                                      |
+| `open_app({ app, view?, path?, params?, embed? })` | nenhum             | um link direto ou rota de mesma origem; `embed: true` renderiza o aplicativo completo in-line onde houver suporte                                                     |
+| `ask_app({ app, message, async?, maxWaitMs? })`    | loop de agente     | encaminha uma tarefa em linguagem natural para o agente no aplicativo desse aplicativo; trabalho longo retorna um `taskId` durável para consulta com `ask_app_status` |
+| `create_workspace_app({ name, template })`         | andaimes           | um novo aplicativo inicializado pelo caminho do espaço de trabalho, além de URL em execução + link direto                                                             |
+| `list_templates`                                   | nenhum             | somente os modelos permitidos                                                                                                                                         |
 
 `create_workspace_app` rejeita qualquer modelo não listado na lista de permissões — a lista de permissões de modelos públicos no `packages/shared-app-config/templates.ts` é oficial e protegida por CI; um agente externo não pode ampliá-lo. Uma ação de modelo com o mesmo nome substitui uma ação interna (precedência de modelo sobre núcleo). Desative todo o conjunto com `MCPConfig.builtinCrossAppTools: false`.
 
@@ -516,6 +516,19 @@ Os catálogos de ferramentas e recursos para hosts de aplicativos são compactos
 
 Para transferências rápidas de ChatGPT/Claude, o caminho ideal é direto: chame a ação que cria ou abre o artefato e deixe o aplicativo MCP iniciar a rota. Uma solicitação de correio deve chamar `manage_draft` e renderizar a rota de composição real. Uma solicitação de painel deve chamar `open_app({ path, embed: true })` ou uma ação de painel com `mcpApp` e renderizar a rota completa do Analytics. Calendário, Formulários, Conteúdo, Slides, Design e Clipes devem seguir o mesmo padrão com seu rascunho/criação/pesquisa actions. `list_apps` é útil quando o modelo precisa escolher entre aplicativos concedidos; `resources/list` amplo, descoberta de catálogo completo ou delegação `ask_app` não devem ser o caminho normal para uma transferência óbvia de UI.
 
+### Solicitações de agente de longa duração
+
+Hosts e gateways MCP não compartilham um único timeout longo de chamada de
+ferramenta; alguns impõem um teto de cinco minutos e outros são
+configuráveis. Não projete uma integração de agente externo em torno de um
+`tools/call` bloqueante de dez minutos. `ask-agent` e `ask_app` confirmam o
+trabalho hospedado rapidamente e depois retornam um `taskId` durável quando a
+espera embutida expira. Consulte com `ask_app_status` usando o `app` e o
+`taskId` retornados; o resultado inclui `pollAfterMs` como um intervalo
+amigável para hosts. A tarefa precisa ser criada antes que a primeira
+resposta possa expirar, então um URL de consulta retornado apenas após uma
+chamada longa não é um contrato de recuperação confiável.
+
 ### Tour por aplicativo {#tour}
 
 Cada modelo listado como permitido que produz ou lista um recurso navegável envia um construtor `link`, e os modelos pesados enviam uma ação GET + `publicAgent` para que um agente conectado possa extrair o estado ativo:
@@ -679,7 +692,7 @@ Ele provisiona um token (um `ACCESS_TOKEN` aleatório no espaço de trabalho `.e
 - **cowork** — o mesmo formato do Código Claude JSON em `~/.cowork/mcp.json`.
 - **codex** — um bloco `[mcp_servers.<name>]` em `~/.codex/config.toml`.
 
-A entrada executa `npx @agent-native/core@latest mcp serve --app <id>`, que por padrão é um **proxy stdio fino** para o `/_agent-native/mcp` do aplicativo local em execução — portanto, o registro de ação ao vivo, HMR, e os links diretos corretos permanecem a única fonte da verdade. Passe `--standalone` para construir o registro em processo. Quando `npx @agent-native/core@latest mcp install` detecta uma origem hospedada (um `APP_URL` / `BETTER_AUTH_URL` / `AGENT_NATIVE_MCP_URL` não localhost no espaço de trabalho `.env`), ele grava uma entrada de cliente `http` apontando para `<origin>/_agent-native/mcp` com um `Bearer` JWT em vez de uma entrada stdio.
+A entrada executa `npx @agent-native/core@latest mcp serve --app <id>`, que por padrão é um **proxy stdio fino** para o `/mcp` do aplicativo local em execução — portanto, o registro de ação ao vivo, HMR, e os links diretos corretos permanecem a única fonte da verdade. Passe `--standalone` para construir o registro em processo. Quando `npx @agent-native/core@latest mcp install` detecta uma origem hospedada (um `APP_URL` / `BETTER_AUTH_URL` / `AGENT_NATIVE_MCP_URL` não localhost no espaço de trabalho `.env`), ele grava uma entrada de cliente `http` apontando para `<origin>/mcp` com um `Bearer` JWT em vez de uma entrada stdio.
 
 Subcomandos complementares:
 
@@ -703,7 +716,7 @@ Você também pode escrever a configuração do cliente MCP manualmente em qualq
   "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 +758,7 @@ As incorporações completas do aplicativo também evitam entregar o token de po
 O fluxo `connect` hospedado substituto nunca copia o segredo compartilhado da implantação. Em vez disso:
 
 - Uma sessão de navegador logada gera um token **por usuário, com escopo e revogável** — um JWT assinado por `A2A_SECRET` que transporta o `sub` + `org_domain` do chamador e um `jti` exclusivo, para que cada ferramenta executada permaneça no escopo do locatário via `runWithRequestContext`.
-- O endpoint `/_agent-native/mcp` existente aceita esse token como qualquer outro portador (consulte [MCP Protocol](/docs/mcp-protocol)) — sem novo endpoint, sem novo transporte.
+- O endpoint `/mcp` existente aceita esse token como qualquer outro portador (consulte [MCP Protocol](/docs/mcp-protocol)) — sem novo endpoint, sem novo transporte.
 - A mesma página do Connect lista todos os tokens que você criou e permite **revogar** qualquer um deles por `jti`. Trate-os como tokens de acesso pessoal: um por cliente agente, revogue quando uma máquina for desativada.
 - O deep link que o agente devolve não carrega nenhum estado privilegiado. A gravação `navigate` com foco no registro sempre tem como escopo a sessão do **navegador**, nunca o token do agente. Portanto, é seguro colar um link em um terminal ou na transcrição do bate-papo.
 

package/corpus/core/docs/content/locales/pt-BR/mcp-clients.mdx

@@ -245,6 +245,35 @@ Isso significa que os usuários que instalaram a extensão claude-in-chrome ter
 
 Os servidores MCP (Model Context Protocol) oferecem novas habilidades ao seu agente, como conectar-se ao Zapier, Cloudflare, Composio ou às ferramentas internas da sua empresa. Uma vez conectado, o agente pode usar essas ferramentas exatamente como as integradas.
 
+Os IDs de preset são `context7`, `sentry`, `notion`, `semgrep`, `linear`,
+`atlassian`, `supabase`, `neon` e `stripe`.
+
+### Atlassian / Jira
+
+O preset Atlassian usa o endpoint OAuth 2.1 do Atlassian Rovo MCP,
+`https://mcp.atlassian.com/v1/mcp/authv2`, e disponibiliza ferramentas do Jira
+e do Confluence. A criação de tickets no Jira exige as permissões da Atlassian
+que autorizam gravações no Jira; o usuário continua vendo apenas os projetos e
+conteúdos permitidos pela sua conta da Atlassian.
+
+Administradores de organizações da Atlassian podem controlar se um cliente
+OAuth tem permissão para se conectar. Antes da conexão, talvez um administrador
+precise adicionar a origem HTTPS real do aplicativo à lista de domínios
+confiáveis em **Atlassian Administration → Rovo → Rovo MCP server → Domains** e
+ativar as permissões necessárias de **Read**, **Write** e **Search** em
+**Permissions**. O domínio deve ser o host em que o aplicativo Agent-Native é
+executado; não copie `https://builder.io/**` para outra implantação, a menos que
+essa seja a origem real dela. Consulte o [guia de configuração do Rovo MCP](https://developer.atlassian.com/cloud/rovo-mcp/guides/getting-started/)
+e os [controles administrativos](https://support.atlassian.com/security-and-access-policies/docs/control-atlassian-rovo-mcp-server-settings/) da Atlassian.
+
+O catálogo fornece o endpoint e as orientações de configuração. O formulário
+genérico de configurações armazena o endpoint e cabeçalhos criptografados
+opcionais, mas não substitui o fluxo interativo de consentimento OAuth da
+Atlassian. Use um cliente ou runtime MCP compatível com OAuth quando a Atlassian
+exigir OAuth interativo. Se o provedor ou runtime aceitar um token Bearer
+estático, siga o processo aprovado de gerenciamento de segredos e nunca cole
+tokens em prompts ou configurações versionadas.
+
 ### Como conectar um servidor MCP remoto
 
 1. **Nome do servidor** — um rótulo curto para sua própria referência (por exemplo, "zapier", "slack-tools").
@@ -263,7 +292,7 @@ Dois escopos são suportados:
 
 Adiciona e remove hot-reload no gerenciador MCP em execução - sem reinicialização do processo e sem reinicialização do servidor. As novas ferramentas `mcp__<scope>-<name>__*` aparecem para o agente na próxima mensagem e podem ser pesquisadas via `tool-search`.
 
-HTTPS URLs são aceitos em todos os lugares; `http://` simples só é permitido para `localhost` durante o desenvolvimento. A autenticação opcional entra como um token de portador enviado via `Authorization: Bearer …` em cada solicitação.
+HTTPS URLs são aceitos em todos os lugares; `http://` simples só é permitido para `localhost` durante o desenvolvimento. A autenticação opcional entra como um token de portador enviado via `Authorization: Bearer …` em cada solicitação. Provedores que aceitam somente OAuth, incluindo Atlassian Rovo MCP, exigem o fluxo OAuth do provedor em vez de um cabeçalho estático.
 
 Nos bastidores, esses servidores são mantidos na tabela `settings` da estrutura sob a chave `u:<email>:mcp-servers-remote` (Pessoal) ou `o:<orgId>:mcp-servers-remote` (Equipe) e mesclados com `mcp.config.json` na inicialização.
 
@@ -292,7 +321,9 @@ O Dispatch é o hub convencional: ele já coordena todos os aplicativos.
   <div class="diagram-panel center" data-rough>
     <span class="diagram-pill accent">Dispatch hub</span
     ><small class="diagram-muted">servidores MCP no escopo da organização</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 +485,7 @@ Use isso para criar dicas de integração "claude-in-chrome detectadas — seu a
 
 Falhas individuais do servidor MCP nunca desativam o agente:
 
-- Um `command` configurado incorretamente → o servidor é ignorado, seu erro aparece em `/mcp/status` em `errors.<server-id>` e todos os outros servidores continuam funcionando.
+- Um `command` configurado incorretamente → o servidor é ignorado, seu erro aparece em `/_agent-native/mcp/status` em `errors.<server-id>` e todos os outros servidores continuam funcionando.
 - O MCP SDK está faltando no `node_modules` → todas as funcionalidades do MCP são ignoradas com um aviso; o bate-papo do agente continua funcionando sem nenhuma ferramenta MCP.
 - Executando em um tempo de execução de borda → O cliente MCP é autônomo.