mintlify · ethanpalm · Jun 25, 2026 · Jun 25, 2026 · Jun 25, 2026 · Jun 25, 2026
diff --git a/ai/model-context-protocol.mdx b/ai/model-context-protocol.mdx
@@ -14,7 +14,7 @@
 Your search MCP server exposes tools for AI applications to search and retrieve your content. Your users must connect your search MCP server to their tools.

 <Tip>
  Looking to let agents edit your content instead of read it? Use the [admin MCP server](/ai/mintlify-mcp) for an authenticated MCP server that exposes branching, page editing, navigation, and `docs.json` tools to trusted agents.
 </Tip>

 ### How MCP servers work
@@ -26,21 +26,21 @@
 - Each tool call happens during the generation process, so the AI application uses up-to-date information from your site to generate its response.

 <Tip>
  Some AI tools like Claude support both MCP and skills. MCP gives access to your content, while skills instruct agents how to use that content effectively. They're complementary and connecting your MCP server gives agents access to both.
 </Tip>

 ### MCP tools

 Your search MCP server provides two tools that agents can use:

 - **Search**: Searches across your site to find relevant content, returning snippets with titles and links. Use this to discover information or find pages matching a query.
 - **Query docs filesystem**: Reads and navigates your site's virtual filesystem using shell-style commands. Use this to browse and retrieve content, or extract specific sections—including batch reads across multiple pages in a single call.

 Agents determine when to use each tool based on the context of the conversation. For example, an agent might first search your site to find relevant pages, then use the query docs filesystem tool to read the full content of the most relevant results.

 ### MCP resources

 Your search MCP server also exposes your [skill.md files](/ai/skillmd) as MCP resources. Agents connected to your search MCP server can discover and access your skill files without installing them separately.

 `Skill.md` resources appear in the search MCP server's resource list and contain the capability descriptions Mintlify generates or that you define in your [custom skill files](/ai/skillmd#custom-skill-files).

@@ -82,7 +82,7 @@

 ### Discovery endpoint

 Mintlify hosts a discovery document at `/.well-known/mcp` for agents and tools to locate your search MCP server without prior configuration.

 `GET /.well-known/mcp` returns a JSON document describing your search MCP server:

@@ -168,12 +168,12 @@
 | `tools[].inputSchema` | JSON Schema for the tool's input parameters. |
 | `tools[].annotations` | Optional [MCP tool annotations](https://modelcontextprotocol.io/specification/2025-06-18/server/tools#tool-annotations) that describe tool behavior. |
 
 The built-in search and query docs filesystem tools are read-only and non-destructive with the following annotations:
 
-- `readOnlyHint: true` — the tool does not modify any state.
-- `destructiveHint: false` — the tool has no destructive side effects.
-- `idempotentHint: true` — repeated calls with the same arguments return equivalent results.
-- `openWorldHint: false` — the tool operates against your indexed documentation rather than the open web.
+- `readOnlyHint: true`—the tool does not modify any state.
+- `destructiveHint: false`—the tool has no destructive side effects.
+- `idempotentHint: true`—repeated calls with the same arguments return equivalent results.
+- `openWorldHint: false`—the tool operates against your indexed documentation rather than the open web.
 
 MCP clients can use these annotations to surface tool safety information to users or to allow read-only tools to run without explicit approval.
 

diff --git a/es/guides/seo.mdx b/es/guides/seo.mdx
@@ -171,7 +171,7 @@ Revísalo mensualmente y prioriza las páginas con muchas impresiones pero pocos
 
 <AccordionGroup>
 <Accordion title="¿Qué longitud debería tener una página de documentación para SEO?">
-No hay una longitud ideal universal. Las páginas deberían ser lo suficientemente largas para cubrir el tema de forma completa y lo suficientemente cortas para mantenerse enfocadas. Una guía de inicio rápido podría tener 800 palabras. Una referencia de API detallada podría tener 3,000. Lo que importa es que los usuarios puedan lograr su objetivo desde la página — si necesitan irse para encontrar información adicional, la página probablemente es demasiado superficial. En general, las páginas con menos de 300 palabras tienen dificultades para posicionar en consultas competitivas porque no demuestran profundidad temática.
+No hay una longitud ideal universal. Las páginas deberían ser lo suficientemente largas para cubrir el tema de forma completa y lo suficientemente cortas para mantenerse enfocadas. Una guía de inicio rápido podría tener 800 palabras. Una referencia de API detallada podría tener 3,000. Lo que importa es que los usuarios puedan lograr su objetivo desde la página—si necesitan irse para encontrar información adicional, la página probablemente es demasiado superficial. En general, las páginas con menos de 300 palabras tienen dificultades para posicionar en consultas competitivas porque no demuestran profundidad temática.
 </Accordion>
 
 <Accordion title="¿El SEO de documentación funciona de forma diferente al SEO de blog?">
@@ -183,14 +183,14 @@ En [Google Search Console](https://search.google.com/search-console), ve a **Sit
 </Accordion>
 
 <Accordion title="¿Con qué frecuencia debo actualizar la documentación para SEO?">
-Actualiza la documentación cada vez que el producto cambie — la precisión es la señal más importante. Específicamente para SEO, las páginas que no se han tocado en más de un año pueden beneficiarse de una revisión para agregar información faltante, actualizar ejemplos y expandir secciones superficiales. Usa Google Search Console para priorizar: las páginas que pierden tráfico o bajan de posición son candidatas para una actualización.
+Actualiza la documentación cada vez que el producto cambie—la precisión es la señal más importante. Específicamente para SEO, las páginas que no se han tocado en más de un año pueden beneficiarse de una revisión para agregar información faltante, actualizar ejemplos y expandir secciones superficiales. Usa Google Search Console para priorizar: las páginas que pierden tráfico o bajan de posición son candidatas para una actualización.
 </Accordion>
 
 <Accordion title="¿Cuál es la diferencia entre SEO y GEO?">
-SEO (Search Engine Optimization) se enfoca en posicionar en motores de búsqueda tradicionales como Google y Bing. GEO (Generative Engine Optimization) se enfoca en ser citado por herramientas impulsadas por IA como ChatGPT, Perplexity y Google AI Overviews. Los fundamentos se superponen — contenido preciso y bien estructurado funciona bien en ambos — pero GEO tiene algunas prácticas adicionales sobre el formato para el análisis por IA. Consulta la [guía de GEO](/es/guides/geo) para más detalles.
+SEO (Search Engine Optimization) se enfoca en posicionar en motores de búsqueda tradicionales como Google y Bing. GEO (Generative Engine Optimization) se enfoca en ser citado por herramientas impulsadas por IA como ChatGPT, Perplexity y Google AI Overviews. Los fundamentos se superponen—contenido preciso y bien estructurado funciona bien en ambos—pero GEO tiene algunas prácticas adicionales sobre el formato para el análisis por IA. Consulta la [guía de GEO](/es/guides/geo) para más detalles.
 </Accordion>
 
 <Accordion title="¿Mintlify gestiona automáticamente el SEO de la documentación?">
-Mintlify gestiona la base técnica: generación de sitemap, HTML semántico, etiquetas canónicas, generación de meta tags y optimización móvil. Lo que Mintlify no puede hacer por ti es escribir mejores títulos, investigar palabras clave, construir enlaces internos o expandir contenido superficial — eso requiere decisiones editoriales. La [referencia de configuración SEO](/es/optimize/seo) cubre todo lo que puedes controlar a través de `docs.json` y el frontmatter de la página.
+Mintlify gestiona la base técnica: generación de sitemap, HTML semántico, etiquetas canónicas, generación de meta tags y optimización móvil. Lo que Mintlify no puede hacer por ti es escribir mejores títulos, investigar palabras clave, construir enlaces internos o expandir contenido superficial—eso requiere decisiones editoriales. La [referencia de configuración SEO](/es/optimize/seo) cubre todo lo que puedes controlar a través de `docs.json` y el frontmatter de la página.
 </Accordion>
 </AccordionGroup>
diff --git a/es/optimize/seo.mdx b/es/optimize/seo.mdx
@@ -368,9 +368,9 @@ Content-Signal: ai-train=yes, search=yes, ai-input=yes
 
 Las señales predeterminadas habilitan tu documentación para:
 
-- `ai-train=yes` — Entrenamiento de modelos de IA.
-- `search=yes` — Creación de índices de búsqueda.
-- `ai-input=yes` — Generación de respuestas con IA, incluyendo generación aumentada por recuperación y asistentes de IA.
+- `ai-train=yes`—Entrenamiento de modelos de IA.
+- `search=yes`—Creación de índices de búsqueda.
+- `ai-input=yes`—Generación de respuestas con IA, incluyendo generación aumentada por recuperación y asistentes de IA.
 
 Estos valores por defecto ayudan a que herramientas de IA como ChatGPT, Claude y Perplexity descubran y citen tu documentación. Para cambiar las señales, [añade un `robots.txt` personalizado](#custom-sitemaps-and-robotstxt-files) en la raíz de tu proyecto. Mintlify sirve los archivos personalizados tal cual, sin las directivas Content-Signal predeterminadas.
 
@@ -438,8 +438,8 @@ Usa esta opción cuando quieras mantener un despliegue en línea para revisión
 
 Esta opción funciona junto con otros controles de indexación:
 
-- **`noindex` por página** — Los ajustes `noindex: true` en el frontmatter de una página siguen aplicándose cuando la opción a nivel de proyecto está desactivada. La opción a nivel de proyecto anula los ajustes por página cuando está activada, por lo que todas las páginas se tratan como `noindex`.
-- **`robots.txt` personalizado** — Si tienes un [`robots.txt` personalizado](#custom-sitemaps-and-robotstxt-files) en la raíz de tu proyecto, Mintlify lo sirve sin modificaciones. La opción a nivel de proyecto no reemplaza un `robots.txt` personalizado, así que actualiza o elimina tu archivo personalizado por separado si necesitas que las reglas para rastreadores coincidan.
+- **`noindex` por página**—Los ajustes `noindex: true` en el frontmatter de una página siguen aplicándose cuando la opción a nivel de proyecto está desactivada. La opción a nivel de proyecto anula los ajustes por página cuando está activada, por lo que todas las páginas se tratan como `noindex`.
+- **`robots.txt` personalizado**—Si tienes un [`robots.txt` personalizado](#custom-sitemaps-and-robotstxt-files) en la raíz de tu proyecto, Mintlify lo sirve sin modificaciones. La opción a nivel de proyecto no reemplaza un `robots.txt` personalizado, así que actualiza o elimina tu archivo personalizado por separado si necesitas que las reglas para rastreadores coincidan.
 
 <div id="seo-best-practices">
   ## Mejores prácticas de SEO

diff --git a/es/organize/settings-structure.mdx b/es/organize/settings-structure.mdx
@@ -376,23 +376,23 @@ El menú contextual brinda a los usuarios acceso rápido a herramientas de IA y
   Acciones disponibles en el menú contextual. La primera opción del array aparece como la acción predeterminada.
 
   Opciones integradas:
-  - `"add-mcp"` — Agrega tu servidor MCP a la configuración del usuario
-  - `"aistudio"` — Envía la página actual a Google AI Studio
-  - `"assistant"` — Abre el asistente de IA con la página actual como contexto
-  - `"copy"` — Copia la página actual como Markdown en el portapapeles
-  - `"chatgpt"` — Envía la página actual a ChatGPT
-  - `"claude"` — Envía la página actual a Claude
-  - `"cursor"` — Instala tu servidor MCP alojado en Cursor
-  - `"devin"` — Envía la página actual a Devin
-  - `"devin-mcp"` — Instala tu servidor MCP alojado en Devin
-  - `"download-pdf"` — Descarga la página actual como un PDF
-  - `"download-spec"` — Descarga las especificaciones de OpenAPI del despliegue (un solo archivo, o comprimidas en zip si hay varias)
-  - `"grok"` — Envía la página actual a Grok
-  - `"mcp"` — Copia la URL de tu servidor MCP en el portapapeles
-  - `"perplexity"` — Envía la página actual a Perplexity
-  - `"view"` — Ver la página actual como Markdown en una nueva pestaña
-  - `"vscode"` — Instala tu servidor MCP alojado en VS Code
-  - `"devin-desktop"` — Abre Devin Desktop con la página actual como contexto
+  - `"add-mcp"`—Agrega tu servidor MCP a la configuración del usuario
+  - `"aistudio"`—Envía la página actual a Google AI Studio
+  - `"assistant"`—Abre el asistente de IA con la página actual como contexto
+  - `"copy"`—Copia la página actual como Markdown en el portapapeles
+  - `"chatgpt"`—Envía la página actual a ChatGPT
+  - `"claude"`—Envía la página actual a Claude
+  - `"cursor"`—Instala tu servidor MCP alojado en Cursor
+  - `"devin"`—Envía la página actual a Devin
+  - `"devin-mcp"`—Instala tu servidor MCP alojado en Devin
+  - `"download-pdf"`—Descarga la página actual como un PDF
+  - `"download-spec"`—Descarga las especificaciones de OpenAPI del despliegue (un solo archivo, o comprimidas en zip si hay varias)
+  - `"grok"`—Envía la página actual a Grok
+  - `"mcp"`—Copia la URL de tu servidor MCP en el portapapeles
+  - `"perplexity"`—Envía la página actual a Perplexity
+  - `"view"`—Ver la página actual como Markdown en una nueva pestaña
+  - `"vscode"`—Instala tu servidor MCP alojado en VS Code
+  - `"devin-desktop"`—Abre Devin Desktop con la página actual como contexto
 
   Define opciones personalizadas como objetos:
 
@@ -410,9 +410,9 @@ El menú contextual brinda a los usuarios acceso rápido a herramientas de IA y
       Destino del enlace. Puede ser una cadena de URL o un objeto con `base` y parámetros `query` opcionales.
 
       Valores de marcador de posición disponibles:
-      - `$page` — Contenido de la página actual
-      - `$path` — Ruta de la página actual
-      - `$mcp` — URL del servidor MCP
+      - `$page`—Contenido de la página actual
+      - `$path`—Ruta de la página actual
+      - `$mcp`—URL del servidor MCP
     </ResponseField>
   </Expandable>
 </ResponseField>

diff --git a/fr/ai/model-context-protocol.mdx b/fr/ai/model-context-protocol.mdx
@@ -40,7 +40,7 @@ Lorsqu'une application d'IA se connecte à votre serveur Search MCP, elle peut r
 Votre serveur Search MCP fournit deux outils que les agents peuvent utiliser :
 
 - **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.
+- **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 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.
 
@@ -189,10 +189,10 @@ Chaque carte de serveur inclut les champs de découverte standards et un tableau
 
 Les outils intégrés de recherche et de requête du système de fichiers de documentation sont annoncés comme étant en lecture seule et non destructifs, avec les annotations suivantes :
 
-- `readOnlyHint: true` — l’outil ne modifie aucun état.
-- `destructiveHint: false` — l’outil n’a aucun effet de bord destructeur.
-- `idempotentHint: true` — des appels répétés avec les mêmes arguments renvoient des résultats équivalents.
-- `openWorldHint: false` — l’outil opère sur votre documentation indexée plutôt que sur le web ouvert.
+- `readOnlyHint: true`—l’outil ne modifie aucun état.
+- `destructiveHint: false`—l’outil n’a aucun effet de bord destructeur.
+- `idempotentHint: true`—des appels répétés avec les mêmes arguments renvoient des résultats équivalents.
+- `openWorldHint: false`—l’outil opère sur votre documentation indexée plutôt que sur le web ouvert.
 
 Les clients MCP peuvent utiliser ces annotations pour présenter des informations de sécurité aux utilisateurs ou pour permettre aux outils en lecture seule de s’exécuter sans approbation explicite.
 

diff --git a/fr/guides/seo.mdx b/fr/guides/seo.mdx
@@ -171,7 +171,7 @@ Vérifiez-le mensuellement et priorisez les pages avec beaucoup d'impressions ma
 
 <AccordionGroup>
 <Accordion title="Quelle longueur devrait avoir une page de documentation pour le SEO ?">
-Il n'y a pas de longueur idéale universelle. Les pages devraient être suffisamment longues pour couvrir le sujet de manière complète et suffisamment courtes pour rester ciblées. Un guide de démarrage peut faire 800 mots. Une référence API détaillée peut en faire 3 000. Ce qui compte, c'est que les utilisateurs puissent atteindre leur objectif depuis la page — s'ils doivent la quitter pour trouver des informations complémentaires, la page est probablement trop légère. En général, les pages de moins de 300 mots ont du mal à se classer pour les requêtes concurrentielles car elles ne démontrent pas de profondeur thématique.
+Il n'y a pas de longueur idéale universelle. Les pages devraient être suffisamment longues pour couvrir le sujet de manière complète et suffisamment courtes pour rester ciblées. Un guide de démarrage peut faire 800 mots. Une référence API détaillée peut en faire 3 000. Ce qui compte, c'est que les utilisateurs puissent atteindre leur objectif depuis la page—s'ils doivent la quitter pour trouver des informations complémentaires, la page est probablement trop légère. En général, les pages de moins de 300 mots ont du mal à se classer pour les requêtes concurrentielles car elles ne démontrent pas de profondeur thématique.
 </Accordion>
 
 <Accordion title="Le SEO de documentation fonctionne-t-il différemment du SEO de blog ?">
@@ -183,14 +183,14 @@ Dans [Google Search Console](https://search.google.com/search-console), allez da
 </Accordion>
 
 <Accordion title="À quelle fréquence dois-je mettre à jour la documentation pour le SEO ?">
-Mettez à jour la documentation chaque fois que le produit change — la précision est le signal le plus important. Pour le SEO spécifiquement, les pages qui n'ont pas été modifiées depuis plus d'un an peuvent bénéficier d'une révision pour ajouter des informations manquantes, mettre à jour les exemples et développer les sections légères. Utilisez Google Search Console pour prioriser : les pages qui perdent du trafic ou qui descendent en position sont candidates à un rafraîchissement.
+Mettez à jour la documentation chaque fois que le produit change—la précision est le signal le plus important. Pour le SEO spécifiquement, les pages qui n'ont pas été modifiées depuis plus d'un an peuvent bénéficier d'une révision pour ajouter des informations manquantes, mettre à jour les exemples et développer les sections légères. Utilisez Google Search Console pour prioriser : les pages qui perdent du trafic ou qui descendent en position sont candidates à un rafraîchissement.
 </Accordion>
 
 <Accordion title="Quelle est la différence entre SEO et GEO ?">
-SEO (Search Engine Optimization) se concentre sur le classement dans les moteurs de recherche traditionnels comme Google et Bing. GEO (Generative Engine Optimization) se concentre sur le fait d'être cité par des outils alimentés par l'IA comme ChatGPT, Perplexity et Google AI Overviews. Les fondamentaux se recoupent — un contenu précis et bien structuré fonctionne bien dans les deux — mais le GEO a quelques pratiques supplémentaires concernant le formatage pour l'analyse par l'IA. Consultez le [guide GEO](/fr/guides/geo) pour plus de détails.
+SEO (Search Engine Optimization) se concentre sur le classement dans les moteurs de recherche traditionnels comme Google et Bing. GEO (Generative Engine Optimization) se concentre sur le fait d'être cité par des outils alimentés par l'IA comme ChatGPT, Perplexity et Google AI Overviews. Les fondamentaux se recoupent—un contenu précis et bien structuré fonctionne bien dans les deux—mais le GEO a quelques pratiques supplémentaires concernant le formatage pour l'analyse par l'IA. Consultez le [guide GEO](/fr/guides/geo) pour plus de détails.
 </Accordion>
 
 <Accordion title="Mintlify gère-t-il automatiquement le SEO de la documentation ?">
-Mintlify gère les fondations techniques : génération du sitemap, HTML sémantique, balises canoniques, génération des balises meta et optimisation mobile. Ce que Mintlify ne peut pas faire pour vous, c'est rédiger de meilleurs titres, faire de la recherche de mots-clés, construire des liens internes ou développer du contenu léger — cela nécessite des décisions éditoriales. La [référence de configuration SEO](/fr/optimize/seo) couvre tout ce que vous pouvez contrôler via `docs.json` et le frontmatter de page.
+Mintlify gère les fondations techniques : génération du sitemap, HTML sémantique, balises canoniques, génération des balises meta et optimisation mobile. Ce que Mintlify ne peut pas faire pour vous, c'est rédiger de meilleurs titres, faire de la recherche de mots-clés, construire des liens internes ou développer du contenu léger—cela nécessite des décisions éditoriales. La [référence de configuration SEO](/fr/optimize/seo) couvre tout ce que vous pouvez contrôler via `docs.json` et le frontmatter de page.
 </Accordion>
 </AccordionGroup>