Serveur Admin Model Context Protocol (MCP)

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. 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. Si votre organisation dispose de plusieurs déploiements, une seule connexion Admin MCP peut accéder à tous ces déploiements et basculer entre eux.

L’Admin MCP est un service Mintlify hébergé à l’adresse https://mcp.mintlify.com. Il n’existe pas de version auto-hébergée — chaque client se connecte au même endpoint et s’authentifie avec votre compte Mintlify.

Avant de connecter l’Admin MCP, confirmez ce qui suit :

• Compte Mintlify : Vous avez besoin d’un compte Mintlify avec accès au projet que vous souhaitez modifier. La session OAuth hérite de vos autorisations du tableau de bord, donc les actions réservées aux administrateurs (telles que update_config sur les paramètres protégés) nécessitent un rôle d’administrateur sur le projet.
• Accès au fournisseur Git : L’application GitHub Mintlify ou la connexion GitLab du projet doit avoir un accès en écriture au dépôt de la branche de déploiement. save ouvre des PR via la même intégration que celle utilisée pour les déploiements normaux.
• Client MCP : Un outil d’IA compatible MCP tel que Claude, Claude Code, ChatGPT, Cursor ou Codex.

Vous devez disposer d’une connexion OAuth interactive à votre compte Mintlify pour vous connecter à l’Admin MCP. Les outils d’IA échangent cette connexion contre un jeton de session limité à un ou plusieurs déploiements, selon la manière dont vous accordez l’accès. Une connexion limitée à des déploiements spécifiques ne peut faire de checkout que sur ceux-ci, tandis qu’une connexion à l’échelle de l’organisation peut faire de checkout n’importe quel déploiement de votre organisation.

Chaque session Admin MCP est liée à une seule branche Git. Le flux est le suivant :

• 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 par parentId (utilisez recursive: true pour inclure tous les descendants), un ou plusieurs types de nœuds, ou n’importe quel scope de division : language, version, tab, dropdown, anchor, product ou item. Les résultats se paginent via un cursor opaque.
• 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.

• update_config: Modifie docs.json (thème, racines de navigation, intégrations, paramètres SEO).

• list_deployments: Liste les déploiements auxquels votre connexion peut accéder, en renvoyant chaque {subdomain, name}. Appelez ceci pour découvrir quel subdomain transmettre à checkout.
• checkout: Lie une session à une branche pour un subdomain de déploiement donné, ou change quelle session de déploiement est active.
• list_branches: Liste les branches Git disponibles pour le projet d’un déploiement, avec un filtrage query optionnel. Renvoie les noms de branches, le nombre total et la branche de déploiement. Appelez ceci avant checkout pour 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 et main.
• save: Ouvre une pull request ou pousse un commit sur la branche de session. Fusionne automatiquement la PR lorsque le déploiement est configuré pour pousser les modifications de l’agent vers main et que la branche de déploiement n’est pas protégée.
• discard_session: Abandonne la session et ses modifications en cours.

Une fois l’Admin MCP connecté, vous pouvez le piloter avec des prompts en langage naturel. Par exemple :

• “Extrais une branche appelée add-billing-faq et 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_token et mets à jour l’exemple pour utiliser api_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.”

Déconnectez l’Admin MCP lorsque vous ne souhaitez plus qu’un outil d’IA modifie votre projet, ou lorsque vous souhaitez forcer une nouvelle connexion OAuth.

• Révoquer l’autorisation OAuth : Dans votre tableau de bord Mintlify, accédez à Settings → Security & access → Connected apps et révoquez l’entrée pour l’outil d’IA que vous avez connecté. La révocation invalide immédiatement tout jeton de session actif, donc les appels d’outils en cours échouent et l’outil doit compléter une nouvelle connexion OAuth lors du prochain appel.
• Supprimer le connecteur dans le client :
  • Claude : Settings → Connectors, puis supprimez l’entrée Admin MCP.
  • Claude Code : claude mcp remove mintlify.
  • ChatGPT : Settings → Connectors, puis supprimez l’entrée Mintlify.
  • Cursor : supprimez l’entrée mintlify de mcp.json et rechargez.
  • Codex : supprimez le bloc [mcp_servers.mintlify] de ~/.codex/config.toml.

La révocation de l’autorisation OAuth n’affecte pas les pull requests que le MCP a déjà ouvertes. Fermez ou annulez ces PR dans votre fournisseur Git si vous souhaitez annuler les modifications en attente.