From f66c6d32f869a5c72cd14c93b29e966f604c3ef8 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Thu, 22 Oct 2026 20:33:38 +0000
Subject: [PATCH] docs: translate admin MCP edit_page batching and notRendered
 (es, fr, zh)

---
 es/ai/mintlify-mcp.mdx | 4 ++--
 fr/ai/mintlify-mcp.mdx | 4 ++--
 zh/ai/mintlify-mcp.mdx | 4 ++--
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/es/ai/mintlify-mcp.mdx b/es/ai/mintlify-mcp.mdx
index 2522ec11e..744da0000 100644
--- a/es/ai/mintlify-mcp.mdx
+++ b/es/ai/mintlify-mcp.mdx
@@ -197,8 +197,8 @@ Para revocar una credencial, haz clic en el icono de eliminar junto a ella.
 
 - **`read`**: Obtén el MDX completo de cualquier página en `branch`, o en tu rama de despliegue cuando lo omites. Pasa una ruta de archivo o un UUID. Para leer una [página privada](/es/editor/pages#private-pages), pasa su ID de nodo `private-page-<uuid>` obtenido de `list_nodes` con `visibility: "private"`. Las lecturas privadas no necesitan `branch` y requieren una sesión OAuth. El Admin MCP rechaza los tokens de cliente y de máquina a máquina para el acceso a páginas privadas.
 - **`search`**: Encuentra líneas que coincidan con una subcadena o expresión regular en todas las páginas. Busca en `branch`, o en tu rama de despliegue cuando lo omites.
-- **`edit_page`**: Aplica una edición dirigida a una página. Para editar una [página privada](/es/editor/pages#private-pages), pasa su ID de nodo `private-page-<uuid>` como `path`. Las ediciones privadas requieren una sesión OAuth con rol de editor o superior en la página y no necesitan `branch`.
-- **`write_page`**: Sobrescribe el contenido MDX completo de una página. Acepta un ID de nodo `private-page-<uuid>` para sobrescribir una página privada bajo los mismos requisitos de OAuth y rol que `edit_page`. Usa `create_node` para crear una nueva página privada.
+- **`edit_page`**: Aplica una edición dirigida a una página. Pasa `oldString` y `newString` para un solo reemplazo, o pasa una lista `edits` de hasta 100 reemplazos para cambiar varias partes de una página en una sola llamada. Mintlify aplica las ediciones en orden, cada una sobre el resultado de la anterior. Si alguna edición falla, no se aplica ninguna. Al igual que `write_page`, `edit_page` devuelve `notRendered` para el marcado que añade la edición y que el editor descarta. No informa del marcado que ya estaba en la página. Para editar una [página privada](/es/editor/pages#private-pages), pasa su ID de nodo `private-page-<uuid>` como `path`. Las ediciones privadas requieren una sesión OAuth con rol de editor o superior en la página y no necesitan `branch`.
+- **`write_page`**: Sobrescribe el contenido MDX completo de una página. Acepta un ID de nodo `private-page-<uuid>` para sobrescribir una página privada bajo los mismos requisitos de OAuth y rol que `edit_page`. Usa `create_node` para crear una nueva página privada. Si el contenido incluye marcado que el editor de Mintlify descarta, como etiquetas `<script>`, bloques `<style>`, controladores de eventos como `onClick` o expresiones de JavaScript, la respuesta incluye un campo `notRendered`. Cada entrada indica el `element` descartado, su `line`, `why` el editor lo descarta y qué usar `instead`, como clases de Tailwind, objetos `style={{}}` en línea con valores literales o componentes de Mintlify como acordeones y pestañas.
 
 <div id="images">
   ### Imágenes
diff --git a/fr/ai/mintlify-mcp.mdx b/fr/ai/mintlify-mcp.mdx
index 7cb370c84..d40ae1ff9 100644
--- a/fr/ai/mintlify-mcp.mdx
+++ b/fr/ai/mintlify-mcp.mdx
@@ -197,8 +197,8 @@ Pour révoquer un identifiant, cliquez sur l'icône de suppression à côté de
 
 - **`read`**: Récupère le MDX complet de n'importe quelle page sur `branch`, ou sur votre branche de déploiement lorsque vous l'omettez. Transmettez un chemin de fichier ou un UUID. Pour lire une [page privée](/fr/editor/pages#private-pages), transmettez son ID de nœud `private-page-<uuid>` obtenu depuis `list_nodes` avec `visibility: "private"`. Les lectures privées n'ont pas besoin de `branch` et nécessitent une session OAuth. L'Admin MCP refuse les jetons client et machine à machine pour l'accès aux pages privées.
 - **`search`**: Trouve les lignes correspondant à une sous-chaîne ou à une expression régulière dans toutes les pages. Recherche dans `branch`, ou dans votre branche de déploiement lorsque vous l'omettez.
-- **`edit_page`**: Applique une modification ciblée à une page. Pour modifier une [page privée](/fr/editor/pages#private-pages), transmettez son ID de nœud `private-page-<uuid>` comme `path`. Les modifications privées nécessitent une session OAuth avec un rôle d'editor ou supérieur sur la page et n'ont pas besoin de `branch`.
-- **`write_page`**: Réécrit le contenu MDX complet d'une page. Accepte un ID de nœud `private-page-<uuid>` pour réécrire une page privée avec les mêmes exigences OAuth et de rôle que `edit_page`. Utilisez `create_node` pour créer une nouvelle page privée.
+- **`edit_page`**: Applique une modification ciblée à une page. Transmettez `oldString` et `newString` pour un seul remplacement, ou transmettez une liste `edits` de jusqu'à 100 remplacements pour modifier plusieurs parties d'une page en un seul appel. Mintlify applique les modifications dans l'ordre, chacune sur le résultat de la précédente. Si une modification échoue, aucune n'est appliquée. Comme `write_page`, `edit_page` renvoie `notRendered` pour le balisage ajouté par la modification que l'éditeur supprime. Il ne signale pas le balisage déjà présent sur la page. Pour modifier une [page privée](/fr/editor/pages#private-pages), transmettez son ID de nœud `private-page-<uuid>` comme `path`. Les modifications privées nécessitent une session OAuth avec un rôle d'editor ou supérieur sur la page et n'ont pas besoin de `branch`.
+- **`write_page`**: Réécrit le contenu MDX complet d'une page. Accepte un ID de nœud `private-page-<uuid>` pour réécrire une page privée avec les mêmes exigences OAuth et de rôle que `edit_page`. Utilisez `create_node` pour créer une nouvelle page privée. Si le contenu inclut du balisage que l'éditeur Mintlify supprime, comme des balises `<script>`, des blocs `<style>`, des gestionnaires d'événements comme `onClick` ou des expressions JavaScript, la réponse inclut un champ `notRendered`. Chaque entrée indique l'`element` supprimé, sa `line`, `why` l'éditeur le supprime et quoi utiliser `instead`, comme des classes Tailwind, des objets `style={{}}` en ligne avec des valeurs littérales ou des composants Mintlify comme les accordéons et les onglets.
 
 <div id="images">
   ### Images
diff --git a/zh/ai/mintlify-mcp.mdx b/zh/ai/mintlify-mcp.mdx
index 377392125..d0e5a2bb2 100644
--- a/zh/ai/mintlify-mcp.mdx
+++ b/zh/ai/mintlify-mcp.mdx
@@ -197,8 +197,8 @@ Claude、ChatGPT 和 Cursor 等常用 MCP 客户端始终可以完成 OAuth 登
 
 - **`read`**: 获取 `branch` 上任意页面的完整 MDX；省略 `branch` 时，则获取部署 branch 上的页面。可以传入文件路径或 UUID。要读取[私有页面](/zh/editor/pages#private-pages)，请传入通过 `list_nodes` 加 `visibility: "private"` 获取的 `private-page-<uuid>` 节点 ID。私有读取无需 `branch`，但需要 OAuth 会话。管理员 MCP 会拒绝使用客户端令牌和机器到机器令牌访问私有页面。
 - **`search`**: 在所有页面中查找匹配子字符串或正则表达式的行。搜索 `branch`；省略时搜索部署 branch。
-- **`edit_page`**: 对页面进行有针对性的编辑。要编辑[私有页面](/zh/editor/pages#private-pages)，请将其 `private-page-<uuid>` 节点 ID 作为 `path` 传入。私有编辑需要在该页面拥有 editor 或更高角色的 OAuth 会话，且无需 `branch`。
-- **`write_page`**: 覆盖页面的完整 MDX 内容。可接受 `private-page-<uuid>` 节点 ID 以覆盖私有页面，其 OAuth 与角色要求与 `edit_page` 相同。要创建新的私有页面，请使用 `create_node`。
+- **`edit_page`**: 对页面进行有针对性的编辑。传入 `oldString` 和 `newString` 进行单次替换，或传入最多包含 100 个替换的 `edits` 列表，在一次调用中修改页面的多个部分。Mintlify 按顺序应用这些编辑，每个编辑都基于上一个编辑的结果。如果任一编辑失败，则所有编辑都不会应用。与 `write_page` 一样，`edit_page` 会针对编辑新增且被编辑器丢弃的标记返回 `notRendered`。它不会报告页面上原本已有的标记。要编辑[私有页面](/zh/editor/pages#private-pages)，请将其 `private-page-<uuid>` 节点 ID 作为 `path` 传入。私有编辑需要在该页面拥有 editor 或更高角色的 OAuth 会话，且无需 `branch`。
+- **`write_page`**: 覆盖页面的完整 MDX 内容。可接受 `private-page-<uuid>` 节点 ID 以覆盖私有页面，其 OAuth 与角色要求与 `edit_page` 相同。要创建新的私有页面，请使用 `create_node`。如果内容包含会被 Mintlify 编辑器丢弃的标记，例如 `<script>` 标签、`<style>` 块、`onClick` 等事件处理器或 JavaScript 表达式，响应中会包含 `notRendered` 字段。每个条目会列出被丢弃的 `element`、其所在的 `line`、编辑器丢弃它的原因 `why`，以及应改用的 `instead` 方案，例如 Tailwind 类、使用字面量值的内联 `style={{}}` 对象，或手风琴和标签页等 Mintlify 组件。
 
 <div id="images">
   ### 图片