@agent-native/core 0.98.17 → 0.99.1

package/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/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.
 

package/docs/content/locales/pt-BR/mcp-protocol.mdx

@@ -22,7 +22,7 @@ MCP é o protocolo padrão para conectar ferramentas de IA a recursos externos.
 
 Conceitos principais:
 
-- **Montado automaticamente** — todos os aplicativos recebem `/_agent-native/mcp` gratuitamente, sem necessidade de configuração
+- **Montado automaticamente** — todos os aplicativos recebem `/mcp` gratuitamente, sem necessidade de configuração
 - **Streamable HTTP** — usa o transporte MCP moderno sobre o HTTP padrão (POST + SSE)
 - **Mesmo actions** — exatamente o mesmo registro de ação que alimenta o chat do agente e o A2A
 - **Ferramenta `ask-agent`** — uma metaferramenta que delega tarefas complexas ao loop completo do agente
@@ -41,7 +41,7 @@ Conceitos principais:
   </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 @@ Ambos os protocolos são montados automaticamente. Use o que for mais adequado a
 | **Melhor para**               | Ferramentas externas que chamam seu aplicativo                         | Comunicação entre agentes                          |
 | **Protocolo**                 | MCP HTTP transmitível                                                  | JSON-RPC 2.0                                       |
 | **Descoberta de ferramentas** | `tools/list`                                                           | Cartão de agente em `/.well-known/agent-card.json` |
-| **Ponto final**               | `/_agent-native/mcp`                                                   | `/_agent-native/a2a`                               |
+| **Ponto final**               | `/mcp`                                                                 | `/_agent-native/a2a`                               |
 | **Apoiado por**               | Claude, ChatGPT, Claude Code, Cursor, Codex, Cowork e outros hosts MCP | Outros aplicativos nativos do agente               |
 | **Execução**                  | Chamadas diretas de ferramenta (sem LLM extra)                         | Loop completo do agente (raciocínio LLM)           |
 
@@ -105,7 +105,7 @@ Você também pode usar a ferramenta `ask-agent` MCP para obter o melhor dos doi
 Para a configuração recomendada de um comando, use [External Agents](/docs/external-agents). Se você estiver escrevendo à mão a configuração MCP para um cliente compatível com OAuth, adicione seu aplicativo como um servidor MCP remoto sem cabeçalhos estáticos:
 
 ```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
 ```
 
 Ou escreva a entrada manualmente em `.mcp.json` (escopo do projeto) ou `~/.claude.json` (escopo do usuário):
@@ -116,7 +116,7 @@ Ou escreva a entrada manualmente em `.mcp.json` (escopo do projeto) ou `~/.claud
   "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
 Qualquer cliente MCP que suporte o transporte Streamable HTTP pode se conectar. O ponto final é:
 
 ```
-POST https://your-app.example.com/_agent-native/mcp
+POST https://your-app.example.com/mcp
 ```
 
 O servidor suporta o handshake MCP padrão: `initialize` → `initialized` → `tools/list` → `tools/call`.
 
-<Endpoint id="doc-block-1vujp7k" title="MCP ponto final" summary={"O endpoint Streamable HTTP montado automaticamente que todo aplicativo nativo do agente expõe."} method="POST" path="/_agent-native/mcp" summary={"MCP Endpoint HTTP transmitível"} auth="Standard remote MCP OAuth (Bearer access token), connect-minted JWT, or static ACCESS_TOKEN/ACCESS_TOKENS" params={[
+<Endpoint id="doc-block-1vujp7k" title="MCP ponto final" summary={"O endpoint Streamable HTTP montado automaticamente que todo aplicativo nativo do agente expõe."} method="POST" path="/mcp" summary={"MCP Endpoint HTTP transmitível"} 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,35 @@ Quando `mcpApp` está presente, a entrada da ferramenta também inclui `_meta.ui
 
 Além das ferramentas de ação individuais, cada servidor MCP inclui uma meta-ferramenta `ask-agent`. Isso envia uma mensagem em linguagem natural ao agente de IA do aplicativo e retorna a resposta.
 
+As solicitações MCP hospedadas usam uma espera embutida limitada para que um loop de agente longo não mantenha um `tools/call` aberto até um timeout do cliente ou do gateway. O argumento opcional `async` inicia a tarefa durável e retorna imediatamente; sem ele, o servidor aguarda brevemente por uma conclusão rápida e depois retorna um identificador de tarefa quando ainda resta trabalho. A espera hospedada tem um limite de 25 segundos.
+
 Use `ask-agent` para tarefas complexas que se beneficiam do raciocínio e do contexto do agente:
 
 ```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
+  }
+}
+```
+
+O agente executa o mesmo loop que o bate-papo interativo: ele pode chamar diversas ferramentas, raciocinar sobre o contexto e produzir uma resposta cuidadosa. Uma tarefa que ainda não terminou retorna um JSON contendo `taskId`, `status`, `pollAfterMs` e:
+
+```json
+{
+  "poll": {
+    "tool": "ask_app_status",
+    "arguments": { "app": "mail", "taskId": "task_123" }
   }
 }
 ```
 
-O agente executa o mesmo loop que o bate-papo interativo: ele pode chamar diversas ferramentas, raciocinar sobre o contexto e produzir uma resposta cuidadosa.
+Chame `ask_app_status` com esses argumentos até que a tarefa alcance um estado
+terminal. O `ask_app` de propriedade do aplicativo no Dispatch usa o mesmo
+contrato de tarefa durável e status, com a concessão do aplicativo selecionado
+verificada tanto no envio quanto na consulta.
 
 ## Autenticação {#authentication}
 
@@ -233,7 +250,7 @@ O endpoint MCP suporta MCP remoto padrão OAuth mais o substituto de token de po
 Para hosts MCP compatíveis com OAuth, configure o servidor remoto URL sem cabeçalhos estáticos:
 
 ```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
 ```
 
 A primeira solicitação MCP não autenticada recebe:
@@ -249,9 +266,9 @@ Endpoints de descoberta:
 | ----------------------------------------- | ---------------------------------------------------------- |
 | `/.well-known/oauth-protected-resource`   | Metadados de recursos protegidos RFC 9728                  |
 | `/.well-known/oauth-authorization-server` | Metadados do servidor de autorização OAuth                 |
-| `/_agent-native/mcp/oauth/register`       | Registro dinâmico de cliente público                       |
-| `/_agent-native/mcp/oauth/authorize`      | Autorização + consentimento do navegador                   |
-| `/_agent-native/mcp/oauth/token`          | Concessões de código de autorização e token de atualização |
+| `/mcp/oauth/register`                     | Registro dinâmico de cliente público                       |
+| `/mcp/oauth/authorize`                    | Autorização + consentimento do navegador                   |
+| `/mcp/oauth/token`                        | Concessões de código de autorização e token de atualização |
 
 <Diagram id="doc-block-yoa2u7" title="Fluxo de descoberta OAuth" summary={"Um 401 inicia a descoberta, o registro e uma autorização PKCE → troca de tokens. O token Bearer é vinculado ao público e tem escopo definido."}>
 
@@ -351,7 +368,7 @@ export default defineNitroPlugin(async (nitro) => {
 Você tem um aplicativo de análise implantado em `analytics.example.com`. Do código 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
 ```
 
 Ou adicione manualmente em `.mcp.json`:
@@ -362,7 +379,7 @@ Ou adicione manualmente em `.mcp.json`:
   "mcpServers": {
     "analytics": {
       "type": "http",
-      "url": "https://analytics.example.com/_agent-native/mcp",
+      "url": "https://analytics.example.com/mcp",
     },
   },
 }

package/docs/content/locales/pt-BR/plan-plugin.mdx

@@ -12,7 +12,7 @@ O aplicativo Agent-Native **Plan** é enviado como um pacote instalável. Uma ú
 Uma instalação oferece:
 
 - **Três skills** — `/visual-plan` (o ponto de entrada canônico), `/visual-recap` e `/visualize-repo`.
-- **O conector do Plano MCP** — registrado no aplicativo hospedado em `https://plan.agent-native.com` (endpoint MCP `https://plan.agent-native.com/_agent-native/mcp`, nome do servidor `plan`).
+- **O conector do Plano MCP** — registrado no aplicativo hospedado em `https://plan.agent-native.com` (endpoint MCP `https://plan.agent-native.com/mcp`, nome do servidor `plan`).
 
 <Diagram id="doc-block-1uxomn4" title={"Três rotas, um pacote"} summary={"O CLI universal, o plug-in Claude Code e o plug-in Codex instalam as mesmas skills do Plan mais o conector do Plan hospedado."}>
 
@@ -43,7 +43,7 @@ Uma instalação oferece:
   <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 no navegador
 ```
 
-Após a instalação, **inicie um novo thread Codex** para que as ferramentas skills e MCP sejam carregadas na sessão. O plugin vem com um conector somente URL (`[mcp_servers.plan]` → `https://plan.agent-native.com/_agent-native/mcp`); `codex mcp login plan` executa o fluxo OAuth. A rota universal CLI acima também funciona para Codex (`npx @agent-native/core@latest skills add visual-plan --client codex`) se você preferir um comando que instale e autentique juntos ou quando desejar arquivos locais ou modo auto-hospedado.
+Após a instalação, **inicie um novo thread Codex** para que as ferramentas skills e MCP sejam carregadas na sessão. O plugin vem com um conector somente URL (`[mcp_servers.plan]` → `https://plan.agent-native.com/mcp`); `codex mcp login plan` executa o fluxo OAuth. A rota universal CLI acima também funciona para Codex (`npx @agent-native/core@latest skills add visual-plan --client codex`) se você preferir um comando que instale e autentique juntos ou quando desejar arquivos locais ou modo auto-hospedado.
 
 > **Instalações mais antigas:** se sua configuração ainda tiver uma entrada `agent-native-plans` apontando para o mesmo URL, executando `npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex` para Codex ou o mesmo comando com seu `--client` de destino, consolida-o no nome canônico `plan`.
 

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

@@ -269,7 +269,7 @@ A estrutura monta suas próprias rotas em `/_agent-native/`. Trate esse namespac
 | `/_agent-native/extensions/*`    | Extensões de tempo de execução e proxy de extensão (alias legado: `/_agent-native/tools/*`) |
 | `/_agent-native/integrations/*`  | Integrações de mensagens/webhook                                                            |
 | `/_agent-native/a2a`             | Agente para agente JSON-RPC                                                                 |
-| `/_agent-native/mcp`             | Ponto final MCP                                                                             |
+| `/mcp`                           | Ponto final MCP                                                                             |
 | `/_agent-native/onboarding/*`    | Lista de verificação de configuração                                                        |
 | `/_agent-native/observability/*` | Traces, feedback, avaliações, experimentos                                                  |
 | `/_agent-native/file-upload`     | Endpoint do provedor de upload de arquivos                                                  |
@@ -465,4 +465,4 @@ const handler = createProductionAgentHandler({
 - [**Banco de dados**](/docs/database) — o padrão `getDb()`/`schema` importado por rotas personalizadas e actions
 - [**Segurança**](/docs/security#access-guards) — `accessFilter`/`assertAccess` e o modelo completo de escopo de dados
 - [**Mensagens**](/docs/messaging) — o padrão canônico de fila de integração para webhooks recebidos
-- [**Protocolo MCP**](/docs/mcp-protocol) — o endpoint `/_agent-native/mcp` que este servidor monta automaticamente
+- [**Protocolo MCP**](/docs/mcp-protocol) — o endpoint `/mcp` que este servidor monta automaticamente

package/docs/content/locales/pt-BR/skills-guide.mdx

@@ -313,7 +313,7 @@ Cada habilidade apoiada pelo aplicativo começa com `agent-native.app-skill.json
   "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/pt-BR/template-assets.mdx

@@ -493,7 +493,7 @@ selecionador humano UI.
 ### Desenvolvedor: distribua a habilidade do aplicativo
 
 A habilidade do aplicativo Assets tem o ID do aplicativo `assets` e MCP hospedado URL hospedado
-`https://assets.agent-native.com/_agent-native/mcp`.
+`https://assets.agent-native.com/mcp`.
 
 ```bash
 # Instalação hospedada mais fácil: instruções de habilidade exportadas mais conector MCP.

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

@@ -123,7 +123,7 @@ No dia a dia, o Dispatch é o lugar onde os administradores e o pessoal de opera
   Acesso de despacho sem copiar segredos brutos. Fonte específica do aplicativo
   a configuração permanece no aplicativo que usa o provedor.
 - **Exponha um conector MCP.** Adicione
-  `https://dispatch.agent-native.com/_agent-native/mcp` em Claude, ChatGPT,
+  `https://dispatch.agent-native.com/mcp` em Claude, ChatGPT,
   Codex, Cursor ou outro host MCP e escolha quais aplicativos de espaço de trabalho serão
   pode ser acessado na página **Agentes** do Dispatch. Use um aplicativo direto URL
   somente quando esse host deve ser isolado para um aplicativo.
@@ -304,7 +304,7 @@ _Como funciona nos bastidores (para desenvolvedores)._
   ]}
 />
 
-- **Modo hub MCP.** O Dispatch ainda pode atuar como o [MCP hub](/docs/mcp-clients#hub) do espaço de trabalho para que todos os outros aplicativos no espaço de trabalho extraiam a mesma lista de servidores MCP de escopo organizacional. Separadamente, o endpoint `/_agent-native/mcp` do próprio Dispatch é o conector MCP externo recomendado para Claude, ChatGPT e outros hosts que devem alcançar vários aplicativos de espaço de trabalho.
+- **Modo hub MCP.** O Dispatch ainda pode atuar como o [MCP hub](/docs/mcp-clients#hub) do espaço de trabalho para que todos os outros aplicativos no espaço de trabalho extraiam a mesma lista de servidores MCP de escopo organizacional. Separadamente, o endpoint `/mcp` do próprio Dispatch é o conector MCP externo recomendado para Claude, ChatGPT e outros hosts que devem alcançar vários aplicativos de espaço de trabalho.
 
 ## Sonhos {#dreams}
 

package/docs/content/locales/pt-BR/template-plan.mdx

@@ -116,7 +116,7 @@ O comando instala três comandos: `/visual-plan`, `/visual-recap` e `/visualize-
 
 Se você estiver usando um host baseado em bate-papo que aceita conectores MCP diretamente dos URLs
 (em vez de um cliente configurado com CLI), conecte o conector de Planos hospedado em
-`https://plan.agent-native.com/_agent-native/mcp` — consulte [MCP Clients](/docs/mcp-clients) para configuração específica do cliente.
+`https://plan.agent-native.com/mcp` — consulte [MCP Clients](/docs/mcp-clients) para configuração específica do cliente.
 
 A autenticação é um login único do navegador durante a configuração — isso é intencional e é
 é o que permite ao agente persistir e compartilhar os planos que gera. O que a autenticação
@@ -255,7 +255,7 @@ Compartilhar e comentar são os fluxos de trabalho que precisam de uma conta:
   revisão entre dispositivos ou em equipe) requer login. O login do Google aparece quando
   as variáveis de ambiente padrão do Google OAuth estão configuradas.
 
-O conector de planos hospedados fica em `https://plan.agent-native.com/_agent-native/mcp`.
+O conector de planos hospedados fica em `https://plan.agent-native.com/mcp`.
 Nunca coloque segredos compartilhados em arquivos de habilidades.
 
 ## Modo de privacidade de arquivos locais {#local-files}
@@ -454,7 +454,7 @@ pnpm dev
 A habilidade apoiada pelo aplicativo hospedado usa:
 
 - Aplicativo: `https://plan.agent-native.com`
-- MCP: `https://plan.agent-native.com/_agent-native/mcp`
+- MCP: `https://plan.agent-native.com/mcp`
 
 O modelo local é útil quando você está desenvolvendo os próprios Planos, testando a persistência local ou executando uma superfície de revisão totalmente auto-hospedada.
 

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

@@ -538,7 +538,7 @@ JSON 输入是代理和复杂对象的首选形状。标志是
 
 ## 通过 MCP 公开它 {#mcp}
 
-启用 MCP 后，您的 actions 将显示在框架的 MCP 服务器中，位置为 `/_agent-native/mcp`。默认情况下，每个调用者都会获得一个紧凑的目录 - 面向应用程序的内置程序以及模板声明的应用程序 actions - 并且 `tool-search` 始终存在，因此任何其他工具都可以按需访问。完整的操作界面仅在明确选择加入（`--full-catalog` 代币或 `AGENT_NATIVE_MCP_FULL_CATALOG=1`）时提供，并且 `publicAgent.expose` 在公共界面上选择安全读取/摄取工具。请参阅 [MCP Protocol](/docs/mcp-protocol) 了解目录层、身份验证和 `mcpApp` 资源详细信息。
+启用 MCP 后，您的 actions 将显示在框架的 MCP 服务器中，位置为 `/mcp`。默认情况下，每个调用者都会获得一个紧凑的目录 - 面向应用程序的内置程序以及模板声明的应用程序 actions - 并且 `tool-search` 始终存在，因此任何其他工具都可以按需访问。完整的操作界面仅在明确选择加入（`--full-catalog` 代币或 `AGENT_NATIVE_MCP_FULL_CATALOG=1`）时提供，并且 `publicAgent.expose` 在公共界面上选择安全读取/摄取工具。请参阅 [MCP Protocol](/docs/mcp-protocol) 了解目录层、身份验证和 `mcpApp` 资源详细信息。
 
 对于支持 UI 的 MCP 主机，操作可以通过 `mcpApp` 字段（加上匹配的 `link`）声明可选的 MCP Apps 资源，以便有能力的主机内联渲染结果。当 `link` 和 `mcpApp` 应指向同一路线时，`embedRoute()` 从一个纯路径构建器构建两者：
 

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

@@ -219,7 +219,7 @@ ACCESS_TOKENS=token1,token2,token3
 每个应用程序的 MCP 端点都可以充当标准受保护的 MCP 资源。支持 OAuth 的客户端只能配置远程 MCP URL：
 
 ```text
-https://mail.agent-native.com/_agent-native/mcp
+https://mail.agent-native.com/mcp
 ```
 
 未经身份验证的 MCP 请求返回指向 `/.well-known/oauth-protected-resource` 的 `WWW-Authenticate` 质询。然后，客户端发现应用程序的 OAuth 元数据，动态注册公共客户端，打开应用程序的授权页面，并与 PKCE 交换授权代码以获取访问和刷新令牌。

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

@@ -113,16 +113,16 @@ Dispatch 自动发现工作区中的其他应用程序作为 A2A 对等体 - 无
 
 ### 统一MCP网关
 
-Dispatch 可以是外部代理的单个 MCP 连接器：在 Claude、ChatGPT、Codex 或 Cursor 中添加一次 `https://dispatch.agent-native.com/_agent-native/mcp`，一次授权可到达每个授予的工作区应用程序，而不是每个应用程序一个连接器。请参阅 [External Agents](/docs/external-agents) 了解完整的连接流程、应用程序授权、OAuth 和内联 MCP 应用程序预览。
+Dispatch 可以是外部代理的单个 MCP 连接器：在 Claude、ChatGPT、Codex 或 Cursor 中添加一次 `https://dispatch.agent-native.com/mcp`，一次授权可到达每个授予的工作区应用程序，而不是每个应用程序一个连接器。请参阅 [External Agents](/docs/external-agents) 了解完整的连接流程、应用程序授权、OAuth 和内联 MCP 应用程序预览。
 
-<Endpoint id="doc-block-15256oc" 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-15256oc" 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>