diff --git a/ai/mintlify-mcp.mdx b/ai/mintlify-mcp.mdx
index 52fa5083f..635b9a73c 100644
--- a/ai/mintlify-mcp.mdx
+++ b/ai/mintlify-mcp.mdx
@@ -165,6 +165,8 @@ You can also override the setting on a per-call basis by passing an explicit `mo
 - **`move_node`**: Move a node, including renaming a page's path.
 - **`delete_node`**: Remove a node from the navigation. Accepts a `private-page-<uuid>` or `private-folder-<uuid>` node id to delete a [private page](/editor/pages#private-pages) or folder from the caller's private tree. Private deletions require an OAuth session with a manager role on the node and work without a checkout.
 
+If a `create_node`, `update_node`, `move_node`, or `delete_node` call leaves the navigation in an invalid state, the response includes a `navigationErrors` field that describes the problem. For example, a page placed at the root next to tabs returns `navigationErrors`. Mintlify can drop invalid nodes from the published navigation, so fix these errors before you call `save`.
+
 ### Configuration
 
 - **`update_config`**: Modify `docs.json` (theme, navigation roots, integrations, SEO settings).
diff --git a/es/ai/mintlify-mcp.mdx b/es/ai/mintlify-mcp.mdx
index 4b0e306f5..8db72a2ca 100644
--- a/es/ai/mintlify-mcp.mdx
+++ b/es/ai/mintlify-mcp.mdx
@@ -183,6 +183,8 @@ También puedes anular el ajuste caso por caso pasando un `mode` explícito a `s
 - **`move_node`**: Mueve un nodo, incluido renombrar la ruta de una página.
 - **`delete_node`**: Elimina un nodo de la navegación. Acepta un ID de nodo `private-page-<uuid>` o `private-folder-<uuid>` para eliminar una [página privada](/es/editor/pages#private-pages) o carpeta del árbol privado del autor de la llamada. Las eliminaciones privadas requieren una sesión OAuth con rol de manager en el nodo y funcionan sin un checkout.
 
+Si una llamada a `create_node`, `update_node`, `move_node` o `delete_node` deja la navegación en un estado no válido, la respuesta incluye un campo `navigationErrors` que describe el problema. Por ejemplo, una página colocada en la raíz junto a pestañas devuelve `navigationErrors`. Mintlify puede omitir los nodos no válidos de la navegación publicada, así que corrige estos errores antes de llamar a `save`.
+
 <div id="configuration">
   ### Configuración
 </div>
diff --git a/fr/ai/mintlify-mcp.mdx b/fr/ai/mintlify-mcp.mdx
index a73677fc8..11a3b1a1a 100644
--- a/fr/ai/mintlify-mcp.mdx
+++ b/fr/ai/mintlify-mcp.mdx
@@ -183,6 +183,8 @@ Vous pouvez également remplacer ce paramètre appel par appel en passant un `mo
 - **`move_node`**: Déplace un nœud, y compris renommer le chemin d'une page.
 - **`delete_node`**: Supprime un nœud de la navigation. Accepte un ID de nœud `private-page-<uuid>` ou `private-folder-<uuid>` pour supprimer une [page privée](/fr/editor/pages#private-pages) ou un dossier de l'arbre privé de l'appelant. Les suppressions privées nécessitent une session OAuth avec un rôle de manager sur le nœud et fonctionnent sans checkout.
 
+Si un appel à `create_node`, `update_node`, `move_node` ou `delete_node` laisse la navigation dans un état invalide, la réponse inclut un champ `navigationErrors` qui décrit le problème. Par exemple, une page placée à la racine à côté d'onglets renvoie `navigationErrors`. Mintlify peut retirer les nœuds invalides de la navigation publiée. Corrigez donc ces erreurs avant d'appeler `save`.
+
 <div id="configuration">
   ### Configuration
 </div>
diff --git a/zh/ai/mintlify-mcp.mdx b/zh/ai/mintlify-mcp.mdx
index de06a9d4b..494094ab3 100644
--- a/zh/ai/mintlify-mcp.mdx
+++ b/zh/ai/mintlify-mcp.mdx
@@ -183,6 +183,8 @@ keywords: ["MCP", "写入权限", "AI", "编辑", "Claude", "ChatGPT", "Cursor",
 - **`move_node`**: 移动节点，包括重命名页面的路径。
 - **`delete_node`**: 从导航中移除节点。可接受 `private-page-<uuid>` 或 `private-folder-<uuid>` 节点 ID，用于从调用者的私有树中删除[私有页面](/zh/editor/pages#private-pages)或私有文件夹。私有删除需要在该节点上具有 manager 角色的 OAuth 会话，且无需 checkout。
 
+如果 `create_node`、`update_node`、`move_node` 或 `delete_node` 调用使导航处于无效状态，响应中会包含描述该问题的 `navigationErrors` 字段。例如，将页面放在根级别并与 tab 并列时会返回 `navigationErrors`。Mintlify 可能会从已发布的导航中移除无效节点，因此请在调用 `save` 之前修复这些错误。
+
 <div id="configuration">
   ### 配置
 </div>