Translate content: quickstart setup agent prompt (es, fr, zh)

es/quickstart.mdx

@@ -5,36 +5,27 @@ keywords: ["quickstart","deploy","get started","first steps","tutorial","setup",
 boost: 3
 ---
 
-Después de completar esta guía, tendrás un sitio de documentación en línea listo para personalizar y actualizar.
-
-<div id="before-you-begin">
-  ## Antes de comenzar
-</div>
-
-Mintlify utiliza un enfoque de documentación como código para administrar tu documentación. Cada página de tu sitio tiene un archivo correspondiente almacenado en tu <Tooltip tip="El código fuente de tu documentación donde se almacenan todos los archivos y su historial. El editor web se conecta a tu repositorio de documentación para acceder y modificar el contenido, o puedes editar los archivos localmente en tu IDE preferido.">repositorio</Tooltip> de documentación.
+import SetupAgentPrompt from "/snippets/es/setup-agent-prompt.mdx";
 
-Cuando conectas tu repositorio de documentación a tu proyecto, puedes trabajar en tu documentación localmente o en el editor web y sincronizar cualquier cambio con tu repositorio remoto.
+Después de completar esta guía, tendrás un sitio de documentación en línea listo para personalizar y actualizar.
 
 <Tip>
-  ¿Utilizas una herramienta de programación con IA?
+  ¿Utilizas un agente de IA?
 
-  Copia el siguiente prompt para agregar la [skill](/es/ai/skillmd) de Mintlify y el [servidor MCP](/es/ai/model-context-protocol) para obtener mejores resultados al actualizar tu documentación.
-</Tip>
+  Copia el siguiente prompt para que tu agente configure el sitio por ti. Le indica a tu agente que cree tu cuenta y despliegue tu sitio. También añade la [skill](/es/ai/skillmd) y el [servidor MCP](/es/ai/model-context-protocol) de Mintlify para obtener mejores resultados cuando actualices tu contenido.
 
-<Prompt
-  description="Instala la skill de Mintlify para obtener contexto sobre la estructura del proyecto de Mintlify, sus componentes y las mejores prácticas de documentación:
+  El prompt divide el inicio rápido en tareas que tu agente puede completar y le indica que te pida cualquier información que necesite mientras lo configura todo.
+</Tip>
 
-npx skills add https://mintlify.com/docs
+<SetupAgentPrompt />
 
-Luego agrega el servidor de Model Context Protocol (MCP) de Mintlify para acceder a la búsqueda en la documentación. Sigue las instrucciones de configuración en https://www.mintlify.com/docs/ai/model-context-protocol.md"
-  actions={["copy", "cursor"]}
->
-  Instala la skill de Mintlify para obtener contexto sobre la estructura del proyecto de Mintlify, sus componentes y las mejores prácticas de documentación:
+<div id="before-you-begin">
+  ## Antes de comenzar
+</div>
 
-  npx skills add https://mintlify.com/docs
+Mintlify utiliza un enfoque de documentación como código para administrar tu documentación. Cada página de tu sitio tiene un archivo correspondiente almacenado en tu <Tooltip tip="El código fuente de tu documentación donde se almacenan todos los archivos y su historial. El editor web se conecta a tu repositorio de documentación para acceder y modificar el contenido, o puedes editar los archivos localmente en tu IDE preferido.">repositorio</Tooltip> de documentación.
 
-  Luego agrega el servidor de Model Context Protocol (MCP) de Mintlify para acceder a la búsqueda en la documentación. Sigue las instrucciones de configuración en https://www.mintlify.com/docs/ai/model-context-protocol.md
-</Prompt>
+Cuando conectas tu repositorio de documentación a tu proyecto, puedes trabajar en tu documentación localmente o en el editor web y sincronizar cualquier cambio con tu repositorio remoto.
 
 <div id="deploy-your-documentation-site">
   ## Implementa tu sitio de documentación

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.
-
-<div id="before-you-begin">
-  ## Avant de commencer
-</div>
-
-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 <Tooltip tip="Le code source de votre documentation où tous les fichiers et leur historique sont stockés. L'éditeur web se connecte à votre référentiel de documentation pour accéder au contenu et le modifier, ou vous pouvez modifier les fichiers localement dans votre IDE préféré.">référentiel</Tooltip> 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.
 
 <Tip>
-  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.
-</Tip>
+  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.
 
-<Prompt
-  description="Installez la skill Mintlify pour obtenir le contexte sur la structure d'un projet Mintlify, ses composants et les bonnes pratiques de documentation :
+  L'invite divise le démarrage rapide en tâches que votre agent peut réaliser et lui indique de vous demander toute information dont il a besoin pendant la configuration.
+</Tip>
 
-npx skills add https://mintlify.com/docs
+<SetupAgentPrompt />
 
-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"
-  actions={["copy", "cursor"]}
->
-  Installez la skill Mintlify pour obtenir le contexte sur la structure d'un projet Mintlify, ses composants et les bonnes pratiques de documentation :
+<div id="before-you-begin">
+  ## Avant de commencer
+</div>
 
-  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 <Tooltip tip="Le code source de votre documentation où tous les fichiers et leur historique sont stockés. L'éditeur web se connecte à votre référentiel de documentation pour accéder au contenu et le modifier, ou vous pouvez modifier les fichiers localement dans votre IDE préféré.">référentiel</Tooltip> 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
-</Prompt>
+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.
 
 <div id="deploy-your-documentation-site">
   ## Déployer votre site de documentation

snippets/es/setup-agent-prompt.mdx

@@ -0,0 +1,25 @@
+{/* vale off */}
+
+<Prompt description="Copia y pega este prompt para que tu agente configure tu sitio de Mintlify." actions={["copy", "cursor"]}>
+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 <dominio>`. 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://<subdominio>.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.
+</Prompt>
+
+{/* vale on */}

snippets/fr/setup-agent-prompt.mdx

@@ -0,0 +1,25 @@
+{/* vale off */}
+
+<Prompt description="Copiez-collez ce prompt pour que votre agent configure votre site Mintlify." actions={["copy", "cursor"]}>
+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 <domaine>`. 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://<sous-domaine>.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.
+</Prompt>
+
+{/* vale on */}