Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 9 additions & 9 deletions es/ai/mintlify-mcp.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -15,9 +15,9 @@ import AdminMcpCodex from "/snippets/es/admin-mcp-codex.mdx";
## Acerca del Admin MCP
</div>

El servidor Admin MCP otorga a las herramientas de IA acceso de escritura a tu contenido y configuración de Mintlify. Úsalo para actualizar contenido y acceder a tu panel. Con el Admin MCP, puedes usar tus herramientas de IA preferidas para editar páginas, reestructurar la navegación, actualizar `docs.json`, abrir pull requests, cambiar configuraciones, crear workflows y más.
El servidor Admin MCP otorga a las herramientas de IA acceso de escritura a tu contenido y configuración de Mintlify. Úsalo para actualizar contenido y acceder a tu panel. Con el Admin MCP, puedes usar tus herramientas de IA preferidas para editar páginas, reestructurar la navegación, actualizar `docs.json`, abrir pull requests, cambiar configuraciones, crear automatizaciones y más.

Conecta cualquier cliente MCP como Claude, Claude Code, ChatGPT o Cursor al servidor Admin MCP. Úsalo para colaborar en tu contenido y configuración de Mintlify con las mismas herramientas que usas para escribir código. Cada llamada a una herramienta de contenido indica la rama en la que trabaja. Las ediciones en tu rama de despliegue llegan como cambios no publicados, y las ediciones en cualquier otra rama pasan por una pull request. Se publican cuando llamas a `publish` o haces merge de la pull request. Los cambios de [gestión de proyectos](#project-management), como las actualizaciones de workflows y de configuración, se aplican de inmediato al proyecto en vivo. Si tu organización tiene varios proyectos, una sola conexión de Admin MCP puede acceder a todos ellos y alternar entre ellos.
Conecta cualquier cliente MCP como Claude, Claude Code, ChatGPT o Cursor al servidor Admin MCP. Úsalo para colaborar en tu contenido y configuración de Mintlify con las mismas herramientas que usas para escribir código. Cada llamada a una herramienta de contenido indica la rama en la que trabaja. Las ediciones en tu rama de despliegue llegan como cambios no publicados, y las ediciones en cualquier otra rama pasan por una pull request. Se publican cuando llamas a `publish` o haces merge de la pull request. Los cambios de [gestión de proyectos](#project-management), como las actualizaciones de automatizaciones y de configuración, se aplican de inmediato al proyecto en vivo. Si tu organización tiene varios proyectos, una sola conexión de Admin MCP puede acceder a todos ellos y alternar entre ellos.

<Note>
El servidor Admin MCP permite que las herramientas de IA accedan a tu panel de Mintlify. Trátalo como una herramienta con acceso de escritura. Conéctalo solo desde herramientas de IA de confianza, revisa cada pull request antes de fusionarla y ten en cuenta que los cambios de gestión de proyectos se aplican de inmediato sin una pull request.
Expand All @@ -32,9 +32,9 @@ El Admin MCP es un servicio alojado por Mintlify en `https://mcp.mintlify.com`.
| | Admin MCP | Search MCP |
| :-- | :-- | :-- |
| **Audiencia** | Tu equipo | Tus usuarios finales |
| **Acceso** | Leer, editar, reestructurar, publicar, crear workflows, gestionar la configuración | Leer y buscar en las páginas publicadas de un sitio |
| **Acceso** | Leer, editar, reestructurar, publicar, crear automatizaciones, gestionar la configuración | Leer y buscar en las páginas publicadas de un sitio |
| **Endpoint** | `https://mcp.mintlify.com` | `/mcp` en el dominio de tu sitio |
| **Salida** | Ediciones de contenido, cambios de navegación, pull requests, ejecuciones de workflows | Resultados de búsqueda y contenido de páginas de tu sitio |
| **Salida** | Ediciones de contenido, cambios de navegación, pull requests, ejecuciones de automatizaciones | Resultados de búsqueda y contenido de páginas de tu sitio |

<div id="prerequisites">
## Requisitos previos
Expand Down Expand Up @@ -251,7 +251,7 @@ Si una llamada a `create_node`, `update_node`, `move_node` o `delete_node` deja
### Gestión de proyectos
</div>

Las herramientas de gestión de proyectos gestionan las operaciones a nivel de proyecto, como administrar workflows, la configuración del proyecto, los dominios personalizados, las fuentes de Git, la autenticación, los miembros, las analíticas y el uso compartido de [páginas privadas](/es/editor/pages#private-pages). Actúan sobre el proyecto en vivo, no sobre una rama.
Las herramientas de gestión de proyectos gestionan las operaciones a nivel de proyecto, como administrar [automatizaciones](/es/automations), la configuración del proyecto, los dominios personalizados, las fuentes de Git, la autenticación, los miembros, las analíticas y el uso compartido de [páginas privadas](/es/editor/pages#private-pages). Actúan sobre el proyecto en vivo, no sobre una rama.

Cada herramienta recibe un `subdomain` del proyecto sobre el que actuar. Las conexiones de toda la organización deben pasar `subdomain`. Llama a `list_deployments` para encontrarlo. Las herramientas de lectura también aceptan `subdomains`, una lista de hasta 25 proyectos, y devuelven un resultado o un error para cada uno. La mayoría de las herramientas reciben un objeto `request` cuyo campo `action` selecciona la operación. Por ejemplo:

Expand All @@ -268,23 +268,23 @@ Herramientas de lectura:
- **`get_analytics_report`**: Lee un informe de analíticas predefinido, como vistas de página, páginas populares, referencias, feedback, chats del asistente o calidad de búsqueda. Selecciona el informe con `request.report`. Los resultados grandes se paginan con `maxRows` y `rowOffset`. Para consultas personalizadas, usa `query_analytics`.
- **`get_analytics_schema`**: Lee las tablas, los eventos y las reglas de SQL que acepta `query_analytics`. La herramienta de IA lo llama una vez antes de escribir una consulta.
- **`query_analytics`**: Ejecuta una consulta `SELECT` de solo lectura sobre las analíticas de tu sitio, como vistas de página, búsqueda, asistente, feedback y tráfico de agentes y humanos. Los resultados ya están limitados al proyecto. Si las consultas de analíticas no están habilitadas para el proyecto, ambas herramientas de consulta de analíticas devuelven un error `not_enabled`.
- **`get_workflows`**: Lista los workflows, obtiene uno o recorre sus ejecuciones.
- **`list_repos_and_prs`**: Lista los repositorios conectados, las pull requests de un repositorio o las integraciones disponibles para usar en un workflow.
- **`get_workflows`**: Lista las automatizaciones, obtiene una o recorre sus ejecuciones.
- **`list_repos_and_prs`**: Lista los repositorios conectados, las pull requests de un repositorio o las integraciones disponibles para usar en una automatización.

Herramientas de escritura:

- **`update_deployment_settings`**: Cambia un ajuste del dashboard, como `noindex`, `base_path`, `name`, `disable_ai_chat`, `search_settings`, `privacy`, `custom_scripts` o un complemento. Usa `update_config` para los ajustes de `docs.json`.
- **`manage_custom_domain`**: Agrega o elimina un dominio personalizado, aprovisiona su hostname o vuelve a lanzar la validación del hostname.
- **`manage_git_source`**: Agrega, actualiza, elimina o reordena los repositorios de Git desde los que se compila un proyecto, o establece la fuente base.
- **`manage_access_auth`**: Configura o elimina la [autenticación](/es/deploy/authentication-setup) del sitio, agrega o elimina contraseñas, configura la autenticación de usuarios finales o cambia cuál está activa.
- **`manage_workflow`**: Crea, actualiza, habilita o deshabilita, elimina o ejecuta un workflow.
- **`manage_workflow`**: Crea, actualiza, habilita o deshabilita, elimina o ejecuta una automatización.
- **`manage_workflow_prs`**: Fusiona o cierra una pull request abierta por una ejecución de [automatización](/es/automations). Para fusionar una pull request de una rama que editó la herramienta de IA, usa `publish` con `merge: true` en su lugar.
- **`manage_members_sharing`**: Lista o elimina miembros de la organización, actualiza sus roles o gestiona los permisos y traslados de páginas privadas en proyectos internos.

Las herramientas de escritura devuelven el estado actualizado del proyecto en `state`, para que la herramienta de IA pueda confirmar el cambio sin una segunda llamada. Cada acción comprueba los ámbitos otorgados a la conexión y tu rol en el dashboard. Una acción para la que no tienes autorización devuelve un error como `insufficient_scope`.

<Warning>
Las escrituras de gestión de proyectos se aplican de inmediato al proyecto en vivo. No crean una rama ni abren una pull request. Confirma el cambio previsto antes de pedirle a una herramienta de IA que actualice workflows, configuraciones, dominios, autenticación o miembros.
Las escrituras de gestión de proyectos se aplican de inmediato al proyecto en vivo. No crean una rama ni abren una pull request. Confirma el cambio previsto antes de pedirle a una herramienta de IA que actualice automatizaciones, configuraciones, dominios, autenticación o miembros.
</Warning>

<div id="branches-and-publishing">
Expand Down
18 changes: 9 additions & 9 deletions fr/ai/mintlify-mcp.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -15,9 +15,9 @@ import AdminMcpCodex from "/snippets/fr/admin-mcp-codex.mdx";
## À propos du serveur Admin MCP
</div>

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.
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 automatisations, et plus encore.

Connectez n'importe quel client MCP comme Claude, Claude Code, ChatGPT ou Cursor au serveur Admin MCP. Utilisez-le pour collaborer sur votre contenu et vos paramètres Mintlify avec les mêmes outils que vous utilisez pour écrire du code. Chaque appel à un outil de contenu indique la branche sur laquelle il travaille. Les modifications sur votre branche de déploiement arrivent sous forme de modifications non publiées, et celles sur toute autre branche passent par une pull request. Elles sont livrées lorsque vous appelez `publish` ou fusionnez la pull request. Les changements de [gestion de projet](#project-management), tels que les mises à jour de workflows et de paramètres, s'appliquent immédiatement au projet en ligne. Si votre organisation dispose de plusieurs projets, une seule connexion Admin MCP peut accéder à tous ces projets et basculer entre eux.
Connectez n'importe quel client MCP comme Claude, Claude Code, ChatGPT ou Cursor au serveur Admin MCP. Utilisez-le pour collaborer sur votre contenu et vos paramètres Mintlify avec les mêmes outils que vous utilisez pour écrire du code. Chaque appel à un outil de contenu indique la branche sur laquelle il travaille. Les modifications sur votre branche de déploiement arrivent sous forme de modifications non publiées, et celles sur toute autre branche passent par une pull request. Elles sont livrées lorsque vous appelez `publish` ou fusionnez la pull request. Les changements de [gestion de projet](#project-management), tels que les mises à jour d'automatisations et de paramètres, s'appliquent immédiatement au projet en ligne. Si votre organisation dispose de plusieurs projets, une seule connexion Admin MCP peut accéder à tous ces projets et basculer entre eux.

<Note>
Le serveur Admin MCP permet aux outils d'IA d'accéder à votre tableau de bord Mintlify. Considérez-le comme un outil avec un accès en écriture. Connectez-le uniquement depuis des outils d'IA de confiance, examinez chaque pull request avant de la fusionner, et sachez que les changements de gestion de projet s'appliquent immédiatement, sans pull request.
Expand All @@ -32,9 +32,9 @@ L'Admin MCP est un service Mintlify hébergé à l'adresse `https://mcp.mintlify
| | Admin MCP | Search MCP |
| :-- | :-- | :-- |
| **Audience** | Votre équipe | Vos utilisateurs finaux |
| **Accès** | Lire, modifier, restructurer, publier, créer des workflows, gérer les paramètres | Lire et rechercher dans les pages publiées d'un site |
| **Accès** | Lire, modifier, restructurer, publier, créer des automatisations, gérer les paramètres | Lire et rechercher dans les pages publiées d'un site |
| **Point de terminaison** | `https://mcp.mintlify.com` | `/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 de votre site |
| **Résultat** | Modifications de contenu, changements de navigation, pull requests, exécutions d'automatisations | Résultats de recherche et contenu des pages de votre site |

<div id="prerequisites">
## Prérequis
Expand Down Expand Up @@ -251,7 +251,7 @@ Si un appel à `create_node`, `update_node`, `move_node` ou `delete_node` laisse
### Gestion de projet
</div>

Les outils de gestion de projet gèrent les opérations au niveau du projet, comme la gestion des workflows, 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](/fr/editor/pages#private-pages). Ils agissent sur le projet en direct, pas sur une branche.
Les outils de gestion de projet gèrent les opérations au niveau du projet, comme la gestion des [automatisations](/fr/automations), 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](/fr/editor/pages#private-pages). 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 :

Expand All @@ -268,23 +268,23 @@ Outils de lecture :
- **`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 avec `request.report`. Les résultats volumineux sont paginés avec `maxRows` et `rowOffset`. Pour des requêtes personnalisées, utilisez `query_analytics`.
- **`get_analytics_schema`**: Lit les tables, les événements et les règles SQL acceptés par `query_analytics`. L'outil d'IA l'appelle une fois avant d'écrire une requête.
- **`query_analytics`**: Exécute une requête `SELECT` en lecture seule sur les analyses de votre site, comme les pages vues, la recherche, l'assistant, les retours et le trafic des agents et des humains. 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 erreur `not_enabled`.
- **`get_workflows`**: Liste les workflows, récupère un workflow 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 un workflow.
- **`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.

Outils d'écriture :

- **`update_deployment_settings`**: Modifie un paramètre du dashboard, comme `noindex`, `base_path`, `name`, `disable_ai_chat`, `search_settings`, `privacy`, `custom_scripts` ou un module complémentaire. Utilisez `update_config` pour les paramètres de `docs.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](/fr/deploy/authentication-setup) du site, ajoute ou supprime des mots de passe, configure l'authentification des utilisateurs finaux ou change celle qui est active.
- **`manage_workflow`**: Crée, met à jour, active ou désactive, supprime ou déclenche un workflow.
- **`manage_workflow`**: Crée, met à jour, active ou désactive, supprime ou déclenche une automatisation.
- **`manage_workflow_prs`**: Fusionne ou ferme une pull request ouverte par une exécution d'[automatisation](/fr/automations). Pour fusionner une pull request d'une branche modifiée par l'outil d'IA, utilisez plutôt `publish` avec `merge: true`.
- **`manage_members_sharing`**: Liste 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 projets internes.

Les outils d'écriture renvoient l'état mis à jour du projet dans `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`.

<Warning>
Les écritures de gestion de projet s'appliquent immédiatement au projet en ligne. Elles ne créent pas de branche et n'ouvrent pas de pull request. Confirmez la modification prévue avant de demander à un outil d'IA de mettre à jour des workflows, des paramètres, des domaines, l'authentification ou des membres.
Les écritures de gestion de projet s'appliquent immédiatement au projet en ligne. Elles ne créent pas de branche et n'ouvrent pas de pull request. Confirmez la modification prévue avant de demander à un outil d'IA de mettre à jour des automatisations, des paramètres, des domaines, l'authentification ou des membres.
</Warning>

<div id="branches-and-publishing">
Expand Down
Loading
Loading