Documentation Index
Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
À propos du serveur Admin MCP
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 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. Lorsque vous utilisez le serveur Admin MCP, toutes les modifications se produisent sur une branche et nécessitent une pull request pour être fusionnées.
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 et examinez chaque pull request avant de la fusionner.
En quoi l’Admin MCP diffère du Search MCP
| Admin MCP | Search MCP | |
|---|---|---|
| Audience | Votre équipe | Vos utilisateurs finaux |
| Accès | Lire, modifier, restructurer, enregistrer, créer des workflows, gérer les paramètres | Lire et rechercher dans les pages publiées |
| Endpoints | Hébergé par Mintlify, à la portée de votre projet | /mcp sur le domaine de votre site |
| Résultat | Modifications de contenu, changements de navigation, pull requests, exécutions de workflows | Résultats de recherche et contenu des pages |
Se connecter à l’Admin MCP
- Claude
- Claude Code
- Cursor
Ajouter l'Admin MCP comme connecteur personnalisé
- Accédez à la page Connectors dans les paramètres de Claude.
- Cliquez sur Add custom connector.
- Ajoutez le connecteur
- Nom : Admin MCP
- URL :
https://mcp.mintlify.com
- Cliquez sur Add et terminez la connexion OAuth.
Comment fonctionne une session
Extraire une branche
Le premier appel doit être
checkout. Il crée une nouvelle branche mintlify-mcp/<slug>-<sha> à partir de votre branche de déploiement (ou se rattache à une branche existante que vous nommez) et renvoie une editorUrl que vous pouvez ouvrir pour suivre l’évolution dans l’éditeur du tableau de bord.Appelez list_branches avant checkout si vous avez besoin de découvrir ou de filtrer les branches existantes du dépôt.Lire, rechercher et modifier
L’IA utilise des outils tels que
search, read, list_nodes, edit_page, write_page, create_node et update_config pour effectuer des modifications. Toutes les modifications sont mises en mémoire tampon sur la branche de session en temps réel — rien ne touche encore votre branche de déploiement.Examiner le diff
Appelez
diff à tout moment pour voir exactement ce qui a changé depuis main. Ouvrez l’editorUrl dans votre tableau de bord pour voir les mêmes changements rendus.Enregistrer
Appelez
save pour pousser la branche vers Git. Utilisez mode: "pr" (par défaut) pour ouvrir une pull request, ou mode: "commit" pour pousser directement sur une branche de PR existante.Ce que l’Admin MCP peut faire
Contenu
read— Récupère le MDX complet de n’importe quelle page sur la branche de session.search— Trouve les lignes correspondant à une sous-chaîne ou à une expression régulière dans toutes les pages.edit_page— Applique une modification ciblée à une page.write_page— Réécrit le contenu MDX complet d’une page.
list_nodes— Parcourt l’arbre de navigation avec des filtres optionnels. Filtrez parparentId(utilisezrecursive: truepour inclure tous les descendants), un ou plusieurs types de nœuds, ou n’importe quel scope de division :language,version,tab,dropdown,anchor,productouitem. Les résultats sont paginés via uncursoropaque.create_node— Ajoute une nouvelle page, un groupe, un onglet, une ancre, une version, une langue, un produit ou une liste déroulante.update_node— Met à jour les propriétés d’un nœud sur place (renommer un groupe, modifier une icône, définir une version par défaut).move_node— Déplace un nœud, y compris renommer le chemin d’une page.delete_node— Supprime un nœud de la navigation.
Configuration
update_config— Modifiedocs.json(thème, racines de navigation, intégrations, paramètres SEO).
Session
checkout— Lie la session à une branche.list_branches— Liste les branches Git disponibles pour le projet, avec un filtragequeryoptionnel. Renvoie les noms de branches, le nombre total et la branche de déploiement. Appelez ceci avantcheckoutpour vous rattacher à une branche existante par son nom.get_session_state— Inspecte la branche en cours, les fichiers modifiés et le diff de navigation en attente.diff— Liste toutes les modifications entre la session etmain.save— Ouvre une pull request ou pousse un commit sur la branche de session.discard_session— Abandonne la session et ses modifications en cours.
Exemples de prompts
- “Extrais une branche appelée
add-billing-faqet crée une nouvelle page sous le groupe FAQ intitulée ‘Billing’. Rédige des réponses aux cinq questions de ce ticket Linear.” - “Trouve toutes les pages qui mentionnent le champ déprécié
legacy_tokenet mets à jour l’exemple pour utiliserapi_keyà la place. Enregistre comme une PR intitulée ‘docs: replace legacy_token references’.” - “Réorganise la référence d’API : déplace les pages webhooks dans un nouveau groupe appelé ‘Webhooks’ et mets à jour les icônes pour qu’elles correspondent au reste de la section.”
Bonnes pratiques
Ouvrir l'URL de l'éditeur
Ouvrir l'URL de l'éditeur
Chaque
checkout renvoie une editorUrl. Ouvrez-la dans un onglet séparé pour pouvoir voir les modifications de l’IA s’afficher en direct dans l’éditeur du tableau de bord pendant que vous rédigez vos prompts.Examiner chaque PR
Examiner chaque PR
L’Admin MCP est suffisamment puissant pour réécrire des centaines de pages en une seule session. Avant de fusionner, lisez le diff de la PR et parcourez l’aperçu rendu. Ne validez pas des changements importants sans les examiner.
Utiliser des slugs pour les noms de branches
Utiliser des slugs pour les noms de branches
Passez un
slug à checkout (par exemple, add-quickstart) pour que la branche générée automatiquement soit lisible. Sans cela, le nom de la branche dérive du jeton de session et est difficile à reconnaître dans votre dépôt.Garder les sessions ciblées
Garder les sessions ciblées
Limitez chaque session à un seul changement. Des sessions plus petites produisent des pull requests plus faciles à examiner et préservent les fenêtres de contexte des agents. Utilisez
discard_session puis checkout à nouveau pour passer à un travail sans lien.Les sessions conservent une branche en mémoire côté Mintlify. Si vous abandonnez une session sans l’enregistrer ou la supprimer, la branche persiste jusqu’à ce que votre prochain checkout l’écrase. Évitez de laisser des branches
mintlify-mcp/* obsolètes dans votre dépôt. Nettoyez-les périodiquement.