## Implementa tu sitio de documentación
diff --git a/fr/quickstart.mdx b/fr/quickstart.mdx
index ef7b65981e..52346f75e7 100644
--- a/fr/quickstart.mdx
+++ b/fr/quickstart.mdx
@@ -5,36 +5,27 @@ keywords: ["démarrage rapide","déploiement","bien démarrer","premiers pas","d
boost: 3
---
-Après avoir terminé ce guide, vous disposerez d'un site de documentation en ligne prêt à être personnalisé et mis à jour.
-
-
- ## Avant de commencer
-
-
-Mintlify utilise une approche *docs-as-code* pour gérer votre documentation. Chaque page de votre site possède un fichier correspondant, stocké dans votre
référentiel de documentation.
+import SetupAgentPrompt from "/snippets/fr/setup-agent-prompt.mdx";
-Lorsque vous connectez votre référentiel de documentation à votre projet, vous pouvez travailler sur votre documentation localement ou dans l'éditeur web et synchroniser toutes les modifications avec votre référentiel distant.
+Après avoir terminé ce guide, vous disposerez d'un site de documentation en ligne prêt à être personnalisé et mis à jour.
- Vous utilisez un outil de développement assisté par IA ?
+ Vous utilisez un agent d'IA ?
- Copiez l'invite suivante pour ajouter la [skill](/fr/ai/skillmd) et le [serveur MCP](/fr/ai/model-context-protocol) Mintlify afin d'obtenir de meilleurs résultats lors de la mise à jour de votre documentation.
-
+ Copiez l'invite suivante pour que votre agent configure votre site à votre place. Elle indique à votre agent de créer votre compte et de déployer votre site. Elle ajoute également la [skill](/fr/ai/skillmd) et le [serveur MCP](/fr/ai/model-context-protocol) Mintlify afin d'obtenir de meilleurs résultats lorsque vous mettez à jour votre contenu.
-
- Installez la skill Mintlify pour obtenir le contexte sur la structure d'un projet Mintlify, ses composants et les bonnes pratiques de documentation :
+
+ ## Avant de commencer
+
- npx skills add https://mintlify.com/docs
+Mintlify utilise une approche *docs-as-code* pour gérer votre documentation. Chaque page de votre site possède un fichier correspondant, stocké dans votre référentiel de documentation.
- Ajoutez ensuite le serveur MCP Mintlify pour accéder à la recherche dans la documentation. Suivez les instructions de configuration sur https://www.mintlify.com/docs/ai/model-context-protocol.md
-
+Lorsque vous connectez votre référentiel de documentation à votre projet, vous pouvez travailler sur votre documentation localement ou dans l'éditeur web et synchroniser toutes les modifications avec votre référentiel distant.
## Déployer votre site de documentation
diff --git a/snippets/es/setup-agent-prompt.mdx b/snippets/es/setup-agent-prompt.mdx
new file mode 100644
index 0000000000..1de34e6d6a
--- /dev/null
+++ b/snippets/es/setup-agent-prompt.mdx
@@ -0,0 +1,25 @@
+{/* vale off */}
+
+
+Pon mi documentación en línea en un sitio de Mintlify publicado. Habrás terminado con éxito cuando me des la URL en vivo y confirmes que carga. Dime claramente cuando algún paso necesite mi intervención—haz todo lo demás por tu cuenta. Si este prompt se pegó antes (por ejemplo, después de un reinicio), continúa desde donde te quedaste en lugar de empezar de cero. Si no tienes acceso a la terminal o a la ejecución de comandos, dime que siga los pasos manuales en [mintlify.com/start](https://mintlify.com/start) en su lugar. Todo lo siguiente requiere ejecutar comandos y necesita Node.js v 20.17.0+ (se recomiendan versiones LTS).
+
+1. Pídeme el contenido existente que se usará para mi sitio de Mintlify. Puede ser una carpeta local o un repositorio. Verifica la fuente antes de construir: repite exactamente qué estás leyendo y muestra el contenido de nivel superior para que yo pueda confirmar que es correcto. Si no puedes acceder a algo que mencioné (los repositorios privados devuelven 404, igual que los inexistentes), detente y pregunta. Nunca sustituyas por una fuente diferente.
+2. Comprueba si `mint` está instalado con `mint --version`. Si no lo está, instálalo con `npm i -g mint` (o `pnpm add -g mint`). Si ya está instalado, ejecuta `mint update` en lugar de reinstalarlo.
+3. Ejecuta `mint status`. Si ya muestra una organización, salta al paso 7.
+4. Requiere mi intervención: si `mint status` muestra que no he iniciado sesión, pregúntame directamente si ya tengo una cuenta de Mintlify. No lo adivines.
+ - Si tengo una: ejecuta `mint login`. Me necesitas para los pasos del navegador y para aprobar el acceso.
+ - Si no la tengo: pídeme mi nombre, apellidos, empresa y correo electrónico si aún no te los he dado—nunca los inventes. Ejecuta `mint signup --firstName [firstName] --lastName [lastName] --company [company] --email [email]` como una tarea en segundo plano, ya que se bloquea hasta que yo haga clic en un enlace de verificación que puede tardar varios minutos.
+5. Requiere mi intervención: revisaré mi correo y haré clic en el enlace de verificación. Eso abre una pestaña del navegador que finaliza automáticamente el resto de la creación de la cuenta o del inicio de sesión. Debo aprobar la CLI y luego conectar un repositorio de GitHub o dejar que Mintlify aloje uno. Dime claramente que este paso me corresponde y espera a que lo termine antes de continuar.
+6. Ejecuta `mint status` de nuevo para confirmar que ya existen una organización y un subdominio. El aprovisionamiento puede tardar un momento después de completar la incorporación—si aún no aparece ningún subdominio, espera unos 10 segundos y reintenta unas cuantas veces antes de concluir que algo va mal.
+7. Requiere mi intervención: pídeme la URL del repositorio conectado a mi proyecto de Mintlify—`mint status` no la muestra, así que no puedes obtenerla por tu cuenta. Clónalo una vez que te la dé.
+8. Revisa qué hay en ese repositorio. Si conecté mi propio repositorio de documentación existente, mi contenido ya está ahí—no lo sobrescribas. Si Mintlify creó el repositorio, contiene contenido de plantilla inicial—reemplázalo con el contenido real de mi documentación del paso 1. Usa `mint new [directorio]` solo si quiero un tema o plantilla distinto al que hay en el repositorio—genéralo localmente y luego usa su salida en lugar del contenido inicial.
+9. Muestra una vista previa con `mint dev`, que normalmente se inicia en `http://localhost:3000` a menos que ese puerto esté en uso. Se bloquea hasta que se detiene, así que ejecútalo como una tarea en segundo plano. Verifica que la vista previa carga y luego deténlo antes de continuar.
+10. Haz commit y push de tus cambios. Mintlify se despliega automáticamente al hacer push.
+11. Requiere mi intervención: si quiero un dominio personalizado, ejecuta `mint add-domain `. Imprime los registros DNS que necesito añadir con mi proveedor de dominio. Dime cuáles son los registros DNS, ya que solo yo puedo configurarlos con mi registrador. Deja claro que este es un paso que debo completar yo.
+12. Confirma que mi sitio está activo: obtén `https://.mintlify.site` (encuentra el subdominio con `mint status`) y confirma que carga. Si agregué un dominio personalizado en el paso 11, obtén también ese dominio y confirma que carga antes de dar por completado este paso—la propagación de DNS puede tardar, así que reintenta varias veces antes de tratar una petición fallida como un error.
+13. Prepárate para seguir trabajando aquí: instala la [skill de Mintlify](https://mintlify.com/docs/ai/skillmd.md) con `npx skills add https://mintlify.com/docs`, y luego registra el [servidor MCP de administración](https://mintlify.com/docs//ai/model-context-protocol.md) en `https://mcp.mintlify.com` para tu herramienta específica. Por ejemplo, `claude mcp add --transport http mintlify https://mcp.mintlify.com` para Claude Code, u obtén https://mintlify.com/docs/ai/mintlify-mcp.md para ver las instrucciones para Claude, Cursor, Codex o ChatGPT. Haz este paso por tu cuenta—no me pidas que ejecute estos comandos.
+14. Requiere mi intervención: la primera llamada a una herramienta del MCP de administración abre una ventana del navegador para el inicio de sesión con OAuth. Apruébalo allí. La mayoría de las herramientas no cargan servidores MCP recién añadidos a mitad de sesión—si las herramientas de Mintlify no aparecen, dime que te reinicie y retomaremos desde aquí.
+15. Si algún comando falla de una forma que no está cubierta arriba, detente y dime el error exacto en lugar de adivinar o reintentar a ciegas. Si parece que algo va mal por el lado de Mintlify y no por lo que estás haciendo, consulta https://status.mintlify.com o remíteme a https://mintlify.com/docs/contact-support.
+
+
+{/* vale on */}
diff --git a/snippets/fr/setup-agent-prompt.mdx b/snippets/fr/setup-agent-prompt.mdx
new file mode 100644
index 0000000000..d5da9e75c0
--- /dev/null
+++ b/snippets/fr/setup-agent-prompt.mdx
@@ -0,0 +1,25 @@
+{/* vale off */}
+
+
+Mettez ma documentation en ligne sur un site Mintlify publié. Vous avez terminé avec succès lorsque vous me donnez l'URL en direct et confirmez qu'elle se charge. Dites-moi clairement chaque fois qu'une étape nécessite mon intervention—faites tout le reste vous-même. Si ce prompt a déjà été collé (par exemple, après un redémarrage), reprenez là où vous vous étiez arrêté au lieu de recommencer depuis le début. Si vous n'avez pas accès au terminal ou à l'exécution de commandes, dites-moi de suivre les étapes manuelles sur [mintlify.com/start](https://mintlify.com/start) à la place. Tout ce qui suit nécessite d'exécuter des commandes et requiert Node.js v 20.17.0+ (les versions LTS sont recommandées).
+
+1. Demandez-moi le contenu existant qui sera utilisé pour mon site Mintlify. Il peut s'agir d'un dossier local ou d'un référentiel. Vérifiez la source avant de construire : reproduisez exactement ce que vous lisez et listez son contenu de niveau supérieur afin que je puisse confirmer qu'il est correct. Si vous ne pouvez pas accéder à quelque chose que j'ai indiqué (les référentiels privés renvoient 404, tout comme ceux qui n'existent pas), arrêtez-vous et demandez. Ne substituez jamais une autre source.
+2. Vérifiez si `mint` est installé avec `mint --version`. S'il est absent, installez-le avec `npm i -g mint` (ou `pnpm add -g mint`). S'il est déjà installé, exécutez `mint update` au lieu de le réinstaller.
+3. Exécutez `mint status`. S'il affiche déjà une organisation, passez à l'étape 7.
+4. Nécessite mon intervention : si `mint status` indique que je ne suis pas connecté, demandez-moi directement si j'ai déjà un compte Mintlify. Ne le devinez pas.
+ - Si j'en ai un : exécutez `mint login`. Vous avez besoin de moi pour les étapes du navigateur et pour approuver l'accès.
+ - Si je n'en ai pas : demandez-moi mon prénom, mon nom, mon entreprise et mon adresse e-mail si je ne vous les ai pas déjà donnés—ne les inventez jamais. Exécutez `mint signup --firstName [firstName] --lastName [lastName] --company [company] --email [email]` en tâche de fond car cette commande se bloque jusqu'à ce que je clique sur un lien de vérification qui peut prendre plusieurs minutes.
+5. Nécessite mon intervention : je vais consulter mon e-mail et cliquer sur le lien de vérification. Cela ouvre un onglet du navigateur qui finalise automatiquement le reste de la création du compte / de la connexion. Je dois approuver la CLI, puis connecter un référentiel GitHub ou laisser Mintlify en héberger un. Dites-moi clairement que cette étape m'incombe, puis attendez qu'elle soit terminée avant de continuer.
+6. Exécutez `mint status` à nouveau pour confirmer qu'une organisation et un sous-domaine existent désormais. Le provisionnement peut prendre un moment après la fin de l'onboarding — si aucun sous-domaine n'apparaît encore, attendez environ 10 secondes et réessayez plusieurs fois avant de conclure qu'il y a un problème.
+7. Nécessite mon intervention : demandez-moi l'URL du référentiel connecté à mon projet Mintlify — `mint status` ne l'expose pas, vous ne pouvez donc pas la trouver vous-même. Clonez-le une fois que je vous l'aurai donnée.
+8. Vérifiez ce qui se trouve dans ce référentiel. Si j'ai connecté mon propre référentiel de documentation existant, mon contenu s'y trouve déjà — ne l'écrasez pas. Si Mintlify a créé le référentiel, il contient du contenu de modèle de démarrage — remplacez-le par le contenu réel de ma documentation issu de l'étape 1. N'utilisez `mint new [répertoire]` que si je veux un thème ou un modèle différent de celui présent dans le référentiel — générez-le localement, puis utilisez sa sortie à la place du contenu préchargé.
+9. Prévisualisez avec `mint dev`, qui démarre généralement sur `http://localhost:3000`, sauf si ce port est déjà utilisé. La commande se bloque jusqu'à ce qu'elle soit arrêtée, exécutez-la donc en tâche de fond. Vérifiez que la prévisualisation se charge, puis arrêtez-la avant de continuer.
+10. Faites un commit et un push de vos changements. Mintlify se déploie automatiquement lors du push.
+11. Nécessite mon intervention : si je veux un domaine personnalisé, exécutez `mint add-domain `. Cette commande imprime les enregistrements DNS que je dois ajouter chez mon fournisseur de domaine. Indiquez-moi les enregistrements DNS, car moi seul peux les configurer chez mon bureau d'enregistrement. Précisez clairement qu'il s'agit d'une étape que je dois effectuer.
+12. Confirmez que mon site est en ligne : récupérez `https://.mintlify.site` (trouvez le sous-domaine via `mint status`) et confirmez qu'il se charge. Si j'ai ajouté un domaine personnalisé à l'étape 11, récupérez également ce domaine et confirmez qu'il se charge avant de considérer cette étape comme terminée — la propagation DNS peut prendre du temps, réessayez donc plusieurs fois avant de considérer un échec de récupération comme une erreur.
+13. Préparez-vous à continuer à travailler ici : installez la [skill Mintlify](https://mintlify.com/docs/ai/skillmd.md) avec `npx skills add https://mintlify.com/docs`, puis enregistrez le [serveur MCP d'administration](https://mintlify.com/docs//ai/model-context-protocol.md) à l'adresse `https://mcp.mintlify.com` pour votre outil spécifique. Par exemple, `claude mcp add --transport http mintlify https://mcp.mintlify.com` pour Claude Code, ou récupérez https://mintlify.com/docs/ai/mintlify-mcp.md pour obtenir les instructions pour Claude, Cursor, Codex ou ChatGPT. Faites cette étape vous-même—ne me demandez pas d'exécuter ces commandes.
+14. Nécessite mon intervention : le premier appel d'outil MCP d'administration ouvre une fenêtre du navigateur pour la connexion OAuth. Approuvez-la là. La plupart des outils ne chargent pas les serveurs MCP nouvellement ajoutés en cours de session — si les outils Mintlify n'apparaissent pas, dites-moi de vous redémarrer et nous reprendrons ici.
+15. Si une commande échoue d'une manière non couverte ci-dessus, arrêtez-vous et donnez-moi l'erreur exacte au lieu de deviner ou de réessayer à l'aveugle. S'il semble que le problème vient du côté de Mintlify plutôt que de ce que vous faites, consultez https://status.mintlify.com ou renvoyez-moi vers https://mintlify.com/docs/contact-support.
+
+
+{/* vale on */}
diff --git a/snippets/zh/setup-agent-prompt.mdx b/snippets/zh/setup-agent-prompt.mdx
new file mode 100644
index 0000000000..55312916b5
--- /dev/null
+++ b/snippets/zh/setup-agent-prompt.mdx
@@ -0,0 +1,25 @@
+{/* vale off */}
+
+
+让我的文档在已发布的 Mintlify 站点上正式上线。当你把在线 URL 给我并确认它能加载时，就算成功完成任务。当某个步骤需要我参与时，请清楚地告诉我——其他所有事情请你自己完成。如果这个提示词之前已经被粘贴过（例如在重启之后），请从上次中断的地方继续，而不是从头开始。如果你没有终端或命令执行权限，请告诉我改为在 [mintlify.com/start](https://mintlify.com/start) 按照手动步骤操作。以下所有步骤都需要执行命令，并且需要 Node.js v 20.17.0+（建议使用 LTS 版本）。
+
+1. 询问我用于 Mintlify 站点的现有内容。它可以是本地文件夹或一个仓库。构建之前请先核对来源：把你正在读取的内容原样回显给我，并列出其顶层目录内容，以便我确认无误。如果你无法访问我指定的内容（私有仓库会返回 404，与不存在的仓库相同），请停下来询问我。绝对不要用其他来源替代。
+2. 使用 `mint --version` 检查是否已安装 `mint`。如果没有，请用 `npm i -g mint`（或 `pnpm add -g mint`）进行安装。如果已经安装，请运行 `mint update` 而不是重新安装。
+3. 运行 `mint status`。如果已经显示了一个组织，请跳到第 7 步。
+4. 需要我参与：如果 `mint status` 显示我未登录，请直接问我是否已经拥有 Mintlify 账号。不要自己猜。
+ - 如果我有：运行 `mint login`。你需要我完成浏览器中的操作以及批准访问权限。
+ - 如果我没有：如果我还没提供，请向我索要名字、姓氏、公司和电子邮件——绝对不要自己编造。将 `mint signup --firstName [firstName] --lastName [lastName] --company [company] --email [email]` 作为后台任务运行，因为它会一直阻塞，直到我点击验证链接，而验证链接可能需要几分钟才会到达。
+5. 需要我参与：我会查收邮件并点击验证链接。这会打开一个浏览器标签页，自动完成剩余的账号创建 / 登录流程。我必须批准 CLI，然后连接一个 GitHub 仓库，或者让 Mintlify 托管一个。请清楚地告诉我这一步由我来做，然后等我完成后再继续。
+6. 再次运行 `mint status` 以确认组织和子域名现在都已存在。入门完成后，配置可能会稍有延迟——如果还看不到子域名，请等大约 10 秒并重试几次，然后再判断是否出了问题。
+7. 需要我参与：请向我索要连接到 Mintlify 项目的仓库的 URL——`mint status` 不会显示它，所以你无法自己查到。拿到后请把它克隆下来。
+8. 检查该仓库中的内容。如果我连接的是自己已有的文档仓库，我的内容已经在里面——请不要覆盖它。如果仓库是由 Mintlify 创建的，它包含初始模板内容——请用第 1 步中我的实际文档内容替换它。只有当我想要使用与仓库中不同的主题或模板时，才使用 `mint new [目录]`——先在本地生成，然后用其输出替换预置内容。
+9. 使用 `mint dev` 进行预览，通常会在 `http://localhost:3000` 启动，除非该端口被占用。它在停止之前会一直阻塞，因此请作为后台任务运行。确认预览可以正常加载后，请先停止它再继续。
+10. 提交并推送你的更改。Mintlify 会在推送时自动部署。
+11. 需要我参与：如果我想使用自定义域名，请运行 `mint add-domain <域名>`。该命令会打印出我需要在域名服务商处添加的 DNS 记录。请把 DNS 记录告诉我，因为只有我可以在域名注册商处配置这些记录。请明确告诉我这是我必须完成的步骤。
+12. 确认我的站点已上线：请获取 `https://<子域名>.mintlify.site`（通过 `mint status` 查找子域名）并确认可以加载。如果我在第 11 步添加了自定义域名，也请获取该域名并确认可以加载，然后再把这一步标记为完成——DNS 传播可能会延迟，所以在把一次获取失败当作错误之前，请多重试几次。
+13. 为在这里持续工作做好准备：使用 `npx skills add https://mintlify.com/docs` 安装 [Mintlify skill](https://mintlify.com/docs/ai/skillmd.md)，然后在 `https://mcp.mintlify.com` 为你使用的具体工具注册 [admin MCP 服务器](https://mintlify.com/docs//ai/model-context-protocol.md)。例如，对于 Claude Code 使用 `claude mcp add --transport http mintlify https://mcp.mintlify.com`，或者获取 https://mintlify.com/docs/ai/mintlify-mcp.md 以查看针对 Claude、Cursor、Codex 或 ChatGPT 的说明。这一步请你自己完成——不要让我来运行这些命令。
+14. 需要我参与：第一次调用 admin MCP 工具时会打开一个浏览器窗口进行 OAuth 登录。请在那里批准。大多数工具在会话中途不会加载新添加的 MCP 服务器——如果 Mintlify 相关工具没有出现，请告诉我重新启动你，然后我们从这里继续。
+15. 如果任何命令以上文未涵盖的方式失败，请停下来告诉我确切的错误信息，而不是随便猜测或盲目重试。如果看起来问题出在 Mintlify 一侧而不是你所做的事情上，请查看 https://status.mintlify.com 或引导我前往 https://mintlify.com/docs/contact-support。
+
+
+{/* vale on */}
diff --git a/zh/quickstart.mdx b/zh/quickstart.mdx
index eada78a324..cde3114d07 100644
--- a/zh/quickstart.mdx
+++ b/zh/quickstart.mdx
@@ -5,34 +5,27 @@ keywords: ["快速入门","部署","入门","第一步","教程","设置","上
boost: 3
---
-完成本指南后，你将拥有一个已上线的文档站点，可以开始对其进行自定义和更新。
+import SetupAgentPrompt from "/snippets/zh/setup-agent-prompt.mdx";
-
- ## 开始之前
-
+完成本指南后，你将拥有一个已上线的文档站点，可以开始对其进行自定义和更新。
-Mintlify 使用“文档即代码” (docs-as-code) 的方法来管理你的文档。站点上的每个页面都有一个对应的文件，存储在你的文档
存储库中。
+
+ 使用 AI 智能体？
-当你将文档存储库连接到你的项目后，你可以在本地或 Web 编辑器中编辑文档，并将任何更改同步到远程存储库。
+ 复制下面的提示词，让你的智能体为你搭建站点。它会指示你的智能体创建账号并部署站点，同时添加 Mintlify [skill](/zh/ai/skillmd) 和 [MCP 服务器](/zh/ai/model-context-protocol)，以便在你更新内容时获得更好的效果。
-
- 使用 AI 编码工具？复制下面的提示词，以添加 Mintlify [skill](/zh/ai/skillmd) 和 Mintlify Model Context Protocol (MCP) 服务器 ([MCP 服务器](/zh/ai/model-context-protocol)) ，在更新文档时获得更好的效果。
+ 该提示词将快速入门拆分为智能体可以完成的一系列任务，并指示它在搭建过程中向你询问所需的任何信息。
-
- 安装 Mintlify skill，以获取 Mintlify 项目结构、组件和文档最佳实践的上下文信息：
+
+ ## 开始之前
+
- npx skills add https://mintlify.com/docs
+Mintlify 使用“文档即代码” (docs-as-code) 的方法来管理你的文档。站点上的每个页面都有一个对应的文件，存储在你的文档存储库中。
- 然后添加 Mintlify MCP 服务器，以便访问文档搜索功能。按照 https://www.mintlify.com/docs/ai/model-context-protocol.md 上的安装说明进行设置。
-
+当你将文档存储库连接到你的项目后，你可以在本地或 Web 编辑器中编辑文档，并将任何更改同步到远程存储库。
## 部署你的文档站点