diff --git a/es/ai/mintlify-mcp.mdx b/es/ai/mintlify-mcp.mdx index f71b231dc..9c807020e 100644 --- a/es/ai/mintlify-mcp.mdx +++ b/es/ai/mintlify-mcp.mdx @@ -11,7 +11,7 @@ keywords: ["MCP", "write access", "AI", "editing", "Claude", "ChatGPT", "Cursor" El servidor Admin MCP otorga a las herramientas de IA acceso de escritura a tu contenido y configuración de Mintlify. Úsalo para actualizar contenido y acceder a tu panel. Con el Admin MCP, puedes usar tus herramientas de IA preferidas para editar páginas, reestructurar la navegación, actualizar `docs.json`, abrir pull requests, cambiar configuraciones, crear workflows y más. -Conecta cualquier cliente MCP como Claude, Claude Code, ChatGPT o Cursor al servidor Admin MCP para colaborar en tu contenido y configuración de Mintlify con las mismas herramientas que usas para escribir código. Las ediciones de contenido ocurren en una rama y se publican mediante una pull request o un commit cuando llamas a `save`. Los cambios de [gestión de proyectos](#project-management), como las actualizaciones de workflows y de configuración, se aplican de inmediato al proyecto en vivo. Si tu organización tiene varios proyectos, una sola conexión de Admin MCP puede acceder a todos ellos y alternar entre ellos. +Conecta cualquier cliente MCP como Claude, Claude Code, ChatGPT o Cursor al servidor Admin MCP. Úsalo para colaborar en tu contenido y configuración de Mintlify con las mismas herramientas que usas para escribir código. Las ediciones de contenido ocurren en una rama y se publican mediante una pull request o un commit cuando llamas a `save`. Los cambios de [gestión de proyectos](#project-management), como las actualizaciones de workflows y de configuración, se aplican de inmediato al proyecto en vivo. Si tu organización tiene varios proyectos, una sola conexión de Admin MCP puede acceder a todos ellos y alternar entre ellos. El servidor Admin MCP permite que las herramientas de IA accedan a tu panel de Mintlify. Trátalo como a un compañero de trabajo con acceso de escritura. Conéctalo solo desde herramientas de IA de confianza, revisa cada pull request antes de fusionarla y ten en cuenta que los cambios de gestión de proyectos se aplican de inmediato sin una pull request. @@ -38,7 +38,7 @@ Consulta la [referencia del MCP de Mintlify Index](/es/search-index/mcp) para ve Antes de conectar el Admin MCP, confirma lo siguiente: -- **Cuenta de Mintlify**: Necesitas una cuenta de Mintlify con acceso al proyecto que quieres editar. La sesión de OAuth hereda tus permisos del dashboard, por lo que las acciones exclusivas de administrador (como `update_config` en configuraciones protegidas) requieren un rol de administrador en el proyecto. +- **Cuenta de Mintlify**: Necesitas una cuenta de Mintlify con acceso al proyecto que quieres editar. La sesión de OAuth hereda tus permisos del panel, por lo que las acciones exclusivas de administrador (como `update_config` en configuraciones protegidas) requieren un rol de administrador en el proyecto. - **Acceso al proveedor de Git**: La conexión de GitHub, GitLab o Bitbucket del proyecto debe tener acceso de escritura al repositorio de la rama de despliegue. `save` abre PRs a través de la misma integración utilizada para los despliegues normales. - **Cliente MCP**: Una herramienta de IA compatible con MCP, como Claude, Claude Code, ChatGPT, Cursor o Codex. @@ -71,7 +71,7 @@ Debes tener un inicio de sesión OAuth interactivo en tu cuenta de Mintlify para claude mcp add --transport http mintlify https://mcp.mintlify.com ``` - En el primer uso, Claude Code abre una ventana del navegador para completar el inicio de sesión OAuth. Tras autenticarte, la sesión se reutiliza para las llamadas posteriores. + En el primer uso, Claude Code abre una ventana del navegador para completar el inicio de sesión OAuth. Tras autenticarte, Claude Code reutiliza la sesión en las llamadas posteriores. Instala el conector oficial de Mintlify desde el [directorio de aplicaciones de ChatGPT](https://chatgpt.com/apps/mintlify-mcp/asdk_app_6a4d5a687f0881918be3cb8b4b93773d) y completa el inicio de sesión OAuth cuando se te solicite. Una vez instalado, ChatGPT puede llamar a las herramientas del Mintlify Admin MCP durante un chat. @@ -94,14 +94,14 @@ Debes tener un inicio de sesión OAuth interactivo en tu cuenta de Mintlify para 4. Recarga Cursor y completa el inicio de sesión OAuth cuando se te solicite. - Añade el servidor Admin MCP a la configuración de tu CLI de Codex en `~/.codex/config.toml`: + Agrega el servidor Admin MCP a la configuración de tu CLI de Codex en `~/.codex/config.toml`: ```toml [mcp_servers.mintlify] url = "https://mcp.mintlify.com" ``` - En el primer uso, Codex abre una ventana del navegador para completar el inicio de sesión de OAuth. Una vez autenticado, la sesión se reutiliza en las llamadas posteriores. + En el primer uso, Codex abre una ventana del navegador para completar el inicio de sesión de OAuth. Tras autenticarte, Codex reutiliza la sesión en las llamadas posteriores. Consulta la [documentación de Codex MCP](https://developers.openai.com/codex/mcp) para más detalles. @@ -129,7 +129,7 @@ Cada sesión del Admin MCP se vincula a una sola rama de Git. El flujo es: Llama a `diff` en cualquier momento para ver exactamente qué ha cambiado desde tu rama de despliegue. Abre un `editorUrl` en tu panel para ver los mismos cambios renderizados. Cuando `create_node` agrega una página, devuelve un `editorUrl` que abre esa página directamente. - Llama a `save` para enviar la rama a Git. `mode: "auto"` (predeterminado) abre una pull request y, si la configuración de revisión del agente del proyecto es push-to-main y la rama de despliegue no está protegida, la fusiona de inmediato (la respuesta incluye `merged: true`). Usa `mode: "pr"` para abrir siempre una pull request y dejarla abierta para revisión, o `mode: "commit"` para hacer push directamente a una rama de PR existente sin abrir una nueva PR. + Llama a `save` para enviar la rama a Git. `mode: "auto"` (predeterminado) abre una pull request. Si la configuración de revisión del agente del proyecto es push-to-main y la rama de despliegue no está protegida, Mintlify fusiona la pull request de inmediato (la respuesta incluye `merged: true`). Usa `mode: "pr"` para abrir siempre una pull request y dejarla abierta para revisión. Usa `mode: "commit"` para hacer push directamente a una rama de PR existente sin abrir una nueva PR. Cuando `save` abre o actualiza una pull request, la respuesta incluye un `editorUrl` que abre la primera página creada o actualizada en la rama. Si los cambios solo afectan a la configuración, el enlace abre la rama. Los guardados que se fusionan de inmediato no devuelven un `editorUrl`. diff --git a/fr/ai/mintlify-mcp.mdx b/fr/ai/mintlify-mcp.mdx index 45933f6b9..a93386b7a 100644 --- a/fr/ai/mintlify-mcp.mdx +++ b/fr/ai/mintlify-mcp.mdx @@ -11,7 +11,7 @@ keywords: ["MCP", "write access", "AI", "editing", "Claude", "ChatGPT", "Cursor" Le serveur Admin MCP donne aux outils d'IA un accès en écriture à votre contenu et à vos paramètres Mintlify. Utilisez-le pour mettre à jour le contenu et accéder à votre tableau de bord. Avec l'Admin MCP, vous pouvez utiliser vos outils d'IA préférés pour modifier des pages, restructurer la navigation, mettre à jour `docs.json`, ouvrir des pull requests, modifier des paramètres, créer des workflows, et plus encore. -Connectez n'importe quel client MCP comme Claude, Claude Code, ChatGPT ou Cursor au serveur Admin MCP pour collaborer sur votre contenu et vos paramètres Mintlify avec les mêmes outils que vous utilisez pour écrire du code. Les modifications de contenu se produisent sur une branche et sont livrées via une pull request ou un commit lorsque vous appelez `save`. Les changements de [gestion de projet](#project-management), tels que les mises à jour de workflows et de paramètres, s'appliquent immédiatement au projet en ligne. Si votre organisation dispose de plusieurs projets, une seule connexion Admin MCP peut accéder à tous ces projets et basculer entre eux. +Connectez n'importe quel client MCP comme Claude, Claude Code, ChatGPT ou Cursor au serveur Admin MCP. Utilisez-le pour collaborer sur votre contenu et vos paramètres Mintlify avec les mêmes outils que vous utilisez pour écrire du code. Les modifications de contenu se produisent sur une branche et sont livrées via une pull request ou un commit lorsque vous appelez `save`. Les changements de [gestion de projet](#project-management), tels que les mises à jour de workflows et de paramètres, s'appliquent immédiatement au projet en ligne. Si votre organisation dispose de plusieurs projets, une seule connexion Admin MCP peut accéder à tous ces projets et basculer entre eux. Le serveur Admin MCP permet aux outils d'IA d'accéder à votre tableau de bord Mintlify. Considérez-le comme un collègue avec un accès en écriture. Connectez-le uniquement depuis des outils d'IA de confiance, examinez chaque pull request avant de la fusionner, et sachez que les changements de gestion de projet s'appliquent immédiatement, sans pull request. @@ -71,7 +71,7 @@ Vous devez disposer d'une connexion OAuth interactive à votre compte Mintlify p claude mcp add --transport http mintlify https://mcp.mintlify.com ``` - Lors de la première utilisation, Claude Code ouvre une fenêtre de navigateur pour terminer la connexion OAuth. Après authentification, la session est réutilisée pour les appels suivants. + Lors de la première utilisation, Claude Code ouvre une fenêtre de navigateur pour terminer la connexion OAuth. Après authentification, Claude Code réutilise la session pour les appels suivants. Installez le connecteur officiel Mintlify depuis le [répertoire d'applications ChatGPT](https://chatgpt.com/apps/mintlify-mcp/asdk_app_6a4d5a687f0881918be3cb8b4b93773d) et terminez la connexion OAuth lorsque vous y êtes invité. Une fois installé, ChatGPT peut appeler les outils du Mintlify Admin MCP pendant un chat. @@ -101,7 +101,7 @@ Vous devez disposer d'une connexion OAuth interactive à votre compte Mintlify p url = "https://mcp.mintlify.com" ``` - Lors de la première utilisation, Codex ouvre une fenêtre de navigateur pour finaliser la connexion OAuth. Une fois authentifié, la session est réutilisée pour les appels suivants. + Lors de la première utilisation, Codex ouvre une fenêtre de navigateur pour finaliser la connexion OAuth. Après authentification, Codex réutilise la session pour les appels suivants. Consultez la [documentation Codex MCP](https://developers.openai.com/codex/mcp) pour plus de détails. @@ -129,7 +129,7 @@ Chaque session Admin MCP est liée à une seule branche Git. Le flux est le suiv Appelez `diff` à tout moment pour voir exactement ce qui a changé depuis votre branche de déploiement. Ouvrez une `editorUrl` dans votre tableau de bord pour voir les mêmes changements rendus. Lorsque `create_node` ajoute une page, il renvoie une `editorUrl` qui ouvre directement cette page. - Appelez `save` pour pousser la branche vers Git. `mode: "auto"` (par défaut) ouvre une pull request et, si le paramètre de revue de l'agent du projet est push-to-main et que la branche de déploiement n'est pas protégée, la fusionne immédiatement (la réponse inclut `merged: true`). Utilisez `mode: "pr"` pour toujours ouvrir une pull request et la laisser ouverte pour révision, ou `mode: "commit"` pour pousser directement sur une branche de PR existante sans ouvrir de nouvelle PR. + Appelez `save` pour pousser la branche vers Git. `mode: "auto"` (par défaut) ouvre une pull request. Si le paramètre de revue de l'agent du projet est push-to-main et que la branche de déploiement n'est pas protégée, Mintlify fusionne immédiatement la pull request (la réponse inclut `merged: true`). Utilisez `mode: "pr"` pour toujours ouvrir une pull request et la laisser ouverte pour révision. Utilisez `mode: "commit"` pour pousser directement sur une branche de PR existante sans ouvrir de nouvelle PR. Lorsque `save` ouvre ou met à jour une pull request, la réponse inclut une `editorUrl` qui ouvre la première page créée ou modifiée sur la branche. Si les changements ne concernent que la configuration, le lien ouvre la branche. Les sauvegardes fusionnées immédiatement ne renvoient pas d'`editorUrl`. diff --git a/zh/ai/mintlify-mcp.mdx b/zh/ai/mintlify-mcp.mdx index 8b53d32f3..7b7f98683 100644 --- a/zh/ai/mintlify-mcp.mdx +++ b/zh/ai/mintlify-mcp.mdx @@ -11,7 +11,7 @@ keywords: ["MCP", "写入权限", "AI", "编辑", "Claude", "ChatGPT", "Cursor", 管理员 MCP 服务器赋予 AI 工具对你的 Mintlify 内容和设置的写入权限。可使用它来更新内容并访问你的控制台。借助管理员 MCP，你可以使用你常用的 AI 工具来编辑页面、调整导航结构、更新 `docs.json`、提交拉取请求、修改设置、创建工作流等等。 -将任意 MCP 客户端 (例如 Claude、Claude Code、ChatGPT 或 Cursor) 连接到管理员 MCP 服务器，即可使用与编写代码相同的工具协同处理你的 Mintlify 内容和设置。内容编辑会发生在某个 branch 上，并在你调用 `save` 时通过拉取请求或提交交付。[项目管理](#project-management)更改 (例如工作流和设置更新) 会立即应用到线上项目。如果你的组织有多个项目，单个管理员 MCP 连接即可访问所有这些项目并在它们之间切换。 +将任意 MCP 客户端 (例如 Claude、Claude Code、ChatGPT 或 Cursor) 连接到管理员 MCP 服务器。连接后，你可以使用与编写代码相同的工具协同处理你的 Mintlify 内容和设置。内容编辑会发生在某个 branch 上，并在你调用 `save` 时通过拉取请求或提交交付。[项目管理](#project-management)更改 (例如工作流和设置更新) 会立即应用到线上项目。如果你的组织有多个项目，单个管理员 MCP 连接即可访问所有这些项目并在它们之间切换。 管理员 MCP 服务器允许 AI 工具访问你的 Mintlify 控制台。请将其视为拥有写入权限的同事。仅从受信任的 AI 工具连接它，在合并前审查每一个拉取请求，并注意项目管理更改会在没有拉取请求的情况下立即生效。 @@ -71,7 +71,7 @@ keywords: ["MCP", "写入权限", "AI", "编辑", "Claude", "ChatGPT", "Cursor", claude mcp add --transport http mintlify https://mcp.mintlify.com ``` - 首次使用时，Claude Code 会打开一个浏览器窗口以完成 OAuth 登录。完成认证后，后续调用会复用该会话。 + 首次使用时，Claude Code 会打开一个浏览器窗口以完成 OAuth 登录。完成认证后，Claude Code 会在后续调用中复用该会话。 从 [ChatGPT 应用目录](https://chatgpt.com/apps/mintlify-mcp/asdk_app_6a4d5a687f0881918be3cb8b4b93773d) 安装 Mintlify 官方连接器，并在出现提示时完成 OAuth 登录。安装后，ChatGPT 即可在聊天中调用 Mintlify 管理员 MCP 工具。 @@ -101,7 +101,7 @@ keywords: ["MCP", "写入权限", "AI", "编辑", "Claude", "ChatGPT", "Cursor", url = "https://mcp.mintlify.com" ``` - 首次使用时，Codex 会打开一个浏览器窗口以完成 OAuth 登录。完成认证后，后续调用会复用该会话。 + 首次使用时，Codex 会打开一个浏览器窗口以完成 OAuth 登录。完成认证后，Codex 会在后续调用中复用该会话。 详情请参见 [Codex MCP 文档](https://developers.openai.com/codex/mcp)。 @@ -129,7 +129,7 @@ keywords: ["MCP", "写入权限", "AI", "编辑", "Claude", "ChatGPT", "Cursor", 随时调用 `diff` 查看与你的部署 branch 相比发生了哪些更改。在控制台中打开 `editorUrl`，可以看到相同更改的渲染效果。当 `create_node` 添加页面时，会返回一个直接打开该页面的 `editorUrl`。 - 调用 `save` 将 branch 推送到 Git。`mode: "auto"`（默认值）会创建一个拉取请求；如果该项目的 agent review 设置为 push-to-main 且部署 branch 未受保护，则会立即将其合并（响应中包含 `merged: true`）。使用 `mode: "pr"` 始终创建拉取请求并保持其打开以供审查，或使用 `mode: "commit"` 直接推送到现有的 PR branch，而不打开新的 PR。 + 调用 `save` 将 branch 推送到 Git。`mode: "auto"`（默认值）会创建一个拉取请求。如果该项目的 agent review 设置为 push-to-main 且部署 branch 未受保护，Mintlify 会立即合并该拉取请求（响应中包含 `merged: true`）。使用 `mode: "pr"` 始终创建拉取请求并保持其打开以供审查。使用 `mode: "commit"` 直接推送到现有的 PR branch，而不打开新的 PR。 当 `save` 创建或更新拉取请求时，响应中会包含一个 `editorUrl`，用于打开该 branch 上第一个新建或更新的页面。如果更改只涉及配置，该链接会打开 branch。立即合并的保存不会返回 `editorUrl`。