Ressources · Connecteur Claude

Connecteur Claude MintlifyCe que Claude sait faire dans ton compte Mintlify.

Le connecteur Claude Mintlify expose 15 outils. 5 lisent ta doc et ta session, 10 écrivent : pages, navigation, configuration, branches et pull requests. Voici comment se déroule une session, ce que Claude peut livrer et ce qui peut partir en ligne sans relecture.

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Aperçu

Ce que ça change pour une équipe doc

Une évolution produit sort et des pages deviennent fausses d'un coup. Avec ce connecteur, tu décris la correction à Claude et il travaille dans ton projet Mintlify : il trouve les pages, les retouche sur une branche dédiée, te montre le diff puis ouvre une pull request. Mintlify précise que chaque retouche s'accumule sur cette branche de session : rien ne touche la branche de déploiement avant un enregistrement.

Remettre d'aplomb les pages après une version. Un paramètre a été renommé : search repère chaque ligne qui garde l'ancien nom, edit_page corrige chaque page, et diff montre le résultat avant que rien ne quitte la branche.

Réorganiser une rubrique. La référence d'API est devenue touffue : list_nodes parcourt l'arborescence, create_node ajoute un nouveau groupe, et move_node y range les pages.

Livrer pour relecture. Quand la branche te va, save ouvre une pull request ; si tu changes d'avis, discard_session jette tout.

Ce que Claude ne peut pas garantir. Les retouches restent sur une branche de session jusqu'à l'enregistrement, mais selon les réglages du projet, un enregistrement peut fusionner aussitôt. Claude travaille avec le rôle de ton compte Mintlify : les réglages réservés aux admins demandent un admin. Et rien ne se déclenche seul, une nouvelle version ne réveille pas Claude. Les tâches planifiées ou déclenchées par un événement relèvent des outils d'automatisation, un autre métier à retrouver depuis la page Intégrations.

Vocabulaire

Le vocabulaire en une minute

Cinq mots que tu croiseras en branchant Mintlify.

Connecteur
Le lien que tu poses une fois entre Claude et un compte que tu as déjà, pour qu'il y travaille pendant qu'il te répond.
Outil
Une action nommée que le connecteur ouvre à Claude dans ce compte. Il choisit seul ceux qu'il lui faut ; la fiche du répertoire les liste tous.
Autorisation
L'écran de connexion de Mintlify, où tu accordes l'accès que Claude utilisera. Donnée une fois par personne, révocable dans les réglages de Mintlify.
Approbation
La confirmation que Claude attend avant d'aller au bout d'une action qui modifie ton compte, affichée dans la conversation au bon moment.
MCP
Le standard commun des connecteurs : c'est lui qui permet à un assistant comme Claude de dialoguer avec un service extérieur.
Connexion

Brancher Mintlify à Claude en trois étapes

  1. 01

    Retrouver Mintlify

    Dans Claude, ouvre Customize puis Connectors et repère Mintlify dans la liste. Sur un espace Team ou Enterprise, un Owner ou un Primary Owner active le connecteur pour l'organisation avant que les membres s'y connectent.

  2. 02

    Se connecter à Mintlify

    Clique sur Connect depuis sa ligne et termine l'identification dans la fenêtre que Mintlify ouvre. Si la connexion se casse un jour, Disconnect puis rebranche depuis la même ligne.

  3. 03

    Relire ce que tu accordes

    Lis l'écran d'autorisation avant de valider. Il appartient à Mintlify, pas à Claude, et fixe ce que couvre l'accès. Tu peux le révoquer plus tard depuis le tableau de bord Mintlify.

Outils

Les 15 outils, rangés selon ce qu'ils font

Mintlify donne à Claude 15 outils : 5 qui lisent ton compte, 10 qui y changent quelque chose.

Deux groupes : ce que Claude lit, et ce qu'il change dans ton projet. Les noms restent en anglais, tels que Claude les affiche.

  • 5 lecture
  • 10 écriture

Ce que Claude lit (5)

5 outils

Cinq outils qui consultent les pages, la navigation et la session en cours sans y toucher.

read

Récupère la source MDX complète de n'importe quelle page de la branche de session, à partir d'un chemin de fichier ou d'un identifiant. Il renvoie la version de la branche, retouches comprises.

Quand ça sert
avant de reprendre le guide de démarrage, tu veux que Claude le parcoure ligne à ligne.

Sourcemintlify.com · 1 octobre 2026 ↗

list_nodes

Liste l'arborescence de navigation avec des filtres facultatifs. On voit ainsi comment pages, groupes et onglets s'organisent avant que quoi que ce soit bouge.

Quand ça sert
tu dois voir comment l'onglet des guides est structuré avant de décider où placer une nouvelle rubrique.

Sourcemintlify.com · 1 octobre 2026 ↗

get_session_state

Affiche la branche courante, les fichiers déjà retouchés dans la session et le diff de navigation en attente, un état des lieux rapide au milieu d'un long chantier.

Quand ça sert
après la pause déjeuner, tu demandes à Claude où en est la session avant de reprendre.

Sourcemintlify.com · 1 octobre 2026 ↗

diff

Liste chaque différence entre la branche de session et ta branche de déploiement, pour voir exactement ce qui partirait avant le moindre enregistrement.

Quand ça sert
une relectrice veut la vue d'ensemble de la session au même endroit avant de donner son feu vert.

Sourcemintlify.com · 1 octobre 2026 ↗

Ce que Claude change (10)

10 outils

Dix outils qui ouvrent une branche, retouchent le contenu ou le livrent. Aucune source ne décrit de confirmation propre : la règle générale plus bas s'applique.

checkout

Approbation : voir la règle

Rattache la session à une branche d'un projet donné, en créant une branche admin-mcp neuve depuis la branche de déploiement du projet. Rappelé, il bascule vers la session d'un autre projet.

Ce que Claude demande
aucune source ne documente de confirmation ici, la règle d'approbation par défaut s'applique.
Quand ça sert
tu veux une branche propre, nommée d'après le correctif, avant toute retouche.

Sourcemintlify.com · 1 octobre 2026 ↗

save

Approbation : voir la règle

Pousse le travail de la session vers Git, en ouvrant une pull request ou en commitant sur la branche de session. Si le projet autorise l'agent à pousser sur main et que la branche n'est pas protégée, Mintlify fusionne aussitôt.

Ce que Claude demande
rien de propre à cette étape n'est documenté, elle relève de la règle générale.
Quand ça sert
la réécriture est finie et attend un relecteur.

Sourcemintlify.com · 1 octobre 2026 ↗

discard_session

Approbation : voir la règle

Jette la session et toutes les retouches en cours. Rien de cette session n'atteint ta branche de déploiement.

Ce que Claude demande
les sources se taisent sur une demande pour celui-ci, c'est le réglage par défaut de la section approbations qui le couvre.
Quand ça sert
une tentative de réorganisation est partie de travers et tu préfères repartir de la branche de déploiement.

Sourcemintlify.com · 1 octobre 2026 ↗

edit_page

Approbation : voir la règle

Applique une correction ciblée à une page en laissant le reste de son contenu tel quel. La modification atterrit sur la branche de session.

Ce que Claude demande
la doc de Mintlify ne décrit aucune confirmation pour cet outil ; la règle générale de Claude fait référence.
Quand ça sert
un seul exemple de code vise encore l'ancien endpoint et seul ce bloc doit bouger.

Sourcemintlify.com · 1 octobre 2026 ↗

write_page

Approbation : voir la règle

Remplace d'un coup tout le contenu MDX d'une page au lieu de rapiécer un passage. La nouvelle version reste sur la branche de session jusqu'à l'enregistrement.

Ce que Claude demande
aucune source ne mentionne de demande dédiée ; reporte-toi à la section approbations.
Quand ça sert
l'ancienne page de dépannage ne se répare plus et mérite un nouveau jet.

Sourcemintlify.com · 1 octobre 2026 ↗

create_node

Approbation : voir la règle

Ajoute à la navigation une page, un groupe, un onglet, une ancre, une version, une langue, un produit ou un menu. Mintlify prévient que des nœuds invalides peuvent sauter de la navigation publiée : les erreurs se corrigent avant l'enregistrement.

Ce que Claude demande
rien n'est documenté pour cet outil en particulier, il relève de la règle générale d'approbation.
Quand ça sert
la FAQ facturation mérite sa propre page dans le groupe FAQ.

Sourcemintlify.com · 1 octobre 2026 ↗

update_node

Approbation : voir la règle

Modifie sur place les propriétés d'un nœud : renommer un groupe, remplacer une icône, fixer une version par défaut, sans rien déplacer.

Ce que Claude demande
la documentation reste muette sur une demande, la règle par défaut s'applique.
Quand ça sert
un groupe affiche encore « Bêta » alors que la fonction est sortie depuis des mois.
Attention
une navigation invalide revient sous forme d'erreurs à corriger avant d'enregistrer.

Sourcemintlify.com · 1 octobre 2026 ↗

move_node

Approbation : voir la règle

Déplace un nœud ailleurs dans la navigation, y compris en renommant le chemin d'une page, ce qui change aussi l'adresse où arrivent les lecteurs.

Ce que Claude demande
aucune confirmation propre à l'outil n'est décrite ; la section approbations dit ce qui le gouverne.
Quand ça sert
les pages sur les webhooks sont éparpillées et doivent se retrouver dans un même groupe.

Sourcemintlify.com · 1 octobre 2026 ↗

delete_node

Approbation : voir la règle

Sort un nœud de la navigation. Le retrait attend sur la branche de session comme toute autre retouche.

Ce que Claude demande
Mintlify ne documente pas de demande pour un retrait ; seule la règle générale fait foi.
Quand ça sert
une fonction abandonnée a encore sa page dans la barre latérale.
Attention
laissés en l'état, des nœuds invalides peuvent disparaître de la navigation publiée.

Sourcemintlify.com · 1 octobre 2026 ↗

update_config

Approbation : voir la règle

Modifie le docs.json du projet : thème, racines de navigation, intégrations et réglages SEO. Sur les paramètres protégés, Mintlify exige un rôle d'admin sur le projet.

Ce que Claude demande
rien au-delà du comportement d'approbation par défaut de Claude n'est documenté ici.
Quand ça sert
la charte graphique a bougé et le thème de la doc doit suivre.

Sourcemintlify.com · 1 octobre 2026 ↗

Approbations

Ce que Claude te demande avant d'agir

Par défaut, Claude s'arrête et demande ton accord avant chaque action qu'il mène sur un compte à ta place. Chez Mintlify, la branche ajoute un second filet, sauf si ton projet laisse les enregistrements fusionner directement.

Sur Team et Enterprise, les propriétaires de l'espace décident si les membres peuvent laisser passer des actions sans demande, et peuvent borner ce que fait un connecteur pour toute l'organisation, garder la lecture et fermer l'écriture par exemple. Claude hérite de ton rôle Mintlify, rien de plus : Mintlify précise que la session OAuth porte les permissions de ton tableau de bord. L'étiquetage officiel outil par outil n'apparaît que dans les réglages d'un compte connecté.

Plans

Sur quels plans c'est disponible

Aucune des 819 fiches du répertoire officiel n'affiche de disponibilité par plan. Cette réponse, connecteur par connecteur, n'est publiée nulle part.

La règle générale, elle, est publiée : les connecteurs distants sont ouverts à tous les utilisateurs sur Claude, Cowork, Claude Desktop et mobile. Sur Team et Enterprise, un Owner ou un Primary Owner active le connecteur pour l'organisation avant que les membres s'y connectent. Ton rôle Mintlify et ton accès Git sont des conditions à part, réglées côté Mintlify. Pour l'état à jour, consulte la fiche du connecteur dans le répertoire officiel.

Limites

Là où ce connecteur s'arrête

Un connecteur n'est pas une automatisation. Claude appelle ces outils pendant qu'il te répond : rien ne démarre quand du code fusionne ou qu'une version sort.

Seul Mintlify documente ce connecteur : le centre d'aide de Claude n'a pas de page dessus, les limites ci-dessous viennent donc de l'éditeur. La page de Mintlify décrit aussi des outils absents de la fiche du répertoire ; cette page ne couvre que les quinze listés. La liste d'outils est un plancher observé, pas un plafond. Le badge du répertoire n'est pas un audit de sécurité, et Anthropic écrit sur chaque fiche qu'il ne choisit pas les outils d'un éditeur. Pour les autres connecteurs et les pages d'automatisation, parcours la page Intégrations.

Besoin d'aide

Besoin d'aide pour brancher Mintlify sur Claude ?

Une personne lit chaque message.

FAQ

Questions fréquentes sur le connecteur Claude Mintlify

01Que peut faire Claude avec le connecteur Mintlify ?
Claude peut travailler directement dans ta documentation Mintlify pendant une conversation. Les quinze outils de la fiche lui permettent d'ouvrir une session sur une branche, de lire et chercher dans les pages, de parcourir la navigation, de faire le point sur la session et le diff, de retoucher ou réécrire des pages, d'ajouter, ajuster, déplacer ou retirer des nœuds, de mettre à jour docs.json, puis d'enregistrer le travail en pull request ou de l'abandonner. Tout se passe sur une branche jusqu'à l'enregistrement.
02Claude peut-il publier des changements sur ma doc en ligne ?
Oui, dans certaines configurations. L'enregistrement ouvre une pull request par défaut, qu'une personne relit ensuite. Mais Mintlify explique que si ton projet pousse les changements de l'agent directement sur la branche de déploiement et que cette branche n'est pas protégée, la pull request fusionne dès que Claude enregistre. Vérifie ton réglage de relecture de l'agent et tes règles de protection avant de brancher : c'est lui qui décide si un humain voit les retouches d'abord.
03Claude demande-t-il avant de retoucher mes pages Mintlify ?
Par défaut, Claude demande une confirmation avant chaque action qu'il mène sur un compte à ta place. Aucune source ne décrit de confirmation propre à un outil Mintlify, cette règle par défaut couvre donc aussi bien l'ouverture de branche que les retouches, la navigation et l'enregistrement. La branche de session ajoute un tampon, puisque rien n'atteint la branche de déploiement avant save. Sur Team et Enterprise, les propriétaires choisissent en plus ce qui passe sans demande.
04Sur quels plans Claude le connecteur Mintlify est-il disponible ?
Aucune source officielle ne publie la disponibilité par plan connecteur par connecteur, et aucune des 819 fiches du répertoire ne l'affiche. La règle générale veut que les connecteurs distants soient ouverts à tous les utilisateurs sur Claude, Cowork, Claude Desktop et mobile, avec une activation par un Owner ou un Primary Owner sur Team et Enterprise. Ton rôle Mintlify et ton accès Git sont des conditions à part. La fiche du répertoire montre l'état à jour pour ton compte.
05Claude obtient-il les droits d'admin sur notre projet Mintlify ?
Non, il obtient les tiens. Mintlify indique que la session OAuth hérite des permissions de ton tableau de bord : les actions réservées aux admins, comme mettre à jour des réglages protégés avec update_config, exigent un rôle d'admin sur le projet. Révoquer l'accès dans Settings, Security & access, Connected apps du tableau de bord Mintlify invalide aussitôt les jetons de session actifs. Sur Team et Enterprise, un propriétaire Claude peut en plus restreindre le connecteur pour tous, sans qu'un membre puisse lever ça.
06Que devient une session jamais enregistrée ?
Sa branche reste derrière elle. Mintlify explique qu'une session abandonnée sans enregistrement ni abandon explicite garde sa branche jusqu'au prochain checkout qui l'écrase. Pour éviter l'encombrement, demande à Claude d'abandonner la session quand un brouillon ne mène nulle part, ou garde chaque session centrée sur un seul changement, pour une pull request facile à relire. Révoquer l'accès OAuth, en revanche, laisse en place les pull requests déjà ouvertes. Ferme-les ou annule-les chez ton fournisseur Git si besoin.
07Claude ou un outil d'automatisation pour Mintlify ?
Ils ne font pas le même métier, alors choisis selon l'usage. Claude avec ce connecteur retouche la documentation en conversation : tu décris la correction, il trouve les pages, montre le diff et ouvre une pull request. Un outil d'automatisation réagit à des événements ou à un calendrier, par exemple pour ouvrir une tâche doc à chaque changement d'API, ce que ce connecteur ne fait jamais seul. Pour réécrire et restructurer à la main, c'est Claude ; pour des déclencheurs récurrents, l'automatisation.