read: Récupère le MDX complet de n’importe quelle page surbranch, ou sur votre branche de déploiement lorsque vous l’omettez. Transmettez un chemin de page, commeguides/setup, ou le dernier segment d’une URL de l’éditeur, qui correspond à l’ID de la page éventuellement précédé d’un titre. Lorsque vous utilisez un ID de page issu d’une URL de l’éditeur, transmettez la branche de cette URL commebranch. La réponse inclut unfilePathque vous pouvez transmettre commepathàedit_pageetwrite_page, ainsi qu’uneversiondu contenu renvoyé. TransmettezforEdit: truepour lire la page en direct plutôt que sa copie enregistrée. UtilisezforEdit: trueavant de réécrire la page avecwrite_page. Pour lire une page privée, transmettez son ID de nœudprivate-page-<uuid>obtenu depuislist_nodesavecvisibility: "private". Les lectures privées n’ont pas besoin debranchet nécessitent une session OAuth. L’Admin MCP refuse les jetons client et machine à machine pour l’accès aux pages privées.search: Recherche dans les pages debranchpar sens et par formulation exacte, ou dans votre branche de déploiement lorsque vous l’omettez. Passez une question, un sujet, un nom ou une expression exacte commequery. Par défaut,searchrenvoie d’abord les pages les plus pertinentes sous forme deresults. Chaque résultat contient lepathet letitlede la page, ainsi que dessnippetsavec les lignes correspondantes. Lorsquesearchest confiant quant au premier résultat, celui-ci inclut aussi lecontentcomplet de la page, jusqu’à 16 Ko. Les résultats suivants incluent lasectionautour de leur meilleure correspondance. Passezlimitpour renvoyer jusqu’à 20 pages (6 par défaut). Pour lister toutes les pages qui contiennent une expression, par exemple avant un renommage, passezmode: "all"(limitpar défaut de 100, maximum 500). Passerregex: truetraitequerycomme une expression régulière et utilise toujoursmode: "all".edit_page: Applique une modification ciblée à une page. Transmettezpathsous les mêmes formes que pourread. TransmettezoldStringetnewStringpour un seul remplacement, ou transmettez une listeeditsde jusqu’à 100 remplacements pour modifier plusieurs parties d’une page en un seul appel. Mintlify applique les modifications dans l’ordre, chacune sur le résultat de la précédente. Si une modification échoue, aucune n’est appliquée. Commewrite_page,edit_pagerenvoienotRenderedpour le balisage ajouté par la modification que l’éditeur supprime. Il ne signale pas le balisage déjà présent sur la page. Pour modifier une page privée, transmettez son ID de nœudprivate-page-<uuid>commepath. Les modifications privées nécessitent une session OAuth avec un rôle d’editor ou supérieur sur la page et n’ont pas besoin debranch.write_page: Réécrit le contenu MDX complet d’une page. Transmettezpathsous les mêmes formes que pourread. Avant de réécrire une page, appelezreadavecforEdit: trueet transmettez laversionrenvoyée àwrite_pagecommebaseVersion. Si la page a changé depuis cette lecture, Mintlify refuse l’écriture, ne modifie rien et renvoiepage_changed. Relisez la page et réappliquez votre modification. Si vous omettezbaseVersionsur une page qui a du contenu,write_pagerenvoiebase_version_required. Une page qui ne contient que du frontmatter n’a pas besoin debaseVersion. Accepte également un ID de nœudprivate-page-<uuid>pour réécrire une page privée avec les mêmes exigences OAuth et de rôle queedit_page. Utilisezcreate_nodepour créer une nouvelle page privée. Si le contenu inclut du balisage que l’éditeur Mintlify supprime, comme des balises<script>, des blocs<style>, des gestionnaires d’événements commeonClickou des expressions JavaScript, la réponse inclut un champnotRendered. Chaque entrée indique l’elementsupprimé, saline,whyl’éditeur le supprime et quoi utiliserinstead, comme des classes Tailwind, des objetsstyle={{}}en ligne avec des valeurs littérales ou des composants Mintlify comme les accordéons et les onglets.read_page_history: Liste l’historique des versions enregistré d’une page surbranch, ou sur votre branche de déploiement lorsque vous l’omettez. Transmettezpathsous les mêmes formes que pourread, y compris un ID de nœudprivate-page-<uuid>. Renvoieversions, de la plus récente à la plus ancienne, et unnextCursor. Chaque version possède unversionId, uncreatedAtet desauthors, chacun avec unnameet untypeparmiuser,gitousystem. Transmettezlimitpour renvoyer de 1 à 50 versions par appel (20 par défaut), et retransmetteznextCursorcommecursorpour lister les versions plus anciennes. Transmettez unversionIdpour obtenir le MDX complet de cette version danscontent. L’outil est en lecture seule. Pour restaurer une version antérieure, appelezreadsur la page avecforEdit: true, puis transmettez lecontentde la version antérieure àwrite_pageavec laversionde cette lecture commebaseVersion. Si cette version contient des données intégrées qui ne sont plus sur la page,write_pagene peut pas les restaurer. Restaurez plutôt cette version depuis l’historique des versions dans l’éditeur. Les erreurs incluentpage_not_found,version_not_foundetinvalid_cursor.
read, search, diff, read_page_history et read_comments remplacent chaque contenu base64 de 1 000 caractères ou plus par un espace réservé tel que [elided 48210 chars #1234567890].
Conservez ces espaces réservés tels quels lorsque vous renvoyez le contenu. edit_page, write_page, create_node et suggest_edit remplacent chaque espace réservé par les données d’origine issues du contenu actuel de la page cible.
Si un espace réservé ne correspond à aucune donnée de la page cible, Mintlify refuse l’écriture, ne modifie rien et renvoie inline_data_unresolved. Copiez les espaces réservés uniquement à partir d’un read de la même page. Si Mintlify ne peut pas lire la page pour restaurer les espaces réservés, il renvoie inline_data_source_unreadable et ne modifie rien. Réessayez l’appel.
upload_file: Démarre le téléversement d’un fichier local. Transmettez lepathde destination, lecontentTypedu fichier et sasizeexacte en octets. Renvoie unuploadId, uneuploadUrlprésignée et lesheadersà envoyer avec le téléversement.finalize_file_upload: Enregistre une image téléversée surbranch. Transmettez l’uploadIdet le mêmepath. Renvoie lesrcà référencer dans le MDX avecedit_pageouwrite_page, ou dans les champslogooufavicondedocs.jsonavecupdate_config.
upload_file, l’outil d’IA téléverse les octets du fichier vers uploadUrl avec une requête PUT et les en-têtes renvoyés. Par exemple :
path d’image, comme images/dashboard.png, et la branch à upload_file. Après le téléversement, appelez finalize_file_upload. Mintlify vérifie que le contenu du fichier téléversé correspond à son extension avant de l’enregistrer. Un téléversement vers un path existant remplace cette image. Seuls les logos et les favicons peuvent être téléversés au format SVG : transmettez purpose: "logo" aux deux outils lorsque vous en téléversez un. Les images de page ne peuvent pas être au format SVG. Les images enregistrées apparaissent dans status et sont publiées avec le reste de vos modifications lorsque vous appelez publish.
Pour écrire une page à partir d’un fichier Markdown local, transmettez un path .md ou .mdx avec contentType défini sur text/markdown ou text/plain. Les téléversements de pages n’ont besoin ni de branch ni de finalize_file_upload. Après le téléversement, transmettez l’uploadId à la place de content à write_page, ou comme data.uploadId à create_node. Cela évite de renvoyer l’intégralité du contenu d’une page volumineuse dans l’appel d’outil.
Utilisez l’uploadId dans un délai de 10 minutes. Chaque uploadId ne fonctionne qu’une fois, sur le même projet et pour le même utilisateur ou client que celui qui l’a créé. Mintlify supprime le fichier téléversé après l’écriture. Un uploadId réutilisé ou expiré renvoie upload_not_found.
Travaillez avec les commentaires et suggestions que votre équipe laisse dans l’éditeur du tableau de bord.
read_comments: Liste les fils de commentaires et de suggestions ouverts sur une page, du plus ancien au plus récent. Transmettezpathsous les mêmes formes que pourread. Chaque fil inclut unthreadId, sontype(commentousuggestion), lequotedTextauquel il est ancré, lesuggestedTextdes suggestions et sescommentsavec l’author, lecontentet lecreatedAtde chacun. Si le texte ancré n’existe plus sur la page, le fil inclutanchorRemoved: trueetquotedTextaffiche la citation d’origine. Lit les fils debranch, ou de votre branche de déploiement lorsque vous l’omettez.add_comment: Démarre un nouveau fil de commentaires sur une page sans modifier son contenu. Utilisez-le pour laisser un retour à votre équipe au lieu de modifier la page. Transmettezpathsous les mêmes formes que pourread, lecontentdu commentaire etquotedText: le plus court passage de texte visible et unique auquel l’ancrer, dans un seul paragraphe ou titre. Utilisez les mots affichés, pas la syntaxe Markdown ou MDX. Par exemple, citezcustom domain, pas[custom domain](/path). Renvoie le nouveauthreadId. Si le texte n’est pas sur la page, l’erreur estno_match. S’il correspond à plusieurs endroits, l’erreur estnot_unique: citez alors un passage plus long.suggest_edit: Propose une suggestion avec suivi des modifications sur une page au lieu de la modifier. Le texte original reste sur la page, barré, et le remplacement apparaît à côté. Rien ne change tant que quelqu’un n’a pas accepté ou rejeté la suggestion dans l’éditeur du tableau de bord. Transmettezpathsous les mêmes formes que pourread,oldStringetnewString.oldStringest le plus court passage de texte visible et unique à remplacer, dans un seul paragraphe ou titre. Utilisez les mots affichés, pas la syntaxe Markdown ou MDX. Transmettez unnewStringvide pour suggérer une suppression. Transmettez uncommentfacultatif pour expliquer en quoi la modification est utile. Mintlify le publie comme réponse de l’agent dans le fil de la suggestion. L’ancien paramètrenotefonctionne toujours comme alias obsolète decomment. Renvoie le nouveauthreadIdavecoriginalTextetsuggestedText, réduits au passage qui change. Si la même suggestion est déjà ouverte, la réponse inclutalreadyExists: trueet lethreadIdexistant. Les erreursno_matchetnot_uniquefonctionnent comme pouradd_comment. L’erreur estno_changelorsque les deux chaînes sont identiques, etconflicting_annotationlorsque le texte chevauche une autre suggestion ouverte.reply_to_comment: Répond à un fil parthreadIdaveccontent. Transmettezresolve: truepour également résoudre le fil. Mintlify publie la réponse en tant qu’agent au nom de l’utilisateur qui a autorisé la connexion, et elle apparaît en direct dans l’éditeur du tableau de bord.resolve_comment: Résout un fil sans répondre.read_inbox: Liste votre boîte de réception du dashboard sur un projet, l’activité la plus récente en premier. La boîte de réception comprend les commentaires et mentions, les modifications suggérées, les demandes de relecture, ainsi que les pages et dossiers privés partagés avec vous. Par défaut,read_inboxrenvoie les éléments ouverts. Passezstateavec la valeuropen,doneouall, etsectionavec la valeurcomment,suggestion,invitation,requestouall(par défaut). La sectionrequestcomprend les demandes de relecture et les invitations. Passezfilterpour limiter les commentaires àmentionsouon-my-page(les pages dont vous êtes propriétaire), les suggestions à celles provenant depeopleou de l’agent, ou la sectionrequestàrequestsouinvites. Le filtre doit correspondre àsection, sauf sisectionvautall. PassezdateFrometdateTosous forme de dates-heures ISO 8601 pour limiter les éléments selon leur dernière activité. Passezlimitpour obtenir de 1 à 50 éléments par appel (20 par défaut), et renvoyeznextCursorcommecursorpour lister les éléments plus anciens. Chaque élément inclut sacategory, sonstate, salatestActivityet satarget. Lorsquetarget.threadest présent, non résolu et ne se trouve pas sur une page privée, appelezread_commentsavec sonfilePathet répondez avecreply_to_comment, tous deux sur sabranch. Les élémentsrestrictedn’incluent pas les détails du fil.read_inboxest en lecture seule et ne marque jamais les éléments comme lus ou terminés. Les erreurs incluentinvalid_filter,invalid_date_rangeetinvalid_cursor.
add_comment, suggest_edit, reply_to_comment et resolve_comment nécessitent une session OAuth et une branch. Ils agissent sur les fils de cette branche et fonctionnent sur votre branche de déploiement même lorsque ses modifications exigent une pull request. Vous pouvez répondre aux fils de suggestions, mais vous devez accepter ou rejeter les suggestions dans l’éditeur. Les commentaires sur les pages privées ne sont pas disponibles via l’Admin MCP. read_inbox nécessite également une session OAuth et ne renvoie que la boîte de réception d’un membre actif de l’organisation du projet.
list_nodes: Parcourt l’arbre de navigation debranch, ou de votre branche de déploiement lorsque vous l’omettez, 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 fichiers et dossiers téléversés (nœudsfileetfile_directory) n’apparaissent que lorsque vous les incluez dans le filtre de type. Chaque nœud renvoie sonid, sontype, sontextet sonparent, ainsi quepath,pageIdethiddenlorsqu’ils s’appliquent. Transmettez lepathd’une page àreadpour obtenir son contenu et son frontmatter. Les résultats se paginent via uncursoropaque. Transmettezvisibility: "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é ignorebranchet les autres filtres, et renvoie lerolede 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. Transmettezvisibility: "private"avecdata.type: "page"oudata.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, n’a pas besoin debranchet place le nœud à la racine privée ou sous un parentprivate-folder-<uuid>existant. Pour les nouvelles pages, la réponse inclut uneeditorUrlqui ouvre la page dans votre tableau de bord. Si une page existe déjà aupathindiqué surbranch,create_nodeécrit le nouveau contenu dans cette page au lieu d’échouer. La page conserve sa place dans la navigation, même si vous transmettez un parent différent, et la réponse inclutupdated: true. Si Mintlify ajoute une nouvelle page à la navigation mais ne parvient pas à enregistrer son contenu,create_noderenvoiePAGE_SEED_FAILED. Appelez à nouveaucreate_nodeavec le mêmepathpour écrire le contenu.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œudprivate-page-<uuid>ouprivate-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 n’ont pas besoin debranch.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œudprivate-page-<uuid>ouprivate-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 n’ont pas besoin debranch.
create_node, update_node, move_node ou delete_node laisse la navigation dans un état invalide, la réponse inclut un champ navigationErrors qui décrit le problème. Par exemple, une page placée à la racine à côté d’onglets renvoie navigationErrors. Mintlify peut retirer les nœuds invalides de la navigation publiée. Corrigez donc ces erreurs avant d’appeler publish.
update_config: Modifie les paramètres de premier niveau dedocs.json, comme le thème, les couleurs, le logo, la barre de navigation, le pied de page, les redirections, les intégrations et le SEO. Il ne peut pas modifiernavigation; utilisez plutôt les outils de navigation. Mintlify rejette en bloc toute configuration non valide.
read_skill: Lit le guide de Mintlify pour la rédaction de documentation, qui couvre les pages, les composants, les widgets, la navigation etdocs.json. Il s’agit de la même skill Mintlify que celle utilisée par l’agent. Appelez-le sanspathpour obtenirSKILL.md, l’index de la skill, ainsi qu’une listefilesde ses fichiers de référence. Transmettez un fichier de cette liste commepath, par exemplereference/widgets.md, pour le lire. L’outil est en lecture seule et n’a pas besoin desubdomainni debranch. Si le fichier n’existe pas, il renvoieskill_file_not_foundavec la listefiles.
skills des skills de l’agent de votre organisation et des vôtres qui sont activées, chacune avec un name, une description et un path. Transmettez le path d’une skill, par exemple org/release-notes/SKILL.md, pour lire ses instructions. La réponse liste les fichiers de référence de la skill dans files, et vous pouvez transmettre n’importe lequel d’entre eux comme path. Les chemins des skills personnelles commencent par me/ et n’apparaissent que pour les sessions OAuth.
L’Admin MCP indique aux outils d’IA d’appeler read_skill avant de rédiger, restructurer ou mettre en forme des pages, et de suivre toute skill d’organisation ou personnelle dont la description correspond à la tâche.
Les outils de gestion de projet gèrent les opérations au niveau du projet, comme la gestion des automatisations, des paramètres de projet, des domaines personnalisés, des sources Git, de l’authentification, des membres, des analyses et du partage des pages privées. Ils agissent sur le projet en direct, pas sur une branche.
Chaque outil prend un subdomain correspondant au projet ciblé. Les connexions à l’échelle de l’organisation doivent transmettre subdomain. Appelez list_deployments pour le trouver. Les outils de lecture acceptent aussi subdomains, une liste de 25 projets maximum, et renvoient un résultat ou une erreur pour chacun. La plupart des outils prennent un objet request dont le champ action sélectionne l’opération. Par exemple :
get_deployment_settings: Lit en un seul appel les paramètres du dashboard d’un projet, y compris les paramètres de publication de l’éditeur et de relecture, ses sources Git, l’état de ses noms d’hôte personnalisés et ses vérifications de sources. La configuration Slack et les snippets sont facultatifs.get_analytics_report: Lit un rapport d’analyse prédéfini, comme les pages vues, les pages populaires, les référents, les retours, les conversations de l’assistant ou la qualité de la recherche. Sélectionnez le rapport avecrequest.report. Les résultats volumineux sont paginés avecmaxRowsetrowOffset. Pour des requêtes personnalisées, utilisezquery_analytics.get_analytics_schema: Lit les tables, les événements et les règles SQL acceptés parquery_analytics. L’outil d’IA l’appelle une fois avant d’écrire une requête.query_analytics: Exécute une requêteSELECTen lecture seule sur les analyses de votre site, comme les pages vues, la recherche, l’assistant, les retours et le trafic. Les résultats sont déjà limités au projet. Si les requêtes d’analyse ne sont pas activées pour le projet, les deux outils de requête d’analyse renvoient une erreurnot_enabled.get_workflows: Liste les automatisations, récupère une automatisation ou parcourt ses exécutions.list_repos_and_prs: Liste les dépôts connectés, les pull requests d’un dépôt ou les intégrations disponibles pour une automatisation.
update_deployment_settings: Modifie un paramètre du dashboard, commenoindex,base_path,name,disable_ai_chat,search_settings,privacy,custom_scriptsou un module complémentaire. Utilisezeditor_publishingpour modifier les paramètres de relecture. Seuls les administrateurs de l’organisation peuvent les modifier, avec les mêmes règles que dans le dashboard. Utilisezupdate_configpour les paramètres dedocs.json.manage_custom_domain: Ajoute ou supprime un domaine personnalisé, provisionne son nom d’hôte ou relance la validation du nom d’hôte.manage_git_source: Ajoute, met à jour, supprime ou réordonne les dépôts Git à partir desquels un projet est compilé, ou définit la source de base.manage_access_auth: Configure ou supprime l’authentification du site, ajoute ou supprime des mots de passe, configure l’authentification des utilisateurs finaux ou change celle qui est active. Le changement ne conserve qu’une configuration JWT. Si la configuration active utilise un autre type, le changement échoue avec une erreur409et laisse votre site inchangé. Pour passer à un autre type, configurez directement la nouvelle authentification. Lorsqu’une action active l’authentification du site, y compris un passage depuis l’authentification des utilisateurs finaux, Mintlify supprime les aperçus existants qui ne disposent ni d’une connexion d’organisation ni d’une protection par mot de passe. DéfinissezpreviewDeploymentssurdelete_unauthenticated(par défaut),delete_alloukeeppour choisir ce qu’il advient des aperçus existants.manage_workflow: Crée, met à jour, active ou désactive, supprime ou déclenche une automatisation. Dans un projet multi-dépôts, transmettez unrepo_namefacultatif (par exemple,mintlify/docs) lorsque vous créez ou mettez à jour une automatisation pour définir son dépôt cible. Le dépôt doit être connecté au projet. Si vous l’omettez, les nouvelles automatisations utilisent la source de base et les mises à jour conservent la cible actuelle.manage_workflow_prs: Fusionne ou ferme une pull request ouverte par une exécution d’automatisation. Pour fusionner une pull request d’une branche modifiée par l’outil d’IA, utilisez plutôtpublishavecmerge: true.manage_members_sharing: Liste, invite ou retire des membres de l’organisation, met à jour leurs rôles ou gère les autorisations et déplacements des pages privées dans les bases. Un seul appel invite jusqu’à 250 personnes et ignore celles qui sont déjà membres ou ont une invitation en attente.
state, afin que l’outil d’IA puisse confirmer la modification sans second appel. Chaque action vérifie les scopes accordés à la connexion et votre rôle dans le dashboard. Une action pour laquelle vous n’êtes pas autorisé renvoie une erreur comme insufficient_scope. Pour la corriger, consultez Les appels d’outils renvoient insufficient_scope.
Ces outils n’apparaissent que lorsque votre projet exige une relecture avant publication. list_review_requests et request_review acceptent un branch facultatif, qui correspond par défaut à votre branche de déploiement. Sur une autre branche, une demande de relecture couvre les modifications de la branche par rapport à votre branche de déploiement. Si votre branche de déploiement est protégée par une règle de protection de branche GitHub, demandez les relectures sur une branche de fonctionnalité.
list_review_requests: Liste les demandes de relecture ouvertes sur une branche. Chaque demande inclut sonrequester, sesreviewerset leurstate, ainsi que sespages. Chaque page a unpath, untitleet uneapprovalvalantapproved,pendingoustalesi la page a changé après l’approbation et doit être relue de nouveau. Les modifications qui n’appartiennent à aucune page, comme la navigation et les paramètres du site, apparaissent sous la forme d’un seul élément intituléSite changes.request_review: Demande aux relecteurs d’approuver vos modifications en attente. Passez jusqu’à 100pagesdans les mêmes formes que pourread, et lesreviewers, chacun sous forme d’emailou derole.role: "admin"sollicite tous les administrateurs.role: "editor"sollicite tous les publieurs, ou tous les éditeurs si votre organisation ne dispose pas du rôle publieur. Si vous avez des modifications en attente qui n’appartiennent à aucune page et qu’aucune autre demande ouverte ne les inclut, Mintlify ajoute l’élémentSite changesà la demande. Mintlify ne sollicite que les membres actifs, autres que vous, qui peuvent approuver. Chaque relecteur reçoit un e-mail et un élément dans sa boîte de réception. Les erreurs incluentno_pending_changeslorsqu’une page n’a rien à relire,no_reviewerslorsqu’aucune personne pouvant approuver ne correspond àreviewersetreview_unavailablelorsque la branche ne peut pas recevoir de demandes de relecture, comme une branche de déploiement protégée.add_reviewers: Ajoute des relecteurs à une demande de relecture ouverte, parrequestId, sans la retirer, comme lorsque vous ajoutez des relecteurs dans l’éditeur. Passezreviewerssous les mêmes formes que pourrequest_review. Les approbations existantes sont conservées. Mintlify ignore le demandeur, les personnes déjà présentes dans la demande et les membres qui ne peuvent pas approuver, et seuls les nouveaux relecteurs reçoivent un e-mail et un élément dans leur boîte de réception. Renvoie larequestmise à jour et les adresses e-mailadded. Les erreurs incluentrequest_not_foundetno_reviewers.withdraw_review_request: Retire une demande de relecture que vous avez faite, parrequestId. Passez unrevieweravec une adresse e-mail pour retirer uniquement ce relecteur. Retirer le dernier relecteur retire la demande. Les pages conservent leurs modifications en attente.approve_review_request: Approuve la demande de relecture d’une autre personne parrequestId, comme en cliquant sur Approve dans l’éditeur. L’Admin MCP indique à l’outil d’IA de n’approuver que lorsque vous lui demandez d’approuver cette demande précise, et de confirmer d’abord avec vous le demandeur et les pages. Renvoieown_requestpour votre propre demande,own_branchpour une branche que vous avez créée,not_reviewersi votre rôle ne peut pas approuver,changedsi les modifications ont été éditées après que l’outil d’IA les a lues etgithub_rejectedsi GitHub a refusé l’approbation, par exemple parce que vous n’avez pas connecté votre compte GitHub. Sur une branche GitHub protégée, l’approbation approuve aussi la pull request dans GitHub avec votre compte connecté.publish_review_request: Publie une demande de relecture approuvée parrequestId, avec untitlepour le message de commit, comme lorsque vous publiez les modifications approuvées d’un collègue dans l’éditeur. Les administrateurs et les publieurs peuvent publier. L’Admin MCP indique à l’outil d’IA de ne publier que lorsque vous lui demandez de publier cette demande précise. Renvoienot_approvedtant que chaque page n’a pas les approbations nécessaires,navigation_heldtant qu’une autre demande ouverte retient des modifications de navigation dont cette demande a besoin etnot_allowedsi votre rôle ne peut pas publier. Sur une branche de fonctionnalité, fusionne la pull request de la branche dans votre branche de déploiement et renvoiemerged. Renvoieno_pull_requestsi la branche n’a pas encore de pull request (appelez d’abordpublishsur la branche) etmerge_not_allowedsi vous devez fusionner dans l’éditeur. Suivez ledeploymentrenvoyé avecdeployment_status.
list_deployments: Liste les projets auxquels votre connexion peut accéder, en renvoyant chaque{subdomain, name, projectType}.projectTypevautsitepour un site ouworkspacepour une base de connaissances. Appelez ceci pour découvrir quelsubdomaintransmettre.create_branch: Crée une nouvelle branche à partir de votre branche de déploiement, ou de la branche existante que vous passez commefrom, avec untitlequi nomme aussi sa pull request. Renvoie lebranchNameà passer commebranch. Consultez Travailler sur une branche. Vous n’en avez pas besoin pour modifier directement la branche de déploiement.list_branches: Liste les branches Git disponibles pour le dépôt d’un projet, avec un filtragequeryoptionnel. Renvoie les noms de branches, le nombre total et la branche de déploiement. Passez n’importe laquelle commebranch.status: Liste les fichiers modifiés, les clésdocs.jsonmodifiées et le diff de navigation en attente surbranch, ou sur votre branche de déploiement lorsque vous l’omettez. Sur la branche de déploiement, liste uniquement vos modifications.diff: Liste toutes les modifications entrebranchet votre branche de déploiement. Chaque fichier modifié et chaque entréedocs.jsonincluentauthorsetbyYou.authorsliste les membres dont l’entrée contient les modifications non publiées.byYouvauttruelorsque l’entrée inclut vos propres modifications. UtilisezbyYoupour distinguer vos modifications de celles d’un collègue sur une branche partagée.publish: Sur la branche de déploiement, commite directement uniquement vos modifications en attente. Si votre projet exige une relecture et que vous n’êtes pas administrateur, renvoiereview_requiredsur la branche de déploiement ou lorsque vous passezmerge: true. Consultez Projets qui exigent une relecture. Sur une branche, commite les modifications en attente et renvoie la pull request de la branche, en en ouvrant une si nécessaire. Passezmerge: truepour fusionner aussi la pull request lorsque les modifications sur la branche de déploiement sont autorisées. Lorsque les modifications atteignent la branche de déploiement, renvoie aussi un statutdeploymentà suivre avecdeployment_status.deployment_status: Vérifie si les modifications publiées sont en ligne sur votre site de documentation. Passez lecommitSharenvoyé parpublish, ou omettez-le pour vérifier le dernier déploiement. Renvoie unstateparmipending,queued,building,live,not_live,failedouskipped, ainsi queliveet unmessageà vous transmettre.not_livesignifie que le site sert toujours une version antérieure, par exemple parce que le déploiement a été annulé ou que votre déploiement est épinglé sur une version antérieure.discard: Abandonne les modifications surbranch. Sur la branche de déploiement, annule uniquement vos modifications en attente. Sur une autre branche que vous avez créée, supprime la branche et ferme sa pull request.
Commentaires