@agent-native/core 0.98.17 → 0.99.1

package/corpus/core/docs/content/locales/de-DE/mcp-protocol.mdx

@@ -22,7 +22,7 @@ MCP ist das Standardprotokoll für die Verbindung von KI-Tools mit externen Funk
 
 Schlüsselkonzepte:
 
-- **Automatisch gemountet** – jede App erhält `/_agent-native/mcp` kostenlos, keine Einrichtung erforderlich
+- **Automatisch gemountet** – jede App erhält `/mcp` kostenlos, keine Einrichtung erforderlich
 - **Streamable HTTP** – nutzt den modernen MCP-Transport über den Standard-HTTP (POST + SSE)
 - **Dasselbe actions** – genau dieselbe Aktionsregistrierung, die den Agenten-Chat und A2A unterstützt
 - **`ask-agent`-Tool** – ein Meta-Tool, das komplexe Aufgaben an die vollständige Agentenschleife delegiert
@@ -41,7 +41,7 @@ Schlüsselkonzepte:
   </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 @@ Beide Protokolle werden automatisch gemountet. Verwenden Sie, was zu Ihrem Anwen
 | **Am besten für**   | Externe Tools rufen Ihre App auf                                         | Agent-zu-Agent-Kommunikation                    |
 | **Protokoll**       | MCP Streambar HTTP                                                       | JSON-RPC 2.0                                    |
 | **Toolerkennung**   | `tools/list`                                                             | Agentenkarte bei `/.well-known/agent-card.json` |
-| **Endpunkt**        | `/_agent-native/mcp`                                                     | `/_agent-native/a2a`                            |
+| **Endpunkt**        | `/mcp`                                                                   | `/_agent-native/a2a`                            |
 | **Unterstützt von** | Claude, ChatGPT, Claude Code, Cursor, Codex, Cowork und andere MCP-Hosts | Andere agentennative Apps                       |
 | **Ausführung**      | Direkte Werkzeugaufrufe (kein zusätzliches LLM)                          | Vollständige Agentenschleife (LLM-Begründung)   |
 
@@ -105,7 +105,7 @@ Sie können auch das Tool `ask-agent` MCP verwenden, um das Beste aus beiden Wel
 Für das empfohlene Ein-Befehl-Setup verwenden Sie [External Agents](/docs/external-agents). Wenn Sie die MCP-Konfiguration für einen OAuth-fähigen Client handschriftlich schreiben, fügen Sie Ihre App als Remote-MCP-Server ohne statische Header hinzu:
 
 ```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
 ```
 
 Oder schreiben Sie den Eintrag handschriftlich in `.mcp.json` (Projektumfang) oder `~/.claude.json` (Benutzerumfang):
@@ -116,7 +116,7 @@ Oder schreiben Sie den Eintrag handschriftlich in `.mcp.json` (Projektumfang) od
   "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
 Jeder MCP-Client, der den Streamable HTTP-Transport unterstützt, kann eine Verbindung herstellen. Der Endpunkt ist:
 
 ```
-POST https://your-app.example.com/_agent-native/mcp
+POST https://your-app.example.com/mcp
 ```
 
 Der Server unterstützt den Standard-MCP-Handshake: `initialize` → `initialized` → `tools/list` → `tools/call`.
 
-<Endpoint id="doc-block-arbi17" title="MCP Endpunkt" summary={"Der automatisch gemountete Streamable HTTP-Endpunkt, den jede agentennative App verfügbar macht."} method="POST" path="/_agent-native/mcp" summary="MCP Streambarer HTTP Endpunkt" auth="Standard remote MCP OAuth (Bearer access token), connect-minted JWT, or static ACCESS_TOKEN/ACCESS_TOKENS" params={[
+<Endpoint id="doc-block-arbi17" title="MCP Endpunkt" summary={"Der automatisch gemountete Streamable HTTP-Endpunkt, den jede agentennative App verfügbar macht."} method="POST" path="/mcp" summary="MCP Streambarer HTTP Endpunkt" 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 @@ Wenn `mcpApp` vorhanden ist, enthält der Toolseintrag auch `_meta.ui.resourceUr
 
 Zusätzlich zu den einzelnen Aktionstools enthält jeder MCP-Server ein `ask-agent`-Metatool. Dadurch wird eine Nachricht in natürlicher Sprache an den KI-Agenten der App gesendet und die Antwort zurückgegeben.
 
+Gehostete MCP-Anfragen verwenden eine begrenzte Inline-Wartezeit, damit eine lange Agentenschleife nicht einen einzelnen `tools/call` bis zu einem Client- oder Gateway-Timeout offen hält. Das optionale Argument `async` startet die dauerhafte Aufgabe und kehrt sofort zurück; ohne dieses Argument wartet der Server kurz auf einen schnellen Abschluss und gibt dann ein Aufgaben-Handle zurück, wenn noch weitere Arbeit aussteht. Die gehostete Wartezeit ist auf 25 Sekunden begrenzt.
+
 Verwenden Sie `ask-agent` für komplexe Aufgaben, die von der Argumentation und dem Kontext des Agenten profitieren:
 
 ```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
+  }
+}
+```
+
+Der Agent führt die gleiche Schleife aus wie der interaktive Chat – er kann mehrere Tools aufrufen, über den Kontext nachdenken und eine durchdachte Antwort produzieren. Eine nicht abgeschlossene Aufgabe gibt JSON mit `taskId`, `status`, `pollAfterMs` und Folgendem zurück:
+
+```json
+{
+  "poll": {
+    "tool": "ask_app_status",
+    "arguments": { "app": "mail", "taskId": "task_123" }
   }
 }
 ```
 
-Der Agent führt die gleiche Schleife aus wie der interaktive Chat – er kann mehrere Tools aufrufen, über den Kontext nachdenken und eine durchdachte Antwort produzieren.
+Rufen Sie `ask_app_status` mit diesen Argumenten auf, bis die Aufgabe einen Endzustand erreicht. Das app-eigene `ask_app` von Dispatch verwendet denselben Vertrag für dauerhafte Aufgaben und Status, wobei die Berechtigung für die ausgewählte App sowohl bei der Übermittlung als auch beim Polling geprüft wird.
 
 ## Authentifizierung {#authentication}
 
@@ -233,7 +247,7 @@ Der MCP-Endpunkt unterstützt den Standard-Remote-MCP OAuth sowie den vorhandene
 Konfigurieren Sie für OAuth-fähige MCP-Hosts den Remote-Server URL ohne statische Header:
 
 ```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
 ```
 
 Die erste nicht authentifizierte MCP-Anfrage erhält:
@@ -249,9 +263,9 @@ Erkennungsendpunkte:
 | ----------------------------------------- | ------------------------------------------------------ |
 | `/.well-known/oauth-protected-resource`   | RFC 9728 Metadaten geschützter Ressourcen              |
 | `/.well-known/oauth-authorization-server` | OAuth Autorisierungsserver-Metadaten                   |
-| `/_agent-native/mcp/oauth/register`       | Dynamische öffentliche Kundenregistrierung             |
-| `/_agent-native/mcp/oauth/authorize`      | Browserautorisierung + Einwilligung                    |
-| `/_agent-native/mcp/oauth/token`          | Autorisierungscode- und Aktualisierungstoken-Gewährung |
+| `/mcp/oauth/register`                     | Dynamische öffentliche Kundenregistrierung             |
+| `/mcp/oauth/authorize`                    | Browserautorisierung + Einwilligung                    |
+| `/mcp/oauth/token`                        | Autorisierungscode- und Aktualisierungstoken-Gewährung |
 
 <Diagram id="doc-block-hsvr0w" title="OAuth Erkennungsablauf" summary={"Ein 401 leitet die Erkennung, Registrierung und einen PKCE-Autorisierung → Token-Austausch ein. Der Bearer-Token ist an die Zielgruppe gebunden und hat einen Gültigkeitsbereich."}>
 
@@ -351,7 +365,7 @@ export default defineNitroPlugin(async (nitro) => {
 Sie haben eine bereitgestellte Analyse-App unter `analytics.example.com`. Von Claude Code:
 
 ```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
 ```
 
 Oder fügen Sie es manuell in `.mcp.json` hinzu:
@@ -362,7 +376,7 @@ Oder fügen Sie es manuell in `.mcp.json` hinzu:
   "mcpServers": {
     "analytics": {
       "type": "http",
-      "url": "https://analytics.example.com/_agent-native/mcp",
+      "url": "https://analytics.example.com/mcp",
     },
   },
 }

package/corpus/core/docs/content/locales/de-DE/plan-plugin.mdx

@@ -12,7 +12,7 @@ Die Agent-Native **Plan**-App wird als ein installierbares Paket geliefert. Eine
 Eine Installation bietet Ihnen:
 
 - **Drei Skills** – `/visual-plan` (der kanonische Einstiegspunkt), `/visual-recap` und `/visualize-repo`.
-- **Der Plan MCP-Connector** – registriert für die gehostete App unter `https://plan.agent-native.com` (MCP-Endpunkt `https://plan.agent-native.com/_agent-native/mcp`, Servername `plan`).
+- **Der Plan MCP-Connector** – registriert für die gehostete App unter `https://plan.agent-native.com` (MCP-Endpunkt `https://plan.agent-native.com/mcp`, Servername `plan`).
 
 <Diagram id="doc-block-zzy087" title="Drei Routen, ein Paket" summary={"Die universelle CLI, das Claude-Code-Plugin und das Codex-Plugin installieren alle dieselben Plan-Skills plus den gehosteten Plan-Connector."}>
 
@@ -43,7 +43,7 @@ Eine Installation bietet Ihnen:
   <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 im Browser
 ```
 
-Nach der Installation **starten Sie einen neuen Codex-Thread**, damit die Tools skills und MCP in die Sitzung geladen werden. Das Plugin enthält einen Nur-URL-Anschluss (`[mcp_servers.plan]` → `https://plan.agent-native.com/_agent-native/mcp`); `codex mcp login plan` führt den OAuth-Flow aus. Die obige universelle CLI-Route funktioniert auch für Codex (`npx @agent-native/core@latest skills add visual-plan --client codex`), wenn Sie einen Befehl bevorzugen, der zusammen installiert und authentifiziert, oder wenn Sie lokale Dateien oder den selbstgehosteten Modus wünschen.
+Nach der Installation **starten Sie einen neuen Codex-Thread**, damit die Tools skills und MCP in die Sitzung geladen werden. Das Plugin enthält einen Nur-URL-Anschluss (`[mcp_servers.plan]` → `https://plan.agent-native.com/mcp`); `codex mcp login plan` führt den OAuth-Flow aus. Die obige universelle CLI-Route funktioniert auch für Codex (`npx @agent-native/core@latest skills add visual-plan --client codex`), wenn Sie einen Befehl bevorzugen, der zusammen installiert und authentifiziert, oder wenn Sie lokale Dateien oder den selbstgehosteten Modus wünschen.
 
 > **Ältere Installationen:** Wenn Ihre Konfiguration immer noch einen `agent-native-plans`-Eintrag enthält, der auf denselben URL zeigt, konsolidiert die Ausführung von `npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex` für Codex oder denselben Befehl mit Ihrem Ziel-`--client` diesen zum kanonischen `plan`-Namen.
 

package/corpus/core/docs/content/locales/de-DE/server.mdx

@@ -267,7 +267,7 @@ Das Framework mountet seine eigenen Routen unter `/_agent-native/`. Behandeln Si
 | `/_agent-native/extensions/*`    | Laufzeiterweiterungen und Erweiterungs-Proxy (Legacy-Alias: `/_agent-native/tools/*`) |
 | `/_agent-native/integrations/*`  | Messaging-/Webhook-Integrationen                                                      |
 | `/_agent-native/a2a`             | Agent-zu-Agent JSON-RPC                                                               |
-| `/_agent-native/mcp`             | MCP-Endpunkt                                                                          |
+| `/mcp`                           | MCP-Endpunkt                                                                          |
 | `/_agent-native/onboarding/*`    | Setup-Checkliste                                                                      |
 | `/_agent-native/observability/*` | Spuren, Feedback, Bewertungen, Experimente                                            |
 | `/_agent-native/file-upload`     | Endpunkt des Datei-Upload-Anbieters                                                   |
@@ -464,4 +464,4 @@ const handler = createProductionAgentHandler({
 - [**Datenbank**](/docs/database) – das `getDb()`/`schema`-Muster, das benutzerdefinierte Routen und Actions importieren
 - [**Sicherheit**](/docs/security#access-guards) – `accessFilter`/`assertAccess` und das vollständige Datenscoping-Modell
 - [**Messaging**](/docs/messaging) – das kanonische Muster für die Integrationswarteschlange eingehender Webhooks
-- [**MCP-Protokoll**](/docs/mcp-protocol) – der `/_agent-native/mcp`-Endpunkt, den dieser Server automatisch einbindet
+- [**MCP-Protokoll**](/docs/mcp-protocol) – der `/mcp`-Endpunkt, den dieser Server automatisch einbindet

package/corpus/core/docs/content/locales/de-DE/skills-guide.mdx

@@ -313,7 +313,7 @@ Jeder app-gestützte Skill beginnt mit `agent-native.app-skill.json` im App-Stam
   "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/de-DE/template-assets.mdx

@@ -491,7 +491,7 @@ menschlicher Picker UI.
 ### Entwickler: App-Skill verteilen
 
 Der Assets-App-Skill hat die App-ID `assets` und wird als MCP URL gehostet
-`https://assets.agent-native.com/_agent-native/mcp`.
+`https://assets.agent-native.com/mcp`.
 
 ```bash
 # Einfachste gehostete Installation: exportierte Skill-Anweisungen plus MCP-Connector.

package/corpus/core/docs/content/locales/de-DE/template-dispatch.mdx

@@ -123,7 +123,7 @@ Tag für Tag ist Dispatch der Ort, an dem Administratoren und Betriebsmitarbeite
   Verteilen Sie den Zugriff, ohne rohe Geheimnisse zu kopieren. App-spezifische Quelle
   Konfiguration bleibt in der App, die den Anbieter verwendet.
 - **Einen MCP-Anschluss freilegen.** Hinzufügen
-  `https://dispatch.agent-native.com/_agent-native/mcp` in Claude, ChatGPT,
+  `https://dispatch.agent-native.com/mcp` in Claude, ChatGPT,
   Codex, Cursor oder ein anderer MCP-Host und wählen Sie dann aus, welche Workspace-Apps verwendet werden sollen
   -Connector kann über die **Agents**-Seite von Dispatch erreicht werden. Verwenden Sie eine direkte App URL
   nur wenn dieser Host auf eine App isoliert werden soll.
@@ -304,7 +304,7 @@ _Wie es unter der Haube funktioniert (für Entwickler)._
   ]}
 />
 
-- **MCP-Hub-Modus.** Dispatch kann weiterhin als [MCP hub](/docs/mcp-clients#hub) des Arbeitsbereichs fungieren, sodass jede andere App im Arbeitsbereich dieselbe MCP-Serverliste im Organisationsbereich abruft. Unabhängig davon ist der `/_agent-native/mcp`-Endpunkt von Dispatch der empfohlene externe MCP-Anschluss für Claude, ChatGPT und andere Hosts, die mehrere Workspace-Apps erreichen sollen.
+- **MCP-Hub-Modus.** Dispatch kann weiterhin als [MCP hub](/docs/mcp-clients#hub) des Arbeitsbereichs fungieren, sodass jede andere App im Arbeitsbereich dieselbe MCP-Serverliste im Organisationsbereich abruft. Unabhängig davon ist der `/mcp`-Endpunkt von Dispatch der empfohlene externe MCP-Anschluss für Claude, ChatGPT und andere Hosts, die mehrere Workspace-Apps erreichen sollen.
 
 ## Träume {#dreams}
 

package/corpus/core/docs/content/locales/de-DE/template-plan.mdx

@@ -116,7 +116,7 @@ Der Befehl installiert drei Befehle: `/visual-plan`, `/visual-recap` und `/visua
 
 Wenn Sie einen Chat-basierten Host verwenden, der MCP-Connector URLs direkt akzeptiert
 (anstelle eines CLI-konfigurierten Clients) verbinden Sie den gehosteten Plans-Connector unter
-`https://plan.agent-native.com/_agent-native/mcp` – siehe [MCP Clients](/docs/mcp-clients) für kundenspezifische Einrichtung.
+`https://plan.agent-native.com/mcp` – siehe [MCP Clients](/docs/mcp-clients) für kundenspezifische Einrichtung.
 
 Die Authentifizierung ist eine einmalige Browser-Anmeldung beim Setup – das ist so beabsichtigt und
 ermöglicht es dem Agenten, die von ihm generierten Pläne beizubehalten und zu teilen. Was ist die Authentifizierung?
@@ -255,7 +255,7 @@ Teilen und Kommentieren sind die Arbeitsabläufe, für die ein Konto erforderlic
   geräteübergreifende oder Teambewertung) erfordert eine Anmeldung. Die Google-Anmeldung wird angezeigt, wenn
   Die standardmäßigen Google OAuth-Umgebungsvariablen sind konfiguriert.
 
-Der gehostete Plan-Connector befindet sich unter `https://plan.agent-native.com/_agent-native/mcp`.
+Der gehostete Plan-Connector befindet sich unter `https://plan.agent-native.com/mcp`.
 Fügen Sie niemals gemeinsame Geheimnisse in Skill-Dateien ein.
 
 ## Datenschutzmodus für lokale Dateien {#local-files}
@@ -453,7 +453,7 @@ pnpm dev
 Der von der gehosteten App unterstützte Skill verwendet:
 
 - App: `https://plan.agent-native.com`
-- MCP: `https://plan.agent-native.com/_agent-native/mcp`
+- MCP: `https://plan.agent-native.com/mcp`
 
 Die lokale Vorlage ist nützlich, wenn Sie Pläne selbst entwickeln, die lokale Persistenz testen oder eine vollständig selbst gehostete Überprüfungsoberfläche ausführen.
 

package/corpus/core/docs/content/locales/es-ES/actions.mdx

@@ -540,7 +540,7 @@ Si su aplicación es del mismo nivel [A2A](/docs/a2a-protocol), otras aplicacion
 
 ## Exponiéndolo sobre MCP {#mcp}
 
-Con MCP habilitado, su actions aparece en el servidor MCP del marco en `/_agent-native/mcp`. Cada persona que llama recibe un catálogo compacto de forma predeterminada (integraciones orientadas a la aplicación más la aplicación declarada con plantilla actions) y `tool-search` siempre está presente para que cualquier otra herramienta permanezca accesible bajo demanda. La superficie de acción completa se ofrece solo mediante suscripción explícita (token `--full-catalog` o `AGENT_NATIVE_MCP_FULL_CATALOG=1`), y `publicAgent.expose` opta por una herramienta de lectura/ingesta segura en la superficie pública. Consulte [MCP Protocol](/docs/mcp-protocol) para conocer los niveles del catálogo, la autenticación y los detalles del recurso `mcpApp`.
+Con MCP habilitado, su actions aparece en el servidor MCP del marco en `/mcp`. Cada persona que llama recibe un catálogo compacto de forma predeterminada (integraciones orientadas a la aplicación más la aplicación declarada con plantilla actions) y `tool-search` siempre está presente para que cualquier otra herramienta permanezca accesible bajo demanda. La superficie de acción completa se ofrece solo mediante suscripción explícita (token `--full-catalog` o `AGENT_NATIVE_MCP_FULL_CATALOG=1`), y `publicAgent.expose` opta por una herramienta de lectura/ingesta segura en la superficie pública. Consulte [MCP Protocol](/docs/mcp-protocol) para conocer los niveles del catálogo, la autenticación y los detalles del recurso `mcpApp`.
 
 Para los hosts MCP compatibles con UI, una acción puede declarar un recurso de aplicaciones MCP opcional a través del campo `mcpApp` (más un `link` coincidente) para que los hosts compatibles representen el resultado en línea. Cuando `link` y `mcpApp` deben apuntar a la misma ruta, `embedRoute()` construye ambos a partir de un generador de rutas puro:
 

package/corpus/core/docs/content/locales/es-ES/authentication.mdx

@@ -219,7 +219,7 @@ La configuración de estas variables nunca muestra una página de inicio de sesi
 El punto final MCP de cada aplicación puede actuar como un recurso MCP protegido estándar. Los clientes compatibles con OAuth se pueden configurar solo con el MCP URL remoto:
 
 ```text
-https://mail.agent-native.com/_agent-native/mcp
+https://mail.agent-native.com/mcp
 ```
 
 Las solicitudes MCP no autenticadas devuelven un desafío `WWW-Authenticate` que apunta a `/.well-known/oauth-protected-resource`. Luego, el cliente descubre los metadatos OAuth de la aplicación, registra dinámicamente un cliente público, abre la página de autorización de la aplicación e intercambia un código de autorización con PKCE para acceder y actualizar tokens.

package/corpus/core/docs/content/locales/es-ES/dispatch.mdx

@@ -113,16 +113,16 @@ Dispatch descubre automáticamente las otras aplicaciones en su espacio de traba
 
 ### Puerta de enlace unificada MCP
 
-Dispatch puede ser el único conector MCP para agentes externos: agregue `https://dispatch.agent-native.com/_agent-native/mcp` una vez en Claude, ChatGPT, Codex o Cursor, y una autorización llega a cada aplicación de espacio de trabajo otorgada en lugar de un conector por aplicación. Consulte [External Agents](/docs/external-agents) para conocer el flujo de conexión completo, las concesiones de aplicaciones, OAuth y las vistas previas de la aplicación MCP en línea.
+Dispatch puede ser el único conector MCP para agentes externos: agregue `https://dispatch.agent-native.com/mcp` una vez en Claude, ChatGPT, Codex o Cursor, y una autorización llega a cada aplicación de espacio de trabajo otorgada en lugar de un conector por aplicación. Consulte [External Agents](/docs/external-agents) para conocer el flujo de conexión completo, las concesiones de aplicaciones, OAuth y las vistas previas de la aplicación MCP en línea.
 
-<Endpoint id="doc-block-12cjrag" method="POST" path="/_agent-native/mcp" summary="Punto final de puerta de enlace MCP unificada" 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-12cjrag" method="POST" path="/mcp" summary="Punto final de puerta de enlace MCP unificada" 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/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/corpus/core/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.