Démarrage rapide

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 à 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 avec npx skills add https://mintlify.com/docs, puis enregistrez le serveur MCP d’administration à 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.