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. Les modifications de contenu se produisent sur une branche et sont livrées via une pull request ou un commit lorsque vous appelez save. Les changements de gestion des déploiements, tels que les mises à jour de workflows et de paramètres, s’appliquent immédiatement au déploiement en ligne. 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. Chaque client se connecte au même endpoint et s’authentifie avec votre compte Mintlify.

Consultez la référence MCP de Mintlify Index pour connaître les paramètres de ses outils et ses limites de débit.

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 : La connexion GitHub, GitLab ou Bitbucket 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.

claude mcp add --transport http mintlify https://mcp.mintlify.com

{
  "mcpServers": {
    "mintlify": {
      "url": "https://mcp.mintlify.com"
    }
  }
}

[mcp_servers.mintlify]
url = "https://mcp.mintlify.com"

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

La section Publication de la page des paramètres de l’Admin MCP dans votre tableau de bord contrôle ce qui se passe lorsque save s’exécute avec mode: "auto". Activez Pousser directement sur votre branche de déploiement pour que Mintlify pousse les modifications directement sur votre branche de déploiement. Désactivez-la pour que save ouvre une pull request à la place.

Ce bouton partage le même paramètre agentReviewProcess que l’agent Slack et l’agent du tableau de bord, donc toute modification ici s’applique également à ces flux.

Le bouton est désactivé dans trois cas :

• Votre branche de déploiement requiert une pull request. Si des règles de protection de branche ou des approbations requises empêchent les push directs, les modifications MCP ouvrent toujours une pull request, quel que soit ce paramètre.
• Mintlify héberge votre déploiement. Pour les sites hébergés par Mintlify, les modifications MCP sont toujours poussées directement, sauf si la protection de branche exige tout de même une pull request.
• Vous n’êtes pas administrateur. La modification de ce paramètre requiert le rôle d’administrateur sur votre projet. Les éditeurs et les lecteurs voient le bouton désactivé avec une bannière de permission.

Vous pouvez également remplacer ce paramètre appel par appel en passant un mode explicite à save : "pr" ouvre toujours une pull request, et "commit" pousse sur une branche de PR existante sans ouvrir de nouvelle PR.

• read: Récupère le MDX complet de n’importe quelle page sur la branche de session. Transmettez un chemin de page comme /quickstart, ou l’ID de page d’une URL de l’éditeur (le segment après ~/), pour qu’un outil d’IA puisse ouvrir une page directement depuis un lien de l’éditeur. Pour lire une page privée, transmettez son ID de nœud private-page-<uuid> obtenu depuis list_nodes avec visibility: "private". Les lectures privées fonctionnent sans checkout et nécessitent une session OAuth. L’admin MCP refuse les jetons client et machine-to-machine pour l’accès aux pages privées.
• 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. Pour modifier une page privée, transmettez son ID de nœud private-page-<uuid> comme path. Les modifications privées nécessitent une session OAuth avec un rôle d’editor ou supérieur sur la page et fonctionnent sans checkout.
• write_page: Réécrit le contenu MDX complet d’une page. Accepte un ID de nœud private-page-<uuid> pour réécrire une page privée avec les mêmes exigences OAuth et de rôle que edit_page. Utilisez create_node pour créer une nouvelle page privée.

• 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. Transmettez visibility: "private" pour lister les pages privées et dossiers auxquels l’utilisateur OAuth a accès, au lieu de l’arbre de navigation de la branche. Le listing privé fonctionne sans checkout, ignore les autres filtres et renvoie le role de chaque nœud.
• create_node: Ajoute une nouvelle page, un groupe, un onglet, une ancre, une version, une langue, un produit ou une liste déroulante. Transmettez visibility: "private" avec data.type: "page" ou data.type: "group" pour créer une page privée ou un dossier privé dans l’arbre privé de l’appelant. L’appelant devient le manager du nœud. La création privée nécessite une session OAuth, fonctionne sans checkout et place le nœud à la racine privée ou sous un parent private-folder-<uuid> existant.
• 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). Accepte un ID de nœud private-page-<uuid> ou private-folder-<uuid> pour renommer une page privée ou un dossier, ou changer son icône ou son tag. Les mises à jour privées nécessitent une session OAuth avec un rôle d’editor ou supérieur et fonctionnent sans checkout.
• move_node: Déplace un nœud, y compris renommer le chemin d’une page.
• delete_node: Supprime un nœud de la navigation. Accepte un ID de nœud private-page-<uuid> ou private-folder-<uuid> pour supprimer une page privée ou un dossier de l’arbre privé de l’appelant. Les suppressions privées nécessitent une session OAuth avec un rôle de manager sur le nœud et fonctionnent sans checkout.

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

Le mode code gère les opérations au niveau du déploiement qui n’ont pas d’outil dédié, comme la gestion des workflows, des paramètres de déploiement, des membres, de la facturation, des intégrations, des analyses et du partage des pages privées. Les outils du mode code ne nécessitent pas de checkout.

• search_code_operations: Recherche les méthodes de gestion des déploiements disponibles pour le mode code. Chaque résultat inclut le schéma d’entrée complet de la méthode.
• execute_code: Exécute un script TypeScript sur les méthodes de gestion des déploiements. Les scopes accordés à la connexion contrôlent chaque méthode, et toute méthode qui ne vous a pas été accordée renvoie une erreur d’autorisation.

• 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 votre branche de déploiement.
• 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.