From 6b6bcec8b170c92ae47ac096bf803bfeb59b0ba1 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 15 May 2026 07:12:20 +0000 Subject: [PATCH] docs: clarify llms.txt access on partially authenticated sites --- ai/llmstxt.mdx | 5 ++++- deploy/authentication-setup.mdx | 2 +- es/ai/llmstxt.mdx | 5 ++++- es/deploy/authentication-setup.mdx | 2 +- fr/ai/llmstxt.mdx | 5 ++++- fr/deploy/authentication-setup.mdx | 2 +- zh/ai/llmstxt.mdx | 5 ++++- zh/deploy/authentication-setup.mdx | 2 +- 8 files changed, 20 insertions(+), 8 deletions(-) diff --git a/ai/llmstxt.mdx b/ai/llmstxt.mdx index b17e66db43..ec7c7ffc06 100644 --- a/ai/llmstxt.mdx +++ b/ai/llmstxt.mdx @@ -12,7 +12,10 @@ The [llms.txt file](https://llmstxt.org) is an industry standard that helps LLMs Mintlify automatically hosts an `llms.txt` file at the root of your project that lists all available pages in your documentation. This file is always up to date and requires zero maintenance. You can optionally add a custom `llms.txt` file to the root of your project. - If your site requires authentication, `llms.txt` and `llms-full.txt` also require authentication to view. LLMs and AI tools that cannot authenticate into your site cannot access these files. The files exclude pages that belong to [user groups](/deploy/authentication-setup#control-access-with-groups). + Authentication affects how `llms.txt` and `llms-full.txt` are served: + + - **Fully authenticated sites**: Both files require authentication to view. LLMs and AI tools that cannot authenticate into your site cannot access these files. + - **Partially authenticated sites**: Both files are publicly accessible without authentication, but their contents are limited to your public pages. Pages that belong to [user groups](/deploy/authentication-setup#control-access-with-groups) are excluded. For more information on how authentication affects AI features, see [Feature availability](/deploy/authentication-setup#feature-availability). diff --git a/deploy/authentication-setup.mdx b/deploy/authentication-setup.mdx index fe9b86142a..b6dfc440b0 100644 --- a/deploy/authentication-setup.mdx +++ b/deploy/authentication-setup.mdx @@ -464,7 +464,7 @@ Some features behave differently or are unavailable when you enable authenticati | Feature | Public | Fully authenticated (all pages protected) | Partially authenticated (some public pages) | | :------ | :---------- | :---------------------------------- | :-------------------------------- | -| [llms.txt and llms-full.txt](/ai/llmstxt) | Full support | Available behind authentication, so AI tools may not be able to access the files | Available behind authentication, so AI tools may not be able to access the files | +| [llms.txt and llms-full.txt](/ai/llmstxt) | Full support | Available behind authentication, so AI tools may not be able to access the files | Publicly accessible, but limited to public pages only | | [MCP server](/ai/model-context-protocol) | Full support | Requires authentication to connect | Available without authentication for public pages and with authentication for protected pages | | [Markdown export](/ai/markdown-export) | Full support | Full support, respects user groups | Full support, respects user groups | | [PDF export](/optimize/pdf-exports) | Full support | Not supported | Not supported | diff --git a/es/ai/llmstxt.mdx b/es/ai/llmstxt.mdx index 3651bb2c4b..681e725166 100644 --- a/es/ai/llmstxt.mdx +++ b/es/ai/llmstxt.mdx @@ -12,7 +12,10 @@ El [archivo llms.txt](https://llmstxt.org) es un estándar del sector que ayuda Mintlify aloja automáticamente un archivo `llms.txt` en la raíz de tu proyecto que lista todas las páginas disponibles de tu documentación. Este archivo siempre está actualizado y no requiere mantenimiento. Opcionalmente, puedes añadir un `llms.txt` personalizado en la raíz de tu proyecto. - Si tu sitio requiere autenticación, `llms.txt` y `llms-full.txt` también requieren autenticación para poder verse. Los LLM y las herramientas de IA que no puedan autenticarse en tu sitio no pueden acceder a estos archivos. Los archivos excluyen las páginas que pertenecen a [grupos de usuarios](/es/deploy/authentication-setup#control-access-with-groups). + La autenticación afecta cómo se sirven `llms.txt` y `llms-full.txt`: + + - **Sitios totalmente autenticados**: ambos archivos requieren autenticación para poder verse. Los LLM y las herramientas de IA que no puedan autenticarse en tu sitio no pueden acceder a estos archivos. + - **Sitios parcialmente autenticados**: ambos archivos son accesibles públicamente sin autenticación, pero su contenido se limita a tus páginas públicas. Se excluyen las páginas que pertenecen a [grupos de usuarios](/es/deploy/authentication-setup#control-access-with-groups). Para obtener más información sobre cómo la autenticación afecta las funciones de IA, consulta [Disponibilidad de funciones](/es/deploy/authentication-setup#feature-availability). diff --git a/es/deploy/authentication-setup.mdx b/es/deploy/authentication-setup.mdx index 8a7799fef1..ef4dbd0a0d 100644 --- a/es/deploy/authentication-setup.mdx +++ b/es/deploy/authentication-setup.mdx @@ -496,7 +496,7 @@ Algunas funciones se comportan de manera diferente o no están disponibles cuand | Función | Público | Totalmente autenticado (todas las páginas protegidas) | Parcialmente autenticado (algunas páginas públicas) | | :----------------------------------------------------------- | :---------------------- | :--------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------- | -| [llms.txt and llms-full.txt](/es/ai/llmstxt) | Compatibilidad completa | Disponible tras autenticación, por lo que es posible que las herramientas de IA no puedan acceder a los archivos | Disponible tras autenticación, por lo que es posible que las herramientas de IA no puedan acceder a los archivos | +| [llms.txt and llms-full.txt](/es/ai/llmstxt) | Compatibilidad completa | Disponible tras autenticación, por lo que es posible que las herramientas de IA no puedan acceder a los archivos | Accesible públicamente, pero limitado solo a las páginas públicas | | [Servidor MCP](/es/ai/model-context-protocol) | Compatibilidad completa | Requiere autenticación para conectarse | Disponible sin autenticación para páginas públicas y con autenticación para páginas protegidas | | [Exportación a Markdown](/es/ai/markdown-export) | Compatibilidad completa | Compatibilidad completa, respeta los grupos de usuarios | Compatibilidad completa, respeta los grupos de usuarios | | [Exportación a PDF](/es/optimize/pdf-exports) | Compatibilidad completa | No compatible | No compatible | diff --git a/fr/ai/llmstxt.mdx b/fr/ai/llmstxt.mdx index 966b22071a..c3786ee621 100644 --- a/fr/ai/llmstxt.mdx +++ b/fr/ai/llmstxt.mdx @@ -12,7 +12,10 @@ Le [fichier llms.txt](https://llmstxt.org) est une norme du secteur qui aide les Mintlify héberge automatiquement, à la racine de votre projet, un fichier `llms.txt` qui répertorie toutes les pages disponibles de votre documentation. Ce fichier est toujours à jour et ne nécessite aucun entretien. Vous pouvez également ajouter un fichier `llms.txt` personnalisé à la racine de votre projet. - Si votre site nécessite une authentification, `llms.txt` et `llms-full.txt` sont également soumis à une authentification pour être consultés. Les LLM et les outils d'IA qui ne peuvent pas s'authentifier sur votre site ne peuvent pas accéder à ces fichiers. Les fichiers excluent les pages qui appartiennent à des [groupes d'utilisateurs](/fr/deploy/authentication-setup#control-access-with-groups). + L'authentification influe sur la façon dont `llms.txt` et `llms-full.txt` sont servis : + + - **Sites entièrement authentifiés** : les deux fichiers nécessitent une authentification pour être consultés. Les LLM et les outils d'IA qui ne peuvent pas s'authentifier sur votre site ne peuvent pas accéder à ces fichiers. + - **Sites partiellement authentifiés** : les deux fichiers sont accessibles publiquement sans authentification, mais leur contenu est limité à vos pages publiques. Les pages qui appartiennent à des [groupes d'utilisateurs](/fr/deploy/authentication-setup#control-access-with-groups) sont exclues. Pour plus d'informations sur l'impact de l'authentification sur les fonctionnalités d'IA, voir [Disponibilité des fonctionnalités](/fr/deploy/authentication-setup#feature-availability). diff --git a/fr/deploy/authentication-setup.mdx b/fr/deploy/authentication-setup.mdx index ed46445ae2..eb250e96be 100644 --- a/fr/deploy/authentication-setup.mdx +++ b/fr/deploy/authentication-setup.mdx @@ -496,7 +496,7 @@ Certaines fonctionnalités se comportent différemment ou ne sont pas disponible | Fonctionnalité | Public | Entièrement authentifié (toutes les pages protégées) | Partiellement authentifié (certaines pages publiques) | | :------------------------------------------------------- | :----------------------- | :--------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------- | -| [llms.txt and llms-full.txt](/fr/ai/llmstxt) | Prise en charge complète | Disponible derrière l’authentification, les outils d’IA peuvent donc ne pas avoir accès aux fichiers | Disponible derrière l’authentification, les outils d’IA peuvent donc ne pas avoir accès aux fichiers | +| [llms.txt and llms-full.txt](/fr/ai/llmstxt) | Prise en charge complète | Disponible derrière l’authentification, les outils d’IA peuvent donc ne pas avoir accès aux fichiers | Accessible publiquement, mais limité aux pages publiques uniquement | | [MCP server](/fr/ai/model-context-protocol) | Prise en charge complète | Nécessite une authentification pour se connecter | Disponible sans authentification pour les pages publiques et avec authentification pour les pages protégées | | [Markdown export](/fr/ai/markdown-export) | Prise en charge complète | Prise en charge complète, respecte les groupes d’utilisateurs | Prise en charge complète, respecte les groupes d’utilisateurs | | [Export PDF](/fr/optimize/pdf-exports) | Prise en charge complète | Non pris en charge | Non pris en charge | diff --git a/zh/ai/llmstxt.mdx b/zh/ai/llmstxt.mdx index 0c249058d4..5ddfd84955 100644 --- a/zh/ai/llmstxt.mdx +++ b/zh/ai/llmstxt.mdx @@ -12,7 +12,10 @@ import { PreviewButton } from "/snippets/previewbutton.jsx" Mintlify 会在项目根目录自动托管一个 `llms.txt` 文件，列出文档中的所有可用页面。该文件始终保持最新且无需维护。你也可以在项目根目录添加自定义的 `llms.txt` 文件。 - 如果你的站点需要认证，查看 `llms.txt` 和 `llms-full.txt` 也同样需要认证。无法通过你站点认证的 LLM 和 AI 工具将无法访问这些文件。这些文件会排除属于[用户分组](/zh/deploy/authentication-setup#control-access-with-groups)的页面。 + 认证会影响 `llms.txt` 和 `llms-full.txt` 的提供方式： + + - **完全认证的站点**：查看这两个文件都需要认证。无法通过你站点认证的 LLM 和 AI 工具将无法访问这些文件。 + - **部分认证的站点**：无需认证即可公开访问这两个文件，但其内容仅限于你的公开页面。属于[用户分组](/zh/deploy/authentication-setup#control-access-with-groups)的页面会被排除。 有关认证如何影响 AI 功能的更多信息，请参阅[功能可用性](/zh/deploy/authentication-setup#feature-availability)。 diff --git a/zh/deploy/authentication-setup.mdx b/zh/deploy/authentication-setup.mdx index cc871cfcf7..50dceccd4c 100644 --- a/zh/deploy/authentication-setup.mdx +++ b/zh/deploy/authentication-setup.mdx @@ -496,7 +496,7 @@ groups: ["admin"] | 功能 | 公开 | 完全认证 (所有页面受保护) | 部分认证 (部分页面公开) | | :------------------------------------------------------- | :--- | :----------------------------- | :----------------------------- | -| [llms.txt 和 llms-full.txt](/zh/ai/llmstxt) | 完全支持 | 需要通过认证后才能访问，因此 AI 工具可能无法访问这些文件 | 需要通过认证后才能访问，因此 AI 工具可能无法访问这些文件 | +| [llms.txt 和 llms-full.txt](/zh/ai/llmstxt) | 完全支持 | 需要通过认证后才能访问，因此 AI 工具可能无法访问这些文件 | 可公开访问，但仅限于公开页面 | | [MCP 服务器](/zh/ai/model-context-protocol) | 完全支持 | 连接时需要认证 | 公开页面无需认证即可使用，受保护页面则需要认证 | | [Markdown 导出](/zh/ai/markdown-export) | 完全支持 | 完全支持，尊重用户分组 | 完全支持，尊重用户分组 | | [PDF 导出](/zh/optimize/pdf-exports) | 完全支持 | 不支持 | 不支持 |