@agent-native/core 0.98.17 → 0.99.0

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

package/docs/content/locales/fr-FR/mcp-protocol.mdx

@@ -22,7 +22,7 @@ MCP est le protocole standard pour connecter les outils d'IA à des capacités e
 
 Concepts clés :
 
-- **Monté automatiquement** – chaque application obtient `/_agent-native/mcp` gratuitement, aucune configuration requise
+- **Monté automatiquement** – chaque application obtient `/mcp` gratuitement, aucune configuration requise
 - **Streamable HTTP** : utilise le transport moderne MCP par rapport au HTTP standard (POST + SSE)
 - **Même actions** : exactement le même registre d'actions qui alimente le chat des agents et A2A
 - **Outil `ask-agent`** — un méta-outil qui délègue à la boucle d'agent complète les tâches complexes
@@ -41,7 +41,7 @@ Concepts clés :
   </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 @@ Les deux protocoles sont montés automatiquement. Utilisez celui qui correspond
 | **Idéal pour**           | Outils externes appelant votre application                              | Communication d'agent à agent                  |
 | **Protocole**            | MCP HTTP diffusable                                                     | JSON-RPC 2.0                                   |
 | **Découverte d'outils**  | `tools/list`                                                            | Carte d'agent à `/.well-known/agent-card.json` |
-| **Point de terminaison** | `/_agent-native/mcp`                                                    | `/_agent-native/a2a`                           |
+| **Point de terminaison** | `/mcp`                                                                  | `/_agent-native/a2a`                           |
 | **Supporté par**         | Claude, ChatGPT, Claude Code, Cursor, Codex, Cowork et autres hôtes MCP | Autres applications natives pour agents        |
 | **Exécution**            | Appels d'outils directs (pas de LLM supplémentaire)                     | Boucle d'agent complète (raisonnement LLM)     |
 
@@ -105,7 +105,7 @@ Vous pouvez également utiliser l'outil `ask-agent` MCP pour tirer le meilleur p
 Pour la configuration recommandée en une seule commande, utilisez [External Agents](/docs/external-agents). Si vous écrivez manuellement la configuration MCP pour un client compatible OAuth, ajoutez votre application en tant que serveur MCP distant sans en-têtes statiques :
 
 ```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 écrivez l'entrée à la main dans `.mcp.json` (portée du projet) ou `~/.claude.json` (portée utilisateur) :
@@ -116,7 +116,7 @@ Ou écrivez l'entrée à la main dans `.mcp.json` (portée du projet) ou `~/.cla
   "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
 Tout client MCP prenant en charge le transport Streamable HTTP peut se connecter. Le point final est :
 
 ```
-POST https://your-app.example.com/_agent-native/mcp
+POST https://your-app.example.com/mcp
 ```
 
 Le serveur prend en charge la négociation standard MCP : `initialize` → `initialized` → `tools/list` → `tools/call`.
 
-<Endpoint id="doc-block-bd4fya" title="Point de terminaison MCP" summary={"Le point de terminaison Streamable HTTP monté automatiquement et exposé par chaque application native d'agent."} method="POST" path="/_agent-native/mcp" summary="MCP Point de terminaison HTTP diffusable" auth="Standard remote MCP OAuth (Bearer access token), connect-minted JWT, or static ACCESS_TOKEN/ACCESS_TOKENS" params={[
+<Endpoint id="doc-block-bd4fya" title="Point de terminaison MCP" summary={"Le point de terminaison Streamable HTTP monté automatiquement et exposé par chaque application native d'agent."} method="POST" path="/mcp" summary="MCP Point de terminaison HTTP diffusable" 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,32 @@ Lorsque `mcpApp` est présent, l'entrée d'outil inclut également `_meta.ui.res
 
 En plus des outils d'action individuels, chaque serveur MCP comprend un méta-outil `ask-agent`. Cela envoie un message en langage naturel à l'agent IA de l'application et renvoie la réponse.
 
+Les requêtes MCP hébergées utilisent une attente en ligne bornée afin qu'une longue boucle d'agent ne maintienne pas un `tools/call` ouvert jusqu'à l'expiration du délai du client ou de la passerelle. L'argument facultatif `async` démarre la tâche durable et renvoie immédiatement ; sans lui, le serveur attend brièvement une réussite rapide, puis renvoie un descripteur de tâche lorsqu'il reste du travail à faire. L'attente hébergée est plafonnée à 25 secondes.
+
 Utilisez `ask-agent` pour des tâches complexes qui bénéficient du raisonnement et du contexte de l'agent :
 
 ```json
 {
   "name": "ask-agent",
   "arguments": {
-    "message": "Draft a follow-up email to the Q3 planning thread with John, summarizing the action items we discussed"
+    "message": "Draft a follow-up email to the Q3 planning thread with John, summarizing the action items we discussed",
+    "async": true
+  }
+}
+```
+
+L'agent exécute la même boucle que le chat interactif : il peut appeler plusieurs outils, raisonner sur le contexte et produire une réponse réfléchie. Une tâche qui n'est pas terminée renvoie un JSON contenant `taskId`, `status`, `pollAfterMs`, et :
+
+```json
+{
+  "poll": {
+    "tool": "ask_app_status",
+    "arguments": { "app": "mail", "taskId": "task_123" }
   }
 }
 ```
 
-L'agent exécute la même boucle que le chat interactif : il peut appeler plusieurs outils, raisonner sur le contexte et produire une réponse réfléchie.
+Appelez `ask_app_status` avec ces arguments jusqu'à ce que la tâche atteigne un état terminal. Le `ask_app` propre à l'application de Dispatch utilise le même contrat de tâche durable et de statut, avec la vérification de l'autorisation de l'application sélectionnée effectuée à la fois lors de la soumission et de l'interrogation.
 
 ## Authentification {#authentication}
 
@@ -233,7 +247,7 @@ Le point de terminaison MCP prend en charge le modèle distant standard MCP OAut
 Pour les hôtes MCP compatibles OAuth, configurez le serveur distant URL sans en-têtes statiques :
 
 ```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 première requête MCP non authentifiée reçoit :
@@ -249,9 +263,9 @@ Points de terminaison de découverte :
 | ----------------------------------------- | ---------------------------------------------------------- |
 | `/.well-known/oauth-protected-resource`   | Métadonnées de ressources protégées RFC 9728               |
 | `/.well-known/oauth-authorization-server` | Métadonnées du serveur d'autorisation OAuth                |
-| `/_agent-native/mcp/oauth/register`       | Inscription dynamique du client public                     |
-| `/_agent-native/mcp/oauth/authorize`      | Autorisation du navigateur + consentement                  |
-| `/_agent-native/mcp/oauth/token`          | Accords de code d'autorisation et de jeton d'actualisation |
+| `/mcp/oauth/register`                     | Inscription dynamique du client public                     |
+| `/mcp/oauth/authorize`                    | Autorisation du navigateur + consentement                  |
+| `/mcp/oauth/token`                        | Accords de code d'autorisation et de jeton d'actualisation |
 
 <Diagram id="doc-block-l7acbd" title={"Flux de découverte OAuth"} summary={"Un 401 lance la découverte, l'enregistrement et un PKCE autorisation → échange de jetons. Le jeton Bearer est limité au public et limité."}>
 
@@ -351,7 +365,7 @@ export default defineNitroPlugin(async (nitro) => {
 Vous disposez d'une application d'analyse déployée sur `analytics.example.com`. À partir du code 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 ajoutez-le à la main dans `.mcp.json` :
@@ -362,7 +376,7 @@ Ou ajoutez-le à la main dans `.mcp.json` :
   "mcpServers": {
     "analytics": {
       "type": "http",
-      "url": "https://analytics.example.com/_agent-native/mcp",
+      "url": "https://analytics.example.com/mcp",
     },
   },
 }

package/docs/content/locales/fr-FR/plan-plugin.mdx

@@ -12,7 +12,7 @@ L'application Agent-Native **Plan** est livrée comme un bundle installable. Une
 Une installation vous offre :
 
 - **Trois skills** — `/visual-plan` (le point d'entrée canonique), `/visual-recap` et `/visualize-repo`.
-- **Le connecteur Plan MCP** — enregistré auprès de l'application hébergée sur `https://plan.agent-native.com` (point de terminaison MCP `https://plan.agent-native.com/_agent-native/mcp`, nom de serveur `plan`).
+- **Le connecteur Plan MCP** — enregistré auprès de l'application hébergée sur `https://plan.agent-native.com` (point de terminaison MCP `https://plan.agent-native.com/mcp`, nom de serveur `plan`).
 
 <Diagram id="doc-block-1il4uk9" title={"Trois itinéraires, un forfait"} summary={"Le CLI universel, le plugin Claude Code et le plugin Codex installent les mêmes skills Plan ainsi que le connecteur Plan hébergé."}>
 
@@ -43,7 +43,7 @@ Une installation vous offre :
   <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 dans le navigateur
 ```
 
-Après l'installation, **démarrez un nouveau thread Codex** pour que les outils skills et MCP se chargent dans la session. Le plugin est livré avec un connecteur uniquement URL (`[mcp_servers.plan]` → `https://plan.agent-native.com/_agent-native/mcp`) ; `codex mcp login plan` exécute le flux OAuth. La route universelle CLI ci-dessus fonctionne également pour Codex (`npx @agent-native/core@latest skills add visual-plan --client codex`) si vous préférez une commande qui s'installe et s'authentifie ensemble, ou lorsque vous souhaitez des fichiers locaux ou un mode auto-hébergé.
+Après l'installation, **démarrez un nouveau thread Codex** pour que les outils skills et MCP se chargent dans la session. Le plugin est livré avec un connecteur uniquement URL (`[mcp_servers.plan]` → `https://plan.agent-native.com/mcp`) ; `codex mcp login plan` exécute le flux OAuth. La route universelle CLI ci-dessus fonctionne également pour Codex (`npx @agent-native/core@latest skills add visual-plan --client codex`) si vous préférez une commande qui s'installe et s'authentifie ensemble, ou lorsque vous souhaitez des fichiers locaux ou un mode auto-hébergé.
 
 > **Installations plus anciennes :** si votre configuration a toujours une entrée `agent-native-plans` pointant vers le même URL, exécutant `npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex` pour Codex, ou la même commande avec votre `--client` cible, la consolide avec le nom canonique `plan`.
 

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

@@ -271,7 +271,7 @@ Le framework monte ses propres routes sous `/_agent-native/`. Traitez cet espace
 | `/_agent-native/extensions/*`    | Extensions d'exécution et proxy d'extension (alias hérité : `/_agent-native/tools/*`) |
 | `/_agent-native/integrations/*`  | Intégrations de messagerie/webhook                                                    |
 | `/_agent-native/a2a`             | Agent à agent JSON-RPC                                                                |
-| `/_agent-native/mcp`             | Point de terminaison MCP                                                              |
+| `/mcp`                           | Point de terminaison MCP                                                              |
 | `/_agent-native/onboarding/*`    | Liste de contrôle de configuration                                                    |
 | `/_agent-native/observability/*` | Traces, retours, évaluations, expériences                                             |
 | `/_agent-native/file-upload`     | Point de terminaison du fournisseur de téléchargement de fichiers                     |
@@ -467,4 +467,4 @@ const handler = createProductionAgentHandler({
 - [**Base de données**](/docs/database) — le modèle `getDb()`/`schema` importé par les routes personnalisées et les actions
 - [**Sécurité**](/docs/security#access-guards) — `accessFilter`/`assertAccess` et le modèle complet de portée des données
 - [**Messagerie**](/docs/messaging) — le modèle canonique de file d'attente d'intégration pour les webhooks entrants
-- [**Protocole MCP**](/docs/mcp-protocol) — le point de terminaison `/_agent-native/mcp` que ce serveur monte automatiquement
+- [**Protocole MCP**](/docs/mcp-protocol) — le point de terminaison `/mcp` que ce serveur monte automatiquement

package/docs/content/locales/fr-FR/skills-guide.mdx

@@ -313,7 +313,7 @@ Chaque compétence basée sur l'application commence par `agent-native.app-skill
   "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/fr-FR/template-assets.mdx

@@ -495,7 +495,7 @@ sélecteur humain UI.
 ### Développeur : distribuer la compétence d'application
 
 La compétence d'application Actifs porte l'ID d'application `assets` et héberge MCP URL
-`https://assets.agent-native.com/_agent-native/mcp`.
+`https://assets.agent-native.com/mcp`.
 
 ```bash
 # Installation hébergée la plus simple : instructions de compétences exportées et connecteur MCP.

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

@@ -123,7 +123,7 @@ Au quotidien, Dispatch est l'endroit où les administrateurs et les opérationne
   Distribuez l'accès sans copier les secrets bruts. Source spécifique à l'application
   la configuration reste dans l'application qui utilise le fournisseur.
 - **Exposer un connecteur MCP.** Ajouter
-  `https://dispatch.agent-native.com/_agent-native/mcp` dans Claude, ChatGPT,
+  `https://dispatch.agent-native.com/mcp` dans Claude, ChatGPT,
   Codex, Cursor ou un autre hôte MCP, puis choisissez les applications d'espace de travail qui
   peut être atteint depuis la page **Agents** de Dispatch. Utiliser une application directe URL
   uniquement lorsque cet hôte doit être isolé sur une seule application.
@@ -304,7 +304,7 @@ _Comment ça marche sous le capot (pour les développeurs)._
   ]}
 />
 
-- **Mode hub MCP.** Dispatch peut toujours agir comme [MCP hub](/docs/mcp-clients#hub) de l'espace de travail, de sorte que toutes les autres applications de l'espace de travail extraient la même liste de serveurs MCP de portée organisationnelle. Par ailleurs, le point de terminaison `/_agent-native/mcp` de Dispatch est le connecteur externe MCP recommandé pour Claude, ChatGPT et d'autres hôtes qui doivent atteindre plusieurs applications d'espace de travail.
+- **Mode hub MCP.** Dispatch peut toujours agir comme [MCP hub](/docs/mcp-clients#hub) de l'espace de travail, de sorte que toutes les autres applications de l'espace de travail extraient la même liste de serveurs MCP de portée organisationnelle. Par ailleurs, le point de terminaison `/mcp` de Dispatch est le connecteur externe MCP recommandé pour Claude, ChatGPT et d'autres hôtes qui doivent atteindre plusieurs applications d'espace de travail.
 
 ## Rêves {#dreams}
 

package/docs/content/locales/fr-FR/template-plan.mdx

@@ -114,7 +114,7 @@ La commande installe trois commandes : `/visual-plan`, `/visual-recap` et `/visu
 
 Si vous utilisez un hôte basé sur le chat qui accepte directement les connecteurs MCP URL
 (plutôt qu'un client configuré avec CLI), connectez le connecteur Plans hébergés à
-`https://plan.agent-native.com/_agent-native/mcp` : voir [MCP Clients](/docs/mcp-clients) pour la configuration spécifique au client.
+`https://plan.agent-native.com/mcp` : voir [MCP Clients](/docs/mcp-clients) pour la configuration spécifique au client.
 
 L'authentification consiste en une connexion unique au navigateur lors de la configuration : c'est prévu, et c'est le cas
 est ce qui permet à l'agent de persister et de partager les plans qu'il génère. Quelle est l'authentification
@@ -253,7 +253,7 @@ Le partage et les commentaires sont les workflows qui nécessitent un compte :
   examen multi-appareils ou d'équipe) nécessite une connexion. La connexion à Google apparaît lorsque
   les variables d'environnement Google OAuth standard sont configurées.
 
-Le connecteur Plans hébergé se trouve sur `https://plan.agent-native.com/_agent-native/mcp`.
+Le connecteur Plans hébergé se trouve sur `https://plan.agent-native.com/mcp`.
 Ne mettez jamais de secrets partagés dans les fichiers de compétences.
 
 ## Mode de confidentialité des fichiers locaux {#local-files}
@@ -452,7 +452,7 @@ pnpm dev
 La compétence basée sur l'application hébergée utilise :
 
 - Application : `https://plan.agent-native.com`
-- MCP: `https://plan.agent-native.com/_agent-native/mcp`
+- MCP: `https://plan.agent-native.com/mcp`
 
 Le modèle local est utile lorsque vous développez Plans lui-même, testez la persistance locale ou exécutez une surface de révision entièrement auto-hébergée.
 

package/docs/content/locales/hi-IN/actions.mdx

@@ -536,7 +536,7 @@ JSON इनपुट एजेंटों और जटिल वस्तु
 
 ## इसे MCP पर उजागर करना {#mcp}
 
-MCP सक्षम होने पर, आपका actions फ्रेमवर्क के MCP सर्वर में `/_agent-native/mcp` पर दिखाई देता है। प्रत्येक कॉल करने वाले को डिफ़ॉल्ट रूप से एक कॉम्पैक्ट कैटलॉग मिलता है - ऐप-फेसिंग बिल्टिन और टेम्पलेट-घोषित ऐप actions - और `tool-search` हमेशा मौजूद रहता है ताकि कोई भी अन्य टूल मांग पर उपलब्ध रहे। पूर्ण क्रिया सतह केवल स्पष्ट ऑप्ट-इन (`--full-catalog` टोकन या `AGENT_NATIVE_MCP_FULL_CATALOG=1`) पर प्रदान की जाती है, और `publicAgent.expose` सार्वजनिक सतह पर एक सुरक्षित रीड/इन्जेस्ट टूल का विकल्प चुनता है। कैटलॉग टियर, ऑथ और `mcpApp` संसाधन विवरण के लिए [MCP Protocol](/docs/mcp-protocol) देखें।
+MCP सक्षम होने पर, आपका actions फ्रेमवर्क के MCP सर्वर में `/mcp` पर दिखाई देता है। प्रत्येक कॉल करने वाले को डिफ़ॉल्ट रूप से एक कॉम्पैक्ट कैटलॉग मिलता है - ऐप-फेसिंग बिल्टिन और टेम्पलेट-घोषित ऐप actions - और `tool-search` हमेशा मौजूद रहता है ताकि कोई भी अन्य टूल मांग पर उपलब्ध रहे। पूर्ण क्रिया सतह केवल स्पष्ट ऑप्ट-इन (`--full-catalog` टोकन या `AGENT_NATIVE_MCP_FULL_CATALOG=1`) पर प्रदान की जाती है, और `publicAgent.expose` सार्वजनिक सतह पर एक सुरक्षित रीड/इन्जेस्ट टूल का विकल्प चुनता है। कैटलॉग टियर, ऑथ और `mcpApp` संसाधन विवरण के लिए [MCP Protocol](/docs/mcp-protocol) देखें।
 
 UI-सक्षम MCP होस्ट के लिए, एक क्रिया `mcpApp` फ़ील्ड (साथ ही एक मिलान `link`) के माध्यम से एक वैकल्पिक MCP ऐप्स संसाधन घोषित कर सकती है ताकि सक्षम होस्ट परिणाम इनलाइन प्रस्तुत कर सकें। जब `link` और `mcpApp` को एक ही मार्ग पर इंगित करना चाहिए, तो `embedRoute()` दोनों को एक शुद्ध पथ बिल्डर से बनाता है:
 

package/docs/content/locales/hi-IN/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/hi-IN/dispatch.mdx

@@ -113,16 +113,16 @@ Slack, ईमेल, टेलीग्राम और व्हाट्सए
 
 ### एकीकृत MCP गेटवे
 
-डिस्पैच बाहरी एजेंटों के लिए एकल MCP कनेक्टर हो सकता है: Claude, ChatGPT, Codex, या कर्सर में एक बार `https://dispatch.agent-native.com/_agent-native/mcp` जोड़ें, और प्रति ऐप एक कनेक्टर के बजाय एक प्राधिकरण प्रत्येक स्वीकृत कार्यक्षेत्र ऐप तक पहुंचता है। संपूर्ण कनेक्ट फ़्लो, ऐप अनुदान, OAuth और इनलाइन MCP ऐप पूर्वावलोकन के लिए [External Agents](/docs/external-agents) देखें।
+डिस्पैच बाहरी एजेंटों के लिए एकल MCP कनेक्टर हो सकता है: Claude, ChatGPT, Codex, या कर्सर में एक बार `https://dispatch.agent-native.com/mcp` जोड़ें, और प्रति ऐप एक कनेक्टर के बजाय एक प्राधिकरण प्रत्येक स्वीकृत कार्यक्षेत्र ऐप तक पहुंचता है। संपूर्ण कनेक्ट फ़्लो, ऐप अनुदान, OAuth और इनलाइन MCP ऐप पूर्वावलोकन के लिए [External Agents](/docs/external-agents) देखें।
 
-<Endpoint id="doc-block-n41avw" 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-n41avw" 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>