From 2470afbc7ec56a5e48baba0961c4fd2918e5e845 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 29 May 2026 23:06:14 +0000 Subject: [PATCH] docs: translate MCP name clarifications to fr and es --- es.json | 1 + es/ai/mintlify-mcp.mdx | 185 +++++++++++++++++++++++++++++++ es/ai/model-context-protocol.mdx | 89 +++++++-------- fr.json | 1 + fr/ai/mintlify-mcp.mdx | 185 +++++++++++++++++++++++++++++++ fr/ai/model-context-protocol.mdx | 91 +++++++-------- 6 files changed, 463 insertions(+), 89 deletions(-) create mode 100644 es/ai/mintlify-mcp.mdx create mode 100644 fr/ai/mintlify-mcp.mdx diff --git a/es.json b/es.json index 798764f843..d9e190b0bd 100644 --- a/es.json +++ b/es.json @@ -199,6 +199,7 @@ "es/ai/llmstxt", "es/ai/skillmd", "es/ai/model-context-protocol", + "es/ai/mintlify-mcp", "es/optimize/search", "es/optimize/seo", "es/ai/markdown-export", diff --git a/es/ai/mintlify-mcp.mdx b/es/ai/mintlify-mcp.mdx new file mode 100644 index 0000000000..95c3439513 --- /dev/null +++ b/es/ai/mintlify-mcp.mdx @@ -0,0 +1,185 @@ +--- +title: "Servidor Admin Model Context Protocol (MCP)" +shortTitle: "Admin MCP" +description: "Permite que las herramientas de IA editen directamente tu contenido y actualicen la configuración de tu panel con el servidor Admin MCP. Conecta Claude, Cursor o cualquier cliente MCP para redactar, guardar y publicar cambios." +keywords: ["MCP", "write access", "AI", "editing", "Claude", "Cursor", "branch", "pull request"] +--- + +
+ ## Acerca del Admin MCP +
+ +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. + +Conecta cualquier cliente MCP como Claude, Claude Code o Cursor al servidor Admin MCP para colaborar en tu contenido y configuración de Mintlify con las mismas herramientas que usas para escribir código. Cuando usas el servidor Admin MCP, todos los cambios ocurren en una rama y requieren una pull request para fusionarse. + + + El servidor Admin MCP permite que las herramientas de IA accedan a tu panel de Mintlify. Trátalo como a un compañero de trabajo con acceso de escritura. Conéctalo solo desde herramientas de IA de confianza y revisa cada pull request antes de fusionarla. + + +
+ ### Cómo se diferencia el Admin MCP del Search MCP +
+ +| | Admin MCP | Search MCP | +| :-- | :-- | :-- | +| **Audiencia** | Tu equipo | Tus usuarios finales | +| **Acceso** | Leer, editar, reestructurar, guardar, crear workflows, gestionar la configuración | Leer y buscar en las páginas publicadas | +| **Endpoints** | Alojado por Mintlify, limitado a tu proyecto | `/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 | + +
+ ## Conectarse al Admin MCP +
+ +Debes tener un inicio de sesión OAuth interactivo en tu cuenta de Mintlify para conectarte al Admin MCP. Las herramientas de IA intercambian ese inicio de sesión por un token de sesión limitado a un proyecto. + + + + + + 1. Navega a la página [Connectors](https://claude.ai/settings/connectors) en la configuración de Claude. + 2. Haz clic en **Add custom connector**. + 3. Agrega el conector + - Nombre: Admin MCP + - URL: `https://mcp.mintlify.com` + 4. Haz clic en **Add** y completa el inicio de sesión OAuth. + + + Haz clic en el botón de archivos adjuntos (el icono más) y luego selecciona tu servidor Admin MCP. Claude ahora puede llamar a las herramientas del Mintlify Admin MCP mientras responde a tu prompt. + + + + + Agrega el servidor Admin MCP con la CLI de Claude Code: + + ```bash + claude mcp add --transport http mintlify https://mcp.mintlify.com + ``` + + En el primer uso, Claude Code abre una ventana del navegador para completar el inicio de sesión OAuth. Tras autenticarte, la sesión se reutiliza para las llamadas posteriores. + + + 1. Abre la paleta de comandos con Command \+ Shift \+ P (Ctrl \+ Shift \+ P en Windows). + 2. Busca **Open MCP settings** y haz clic en **Add custom MCP**. + 3. En `mcp.json`, agrega el Admin MCP: + + ```json + { + "mcpServers": { + "mintlify": { + "url": "https://mcp.mintlify.com" + } + } + } + ``` + + 4. Recarga Cursor y completa el inicio de sesión OAuth cuando se te solicite. + + + +
+ ## Cómo funciona una sesión +
+ +Cada sesión del Admin MCP se vincula a una sola rama de Git. El flujo es: + + + + La primera llamada debe ser `checkout`. Crea una nueva rama `mintlify-mcp/-` a partir de tu rama de despliegue (o se adjunta a una rama existente que indiques) y devuelve un `editorUrl` que puedes abrir para seguir el progreso en el editor del panel. + + Llama a `list_branches` antes de `checkout` si necesitas descubrir o filtrar las ramas existentes en el repositorio. + + + La IA usa herramientas como `search`, `read`, `list_nodes`, `edit_page`, `write_page`, `create_node` y `update_config` para realizar cambios. Todas las ediciones se mantienen en la rama de la sesión en tiempo real; nada toca aún tu rama de despliegue. + + + Llama a `diff` en cualquier momento para ver exactamente qué ha cambiado desde `main`. Abre el `editorUrl` en tu panel para ver los mismos cambios renderizados. + + + Llama a `save` para enviar la rama a Git. Usa `mode: "pr"` (predeterminado) para abrir una pull request, o `mode: "commit"` para hacer push directamente a una rama de PR existente. + + + Llama a `discard_session` para descartar todos los cambios en la sesión y liberar la rama. + + + + + Llamar a `checkout` nuevamente durante una sesión activa cambia la sesión a la nueva rama. Usa esto para abandonar un borrador en curso y empezar de nuevo sin terminar la conversación. + + +
+ ## Qué puede hacer el Admin MCP +
+ +
+ ### Contenido +
+ +- **`read`** — Obtén el MDX completo de cualquier página en la rama de la sesión. +- **`search`** — Encuentra líneas que coincidan con una subcadena o expresión regular en todas las páginas. +- **`edit_page`** — Aplica una edición dirigida a una página. +- **`write_page`** — Sobrescribe el contenido MDX completo de una página. + + + +- **`list_nodes`** — Recorre el árbol de navegación con filtros opcionales. Filtra por `parentId` (usa `recursive: true` para incluir todos los descendientes), uno o más tipos de nodo, o cualquier ámbito de división: `language`, `version`, `tab`, `dropdown`, `anchor`, `product` o `item`. Los resultados se paginan a través de un `cursor` opaco. +- **`create_node`** — Agrega una nueva página, grupo, pestaña, ancla, versión, idioma, producto o desplegable. +- **`update_node`** — Actualiza las propiedades de un nodo en su lugar (renombrar un grupo, cambiar un icono, establecer una versión predeterminada). +- **`move_node`** — Mueve un nodo, incluido renombrar la ruta de una página. +- **`delete_node`** — Elimina un nodo de la navegación. + +
+ ### Configuración +
+ +- **`update_config`** — Modifica `docs.json` (tema, raíces de navegación, integraciones, configuración de SEO). + +
+ ### Sesión +
+ +- **`checkout`** — Vincula la sesión a una rama. +- **`list_branches`** — Lista las ramas de Git disponibles para el proyecto, con filtrado opcional por `query`. Devuelve los nombres de las ramas, el total y la rama de despliegue. Llama a esto antes de `checkout` para adjuntarte a una rama existente por nombre. +- **`get_session_state`** — Inspecciona la rama actual, los archivos editados y el diff de navegación pendiente. +- **`diff`** — Lista todos los cambios entre la sesión y `main`. +- **`save`** — Abre una pull request o hace commit en la rama de la sesión. +- **`discard_session`** — Descarta la sesión y sus cambios pendientes. + +
+ ## Ejemplos de prompts +
+ +Después de conectarte al Admin MCP, puedes manejarlo con prompts en lenguaje natural. Por ejemplo: + +- _"Haz checkout de una rama llamada `add-billing-faq` y crea una nueva página bajo el grupo FAQ titulada 'Billing'. Redacta respuestas para las cinco preguntas de este issue de Linear."_ +- _"Encuentra todas las páginas que mencionen el campo obsoleto `legacy_token` y actualiza el ejemplo para que use `api_key` en su lugar. Guarda como PR titulada 'docs: replace legacy\_token references'."_ +- _"Reorganiza la referencia de API: mueve las páginas de webhooks a un nuevo grupo llamado 'Webhooks' y actualiza los iconos para que coincidan con el resto de la sección."_ + +
+ ## Buenas prácticas +
+ + + + Cada `checkout` devuelve un `editorUrl`. Ábrelo en una pestaña aparte para ver cómo se renderizan los cambios de la IA en vivo en el editor del panel mientras escribes prompts. + + + + El Admin MCP es lo suficientemente potente como para reescribir cientos de páginas en una sola sesión. Antes de fusionar, lee el diff de la PR y revisa la vista previa renderizada. No apruebes cambios grandes sin revisarlos. + + + + Pasa un `slug` a `checkout` (por ejemplo, `add-quickstart`) para que la rama generada automáticamente sea legible. Sin él, el nombre de la rama deriva del token de sesión y es difícil de reconocer en tu repositorio. + + + + Mantén cada sesión enfocada en un solo cambio. Las sesiones más pequeñas producen pull requests más fáciles de revisar y preservan las ventanas de contexto de los agentes. Usa `discard_session` y vuelve a llamar a `checkout` para cambiar a un trabajo no relacionado. + + + + + Las sesiones mantienen una rama en memoria en el lado de Mintlify. Si abandonas una sesión sin guardarla ni descartarla, la rama persiste hasta que tu próximo checkout la sobrescriba. Evita dejar ramas `mintlify-mcp/*` obsoletas en tu repositorio. Límpialas periódicamente. + diff --git a/es/ai/model-context-protocol.mdx b/es/ai/model-context-protocol.mdx index e20e0a64db..e59166eb30 100644 --- a/es/ai/model-context-protocol.mdx +++ b/es/ai/model-context-protocol.mdx @@ -1,7 +1,8 @@ --- -title: "Protocolo de Contexto del Modelo (MCP)" -description: "Conecta tu documentación y endpoints de API a herramientas de IA como Claude y Cursor con un servidor de Protocolo de Contexto de Modelos (MCP) alojado." -keywords: ["MCP", "Herramientas de IA", "Claude", "Cursor"] +title: "Servidor Search Model Context Protocol (MCP)" +shortTitle: "Search MCP" +description: "Conecta tu contenido a herramientas de IA como Claude y Cursor con un servidor MCP alojado para búsqueda." +keywords: ["MCP", "AI tools", "Claude", "Cursor", "search"] --- import { PreviewButton } from "/snippets/previewbutton.jsx" @@ -10,46 +11,46 @@ import { PreviewButton } from "/snippets/previewbutton.jsx" ## Acerca de los servidores MCP -El Model Context Protocol (MCP) es un protocolo abierto que crea conexiones estandarizadas entre aplicaciones de IA y servicios externos, como la documentación. Mintlify genera un servidor MCP a partir de tu documentación, preparando tu contenido para el ecosistema de IA más amplio, donde cualquier cliente MCP (como Claude, Cursor, Goose y otros) puede conectarse a tu documentación. +El Model Context Protocol (MCP) es un protocolo abierto que crea conexiones estandarizadas entre aplicaciones de IA y servicios externos, como la documentación. Mintlify genera un servidor Search MCP para tu sitio, preparando tu contenido para el ecosistema de IA más amplio. Cualquier cliente MCP como Claude, Cursor, Goose o ChatGPT puede conectarse a tu contenido. -Tu servidor MCP expone herramientas para que las aplicaciones de IA puedan buscar en tu documentación y obtener el contenido completo de las páginas. Tus usuarios deben conectar tu servidor MCP a sus herramientas. +Tu servidor Search MCP expone herramientas para que las aplicaciones de IA busquen y recuperen tu contenido. Tus usuarios deben conectar tu servidor Search MCP a sus herramientas. - ¿Quieres permitir que los agentes editen tu contenido en lugar de solo leerlo? Consulta el [servidor MCP de Mintlify](/ai/mintlify-mcp) para acceder a un servidor MCP autenticado que expone herramientas de branching, edición de páginas, navegación y `docs.json` a agentes de confianza. + ¿Quieres permitir que los agentes editen tu contenido en lugar de solo leerlo? Usa el [servidor Admin MCP](/es/ai/mintlify-mcp) para acceder a un servidor MCP autenticado que expone herramientas de branching, edición de páginas, navegación y `docs.json` a agentes de confianza.
### Cómo funcionan los servidores MCP
-Cuando una aplicación de IA se conecta a tu servidor MCP de documentación, puede buscar en tu documentación y obtener el contenido completo de las páginas directamente en respuesta a la instrucción de un usuario, en lugar de basarse en información de sus datos de entrenamiento o realizar una búsqueda genérica en la web. Tu servidor MCP proporciona acceso a todo el contenido indexado de tu sitio de documentación. +Cuando una aplicación de IA se conecta a tu servidor Search MCP, puede buscar en tu contenido y recuperar páginas completas en respuesta al prompt de un usuario. Esto evita basarse en información de los datos de entrenamiento o en búsquedas web genéricas. Tu servidor Search MCP proporciona acceso a todo el contenido indexado de tu sitio Mintlify. -* Las aplicaciones de IA pueden buscar proactivamente en tu documentación mientras generan una respuesta, incluso si no se les pide explícitamente que busquen en tu documentación para encontrar una respuesta. -* Las aplicaciones de IA determinan cuándo usar las herramientas disponibles según el contexto de la conversación y la relevancia de tu documentación. -* Cada llamada a la herramienta ocurre durante el proceso de generación, por lo que la aplicación de IA utiliza información actualizada de tu documentación para generar su respuesta. +* Las aplicaciones de IA pueden buscar proactivamente en tu contenido mientras generan una respuesta, incluso si no se les pide explícitamente que busquen una respuesta. +* Las aplicaciones de IA determinan cuándo usar las herramientas disponibles según el contexto de la conversación y la relevancia de tu contenido. +* Cada llamada a la herramienta ocurre durante el proceso de generación, por lo que la aplicación de IA utiliza información actualizada de tu sitio para generar su respuesta. - Algunas herramientas de IA como Claude son compatibles tanto con MCP como con skills. MCP proporciona acceso al contenido de tu documentación, mientras que los skills indican a los agentes cómo usar ese contenido de forma eficaz. Son complementarios y al conectar tu servidor MCP los agentes obtienen acceso a ambos. + Algunas herramientas de IA como Claude son compatibles tanto con MCP como con skills. MCP proporciona acceso a tu contenido, mientras que los skills indican a los agentes cómo usar ese contenido de forma eficaz. Son complementarios y al conectar tu servidor MCP los agentes obtienen acceso a ambos.
### Herramientas MCP
-Tu servidor MCP proporciona dos herramientas que los agentes pueden usar: +Tu servidor Search MCP proporciona dos herramientas que los agentes pueden usar: -- **Search**: Busca en toda tu documentación para encontrar contenido relevante, devolviendo fragmentos con títulos y enlaces. Úsala para descubrir información o encontrar páginas que coincidan con una consulta. -- **Query docs filesystem**: Lee y navega el sistema de archivos virtual de tu documentación usando comandos de estilo shell. Úsala para obtener el contenido de páginas, explorar la estructura de la documentación o extraer secciones específicas, incluyendo lecturas de múltiples páginas en una sola llamada. +- **Search**: Busca en tu sitio para encontrar contenido relevante, devolviendo fragmentos con títulos y enlaces. Úsala para descubrir información o encontrar páginas que coincidan con una consulta. +- **Query docs filesystem**: Lee y navega el sistema de archivos virtual de tu sitio usando comandos de estilo shell. Úsala para explorar y recuperar contenido, o extraer secciones específicas, incluyendo lecturas de múltiples páginas en una sola llamada. -Los agentes determinan cuándo usar cada herramienta según el contexto de la conversación. Por ejemplo, un agente podría primero buscar en tu documentación para encontrar páginas relevantes y luego usar la herramienta query docs filesystem para leer el contenido completo de los resultados más relevantes. +Los agentes determinan cuándo usar cada herramienta según el contexto de la conversación. Por ejemplo, un agente podría primero buscar en tu sitio para encontrar páginas relevantes y luego usar la herramienta query docs filesystem para leer el contenido completo de los resultados más relevantes.
### Recursos MCP
-Tu servidor MCP también expone tus [archivos skill.md](/es/ai/skillmd) como recursos MCP. Los agentes conectados a tu servidor MCP pueden descubrir y acceder a tus archivos de skill sin necesidad de instalarlos por separado. +Tu servidor Search MCP también expone tus [archivos skill.md](/es/ai/skillmd) como recursos MCP. Los agentes conectados a tu servidor Search MCP pueden descubrir y acceder a tus archivos de skill sin necesidad de instalarlos por separado. -Los recursos `Skill.md` aparecen en la lista de recursos del servidor MCP y contienen las descripciones de capacidades que Mintlify genera o que tú defines en tus [archivos de skill personalizados](/es/ai/skillmd#custom-skill-files). +Los recursos `Skill.md` aparecen en la lista de recursos del servidor Search MCP y contienen las descripciones de capacidades que Mintlify genera o que tú defines en tus [archivos de skill personalizados](/es/ai/skillmd#custom-skill-files).
### Parámetros de búsqueda @@ -57,32 +58,32 @@ Los recursos `Skill.md` aparecen en la lista de recursos del servidor MCP y cont La herramienta de búsqueda MCP admite parámetros opcionales que las aplicaciones de IA usan para controlar y refinar los resultados de búsqueda. -* **`version`**: Filtra los resultados a una versión específica de la documentación. Por ejemplo, `'v0.7'`. Solo está disponible cuando tu documentación tiene varias versiones. Solo devuelve contenido etiquetado con la versión especificada o contenido disponible en todas las versiones. -* **`language`**: Filtra los resultados a un código de idioma específico. Por ejemplo, `'en'`, `'zh'` o `'es'`. Solo está disponible cuando tu documentación tiene varios idiomas. Solo devuelve contenido en el idioma especificado o contenido disponible en todos los idiomas. +* **`version`**: Filtra los resultados a una versión específica del sitio. Por ejemplo, `'v0.7'`. Solo está disponible cuando tu sitio tiene varias versiones. Solo devuelve contenido etiquetado con la versión especificada o contenido disponible en todas las versiones. +* **`language`**: Filtra los resultados a un código de idioma específico. Por ejemplo, `'en'`, `'zh'` o `'es'`. Solo está disponible cuando tu sitio tiene varios idiomas. Solo devuelve contenido en el idioma especificado o contenido disponible en todos los idiomas. Las aplicaciones de IA determinan cuándo aplicar estos parámetros en función del contexto de la búsqueda del usuario. Por ejemplo, si un usuario pregunta por una versión específica de la API, la aplicación de IA puede aplicar automáticamente el filtro adecuado para ofrecer resultados más relevantes. -Las herramientas de IA pueden buscar en la web, pero MCP ofrece ventajas claras para la documentación. +Las herramientas de IA pueden buscar en la web, pero el Search MCP ofrece ventajas claras. -* **Acceso directo a la fuente**: La búsqueda en la web depende de lo que los motores de búsqueda hayan indexado, lo cual puede estar desactualizado o incompleto. MCP busca directamente en tu documentación indexada actual. +* **Acceso directo a la fuente**: La búsqueda en la web depende de lo que los motores de búsqueda hayan indexado, lo cual puede estar desactualizado o incompleto. El Search MCP busca directamente en tu contenido indexado actual. * **Flujo de trabajo integrado**: MCP permite que la IA busque mientras genera la respuesta, en lugar de realizar una búsqueda web por separado. -* **Sin ruido de búsqueda**: Los algoritmos de SEO (optimización para motores de búsqueda) y de clasificación influyen en los resultados de búsqueda en la web. MCP va directamente al contenido de tu documentación. +* **Sin ruido de búsqueda**: Los algoritmos de SEO (optimización para motores de búsqueda) y de clasificación influyen en los resultados de búsqueda en la web. MCP va directamente a tu contenido.
- ## Accede a tu servidor MCP + ## Accede a tu servidor Search MCP
-Mintlify genera un servidor MCP para tu documentación y lo aloja en la ruta `/mcp` de la URL de tu documentación. Por ejemplo, el servidor MCP de Mintlify está disponible en `https://mintlify.com/docs/mcp`. +Mintlify genera un servidor Search MCP para tu sitio y lo aloja en la ruta `/mcp` de la URL de tu sitio. Por ejemplo, el servidor Search MCP de Mintlify está disponible en `https://mintlify.com/docs/mcp`. -* Para la documentación pública, tu servidor MCP está disponible para cualquiera. Busca en todas las páginas públicas indexadas. -* Para la documentación con autenticación parcial, donde algunas páginas son públicas y otras requieren iniciar sesión, debes habilitar tu servidor MCP antes de que los usuarios puedan acceder a él. Los usuarios no autenticados pueden buscar en el contenido público. Los usuarios que se autentican pueden buscar en todo el contenido al que tienen permiso de acceso según sus [grupos de usuarios](/es/deploy/authentication-setup). -* Para la documentación en la que todas las páginas requieren autenticación, debes habilitar tu servidor MCP antes de que esté disponible para los usuarios. Los usuarios deben autenticarse antes de conectarse a tu servidor MCP. Tu servidor MCP busca solo en el contenido al que cada usuario tiene acceso según sus [grupos de usuarios](/es/deploy/authentication-setup). +* Para contenido público, tu servidor Search MCP está disponible para cualquiera. Busca en todas las páginas públicas indexadas. +* Para contenido con autenticación parcial, donde algunas páginas son públicas y otras requieren iniciar sesión, debes habilitar tu servidor Search MCP antes de que los usuarios puedan acceder a él. Los usuarios no autenticados pueden buscar en el contenido público. Los usuarios que se autentican pueden buscar en todo el contenido al que tienen permiso de acceso según sus [grupos de usuarios](/es/deploy/authentication-setup). +* Para contenido en el que todas las páginas requieren autenticación, debes habilitar tu servidor Search MCP antes de que esté disponible para los usuarios. Los usuarios deben autenticarse antes de conectarse a tu servidor Search MCP. Tu servidor Search MCP busca solo en el contenido al que cada usuario tiene acceso según sus [grupos de usuarios](/es/deploy/authentication-setup). -Puedes ver y copiar la URL de tu servidor MCP en la [página del servidor MCP](https://dashboard.mintlify.com/products/mcp) de tu dashboard. +Puedes ver y copiar la URL de tu servidor Search MCP en la [página del servidor MCP](https://dashboard.mintlify.com/products/mcp) de tu dashboard. Página del servidor MCP en el dashboard. @@ -91,16 +92,16 @@ Puedes ver y copiar la URL de tu servidor MCP en la [página del servidor MCP](h - Los servidores MCP alojados utilizan las rutas `/mcp` y `/authed/mcp`. Otros elementos de navegación no pueden utilizar estas rutas. + Los servidores Search MCP utilizan las rutas `/mcp` y `/authed/mcp`. Otros elementos de navegación no pueden utilizar estas rutas.
### Endpoint de descubrimiento
-Mintlify aloja un documento de descubrimiento en `/.well-known/mcp` para que los agentes y herramientas localicen tu servidor MCP sin configuración previa. +Mintlify aloja un documento de descubrimiento en `/.well-known/mcp` para que los agentes y herramientas localicen tu servidor Search MCP sin configuración previa. -`GET /.well-known/mcp` devuelve un documento JSON que describe tu servidor MCP: +`GET /.well-known/mcp` devuelve un documento JSON que describe tu servidor Search MCP: ```json { @@ -139,9 +140,9 @@ Para la compatibilidad con agentes, el mismo documento de descubrimiento tambié ### Habilitar MCP autenticado
-Si tu documentación requiere autenticación, tu servidor MCP exige que los usuarios se autentiquen antes de conectarse. Cuando un usuario añade la URL de tu servidor MCP a su herramienta de IA, debe iniciar sesión con sus credenciales existentes. Después de autenticarse, se le redirige de vuelta a su herramienta. El servidor MCP solo devuelve el contenido al que cada usuario tiene permiso de acceso según sus [grupos de usuarios](/es/deploy/authentication-setup). +Si tu sitio requiere autenticación, tu servidor Search MCP exige que los usuarios se autentiquen antes de conectarse. Cuando un usuario añade la URL de tu servidor MCP a su herramienta de IA, debe iniciar sesión con sus credenciales existentes. Después de autenticarse, se le redirige de vuelta a su herramienta. El servidor MCP solo devuelve el contenido al que cada usuario tiene permiso de acceso según sus [grupos de usuarios](/es/deploy/authentication-setup). -Si tu documentación tiene autenticación parcial con páginas públicas y protegidas, dispones de dos endpoints del servidor MCP: +Si tu sitio tiene autenticación parcial con páginas públicas y protegidas, dispones de dos endpoints del servidor Search MCP: - `/mcp`: No requiere autenticación. Devuelve solo contenido público. Comparte este endpoint con usuarios que necesiten acceso al contenido público. - `/authed/mcp`: Siempre requiere autenticación. Devuelve contenido según los permisos de cada usuario basados en sus [grupos de usuarios](/es/deploy/authentication-setup). Comparte este endpoint con usuarios que necesiten acceso al contenido protegido. @@ -181,7 +182,7 @@ Las credenciales de cliente se autentican contra el endpoint `/authed/mcp` y dev 4. Copia el **client ID** y el **client secret**. El client secret solo se muestra una vez. No podrás recuperarlo después. - Envía una solicitud POST al endpoint de token de tu servidor MCP con tu client ID y secret. Tu endpoint de token se encuentra en la ruta `/authed/mcp/oauth/token` de la URL de tu documentación. + Envía una solicitud POST al endpoint de token de tu servidor MCP con tu client ID y secret. Tu endpoint de token se encuentra en la ruta `/authed/mcp/oauth/token` de la URL de tu sitio. ```bash cURL @@ -263,20 +264,20 @@ Para proteger la disponibilidad, Mintlify aplica límites de uso a los servidore | Alcance | Límite | Descripción | | :---------------------------------- | :------------------------- | :-------------------------------------------------------------------------------- | | Por usuario (dirección IP) | 5.000 solicitudes por hora | Limita la frecuencia con la que un solo usuario puede consultar la configuración de tu servidor MCP. | -| Search por sitio de documentación (domain) | 10.000 solicitudes por hora | Limita el total de llamadas a la herramienta de búsqueda entre todos los usuarios de tu servidor MCP. | -| Query docs filesystem por sitio de documentación (domain) | 10.000 solicitudes por hora | Limita el total de llamadas a la herramienta query docs filesystem entre todos los usuarios de tu servidor MCP. | -| Search autenticado por sitio de documentación (domain) | 5.000 solicitudes por hora | Limita el total de llamadas autenticadas a la herramienta de búsqueda entre todos los usuarios de tu servidor MCP. | -| Query docs filesystem autenticado por sitio de documentación (domain) | 5.000 solicitudes por hora | Limita el total de llamadas autenticadas a la herramienta query docs filesystem entre todos los usuarios de tu servidor MCP. | +| Search por sitio (domain) | 10.000 solicitudes por hora | Limita el total de llamadas a la herramienta de búsqueda entre todos los usuarios de tu servidor MCP. | +| Query docs filesystem por sitio (domain) | 10.000 solicitudes por hora | Limita el total de llamadas a la herramienta query docs filesystem entre todos los usuarios de tu servidor MCP. | +| Search autenticado por sitio (domain) | 5.000 solicitudes por hora | Limita el total de llamadas autenticadas a la herramienta de búsqueda entre todos los usuarios de tu servidor MCP. | +| Query docs filesystem autenticado por sitio (domain) | 5.000 solicitudes por hora | Limita el total de llamadas autenticadas a la herramienta query docs filesystem entre todos los usuarios de tu servidor MCP. |
## Filtrado de contenido e indexación
-Tu servidor MCP busca contenido que Mintlify indexa a partir de tu repositorio de documentación. La forma en que se procesan los archivos y se realiza la indexación de búsqueda determina qué contenido está disponible a través de tu servidor MCP. +Tu servidor MCP busca contenido que Mintlify indexa a partir del repositorio de tu proyecto. La forma en que se procesan los archivos y se realiza la indexación de búsqueda determina qué contenido está disponible a través de tu servidor MCP. -En la documentación que requiere autenticación, tu servidor MCP indexa las [páginas públicas](/es/deploy/authentication-setup#make-pages-public) y cualquier página a la que un usuario autenticado tenga permiso de acceso según sus [grupos de usuarios](/es/deploy/authentication-setup#restrict-pages-to-specific-user-groups). +Para los sitios que requieren autenticación, tu servidor MCP indexa las [páginas públicas](/es/deploy/authentication-setup#make-pages-public) y cualquier página a la que un usuario autenticado tenga permiso de acceso según sus [grupos de usuarios](/es/deploy/authentication-setup#restrict-pages-to-specific-user-groups). -En la documentación con autenticación parcial, los usuarios no autenticados pueden buscar en las páginas públicas. Los usuarios autenticados pueden buscar en las páginas públicas y en cualquier página a la que tengan permiso de acceso según sus grupos de usuarios. +Para los sitios con autenticación parcial, los usuarios no autenticados pueden buscar en las páginas públicas. Los usuarios autenticados pueden buscar en las páginas públicas y en cualquier página a la que tengan permiso de acceso según sus grupos de usuarios.
### Procesamiento de archivos con `.mintignore` @@ -316,13 +317,13 @@ Tus usuarios deben conectar tu servidor MCP a sus herramientas de IA preferidas. 1. Haz que la URL de tu servidor MCP sea pública. 2. Los usuarios copian la URL de tu servidor MCP y la añaden a sus herramientas. -3. Los usuarios acceden a tu documentación desde sus herramientas. +3. Los usuarios acceden a tu contenido desde sus herramientas. Estas son algunas formas en que puedes ayudar a tus usuarios a conectarse a tu servidor MCP: - Agrega opciones en el [menú contextual](/es/ai/contextual-menu) para que tus usuarios se conecten a tu servidor MCP desde cualquier página de tu documentación. + Agrega opciones en el [menú contextual](/es/ai/contextual-menu) para que tus usuarios se conecten a tu servidor MCP desde cualquier página de tu sitio. | Opción | Identificador | Descripción | | :----- | :------------ | :---------- | diff --git a/fr.json b/fr.json index f79bd9f4d0..6917eaa684 100644 --- a/fr.json +++ b/fr.json @@ -199,6 +199,7 @@ "fr/ai/llmstxt", "fr/ai/skillmd", "fr/ai/model-context-protocol", + "fr/ai/mintlify-mcp", "fr/optimize/search", "fr/optimize/seo", "fr/ai/markdown-export", diff --git a/fr/ai/mintlify-mcp.mdx b/fr/ai/mintlify-mcp.mdx new file mode 100644 index 0000000000..e68bc8b7f8 --- /dev/null +++ b/fr/ai/mintlify-mcp.mdx @@ -0,0 +1,185 @@ +--- +title: "Serveur Admin Model Context Protocol (MCP)" +shortTitle: "Admin MCP" +description: "Permettez aux outils d'IA de modifier directement votre contenu et de mettre à jour les paramètres de votre tableau de bord avec le serveur Admin MCP. Connectez Claude, Cursor ou tout autre client MCP pour rédiger, enregistrer et publier des changements." +keywords: ["MCP", "write access", "AI", "editing", "Claude", "Cursor", "branch", "pull request"] +--- + +
+ ## À propos du serveur Admin 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 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. + + + Le serveur Admin MCP permet aux outils d'IA d'accéder à votre tableau de bord Mintlify. Considérez-le comme un collègue avec un accès en écriture. Connectez-le uniquement depuis des outils d'IA de confiance et examinez chaque pull request avant de la fusionner. + + +
+ ### En quoi l'Admin MCP diffère du Search MCP +
+ +| | Admin MCP | Search MCP | +| :-- | :-- | :-- | +| **Audience** | Votre équipe | Vos utilisateurs finaux | +| **Accès** | Lire, modifier, restructurer, enregistrer, créer des workflows, gérer les paramètres | Lire et rechercher dans les pages publiées | +| **Endpoints** | Hébergé par Mintlify, à la portée de votre projet | `/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 | + +
+ ## Se connecter à l'Admin MCP +
+ +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 seul projet. + + + + + + 1. Accédez à la page [Connectors](https://claude.ai/settings/connectors) dans les paramètres de Claude. + 2. Cliquez sur **Add custom connector**. + 3. Ajoutez le connecteur + - Nom : Admin MCP + - URL : `https://mcp.mintlify.com` + 4. Cliquez sur **Add** et terminez la connexion OAuth. + + + Cliquez sur le bouton des pièces jointes (l'icône plus), puis sélectionnez votre serveur Admin MCP. Claude peut maintenant appeler les outils Mintlify Admin MCP tout en répondant à votre prompt. + + + + + Ajoutez le serveur Admin MCP avec la CLI Claude Code : + + ```bash + claude mcp add --transport http mintlify https://mcp.mintlify.com + ``` + + Lors de la première utilisation, Claude Code ouvre une fenêtre de navigateur pour terminer la connexion OAuth. Après authentification, la session est réutilisée pour les appels suivants. + + + 1. Ouvrez la palette de commandes avec Command \+ Shift \+ P (Ctrl \+ Shift \+ P sous Windows). + 2. Recherchez **Open MCP settings** et cliquez sur **Add custom MCP**. + 3. Dans `mcp.json`, ajoutez l'Admin MCP : + + ```json + { + "mcpServers": { + "mintlify": { + "url": "https://mcp.mintlify.com" + } + } + } + ``` + + 4. Rechargez Cursor et terminez la connexion OAuth lorsque vous y êtes invité. + + + +
+ ## Comment fonctionne une session +
+ +Chaque session Admin MCP est liée à une seule branche Git. Le flux est le suivant : + + + + Le premier appel doit être `checkout`. Il crée une nouvelle branche `mintlify-mcp/-` à partir de votre branche de déploiement (ou se rattache à une branche existante que vous nommez) et renvoie une `editorUrl` que vous pouvez ouvrir pour suivre l'évolution dans l'éditeur du tableau de bord. + + Appelez `list_branches` avant `checkout` si vous avez besoin de découvrir ou de filtrer les branches existantes du dépôt. + + + L'IA utilise des outils tels que `search`, `read`, `list_nodes`, `edit_page`, `write_page`, `create_node` et `update_config` pour effectuer des modifications. Toutes les modifications sont mises en mémoire tampon sur la branche de session en temps réel — rien ne touche encore votre branche de déploiement. + + + Appelez `diff` à tout moment pour voir exactement ce qui a changé depuis `main`. Ouvrez l'`editorUrl` dans votre tableau de bord pour voir les mêmes changements rendus. + + + Appelez `save` pour pousser la branche vers Git. Utilisez `mode: "pr"` (par défaut) pour ouvrir une pull request, ou `mode: "commit"` pour pousser directement sur une branche de PR existante. + + + Appelez `discard_session` pour abandonner toutes les modifications en session et libérer la branche. + + + + + Appeler `checkout` à nouveau pendant une session active fait basculer la session sur la nouvelle branche. Utilisez cela pour abandonner un brouillon en cours et repartir à zéro sans mettre fin à la conversation. + + +
+ ## Ce que l'Admin MCP peut faire +
+ +
+ ### Contenu +
+ +- **`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 sont paginés 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. + +
+ ### Configuration +
+ +- **`update_config`** — Modifie `docs.json` (thème, racines de navigation, intégrations, paramètres SEO). + +
+ ### Session +
+ +- **`checkout`** — Lie la session à une branche. +- **`list_branches`** — Liste les branches Git disponibles pour le projet, 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. +- **`discard_session`** — Abandonne la session et ses modifications en cours. + +
+ ## Exemples de prompts +
+ +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."_ + +
+ ## Bonnes pratiques +
+ + + + Chaque `checkout` renvoie une `editorUrl`. Ouvrez-la dans un onglet séparé pour pouvoir voir les modifications de l'IA s'afficher en direct dans l'éditeur du tableau de bord pendant que vous rédigez vos prompts. + + + + L'Admin MCP est suffisamment puissant pour réécrire des centaines de pages en une seule session. Avant de fusionner, lisez le diff de la PR et parcourez l'aperçu rendu. Ne validez pas des changements importants sans les examiner. + + + + Passez un `slug` à `checkout` (par exemple, `add-quickstart`) pour que la branche générée automatiquement soit lisible. Sans cela, le nom de la branche dérive du jeton de session et est difficile à reconnaître dans votre dépôt. + + + + Limitez chaque session à un seul changement. Des sessions plus petites produisent des pull requests plus faciles à examiner et préservent les fenêtres de contexte des agents. Utilisez `discard_session` puis `checkout` à nouveau pour passer à un travail sans lien. + + + + + Les sessions conservent une branche en mémoire côté Mintlify. Si vous abandonnez une session sans l'enregistrer ou la supprimer, la branche persiste jusqu'à ce que votre prochain checkout l'écrase. Évitez de laisser des branches `mintlify-mcp/*` obsolètes dans votre dépôt. Nettoyez-les périodiquement. + diff --git a/fr/ai/model-context-protocol.mdx b/fr/ai/model-context-protocol.mdx index e8c2051905..84e9c750af 100644 --- a/fr/ai/model-context-protocol.mdx +++ b/fr/ai/model-context-protocol.mdx @@ -1,7 +1,8 @@ --- -title: "Model Context Protocol (MCP)" -description: "Connectez votre documentation et vos endpoints d'API aux outils d'IA comme Claude et Cursor avec un serveur Model Context Protocol (MCP) hébergé." -keywords: ["MCP", "AI tools", "Claude", "Cursor"] +title: "Serveur Search Model Context Protocol (MCP)" +shortTitle: "Search MCP" +description: "Connectez votre contenu aux outils d'IA comme Claude et Cursor avec un serveur MCP hébergé pour la recherche." +keywords: ["MCP", "AI tools", "Claude", "Cursor", "search"] --- import { PreviewButton } from "/snippets/previewbutton.jsx" @@ -10,46 +11,46 @@ import { PreviewButton } from "/snippets/previewbutton.jsx" ## À propos des serveurs MCP
-Le Model Context Protocol (MCP) est un protocole ouvert qui crée des connexions standardisées entre les applications d'IA et des services externes, comme la documentation. Mintlify génère un serveur MCP à partir de votre documentation, en préparant votre contenu pour un écosystème d'IA plus vaste dans lequel n'importe quel client MCP comme Claude, Cursor, Goose, ChatGPT et d'autres peut se connecter à votre documentation. +Le Model Context Protocol (MCP) est un protocole ouvert qui crée des connexions standardisées entre les applications d'IA et des services externes, comme la documentation. Mintlify génère un serveur Search MCP pour votre site, en préparant votre contenu pour un écosystème d'IA plus vaste. N'importe quel client MCP comme Claude, Cursor, Goose ou ChatGPT peut se connecter à votre contenu. -Votre serveur MCP expose des outils permettant aux applications d'IA de rechercher dans votre documentation et de récupérer le contenu complet des pages. Vos utilisateurs doivent connecter votre serveur MCP à leurs outils. +Votre serveur Search MCP expose des outils permettant aux applications d'IA de rechercher et de récupérer votre contenu. Vos utilisateurs doivent connecter votre serveur Search MCP à leurs outils. - Vous souhaitez plutôt permettre aux agents de modifier votre contenu au lieu de simplement le lire ? Consultez le [serveur MCP Mintlify](/ai/mintlify-mcp) pour découvrir un serveur MCP authentifié qui expose des outils de branching, d'édition de pages, de navigation et de `docs.json` aux agents de confiance. + Vous souhaitez plutôt permettre aux agents de modifier votre contenu au lieu de simplement le lire ? Utilisez le [serveur Admin MCP](/fr/ai/mintlify-mcp) pour un serveur MCP authentifié qui expose des outils de branching, d'édition de pages, de navigation et de `docs.json` aux agents de confiance.
### Fonctionnement des serveurs MCP
-Lorsqu'une application d'IA se connecte à votre serveur MCP de documentation, elle peut rechercher dans votre documentation et récupérer le contenu complet des pages directement en réponse à la requête d'un utilisateur, au lieu de s'appuyer sur des informations issues de ses données d'entraînement ou d'effectuer une recherche générique sur le web. Votre serveur MCP donne accès à tout le contenu indexé de votre site de documentation. +Lorsqu'une application d'IA se connecte à votre serveur Search MCP, elle peut rechercher dans votre contenu et récupérer des pages complètes en réponse à la requête d'un utilisateur. Cela évite de s'appuyer sur des informations issues des données d'entraînement ou de recherches web génériques. Votre serveur Search MCP donne accès à tout le contenu indexé de votre site Mintlify. -* Les applications d'IA peuvent rechercher de manière proactive dans votre documentation pendant qu'elles génèrent une réponse, même s'il ne leur a pas été explicitement demandé d'y rechercher une réponse. -* Les applications d'IA déterminent quand utiliser les outils disponibles en fonction du contexte de la conversation et de la pertinence de votre documentation. -* Chaque appel d'outil a lieu pendant le processus de génération, de sorte que l'application d'IA utilise des informations à jour de votre documentation pour générer sa réponse. +* Les applications d'IA peuvent rechercher de manière proactive dans votre contenu pendant qu'elles génèrent une réponse, même s'il ne leur a pas été explicitement demandé d'y rechercher une réponse. +* Les applications d'IA déterminent quand utiliser les outils disponibles en fonction du contexte de la conversation et de la pertinence de votre contenu. +* Chaque appel d'outil a lieu pendant le processus de génération, de sorte que l'application d'IA utilise des informations à jour de votre site pour générer sa réponse. - Certains outils d'IA comme Claude prennent en charge à la fois MCP et les skills. MCP donne accès au contenu de votre documentation, tandis que les skills indiquent aux agents comment utiliser ce contenu efficacement. Ils sont complémentaires et la connexion de votre serveur MCP donne aux agents accès aux deux. + Certains outils d'IA comme Claude prennent en charge à la fois MCP et les skills. MCP donne accès à votre contenu, tandis que les skills indiquent aux agents comment utiliser ce contenu efficacement. Ils sont complémentaires et la connexion de votre serveur MCP donne aux agents accès aux deux.
### Outils MCP
-Votre serveur MCP fournit deux outils que les agents peuvent utiliser : +Votre serveur Search MCP fournit deux outils que les agents peuvent utiliser : -- **Search** : Recherche dans votre documentation pour trouver du contenu pertinent, en renvoyant des extraits avec des titres et des liens. Utilisez cet outil pour découvrir des informations ou trouver des pages correspondant à une requête. -- **Query docs filesystem** : Lit et parcourt le système de fichiers virtuel de votre documentation à l'aide de commandes de type shell. Utilisez cet outil pour récupérer le contenu des pages, parcourir la structure de la documentation ou extraire des sections spécifiques, y compris des lectures par lots sur plusieurs pages en un seul appel. +- **Search** : Recherche sur votre site pour trouver du contenu pertinent, en renvoyant des extraits avec des titres et des liens. Utilisez cet outil pour découvrir des informations ou trouver des pages correspondant à une requête. +- **Query docs filesystem** : Lit et parcourt le système de fichiers virtuel de votre site à l'aide de commandes de type shell. Utilisez cet outil pour parcourir et récupérer du contenu, ou extraire des sections spécifiques — y compris des lectures par lots sur plusieurs pages en un seul appel. -Les agents déterminent quand utiliser chaque outil en fonction du contexte de la conversation. Par exemple, un agent peut d'abord rechercher dans votre documentation pour trouver des pages pertinentes, puis utiliser l'outil query docs filesystem pour lire le contenu complet des résultats les plus pertinents. +Les agents déterminent quand utiliser chaque outil en fonction du contexte de la conversation. Par exemple, un agent peut d'abord rechercher sur votre site pour trouver des pages pertinentes, puis utiliser l'outil query docs filesystem pour lire le contenu complet des résultats les plus pertinents.
### Ressources MCP
-Votre serveur MCP expose également vos [fichiers skill.md](/fr/ai/skillmd) en tant que ressources MCP. Les agents connectés à votre serveur MCP peuvent découvrir et accéder à vos fichiers de skill sans les installer séparément. +Votre serveur Search MCP expose également vos [fichiers skill.md](/fr/ai/skillmd) en tant que ressources MCP. Les agents connectés à votre serveur Search MCP peuvent découvrir et accéder à vos fichiers de skill sans les installer séparément. -Les ressources `Skill.md` apparaissent dans la liste des ressources du serveur MCP et contiennent les descriptions de capacités que Mintlify génère ou que vous définissez dans vos [fichiers de skill personnalisés](/fr/ai/skillmd#custom-skill-files). +Les ressources `Skill.md` apparaissent dans la liste des ressources du serveur Search MCP et contiennent les descriptions de capacités que Mintlify génère ou que vous définissez dans vos [fichiers de skill personnalisés](/fr/ai/skillmd#custom-skill-files).
### Paramètres de recherche @@ -57,32 +58,32 @@ Les ressources `Skill.md` apparaissent dans la liste des ressources du serveur M L’outil de recherche MCP prend en charge des paramètres facultatifs que les applications d’IA utilisent pour contrôler et affiner les résultats de recherche. -* **`version`** : Filtre les résultats pour une version spécifique de la documentation. Par exemple, `'v0.7'`. Disponible uniquement lorsque votre documentation comporte plusieurs versions. Ne renvoie que le contenu balisé avec la version spécifiée ou le contenu disponible dans toutes les versions. -* **`language`** : Filtre les résultats pour un code de langue spécifique. Par exemple, `'en'`, `'zh'` ou `'es'`. Disponible uniquement lorsque votre documentation comporte plusieurs langues. Ne renvoie que le contenu dans la langue spécifiée ou le contenu disponible dans toutes les langues. +* **`version`** : Filtre les résultats pour une version spécifique du site. Par exemple, `'v0.7'`. Disponible uniquement lorsque votre site comporte plusieurs versions. Ne renvoie que le contenu balisé avec la version spécifiée ou le contenu disponible dans toutes les versions. +* **`language`** : Filtre les résultats pour un code de langue spécifique. Par exemple, `'en'`, `'zh'` ou `'es'`. Disponible uniquement lorsque votre site comporte plusieurs langues. Ne renvoie que le contenu dans la langue spécifiée ou le contenu disponible dans toutes les langues. Les applications d’IA déterminent quand appliquer ces paramètres en fonction du contexte de la requête de l’utilisateur. Par exemple, si un utilisateur pose une question sur une version spécifique d’une API, l’application d’IA peut appliquer automatiquement le filtre approprié pour fournir des résultats plus pertinents. -Les outils d'IA peuvent rechercher sur le web, mais MCP offre des avantages spécifiques pour la documentation. +Les outils d'IA peuvent rechercher sur le web, mais le Search MCP offre des avantages spécifiques. -* **Accès direct à la source** : La recherche sur le web dépend de ce que les moteurs de recherche ont indexé, ce qui peut être obsolète ou incomplet. MCP interroge directement votre documentation indexée la plus à jour. -* **Flux de travail intégré** : MCP permet à l'IA de rechercher pendant la génération de la réponse plutôt que d'effectuer une recherche web séparée. -* **Aucun bruit de recherche** : Les algorithmes de référencement (SEO) et de classement influencent les résultats de la recherche sur le web. MCP accède directement au contenu de votre documentation. +* **Accès direct à la source** : La recherche sur le web dépend de ce que les moteurs de recherche ont indexé, ce qui peut être obsolète ou incomplet. Le Search MCP interroge directement votre contenu indexé le plus à jour. +* **Flux de travail intégré** : MCP permet à l'IA de rechercher pendant la génération de la réponse plutôt que d'effectuer une recherche web séparée. +* **Aucun bruit de recherche** : Les algorithmes de référencement (SEO) et de classement influencent les résultats de la recherche sur le web. MCP accède directement à votre contenu.
- ## Accéder à votre serveur MCP + ## Accéder à votre serveur Search MCP
-Mintlify génère un serveur MCP pour votre documentation et l’héberge au chemin `/mcp` de l’URL de votre documentation. Par exemple, le serveur MCP de Mintlify est disponible à l’adresse `https://mintlify.com/docs/mcp`. +Mintlify génère un serveur Search MCP pour votre site et l'héberge au chemin `/mcp` de l'URL de votre site. Par exemple, le serveur Search MCP de Mintlify est disponible à l'adresse `https://mintlify.com/docs/mcp`. -* Pour la documentation publique, votre serveur MCP est accessible à tous. Il recherche dans toutes les pages publiques indexées. -* Pour la documentation avec authentification partielle, où certaines pages sont publiques et d’autres nécessitent une connexion, vous devez activer votre serveur MCP avant que les utilisateurs puissent y accéder. Les utilisateurs non authentifiés peuvent rechercher dans le contenu public. Les utilisateurs qui s’authentifient peuvent rechercher dans tout le contenu auquel ils ont l’autorisation d’accéder en fonction de leurs [groupes d’utilisateurs](/fr/deploy/authentication-setup). -* Pour la documentation où toutes les pages requièrent une authentification, vous devez activer votre serveur MCP avant qu’il soit accessible aux utilisateurs. Les utilisateurs doivent s’authentifier avant de se connecter à votre serveur MCP. Votre serveur MCP recherche uniquement dans le contenu auquel chaque utilisateur a accès en fonction de ses [groupes d’utilisateurs](/fr/deploy/authentication-setup). +* Pour un contenu public, votre serveur Search MCP est accessible à tous. Il recherche dans toutes les pages publiques indexées. +* Pour un contenu avec authentification partielle, où certaines pages sont publiques et d'autres nécessitent une connexion, vous devez activer votre serveur Search MCP avant que les utilisateurs puissent y accéder. Les utilisateurs non authentifiés peuvent rechercher dans le contenu public. Les utilisateurs qui s'authentifient peuvent rechercher dans tout le contenu auquel ils ont l'autorisation d'accéder en fonction de leurs [groupes d'utilisateurs](/fr/deploy/authentication-setup). +* Pour un contenu où toutes les pages requièrent une authentification, vous devez activer votre serveur Search MCP avant qu'il soit accessible aux utilisateurs. Les utilisateurs doivent s'authentifier avant de se connecter à votre serveur Search MCP. Votre serveur Search MCP recherche uniquement dans le contenu auquel chaque utilisateur a accès en fonction de ses [groupes d'utilisateurs](/fr/deploy/authentication-setup). -Vous pouvez afficher et copier l'URL de votre serveur MCP sur la [page du serveur MCP](https://dashboard.mintlify.com/products/mcp) dans votre Dashboard. +Vous pouvez afficher et copier l'URL de votre serveur Search MCP sur la [page du serveur MCP](https://dashboard.mintlify.com/products/mcp) dans votre Dashboard. Page du serveur MCP dans le Dashboard. @@ -91,16 +92,16 @@ Vous pouvez afficher et copier l'URL de votre serveur MCP sur la [page du se - Les serveurs MCP hébergés utilisent les chemins `/mcp` et `/authed/mcp`. Les autres éléments de navigation ne peuvent pas utiliser ces chemins. + Les serveurs Search MCP utilisent les chemins `/mcp` et `/authed/mcp`. Les autres éléments de navigation ne peuvent pas utiliser ces chemins.
### Point de terminaison de découverte
-Mintlify héberge un document de découverte à l’adresse `/.well-known/mcp` pour permettre aux agents et aux outils de localiser votre serveur MCP sans configuration préalable. +Mintlify héberge un document de découverte à l'adresse `/.well-known/mcp` pour permettre aux agents et aux outils de localiser votre serveur Search MCP sans configuration préalable. -`GET /.well-known/mcp` renvoie un document JSON décrivant votre serveur MCP : +`GET /.well-known/mcp` renvoie un document JSON décrivant votre serveur Search MCP : ```json { @@ -139,9 +140,9 @@ Pour la compatibilité avec les agents, le même document de découverte est ég ### Activer le MCP avec authentification
-Si votre documentation nécessite une authentification, votre serveur MCP demande aux utilisateurs de s’authentifier avant de se connecter. Lorsqu’un utilisateur ajoute l’URL de votre serveur MCP à son outil d’IA, il doit se connecter avec ses identifiants existants. Après l’authentification, une redirection le renvoie vers son outil. Le serveur MCP ne renvoie que le contenu auquel chaque utilisateur est autorisé à accéder en fonction de ses [groupes d’utilisateurs](/fr/deploy/authentication-setup). +Si votre site nécessite une authentification, votre serveur Search MCP demande aux utilisateurs de s'authentifier avant de se connecter. Lorsqu'un utilisateur ajoute l'URL de votre serveur MCP à son outil d'IA, il doit se connecter avec ses identifiants existants. Après l'authentification, une redirection le renvoie vers son outil. Le serveur MCP ne renvoie que le contenu auquel chaque utilisateur est autorisé à accéder en fonction de ses [groupes d'utilisateurs](/fr/deploy/authentication-setup). -Si votre documentation utilise une authentification partielle avec des pages publiques et des pages protégées, vous disposez de deux endpoints de serveur MCP : +Si votre site utilise une authentification partielle avec des pages publiques et des pages protégées, vous disposez de deux endpoints de serveur Search MCP : - `/mcp` : Ne nécessite pas d’authentification. Renvoie uniquement le contenu public. Partagez-le avec les utilisateurs qui ont besoin d’accéder au contenu public. - `/authed/mcp` : Nécessite toujours une authentification. Renvoie le contenu en fonction des permissions de chaque utilisateur selon ses [groupes d’utilisateurs](/fr/deploy/authentication-setup). Partagez-le avec les utilisateurs qui ont besoin d’accéder au contenu protégé. @@ -181,7 +182,7 @@ Les identifiants client s'authentifient auprès de l'endpoint `/authed/mcp` et r 4. Copiez le **client ID** et le **client secret**. Le client secret n'est affiché qu'une seule fois. Vous ne pourrez pas le récupérer ultérieurement. - Envoyez une requête POST à l'endpoint de jeton de votre serveur MCP avec votre client ID et votre secret. Votre endpoint de jeton se trouve au chemin `/authed/mcp/oauth/token` de l'URL de votre documentation. + Envoyez une requête POST à l'endpoint de jeton de votre serveur MCP avec votre client ID et votre secret. Votre endpoint de jeton se trouve au chemin `/authed/mcp/oauth/token` de l'URL de votre site. ```bash cURL @@ -263,20 +264,20 @@ Pour protéger la disponibilité, Mintlify applique des limites de débit aux se | Portée | Limite | Description | | :--------------------------------- | :----------------------- | :--------------------------------------------------------------------------------------------------------- | | Par utilisateur (adresse IP) | 5 000 requêtes par heure | Limite la fréquence à laquelle un même utilisateur peut interroger la configuration de votre serveur MCP. | -| Search par site de documentation (domain) | 10 000 requêtes par heure | Limite le nombre total d’appels à l’outil de recherche effectués par tous les utilisateurs de votre serveur MCP. | -| Query docs filesystem par site de documentation (domain) | 10 000 requêtes par heure | Limite le nombre total d’appels à l’outil query docs filesystem effectués par tous les utilisateurs de votre serveur MCP. | -| Search authentifié par site de documentation (domain) | 5 000 requêtes par heure | Limite le nombre total d’appels authentifiés à l’outil de recherche effectués par tous les utilisateurs de votre serveur MCP. | -| Query docs filesystem authentifié par site de documentation (domain) | 5 000 requêtes par heure | Limite le nombre total d’appels authentifiés à l’outil query docs filesystem effectués par tous les utilisateurs de votre serveur MCP. | +| Search par site (domain) | 10 000 requêtes par heure | Limite le nombre total d'appels à l'outil de recherche effectués par tous les utilisateurs de votre serveur MCP. | +| Query docs filesystem par site (domain) | 10 000 requêtes par heure | Limite le nombre total d'appels à l'outil query docs filesystem effectués par tous les utilisateurs de votre serveur MCP. | +| Search authentifié par site (domain) | 5 000 requêtes par heure | Limite le nombre total d'appels authentifiés à l'outil de recherche effectués par tous les utilisateurs de votre serveur MCP. | +| Query docs filesystem authentifié par site (domain) | 5 000 requêtes par heure | Limite le nombre total d'appels authentifiés à l'outil query docs filesystem effectués par tous les utilisateurs de votre serveur MCP. |
## Filtrage du contenu et indexation
-Votre serveur MCP recherche le contenu que Mintlify indexe à partir de votre référentiel de documentation. Le traitement des fichiers et l’indexation pour la recherche déterminent quel contenu est disponible via votre serveur MCP. +Votre serveur MCP recherche le contenu que Mintlify indexe à partir du référentiel de votre projet. Le traitement des fichiers et l'indexation pour la recherche déterminent quel contenu est disponible via votre serveur MCP. -Pour la documentation nécessitant une authentification, votre serveur MCP indexe les [pages publiques](/fr/deploy/authentication-setup#make-pages-public) ainsi que toutes les pages auxquelles un utilisateur authentifié a l'autorisation d'accéder en fonction de ses [groupes d'utilisateurs](/fr/deploy/authentication-setup#restrict-pages-to-specific-user-groups). +Pour les sites nécessitant une authentification, votre serveur MCP indexe les [pages publiques](/fr/deploy/authentication-setup#make-pages-public) ainsi que toutes les pages auxquelles un utilisateur authentifié a l'autorisation d'accéder en fonction de ses [groupes d'utilisateurs](/fr/deploy/authentication-setup#restrict-pages-to-specific-user-groups). -Pour la documentation avec authentification partielle, les utilisateurs non authentifiés peuvent rechercher dans les pages publiques. Les utilisateurs authentifiés peuvent rechercher dans les pages publiques ainsi que dans toutes les pages auxquelles ils ont l'autorisation d'accéder en fonction de leurs groupes d'utilisateurs. +Pour les sites avec authentification partielle, les utilisateurs non authentifiés peuvent rechercher dans les pages publiques. Les utilisateurs authentifiés peuvent rechercher dans les pages publiques ainsi que dans toutes les pages auxquelles ils ont l'autorisation d'accéder en fonction de leurs groupes d'utilisateurs.
### Traitement des fichiers avec `.mintignore` @@ -316,13 +317,13 @@ Vos utilisateurs doivent connecter votre serveur MCP à leurs outils d'IA pr 1. Rendez l'URL de votre serveur MCP publique. 2. Les utilisateurs copient l'URL de votre serveur MCP et l'ajoutent à leurs outils. -3. Les utilisateurs accèdent à votre documentation depuis leurs outils. +3. Les utilisateurs accèdent à votre contenu depuis leurs outils. Voici quelques façons d'aider vos utilisateurs à se connecter à votre serveur MCP : - Ajoutez des options dans le [menu contextuel](/fr/ai/contextual-menu) pour permettre à vos utilisateurs de se connecter à votre serveur MCP depuis n'importe quelle page de votre documentation. + Ajoutez des options dans le [menu contextuel](/fr/ai/contextual-menu) pour permettre à vos utilisateurs de se connecter à votre serveur MCP depuis n'importe quelle page de votre site. | Option | Identifiant | Description | | :----- | :--------- | :---------- |