@agent-native/core 0.98.17 → 0.99.1

package/docs/content/locales/es-ES/external-agents.mdx

@@ -98,7 +98,7 @@ Agregue un conector MCP remoto al host donde desea utilizar Agent-Native.
 Para trabajos en espacios de trabajo o entre aplicaciones, utilice Dispatch:
 
 ```text
-https://dispatch.agent-native.com/_agent-native/mcp
+https://dispatch.agent-native.com/mcp
 ```
 
 Dispatch es la puerta de enlace única para Mail, Calendar, Analytics, Brain y tu
@@ -109,12 +109,12 @@ llegar a todas las aplicaciones o solo a las seleccionadas. El host conectado ob
 Para una aplicación aislada intencionalmente, úsela directamente:
 
 ```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
 ```
 
 Cada aplicación alojada también tiene una página de ayuda en
-`https://&lt;app&gt;/_agent-native/mcp/connect` con el URL copiable y
+`https://&lt;app&gt;/mcp/connect` con el URL copiable y
 pestañas específicas del host para Claude, ChatGPT, Cursor, Código Claude, Codex y Otros.
 
 ### Claude y ChatGPT OAuth {#oauth}
@@ -238,7 +238,7 @@ Una vez conectado, la autenticación debe persistir a largo plazo: los tokens de
 npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex
 ```
 
-`reconnect` encuentra cualquier entrada de configuración MCP cuyo URL termine en `/_agent-native/mcp` para el host dado y el cliente seleccionado (que coincida con URL independientemente del nombre del conector), luego actualiza o reemplaza el material de autenticación sin tocar su skills instalado ni volver a ejecutar el flujo de instalación completo. Pase la aplicación base URL (por ejemplo, `https://plan.agent-native.com`): se infiere el sufijo `/_agent-native/mcp`. La autenticación y la carga de herramientas son por cliente, así que reinicie/recargue ese cliente después; Codex necesita una nueva sesión antes de que aparezcan las herramientas recién cargadas.
+`reconnect` encuentra cualquier entrada de configuración MCP cuyo URL termine en `/mcp` para el host dado y el cliente seleccionado (que coincida con URL independientemente del nombre del conector), luego actualiza o reemplaza el material de autenticación sin tocar su skills instalado ni volver a ejecutar el flujo de instalación completo. Pase la aplicación base URL (por ejemplo, `https://plan.agent-native.com`): se infiere el sufijo `/mcp`. La autenticación y la carga de herramientas son por cliente, así que reinicie/recargue ese cliente después; Codex necesita una nueva sesión antes de que aparezcan las herramientas recién cargadas.
 
 En el código Claude, la ruta equivalente a UI es: ejecute `/mcp` y elija **Autenticar** (o **Reconectar**) para el conector correspondiente.
 
@@ -246,7 +246,7 @@ Nunca reinstale la habilidad desde cero solo para arreglar un 401: `reconnect` e
 
 ### Conectar página alternativa {#connect-page-fallback}
 
-Para clientes MCP que no pueden agregar un OAuth URL remoto directamente, abra la aplicación en su navegador y use su opción **Connect** (servida en `https://&lt;app&gt;/_agent-native/mcp/connect`). Una vez que haya iniciado sesión, haga clic en **Conectar/Autorizar**. La página le ofrece un enlace profundo de un solo clic que configura un agente detectado o un bloque `.mcp.json` listo para pegar:
+Para clientes MCP que no pueden agregar un OAuth URL remoto directamente, abra la aplicación en su navegador y use su opción **Connect** (servida en `https://&lt;app&gt;/mcp/connect`). Una vez que haya iniciado sesión, haga clic en **Conectar/Autorizar**. La página le ofrece un enlace profundo de un solo clic que configura un agente detectado o un bloque `.mcp.json` listo para pegar:
 
 ```jsonc
 // .mcp.json
@@ -254,7 +254,7 @@ Para clientes MCP que no pueden agregar un OAuth URL remoto directamente, abra l
   "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 @@ Las aplicaciones nativas del agente alojadas también admiten el flujo remoto es
 
 ```bash
 claude mcp add --transport http agent-native \
-  https://dispatch.agent-native.com/_agent-native/mcp
+  https://dispatch.agent-native.com/mcp
 ```
 
 Esta es la misma entrada exclusiva para URL que `npx @agent-native/core@latest connect https://dispatch.agent-native.com --client claude-code` escribe para usted. Luego ejecute `/mcp` en el código Claude y elija **Autenticar**. El cliente descubre la autenticación del desafío `401 WWW-Authenticate` del servidor MCP, recupera `/.well-known/oauth-protected-resource` y `/.well-known/oauth-authorization-server`, registra dinámicamente un cliente público OAuth, abre la página de autorización de la aplicación y almacena el token resultante de forma segura. Los conectores en modo desarrollador ChatGPT utilizan el mismo servidor URL:
 
 ```text
-https://dispatch.agent-native.com/_agent-native/mcp
+https://dispatch.agent-native.com/mcp
 ```
 
 El flujo OAuth es código de autorización + PKCE con rotación de token de actualización. Los tokens de acceso están vinculados a la audiencia al recurso MCP exacto, URL, y llevan la identidad de usuario/organización firmada, por lo que las llamadas a herramientas, `resources/read` y `tools/call` iniciado por iframe de la aplicación MCP se ejecutan a través del mismo alcance de inquilino `runWithRequestContext` que la ruta JWT creada por conexión existente. El iframe nunca recibe tokens OAuth sin procesar; el host media las llamadas a través de la conexión MCP autenticada.
@@ -502,13 +502,13 @@ Consulte [MCP Apps](/docs/mcp-apps) para obtener detalles completos del puente:
 
 Además de las herramientas por acción, el servidor MCP expone un conjunto de verbos estables, por lo que un agente externo tiene una superficie predecible sin adivinar los nombres de acción por aplicación:
 
-| Herramienta                                        | Efectos secundarios | Devoluciones                                                                                                                 |
-| -------------------------------------------------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
-| `list_apps`                                        | ninguno             | aplicaciones de espacio de trabajo + sus URL/estado de ejecución                                                             |
-| `open_app({ app, view?, path?, params?, embed? })` | ninguno             | un enlace profundo o una ruta del mismo origen; `embed: true` renderiza la aplicación completa en línea donde sea compatible |
-| `ask_app({ app, message })`                        | bucle de agente     | enruta una tarea en lenguaje natural al agente dentro de la aplicación de esa aplicación (delega a `ask-agent`)              |
-| `create_workspace_app({ name, template })`         | andamios            | una nueva aplicación iniciada a través de la ruta del espacio de trabajo, además de su URL en ejecución + enlace profundo    |
-| `list_templates`                                   | ninguno             | solo las plantillas incluidas en la lista permitida                                                                          |
+| Herramienta                                        | Efectos secundarios | Devoluciones                                                                                                                                                               |
+| -------------------------------------------------- | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `list_apps`                                        | ninguno             | aplicaciones de espacio de trabajo + sus URL/estado de ejecución                                                                                                           |
+| `open_app({ app, view?, path?, params?, embed? })` | ninguno             | un enlace profundo o una ruta del mismo origen; `embed: true` renderiza la aplicación completa en línea donde sea compatible                                               |
+| `ask_app({ app, message, async?, maxWaitMs? })`    | bucle de agente     | enruta una tarea en lenguaje natural al agente dentro de la aplicación de esa aplicación; el trabajo largo devuelve un `taskId` duradero para sondear con `ask_app_status` |
+| `create_workspace_app({ name, template })`         | andamios            | una nueva aplicación iniciada a través de la ruta del espacio de trabajo, además de su URL en ejecución + enlace profundo                                                  |
+| `list_templates`                                   | ninguno             | solo las plantillas incluidas en la lista permitida                                                                                                                        |
 
 `create_workspace_app` rechaza cualquier plantilla no incluida en la lista de permitidos: la lista de plantillas públicas permitidas en `packages/shared-app-config/templates.ts` tiene autoridad y está protegida por CI; un agente externo no puede ampliarlo. Una acción de plantilla con el mismo nombre anula una acción incorporada (precedencia de plantilla sobre núcleo). Desactive todo el conjunto con `MCPConfig.builtinCrossAppTools: false`.
 
@@ -516,6 +516,19 @@ Los catálogos de herramientas y recursos para hosts de aplicaciones son compact
 
 Para transferencias rápidas de ChatGPT/Claude, la ruta ideal es directa: llame a la acción que crea o abre el artefacto, luego deje que la aplicación MCP inicie la ruta. Una solicitud de correo debe llamar a `manage_draft` y representar la ruta de redacción real. Una solicitud de panel debe llamar a `open_app({ path, embed: true })` o una acción de panel con `mcpApp` y representar la ruta de análisis completa. Calendario, formularios, contenido, diapositivas, diseño y clips deben seguir el mismo patrón con su borrador/creación/búsqueda actions. `list_apps` es útil cuando el modelo debe elegir entre las aplicaciones otorgadas; `resources/list` amplio, descubrimiento de catálogo completo o delegación de `ask_app` no deberían ser la ruta normal para una transferencia obvia de UI.
 
+### Solicitudes de agente de larga duración
+
+Los hosts y gateways MCP no comparten un único tiempo de espera largo para las
+llamadas a herramientas; algunos aplican un límite de cinco minutos y otros lo
+hacen configurable. No diseñe una integración de agente externo alrededor de
+una `tools/call` bloqueante de diez minutos. `ask-agent` y `ask_app` confirman
+el trabajo alojado rápidamente y luego devuelven un `taskId` duradero cuando
+expira la espera en línea. Sondee con `ask_app_status` usando el `app` y el
+`taskId` devueltos; el resultado incluye `pollAfterMs` como un intervalo apto
+para hosts. La tarea debe crearse antes de que la primera respuesta pueda
+agotar el tiempo de espera, por lo que una URL de sondeo devuelta solo después
+de una llamada larga no es un contrato de recuperación confiable.
+
 ### Recorrido por aplicación {#tour}
 
 Cada plantilla incluida en la lista permitida que produce o enumera un recurso navegable incluye un generador `link`, y las de ingesta pesada incluyen una acción GET + `publicAgent` para que un agente conectado pueda obtener el estado en vivo:
@@ -679,7 +692,7 @@ Aprovisiona un token (un `ACCESS_TOKEN` aleatorio en el espacio de trabajo `.env
 - **cowork**: la misma forma del código Claude JSON en `~/.cowork/mcp.json`.
 - **codex**: un bloque `[mcp_servers.<name>]` en `~/.codex/config.toml`.
 
-La entrada ejecuta `npx @agent-native/core@latest mcp serve --app <id>`, que de forma predeterminada es un **proxy stdio ligero** para el `/_agent-native/mcp` de la aplicación local en ejecución, por lo que el registro de acciones en vivo, HMR y los enlaces profundos correctos siguen siendo la única fuente de verdad. Pase `--standalone` para crear el registro en proceso. Cuando `npx @agent-native/core@latest mcp install` detecta un origen alojado (un `APP_URL` / `BETTER_AUTH_URL` / `AGENT_NATIVE_MCP_URL` que no es un host local en el espacio de trabajo `.env`), escribe una entrada de cliente `http` que apunta a `<origin>/_agent-native/mcp` con un `Bearer` JWT en lugar de una entrada stdio.
+La entrada ejecuta `npx @agent-native/core@latest mcp serve --app <id>`, que de forma predeterminada es un **proxy stdio ligero** para el `/mcp` de la aplicación local en ejecución, por lo que el registro de acciones en vivo, HMR y los enlaces profundos correctos siguen siendo la única fuente de verdad. Pase `--standalone` para crear el registro en proceso. Cuando `npx @agent-native/core@latest mcp install` detecta un origen alojado (un `APP_URL` / `BETTER_AUTH_URL` / `AGENT_NATIVE_MCP_URL` que no es un host local en el espacio de trabajo `.env`), escribe una entrada de cliente `http` que apunta a `<origin>/mcp` con un `Bearer` JWT en lugar de una entrada stdio.
 
 Subcomandos complementarios:
 
@@ -703,7 +716,7 @@ También puede escribir la configuración del cliente MCP a mano en cualquier pu
   "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 @@ Las inserciones de aplicaciones completas también evitan entregar el token de p
 El flujo `connect` alojado de reserva nunca copia el secreto compartido de la implementación. En lugar de ello:
 
 - Una sesión de navegador iniciada genera un token **por usuario, con alcance y revocable**: un JWT firmado por `A2A_SECRET` que lleva el `sub` + `org_domain` de la persona que llama y un `jti` único, por lo que cada ejecución de herramienta permanece dentro del alcance del inquilino a través de `runWithRequestContext`.
-- El punto final `/_agent-native/mcp` existente acepta ese token como cualquier otro portador (ver [MCP Protocol](/docs/mcp-protocol)): ni punto final nuevo, ni transporte nuevo.
+- El punto final `/mcp` existente acepta ese token como cualquier otro portador (ver [MCP Protocol](/docs/mcp-protocol)): ni punto final nuevo, ni transporte nuevo.
 - La misma página de Connect enumera todos los tokens que ha acuñado y le permite **revocar** cualquiera de ellos mediante `jti`. Trátelos como tokens de acceso personal: uno por cliente agente y revoque cuando se desmantele una máquina.
 - El vínculo profundo que el agente devuelve no conlleva ningún estado privilegiado. La escritura `navigate` centrada en registros siempre tiene como alcance la sesión del **navegador**, nunca el token del agente, por lo que es seguro pegar un vínculo en una terminal o en la transcripción del chat.
 

package/docs/content/locales/es-ES/mcp-clients.mdx

@@ -246,6 +246,18 @@ Esto significa que los usuarios que han instalado la extensión claude-in-chrome
 
 Los servidores MCP (Protocolo de contexto modelo) le brindan a su agente nuevas capacidades, como conectarse a Zapier, Cloudflare, Composio o las herramientas internas de su empresa. Una vez conectado, el agente puede utilizar esas herramientas al igual que las integradas.
 
+Los identificadores de los ajustes preestablecidos son `context7`, `sentry`, `notion`, `semgrep`, `linear`,
+`atlassian`, `supabase`, `neon` y `stripe`.
+
+### Atlassian / Jira
+
+El ajuste preestablecido de Atlassian usa el punto de conexión OAuth 2.1 de Atlassian Rovo MCP,
+`https://mcp.atlassian.com/v1/mcp/authv2`, y proporciona herramientas de Jira y Confluence. Para crear incidencias de Jira se necesitan los permisos de Atlassian que permiten escribir en Jira; el usuario solo puede ver los proyectos y el contenido a los que su cuenta de Atlassian tiene acceso.
+
+Los administradores de una organización de Atlassian pueden controlar si un cliente OAuth tiene permiso para conectarse. Antes de establecer la conexión, es posible que un administrador deba añadir el origen HTTPS real de la aplicación a la lista de dominios de confianza en **Administración de Atlassian → Rovo → Servidor Rovo MCP → Dominios** y habilitar los permisos necesarios de **Lectura**, **Escritura** y **Búsqueda** en **Permisos**. El dominio debe ser el host en el que se ejecuta la aplicación agent-native; no copie `https://builder.io/**` en otro despliegue salvo que ese sea su origen real. Consulte la [guía de configuración de Rovo MCP](https://developer.atlassian.com/cloud/rovo-mcp/guides/getting-started/) y los [controles de administración](https://support.atlassian.com/security-and-access-policies/docs/control-atlassian-rovo-mcp-server-settings/) de Atlassian.
+
+El catálogo proporciona el punto de conexión y las instrucciones de configuración. El formulario de configuración genérico guarda el punto de conexión y los encabezados cifrados opcionales, pero no sustituye el flujo de consentimiento OAuth interactivo de Atlassian. Use un cliente o un entorno de ejecución MCP compatible con OAuth cuando Atlassian requiera OAuth interactivo. Si el proveedor o el entorno de ejecución admite un token Bearer estático, siga el método aprobado para administrar secretos y nunca pegue tokens en prompts ni en archivos de configuración enviados al repositorio.
+
 ### Cómo conectar un servidor MCP remoto
 
 1. **Nombre del servidor**: una etiqueta breve para su propia referencia (por ejemplo, "zapier", "slack-tools").
@@ -264,7 +276,7 @@ Se admiten dos ámbitos:
 
 Agrega y elimina la recarga en caliente en el administrador MCP en ejecución: sin reinicio del proceso ni reinicio del servidor. Las nuevas herramientas `mcp__<scope>-<name>__*` le aparecen al agente en el siguiente mensaje y se pueden buscar a través de `tool-search`.
 
-HTTPS URL se aceptan en todas partes; `http://` simple solo se permite para `localhost` durante el desarrollo. La autenticación opcional se ingresa como un token de portador que se envía a través de `Authorization: Bearer …` en cada solicitud.
+HTTPS URL se aceptan en todas partes; `http://` simple solo se permite para `localhost` durante el desarrollo. La autenticación opcional se ingresa como un token de portador que se envía a través de `Authorization: Bearer …` en cada solicitud. Los proveedores que solo admiten OAuth, incluido Atlassian Rovo MCP, requieren el flujo OAuth del proveedor en lugar de un encabezado estático.
 
 En el fondo, estos servidores persisten en la tabla `settings` del marco bajo la clave `u:<email>:mcp-servers-remote` (Personal) o `o:<orgId>:mcp-servers-remote` (Equipo) y se fusionan con `mcp.config.json` al inicio.
 
@@ -294,7 +306,9 @@ El envío es el centro convencional: ya coordina todas las aplicaciones.
     <span class="diagram-pill accent">Dispatch hub</span
     ><small class="diagram-muted"
       >servidores MCP con alcance de organización</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>
@@ -456,7 +470,7 @@ Utilice esto para crear sugerencias de incorporación de "Claude-in-chrome detec
 
 Las fallas individuales del servidor MCP nunca desactivan el agente:
 
-- Un `command` mal configurado → se omite el servidor, su error aparece en `/mcp/status` debajo de `errors.<server-id>` y todos los demás servidores continúan funcionando.
+- Un `command` mal configurado → se omite el servidor, su error aparece en `/_agent-native/mcp/status` debajo de `errors.<server-id>` y todos los demás servidores continúan funcionando.
 - Falta el MCP SDK en `node_modules` → todas las funciones de MCP se omiten con una advertencia; El chat del agente sigue funcionando sin herramientas MCP.
 - Ejecutar en un tiempo de ejecución perimetral → El cliente MCP no funciona.
 

package/docs/content/locales/es-ES/mcp-protocol.mdx

@@ -22,7 +22,7 @@ MCP es el protocolo estándar para conectar herramientas de IA a capacidades ext
 
 Conceptos clave:
 
-- **Montado automáticamente**: cada aplicación obtiene `/_agent-native/mcp` gratis, no requiere configuración
+- **Montado automáticamente**: cada aplicación obtiene `/mcp` gratis, no requiere configuración
 - **HTTP transmitible**: utiliza el transporte moderno MCP sobre el estándar HTTP (POST + SSE)
 - **Mismo actions**: exactamente el mismo registro de acciones que impulsa el chat del agente y A2A
 - **Herramienta `ask-agent`**: una metaherramienta que delega al ciclo completo del agente para tareas complejas
@@ -41,7 +41,7 @@ Conceptos clave:
   </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 protocolos se montan automáticamente. Utilice el que se ajuste a su caso
 | **Mejor para**                     | Herramientas externas que llaman a tu aplicación                      | Comunicación de agente a agente                     |
 | **Protocolo**                      | MCP HTTP transmitible                                                 | JSON-RPC 2.0                                        |
 | **Descubrimiento de herramientas** | `tools/list`                                                          | Tarjeta de agente en `/.well-known/agent-card.json` |
-| **Punto final**                    | `/_agent-native/mcp`                                                  | `/_agent-native/a2a`                                |
+| **Punto final**                    | `/mcp`                                                                | `/_agent-native/a2a`                                |
 | **Con el apoyo de**                | Claude, ChatGPT, Claude Code, Cursor, Codex, Cowork y otros hosts MCP | Otras aplicaciones nativas del agente               |
 | **Ejecución**                      | Llamadas directas a herramientas (sin LLM adicionales)                | Bucle de agente completo (razonamiento LLM)         |
 
@@ -105,7 +105,7 @@ También puedes usar la herramienta `ask-agent` MCP para obtener lo mejor de amb
 Para la configuración de un solo comando recomendada, utilice [External Agents](/docs/external-agents). Si está escribiendo a mano la configuración de MCP para un cliente compatible con OAuth, agregue su aplicación como un servidor MCP remoto sin encabezados 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
 ```
 
 O escriba la entrada a mano en `.mcp.json` (alcance del proyecto) o `~/.claude.json` (alcance del usuario):
@@ -116,7 +116,7 @@ O escriba la entrada a mano en `.mcp.json` (alcance del proyecto) o `~/.claude.j
   "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
 Cualquier cliente MCP que admita el transporte Streamable HTTP puede conectarse. El punto final es:
 
 ```
-POST https://your-app.example.com/_agent-native/mcp
+POST https://your-app.example.com/mcp
 ```
 
 El servidor admite el protocolo de enlace estándar MCP: `initialize` → `initialized` → `tools/list` → `tools/call`.
 
-<Endpoint id="doc-block-1t35cn" title="Endpoint MCP" summary={"El punto final Streamable HTTP montado automáticamente que expone cada aplicación nativa del agente."} method="POST" path="/_agent-native/mcp" summary="MCP Punto final HTTP transmitible" auth="Standard remote MCP OAuth (Bearer access token), connect-minted JWT, or static ACCESS_TOKEN/ACCESS_TOKENS" params={[
+<Endpoint id="doc-block-1t35cn" title="Endpoint MCP" summary={"El punto final Streamable HTTP montado automáticamente que expone cada aplicación nativa del agente."} method="POST" path="/mcp" summary="MCP Punto final HTTP transmitible" 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,41 @@ Cuando `mcpApp` está presente, la entrada de herramienta también incluye `_met
 
 Además de las herramientas de acción individuales, cada servidor MCP incluye una metaherramienta `ask-agent`. Esto envía un mensaje en lenguaje natural al agente de inteligencia artificial de la aplicación y devuelve la respuesta.
 
+Las solicitudes MCP alojadas usan una espera en línea acotada para que un
+ciclo de agente largo no mantenga abierta una `tools/call` hasta el tiempo de
+espera de un cliente o gateway. El argumento opcional `async` inicia la tarea
+duradera y devuelve el control de inmediato; sin él, el servidor espera
+brevemente una finalización rápida y luego devuelve un identificador de tarea
+cuando queda trabajo pendiente. La espera alojada tiene un límite de 25
+segundos.
+
 Utilice `ask-agent` para tareas complejas que se beneficien del razonamiento y el contexto del 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
+  }
+}
+```
+
+El agente ejecuta el mismo ciclo que el chat interactivo: puede llamar a múltiples herramientas, razonar sobre el contexto y producir una respuesta reflexiva. Una tarea que no ha terminado devuelve JSON que contiene `taskId`, `status`, `pollAfterMs`, y:
+
+```json
+{
+  "poll": {
+    "tool": "ask_app_status",
+    "arguments": { "app": "mail", "taskId": "task_123" }
   }
 }
 ```
 
-El agente ejecuta el mismo ciclo que el chat interactivo: puede llamar a múltiples herramientas, razonar sobre el contexto y producir una respuesta reflexiva.
+Llame a `ask_app_status` con esos argumentos hasta que la tarea alcance un
+estado terminal. El `ask_app` propio de cada aplicación en Dispatch usa el
+mismo contrato de tarea y estado duraderos, con la concesión de la aplicación
+seleccionada verificada tanto en el envío como en el sondeo.
 
 ## Autenticación {#authentication}
 
@@ -233,7 +256,7 @@ El punto final MCP admite MCP OAuth remoto estándar más el respaldo de token d
 Para hosts MCP compatibles con OAuth, configure el servidor remoto URL sin encabezados 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
 ```
 
 La primera solicitud MCP no autenticada recibe:
@@ -249,9 +272,9 @@ Puntos finales de descubrimiento:
 | ----------------------------------------- | ---------------------------------------------------------------- |
 | `/.well-known/oauth-protected-resource`   | RFC 9728 metadatos de recursos protegidos                        |
 | `/.well-known/oauth-authorization-server` | Metadatos del servidor de autorización OAuth                     |
-| `/_agent-native/mcp/oauth/register`       | Registro dinámico de cliente público                             |
-| `/_agent-native/mcp/oauth/authorize`      | Autorización del navegador + consentimiento                      |
-| `/_agent-native/mcp/oauth/token`          | Concesiones de códigos de autorización y tokens de actualización |
+| `/mcp/oauth/register`                     | Registro dinámico de cliente público                             |
+| `/mcp/oauth/authorize`                    | Autorización del navegador + consentimiento                      |
+| `/mcp/oauth/token`                        | Concesiones de códigos de autorización y tokens de actualización |
 
 <Diagram id="doc-block-1infile" title="OAuth flujo de descubrimiento" summary={"Un 401 inicia el descubrimiento, el registro y una autorización PKCE → intercambio de tokens. El token de portador está limitado a la audiencia y tiene un alcance."}>
 
@@ -351,7 +374,7 @@ export default defineNitroPlugin(async (nitro) => {
 Tiene una aplicación de análisis implementada en `analytics.example.com`. Del 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
 ```
 
 O agregarlo a mano en `.mcp.json`:
@@ -362,7 +385,7 @@ O agregarlo a mano en `.mcp.json`:
   "mcpServers": {
     "analytics": {
       "type": "http",
-      "url": "https://analytics.example.com/_agent-native/mcp",
+      "url": "https://analytics.example.com/mcp",
     },
   },
 }

package/docs/content/locales/es-ES/plan-plugin.mdx

@@ -12,7 +12,7 @@ La aplicación **Plan** de Agent-Native se envía como un paquete instalable. Un
 Una instalación te ofrece:
 
 - **Tres skills**: `/visual-plan` (el punto de entrada canónico), `/visual-recap` y `/visualize-repo`.
-- **El conector del plan MCP**: registrado en la aplicación alojada en `https://plan.agent-native.com` (extremo MCP `https://plan.agent-native.com/_agent-native/mcp`, nombre de servidor `plan`).
+- **El conector del plan MCP**: registrado en la aplicación alojada en `https://plan.agent-native.com` (extremo MCP `https://plan.agent-native.com/mcp`, nombre de servidor `plan`).
 
 <Diagram id="doc-block-1i4grvb" title="Tres rutas, un paquete" summary={"El CLI universal, el complemento de Claude Code y el complemento de Codex instalan las mismas skills de Plan más el conector de Plan alojado."}>
 
@@ -43,7 +43,7 @@ Una instalación te ofrece:
   <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 en el navegador
 ```
 
-Después de la instalación, **inicie un nuevo subproceso Codex** para que las herramientas skills y MCP se carguen en la sesión. El complemento incluye un conector exclusivo para URL (`[mcp_servers.plan]` → `https://plan.agent-native.com/_agent-native/mcp`); `codex mcp login plan` ejecuta el flujo OAuth. La ruta universal CLI anterior también funciona para Codex (`npx @agent-native/core@latest skills add visual-plan --client codex`) si prefiere un comando que instale y autentique juntos, o cuando desea archivos locales o modo autohospedado.
+Después de la instalación, **inicie un nuevo subproceso Codex** para que las herramientas skills y MCP se carguen en la sesión. El complemento incluye un conector exclusivo para URL (`[mcp_servers.plan]` → `https://plan.agent-native.com/mcp`); `codex mcp login plan` ejecuta el flujo OAuth. La ruta universal CLI anterior también funciona para Codex (`npx @agent-native/core@latest skills add visual-plan --client codex`) si prefiere un comando que instale y autentique juntos, o cuando desea archivos locales o modo autohospedado.
 
 > **Instalaciones anteriores:** si su configuración todavía tiene una entrada `agent-native-plans` que apunta al mismo URL, ejecutando `npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex` para Codex, o el mismo comando con su `--client` de destino, lo consolida con el nombre canónico `plan`.
 

package/docs/content/locales/es-ES/server.mdx

@@ -269,7 +269,7 @@ El marco monta sus propias rutas bajo `/_agent-native/`. Trate ese espacio de no
 | `/_agent-native/extensions/*`    | Extensiones de tiempo de ejecución y proxy de extensión (alias heredado: `/_agent-native/tools/*`) |
 | `/_agent-native/integrations/*`  | Integraciones de mensajería/webhook                                                                |
 | `/_agent-native/a2a`             | Agente a agente JSON-RPC                                                                           |
-| `/_agent-native/mcp`             | Punto final MCP                                                                                    |
+| `/mcp`                           | Punto final MCP                                                                                    |
 | `/_agent-native/onboarding/*`    | Lista de verificación de configuración                                                             |
 | `/_agent-native/observability/*` | Seguimientos, comentarios, evaluaciones, experimentos                                              |
 | `/_agent-native/file-upload`     | Punto final del proveedor de carga de archivos                                                     |
@@ -465,4 +465,4 @@ const handler = createProductionAgentHandler({
 - [**Base de datos**](/docs/database) — el patrón `getDb()`/`schema` que importan tanto las rutas personalizadas como las acciones
 - [**Seguridad**](/docs/security#access-guards) — `accessFilter`/`assertAccess` y el modelo completo de ámbito de datos
 - [**Mensajería**](/docs/messaging) — el patrón canónico de cola de integración para webhooks entrantes
-- [**Protocolo MCP**](/docs/mcp-protocol) — el endpoint `/_agent-native/mcp` que este servidor monta automáticamente
+- [**Protocolo MCP**](/docs/mcp-protocol) — el endpoint `/mcp` que este servidor monta automáticamente

package/docs/content/locales/es-ES/skills-guide.mdx

@@ -313,7 +313,7 @@ Cada habilidad respaldada por la aplicación comienza con `agent-native.app-skil
   "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/es-ES/template-assets.mdx

@@ -493,7 +493,7 @@ recolector humano UI.
 ### Desarrollador: distribuir la habilidad de la aplicación
 
 La habilidad de la aplicación Assets tiene el ID de aplicación `assets` y está alojado MCP URL
-`https://assets.agent-native.com/_agent-native/mcp`.
+`https://assets.agent-native.com/mcp`.
 
 ```bash
 # Instalación alojada más sencilla: instrucciones de habilidades exportadas más conector MCP.

package/docs/content/locales/es-ES/template-dispatch.mdx

@@ -123,7 +123,7 @@ Día a día, Dispatch es el lugar donde los administradores y el personal de ope
   Acceso de envío sin copiar secretos sin procesar. Fuente específica de la aplicación
   la configuración permanece en la aplicación que utiliza el proveedor.
 - **Exponer un conector MCP.** Agregar
-  `https://dispatch.agent-native.com/_agent-native/mcp` en Claude, ChatGPT,
+  `https://dispatch.agent-native.com/mcp` en Claude, ChatGPT,
   Codex, Cursor u otro host MCP, luego elija qué aplicaciones del espacio de trabajo
   puede comunicarse desde la página **Agentes** de Dispatch. Utilice una aplicación directa URL
   solo cuando ese host debe estar aislado en una aplicación.
@@ -304,7 +304,7 @@ _Cómo funciona internamente (para desarrolladores)._
   ]}
 />
 
-- **Modo concentrador MCP.** Dispatch aún puede actuar como [MCP hub](/docs/mcp-clients#hub) del espacio de trabajo, por lo que todas las demás aplicaciones del espacio de trabajo extraen la misma lista de servidores MCP del ámbito de la organización. Por otra parte, el punto final `/_agent-native/mcp` de Dispatch es el conector MCP externo recomendado para Claude, ChatGPT y otros hosts que deberían llegar a múltiples aplicaciones de espacio de trabajo.
+- **Modo concentrador MCP.** Dispatch aún puede actuar como [MCP hub](/docs/mcp-clients#hub) del espacio de trabajo, por lo que todas las demás aplicaciones del espacio de trabajo extraen la misma lista de servidores MCP del ámbito de la organización. Por otra parte, el punto final `/mcp` de Dispatch es el conector MCP externo recomendado para Claude, ChatGPT y otros hosts que deberían llegar a múltiples aplicaciones de espacio de trabajo.
 
 ## Sueños {#dreams}
 

package/docs/content/locales/es-ES/template-plan.mdx

@@ -114,7 +114,7 @@ El comando instala tres comandos: `/visual-plan`, `/visual-recap` y `/visualize-
 
 Si está utilizando un host basado en chat que acepta conectores MCP URL directamente
 (en lugar de un cliente configurado con CLI), conecte el conector de planes alojado en
-`https://plan.agent-native.com/_agent-native/mcp`: consulte [MCP Clients](/docs/mcp-clients) para conocer la configuración específica del cliente.
+`https://plan.agent-native.com/mcp`: consulte [MCP Clients](/docs/mcp-clients) para conocer la configuración específica del cliente.
 
 La autenticación es un inicio de sesión único en el navegador durante la configuración; esto es lo que se pretende y
 es lo que permite al agente persistir y compartir los planes que genera. ¿Qué diablos?
@@ -253,7 +253,7 @@ Compartir y comentar son los flujos de trabajo que necesitan una cuenta:
   revisión en varios dispositivos o en equipo) requiere iniciar sesión. El inicio de sesión de Google aparece cuando
   las variables de entorno estándar de Google OAuth están configuradas.
 
-El conector de planes alojado se encuentra en `https://plan.agent-native.com/_agent-native/mcp`.
+El conector de planes alojado se encuentra en `https://plan.agent-native.com/mcp`.
 Nunca coloques secretos compartidos en archivos de habilidades.
 
 ## Modo de privacidad de archivos locales {#local-files}
@@ -452,7 +452,7 @@ pnpm dev
 La habilidad respaldada por la aplicación alojada utiliza:
 
 - Aplicación: `https://plan.agent-native.com`
-- MCP: `https://plan.agent-native.com/_agent-native/mcp`
+- MCP: `https://plan.agent-native.com/mcp`
 
 La plantilla local es útil cuando estás desarrollando planes, probando la persistencia local o ejecutando una superficie de revisión totalmente autohospedada.
 

package/docs/content/locales/fr-FR/actions.mdx

@@ -540,7 +540,7 @@ Si votre application est un homologue [A2A](/docs/a2a-protocol), d'autres applic
 
 ## L'exposer sur MCP {#mcp}
 
-Avec MCP activé, votre actions apparaît sur le serveur MCP du framework à `/_agent-native/mcp`. Chaque appelant reçoit par défaut un catalogue compact (intégrés aux applications plus l'application actions déclarée dans le modèle) et `tool-search` est toujours présent afin que tout autre outil reste accessible à la demande. La surface d'action complète n'est servie que sur adhésion explicite (jeton `--full-catalog` ou `AGENT_NATIVE_MCP_FULL_CATALOG=1`), et `publicAgent.expose` opte pour un outil de lecture/ingestion sécurisé sur la surface publique. Consultez [MCP Protocol](/docs/mcp-protocol) pour connaître les niveaux de catalogue, l'authentification et les détails des ressources `mcpApp`.
+Avec MCP activé, votre actions apparaît sur le serveur MCP du framework à `/mcp`. Chaque appelant reçoit par défaut un catalogue compact (intégrés aux applications plus l'application actions déclarée dans le modèle) et `tool-search` est toujours présent afin que tout autre outil reste accessible à la demande. La surface d'action complète n'est servie que sur adhésion explicite (jeton `--full-catalog` ou `AGENT_NATIVE_MCP_FULL_CATALOG=1`), et `publicAgent.expose` opte pour un outil de lecture/ingestion sécurisé sur la surface publique. Consultez [MCP Protocol](/docs/mcp-protocol) pour connaître les niveaux de catalogue, l'authentification et les détails des ressources `mcpApp`.
 
 Pour les hôtes MCP compatibles UI, une action peut déclarer une ressource d'applications MCP facultative via le champ `mcpApp` (plus un `link` correspondant) afin que les hôtes capables rendent le résultat en ligne. Lorsque `link` et `mcpApp` doivent pointer vers le même itinéraire, `embedRoute()` construit les deux à partir d'un seul générateur de chemin pur :
 

package/docs/content/locales/fr-FR/authentication.mdx

@@ -219,7 +219,7 @@ La configuration de ces variables ne génère jamais de page de connexion par je
 Le point de terminaison MCP de chaque application peut agir comme une ressource MCP protégée standard. Les clients compatibles OAuth peuvent être configurés uniquement avec le MCP URL distant :
 
 ```text
-https://mail.agent-native.com/_agent-native/mcp
+https://mail.agent-native.com/mcp
 ```
 
 Les requêtes MCP non authentifiées renvoient un défi `WWW-Authenticate` pointant vers `/.well-known/oauth-protected-resource`. Le client découvre ensuite les métadonnées OAuth de l'application, enregistre dynamiquement un client public, ouvre la page d'autorisation de l'application et échange un code d'autorisation avec PKCE pour les jetons d'accès et d'actualisation.

package/docs/content/locales/fr-FR/dispatch.mdx

@@ -113,16 +113,16 @@ Dispatch découvre automatiquement les autres applications de votre espace de tr
 
 ### Passerelle unifiée MCP
 
-Dispatch peut être le connecteur MCP unique pour les agents externes : ajoutez `https://dispatch.agent-native.com/_agent-native/mcp` une fois dans Claude, ChatGPT, Codex ou Cursor, et une autorisation atteint chaque application d'espace de travail accordée au lieu d'un connecteur par application. Consultez [External Agents](/docs/external-agents) pour connaître le flux de connexion complet, les subventions d'application, OAuth et les aperçus de l'application MCP en ligne.
+Dispatch peut être le connecteur MCP unique pour les agents externes : ajoutez `https://dispatch.agent-native.com/mcp` une fois dans Claude, ChatGPT, Codex ou Cursor, et une autorisation atteint chaque application d'espace de travail accordée au lieu d'un connecteur par application. Consultez [External Agents](/docs/external-agents) pour connaître le flux de connexion complet, les subventions d'application, OAuth et les aperçus de l'application MCP en ligne.
 
-<Endpoint id="doc-block-173hyrp" method="POST" path="/_agent-native/mcp" summary={"Point de terminaison de passerelle MCP unifiée"} 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-173hyrp" method="POST" path="/mcp" summary={"Point de terminaison de passerelle MCP unifiée"} 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>