@agent-native/core 0.98.17 → 0.99.1

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

package/corpus/core/docs/content/locales/fr-FR/external-agents.mdx

@@ -98,7 +98,7 @@ Ajoutez un connecteur MCP distant à l'hôte sur lequel vous souhaitez utiliser
 Pour le travail dans un espace de travail ou entre applications, utilisez Dispatch :
 
 ```text
-https://dispatch.agent-native.com/_agent-native/mcp
+https://dispatch.agent-native.com/mcp
 ```
 
 Dispatch est la passerelle unique pour Mail, Calendrier, Analytics, Brain et votre
@@ -109,12 +109,12 @@ atteindre toutes les applications ou uniquement les applications sélectionnées
 Pour une application intentionnellement isolée, utilisez cette application directement :
 
 ```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
 ```
 
 Chaque application hébergée dispose également d'une page d'aide à l'adresse
-`https://&lt;app&gt;/_agent-native/mcp/connect` avec le URL copiable et
+`https://&lt;app&gt;/mcp/connect` avec le URL copiable et
 Onglets spécifiques à l'hôte pour Claude, ChatGPT, Cursor, Claude Code, Codex et autres.
 
 ### Claude et ChatGPT OAuth {#oauth}
@@ -238,7 +238,7 @@ Une fois connecté, l'authentification doit persister à long terme : les jeton
 npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex
 ```
 
-`reconnect` trouve toute entrée de configuration MCP dont URL se termine par `/_agent-native/mcp` pour l'hôte donné et le client sélectionné (correspondant à URL quel que soit le nom du connecteur), puis actualise ou remplace le matériel d'authentification sans toucher à votre skills installé ni réexécuter le flux d'installation complet. Transmettez l'application de base URL (par exemple `https://plan.agent-native.com`) — le suffixe `/_agent-native/mcp` est déduit. L'authentification et le chargement des outils se font par client, alors redémarrez/rechargez ce client par la suite ; Codex a besoin d'une nouvelle session avant que les outils nouvellement chargés n'apparaissent.
+`reconnect` trouve toute entrée de configuration MCP dont URL se termine par `/mcp` pour l'hôte donné et le client sélectionné (correspondant à URL quel que soit le nom du connecteur), puis actualise ou remplace le matériel d'authentification sans toucher à votre skills installé ni réexécuter le flux d'installation complet. Transmettez l'application de base URL (par exemple `https://plan.agent-native.com`) — le suffixe `/mcp` est déduit. L'authentification et le chargement des outils se font par client, alors redémarrez/rechargez ce client par la suite ; Codex a besoin d'une nouvelle session avant que les outils nouvellement chargés n'apparaissent.
 
 Dans le code Claude, le chemin UI équivalent est : exécutez `/mcp` et choisissez **Authentifier** (ou **Reconnecter**) pour le connecteur concerné.
 
@@ -246,7 +246,7 @@ Ne réinstallez jamais la compétence à partir de zéro juste pour réparer un
 
 ### Page de secours de connexion {#connect-page-fallback}
 
-Pour les clients MCP qui ne peuvent pas ajouter directement un OAuth distant URL, ouvrez l'application dans votre navigateur et utilisez son offre **Connect** (servie sur `https://&lt;app&gt;/_agent-native/mcp/connect`). Une fois connecté, cliquez sur **Connecter/Autoriser**. La page vous remet soit un lien profond en un clic qui configure un agent détecté, soit un bloc `.mcp.json` prêt à coller :
+Pour les clients MCP qui ne peuvent pas ajouter directement un OAuth distant URL, ouvrez l'application dans votre navigateur et utilisez son offre **Connect** (servie sur `https://&lt;app&gt;/mcp/connect`). Une fois connecté, cliquez sur **Connecter/Autoriser**. La page vous remet soit un lien profond en un clic qui configure un agent détecté, soit un bloc `.mcp.json` prêt à coller :
 
 ```jsonc
 // .mcp.json
@@ -254,7 +254,7 @@ Pour les clients MCP qui ne peuvent pas ajouter directement un OAuth distant URL
   "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 @@ Les applications natives d'agent hébergées prennent également en charge le fl
 
 ```bash
 claude mcp add --transport http agent-native \
-  https://dispatch.agent-native.com/_agent-native/mcp
+  https://dispatch.agent-native.com/mcp
 ```
 
 Il s'agit de la même entrée réservée uniquement à URL que `npx @agent-native/core@latest connect https://dispatch.agent-native.com --client claude-code` écrit pour vous. Exécutez ensuite `/mcp` dans le code Claude et choisissez **Authentifier**. Le client découvre l'authentification à partir du défi `401 WWW-Authenticate` du serveur MCP, récupère `/.well-known/oauth-protected-resource` et `/.well-known/oauth-authorization-server`, enregistre dynamiquement un client OAuth public, ouvre la page d'autorisation de l'application et stocke le jeton résultant en toute sécurité. Les connecteurs en mode développeur ChatGPT utilisent le même serveur URL :
 
 ```text
-https://dispatch.agent-native.com/_agent-native/mcp
+https://dispatch.agent-native.com/mcp
 ```
 
 Le flux OAuth est le code d'autorisation + PKCE avec rotation du jeton d'actualisation. Les jetons d'accès sont liés au public à la ressource MCP exacte URL et portent l'identité signée de l'utilisateur/de l'organisation. Ainsi, les appels d'outils, `resources/read` et MCP initiés par iframe de l'application `tools/call` s'exécutent tous via la même portée de locataire `runWithRequestContext` que le chemin JWT existant créé par la connexion. L'iframe ne reçoit jamais de jetons OAuth bruts ; l'hôte négocie les appels via la connexion authentifiée MCP.
@@ -502,13 +502,13 @@ Voir [MCP Apps](/docs/mcp-apps) pour plus de détails sur le pont : transplanta
 
 En plus des outils par action, le serveur MCP expose un ensemble de verbes stable, de sorte qu'un agent externe dispose d'une surface prévisible sans deviner les noms d'action par application :
 
-| Outil                                              | Effets secondaires | Retours                                                                                                                              |
-| -------------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
-| `list_apps`                                        | aucun              | applications d'espace de travail + leurs URL/état d'exécution                                                                        |
-| `open_app({ app, view?, path?, params?, embed? })` | aucun              | un lien profond ou une route de même origine ; `embed: true` restitue l'application complète en ligne là où elle est prise en charge |
-| `ask_app({ app, message })`                        | boucle d'agent     | achemine une tâche en langage naturel vers l'agent intégré à l'application (délégués à `ask-agent`)                                  |
-| `create_workspace_app({ name, template })`         | échafaudages       | une nouvelle application démarrée via le chemin de l'espace de travail, ainsi que son URL en cours d'exécution + son lien profond    |
-| `list_templates`                                   | aucun              | les modèles autorisés uniquement                                                                                                     |
+| Outil                                              | Effets secondaires | Retours                                                                                                                                                                 |
+| -------------------------------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `list_apps`                                        | aucun              | applications d'espace de travail + leurs URL/état d'exécution                                                                                                           |
+| `open_app({ app, view?, path?, params?, embed? })` | aucun              | un lien profond ou une route de même origine ; `embed: true` restitue l'application complète en ligne là où elle est prise en charge                                    |
+| `ask_app({ app, message, async?, maxWaitMs? })`    | boucle d'agent     | achemine une tâche en langage naturel vers l'agent intégré à l'application ; les tâches longues renvoient un `taskId` durable pour l'interrogation via `ask_app_status` |
+| `create_workspace_app({ name, template })`         | échafaudages       | une nouvelle application démarrée via le chemin de l'espace de travail, ainsi que son URL en cours d'exécution + son lien profond                                       |
+| `list_templates`                                   | aucun              | les modèles autorisés uniquement                                                                                                                                        |
 
 `create_workspace_app` rejette tout modèle non autorisé : la liste verte de modèles publics dans `packages/shared-app-config/templates.ts` fait autorité et est protégée par CI ; un agent extérieur ne peut pas l’élargir. Une action de modèle du même nom remplace une action intégrée (précédence du modèle sur le noyau). Désactivez l'ensemble avec `MCPConfig.builtinCrossAppTools: false`.
 
@@ -516,6 +516,10 @@ Les catalogues d'outils et de ressources pour les hôtes d'applications sont com
 
 Pour des transferts rapides ChatGPT/Claude, le chemin idéal est direct : appelez l'action qui crée ou ouvre l'artefact, puis laissez l'application MCP lancer l'itinéraire. Une requête Mail doit appeler `manage_draft` et afficher la véritable route de composition. Une demande de tableau de bord doit appeler `open_app({ path, embed: true })` ou une action de tableau de bord avec `mcpApp` et afficher l'itinéraire Analytics complet. Le calendrier, les formulaires, le contenu, les diapositives, la conception et les clips doivent suivre le même modèle avec leur brouillon/création/recherche actions. `list_apps` est utile lorsque le modèle doit choisir parmi les applications accordées ; Une large `resources/list`, une découverte de catalogue complet ou une délégation `ask_app` ne devraient pas être la voie normale pour un transfert évident de UI.
 
+### Requêtes d'agent de longue durée
+
+Les hôtes et passerelles MCP ne partagent pas un seul et même délai d'expiration pour les appels d'outils : certains imposent un plafond de cinq minutes, d'autres sont configurables. Ne concevez pas une intégration d'agent externe autour d'un `tools/call` bloquant de dix minutes. `ask-agent` et `ask_app` accusent rapidement réception du travail hébergé, puis renvoient un `taskId` durable lorsque l'attente en ligne expire. Interrogez avec `ask_app_status` en utilisant les `app` et `taskId` renvoyés ; le résultat inclut `pollAfterMs` comme intervalle adapté à l'hôte. La tâche doit être créée avant que la première réponse ne puisse expirer, de sorte qu'une URL d'interrogation renvoyée seulement après un long appel n'est pas un contrat de récupération fiable.
+
 ### Visite par application {#tour}
 
 Chaque modèle sur liste verte qui produit ou répertorie une ressource navigable est livré avec un générateur `link`, et ceux qui sont lourds à ingérer envoient une action GET + `publicAgent` afin qu'un agent connecté puisse extraire l'état en direct :
@@ -679,7 +683,7 @@ Il provisionne un jeton (un `ACCESS_TOKEN` aléatoire dans l'espace de travail `
 - **cowork** — la même forme du code Claude JSON dans `~/.cowork/mcp.json`.
 - **codex** — un bloc `[mcp_servers.<name>]` dans `~/.codex/config.toml`.
 
-L'entrée exécute `npx @agent-native/core@latest mcp serve --app <id>`, qui est par défaut un **thin stdio proxy** pour le `/_agent-native/mcp` de l'application locale en cours d'exécution — de sorte que le registre d'action en direct, HMR et les liens profonds corrects restent la source unique de vérité. Transmettez `--standalone` pour créer le registre en cours de processus. Lorsque `npx @agent-native/core@latest mcp install` détecte une origine hébergée (un hôte non local `APP_URL` / `BETTER_AUTH_URL` / `AGENT_NATIVE_MCP_URL` dans l'espace de travail `.env`), il écrit une entrée client `http` pointant vers `<origin>/_agent-native/mcp` avec un `Bearer` JWT au lieu d'une entrée stdio.
+L'entrée exécute `npx @agent-native/core@latest mcp serve --app <id>`, qui est par défaut un **thin stdio proxy** pour le `/mcp` de l'application locale en cours d'exécution — de sorte que le registre d'action en direct, HMR et les liens profonds corrects restent la source unique de vérité. Transmettez `--standalone` pour créer le registre en cours de processus. Lorsque `npx @agent-native/core@latest mcp install` détecte une origine hébergée (un hôte non local `APP_URL` / `BETTER_AUTH_URL` / `AGENT_NATIVE_MCP_URL` dans l'espace de travail `.env`), il écrit une entrée client `http` pointant vers `<origin>/mcp` avec un `Bearer` JWT au lieu d'une entrée stdio.
 
 Sous-commandes compagnon :
 
@@ -703,7 +707,7 @@ Vous pouvez également écrire manuellement la configuration du client MCP sur n
   "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 +749,7 @@ Les intégrations d'applications complètes évitent également de transmettre l
 Le flux `connect` hébergé de secours ne copie jamais le secret partagé du déploiement. Au lieu de cela :
 
 - Une session de navigateur connectée génère un jeton **par utilisateur, limité et révocable** : un JWT signé `A2A_SECRET` portant le `sub` + `org_domain` de l'appelant et un `jti` unique, de sorte que chaque exécution d'outil reste limitée au client via `runWithRequestContext`.
-- Le point de terminaison `/_agent-native/mcp` existant accepte ce jeton comme n'importe quel autre support (voir [MCP Protocol](/docs/mcp-protocol)) — pas de nouveau point de terminaison, pas de nouveau transport.
+- Le point de terminaison `/mcp` existant accepte ce jeton comme n'importe quel autre support (voir [MCP Protocol](/docs/mcp-protocol)) — pas de nouveau point de terminaison, pas de nouveau transport.
 - La même page Connect répertorie tous les jetons que vous avez créés et vous permet de **révoquer** n'importe lequel d'entre eux par `jti`. Traitez-les comme des jetons d'accès personnels : un par client agent, révoqué lorsqu'une machine est mise hors service.
 - Le lien profond que l'agent restitue ne comporte aucun état privilégié. L'écriture `navigate` axée sur l'enregistrement est toujours limitée à la session du **navigateur**, jamais au jeton de l'agent. Un lien peut donc être collé en toute sécurité dans un terminal ou une transcription de discussion.
 

package/corpus/core/docs/content/locales/fr-FR/mcp-clients.mdx

@@ -245,6 +245,18 @@ Cela signifie que les utilisateurs qui ont installé l'extension claude-in-chrom
 
 Les serveurs MCP (Model Context Protocol) offrent à votre agent de nouvelles capacités, comme la connexion à Zapier, Cloudflare, Composio ou aux outils internes de votre entreprise. Une fois connecté, l'agent peut utiliser ces outils tout comme ses outils intégrés.
 
+Les identifiants des préréglages sont `context7`, `sentry`, `notion`, `semgrep`, `linear`,
+`atlassian`, `supabase`, `neon` et `stripe`.
+
+### Atlassian / Jira
+
+Le préréglage Atlassian utilise le point de terminaison OAuth 2.1 d'Atlassian Rovo MCP,
+`https://mcp.atlassian.com/v1/mcp/authv2`, et donne accès aux outils Jira et Confluence. La création de tickets Jira nécessite les autorisations Atlassian permettant l'écriture dans Jira ; l'utilisateur ne voit toujours que les projets et les contenus autorisés par son compte Atlassian.
+
+Les administrateurs d'une organisation Atlassian peuvent décider si un client OAuth est autorisé à se connecter. Avant la connexion, un administrateur peut devoir ajouter l'origine HTTPS réelle de l'application à la liste des domaines de confiance sous **Administration Atlassian → Rovo → Serveur Rovo MCP → Domaines**, puis activer les autorisations **Lecture**, **Écriture** et **Recherche** requises sous **Autorisations**. Le domaine doit correspondre à l'hôte sur lequel l'application agent-native s'exécute ; ne copiez pas `https://builder.io/**` vers un autre déploiement, sauf s'il s'agit réellement de son origine. Consultez le [guide de configuration de Rovo MCP](https://developer.atlassian.com/cloud/rovo-mcp/guides/getting-started/) et les [contrôles d'administration](https://support.atlassian.com/security-and-access-policies/docs/control-atlassian-rovo-mcp-server-settings/) d'Atlassian.
+
+Le catalogue fournit le point de terminaison et les instructions de configuration. Le formulaire de paramètres générique enregistre le point de terminaison et les en-têtes chiffrés facultatifs, mais il ne remplace pas le processus interactif de consentement OAuth d'Atlassian. Utilisez un client ou un environnement d'exécution MCP compatible avec OAuth lorsqu'Atlassian exige une authentification OAuth interactive. Si le fournisseur ou l'environnement d'exécution prend en charge un jeton Bearer statique, suivez sa procédure approuvée de gestion des secrets et ne collez jamais de jetons dans des prompts ou dans une configuration versionnée.
+
 ### Comment connecter un serveur MCP distant
 
 1. **Nom du serveur** — une courte étiquette pour votre propre référence (par exemple "zapier", "slack-tools").
@@ -263,7 +275,7 @@ Deux étendues sont prises en charge :
 
 Ajoute et supprime le rechargement à chaud dans le gestionnaire MCP en cours d'exécution – pas de redémarrage du processus ni de redémarrage du serveur. Les nouveaux outils `mcp__<scope>-<name>__*` apparaissent à l'agent lors du message suivant et peuvent être recherchés via `tool-search`.
 
-Les HTTPS URL sont acceptés partout ; Le `http://` simple n'est autorisé que pour le `localhost` pendant le développement. L'authentification facultative est introduite sous la forme d'un jeton Bearer envoyé via `Authorization: Bearer …` à chaque demande.
+Les HTTPS URL sont acceptés partout ; Le `http://` simple n'est autorisé que pour le `localhost` pendant le développement. L'authentification facultative est introduite sous la forme d'un jeton Bearer envoyé via `Authorization: Bearer …` à chaque demande. Les fournisseurs qui prennent uniquement en charge OAuth, dont Atlassian Rovo MCP, nécessitent le processus OAuth du fournisseur au lieu d'un en-tête statique.
 
 Sous le capot, ces serveurs sont conservés dans la table `settings` du framework sous la clé `u:<email>:mcp-servers-remote` (Personnel) ou `o:<orgId>:mcp-servers-remote` (Équipe) et fusionnés avec `mcp.config.json` au démarrage.
 
@@ -292,7 +304,9 @@ Dispatch est le hub conventionnel : il assure déjà la coordination entre les
   <div class="diagram-panel center" data-rough>
     <span class="diagram-pill accent">Dispatch hub</span
     ><small class="diagram-muted">serveurs MCP au périmètre organisation</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 @@ Utilisez ceci pour créer des conseils d'intégration « Claude-in-Chrome déte
 
 Les pannes individuelles du serveur MCP ne mettent jamais l'agent hors service :
 
-- Un `command` mal configuré → le serveur est ignoré, son erreur apparaît dans `/mcp/status` sous `errors.<server-id>` et tous les autres serveurs continuent de fonctionner.
+- Un `command` mal configuré → le serveur est ignoré, son erreur apparaît dans `/_agent-native/mcp/status` sous `errors.<server-id>` et tous les autres serveurs continuent de fonctionner.
 - Le MCP SDK est absent du `node_modules` → toutes les fonctionnalités du MCP sont ignorées avec un avertissement ; Le chat d'agent continue de fonctionner sans aucun outil MCP.
 - S'exécuter dans un environnement d'exécution Edge → Le client MCP ne fonctionne pas.