Si tu organización tiene múltiples despliegues, el agente te pide que elijas con cuál despliegue trabajar la primera vez que envías una solicitud.
@@ -82,6 +94,20 @@ Una vez conectado, puedes:
- Continuar las conversaciones en hilos para iterar sobre los cambios o hacer preguntas de seguimiento. El agente reutiliza los archivos e imágenes compartidos previamente en el hilo como contexto para las solicitudes posteriores, por lo que no es necesario que los vuelvas a cargar.
- Compartir enlaces a solicitudes de extracción con el agente para actualizar la documentación relacionada.
+
+ ## Haz preguntas sobre tu documentación
+
+
+Hazle preguntas al agente sobre tu producto o documentación y recibe respuestas en el hilo.
+
+- **Nueva pregunta**: Envía un mensaje directo al agente o menciona `@mintlify` en un canal con tu pregunta.
+- **Hilo existente**: Responde en el hilo y menciona `@mintlify` con una pregunta de seguimiento.
+
+Ejemplos de preguntas:
+- «¿Qué páginas mencionan el límite de tasa de la API?»
+- «¿Cómo configuro la autenticación?»
+- «¿Cómo está estructurada nuestra navegación?»
+
## Actualizar la documentación
diff --git a/es/ai/model-context-protocol.mdx b/es/ai/model-context-protocol.mdx
index d525a6d2e7..f7b5d159ff 100644
--- a/es/ai/model-context-protocol.mdx
+++ b/es/ai/model-context-protocol.mdx
@@ -94,6 +94,45 @@ 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.
+
+ ### 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.
+
+`GET /.well-known/mcp` devuelve un documento JSON que describe tu servidor MCP:
+
+```json
+{
+ "version": "1.0.0",
+ "transport": "http",
+ "url": "https://your-docs.com/mcp",
+ "servers": [
+ {
+ "name": "public",
+ "url": "https://your-docs.com/mcp",
+ "transport": "http",
+ "authentication": "none"
+ },
+ {
+ "name": "authenticated",
+ "url": "https://your-docs.com/authed/mcp",
+ "transport": "http",
+ "authentication": "oauth2"
+ }
+ ]
+}
+```
+
+| Campo | Descripción |
+| --- | --- |
+| `version` | La versión del servidor MCP. |
+| `transport` | El protocolo de transporte. Siempre es `http`. |
+| `url` | La URL pública predeterminada del servidor MCP. |
+| `servers` | Servidores MCP disponibles. Siempre incluye una entrada `public`. Cuando la autenticación está habilitada en tu sitio, también incluye una entrada `authenticated`. |
+| `servers[].name` | Identificador de la entrada del servidor. |
+| `servers[].authentication` | Método de autenticación de la entrada del servidor. |
+
### Habilitar MCP autenticado
diff --git a/es/editor/configurations.mdx b/es/editor/configurations.mdx
index a414d514b0..7280eb1c8c 100644
--- a/es/editor/configurations.mdx
+++ b/es/editor/configurations.mdx
@@ -92,6 +92,12 @@ Personaliza la experiencia de búsqueda.
* **Marcador de posición de búsqueda**: El texto que aparece en el campo de búsqueda antes de que los usuarios escriban. El valor predeterminado es «Buscar o preguntar…».
+
+ ## Conectar integraciones
+
+
+Conecta herramientas de terceros para Analytics, soporte y cumplimiento.
+
## Configurar especificaciones de la API
diff --git a/es/guides/help-center.mdx b/es/guides/help-center.mdx
index ac36a32e1a..e7421cc0c5 100644
--- a/es/guides/help-center.mdx
+++ b/es/guides/help-center.mdx
@@ -14,6 +14,20 @@ Mintlify proporciona la infraestructura para centros de soporte que escalan con
* **Analytics**: Haz un seguimiento de qué artículos reciben visitas, qué preguntas hacen los clientes y dónde tienen dificultades.
* **Autenticación**: Usa [SSO o OAuth](/es/deploy/authentication-setup) para mostrar contenido personalizado según los planes o tipos de cuenta de los clientes.
+
+ ## Empieza desde una plantilla
+
+
+La forma más rápida de crear un nuevo centro de ayuda es con el comando `mint new --template`. Ejecuta el comando y selecciona la plantilla de inicio del centro de ayuda.
+
+```bash
+mint new your-help-center-name --template help-center-starter
+```
+
+Esto crea un nuevo proyecto preconfigurado para un centro de ayuda, que incluye la estructura de navegación, páginas de ejemplo y listados de directorios. Consulta el [ejemplo en vivo](https://help-center-starter.mintlify.app/) o revisa el [código fuente de la plantilla](https://github.com/mintlify/templates/tree/main/help-center-starter).
+
+Si prefieres configurar un centro de ayuda en un proyecto existente, continúa con los pasos a continuación.
+
## Requisitos previos
diff --git a/fr/agent/slack.mdx b/fr/agent/slack.mdx
index ba59b773ff..f37be1b85e 100644
--- a/fr/agent/slack.mdx
+++ b/fr/agent/slack.mdx
@@ -24,6 +24,18 @@ keywords: ["Intégration Slack", "Bot Slack", "Collaboration d'équipe", "Intég
- Envoyez un message direct à l'agent.
- Mentionnez l'agent avec `@mintlify` dans un canal.
+
+ Chaque espace de travail Slack ne peut être connecté qu'à une seule organisation Mintlify à la fois. Si vous tentez d'installer l'agent dans un espace de travail déjà connecté à une autre organisation, l'installation échoue avec une erreur « wrong organization ». Désinstallez d'abord l'application de l'autre organisation, ou utilisez un autre espace de travail Slack.
+
+
+
+ ### Reconnecter ou réinstaller l'agent
+
+
+Si vous devez réautoriser l'agent — par exemple, pour accorder de nouvelles permissions après une mise à jour des scopes Slack ou pour récupérer après la révocation d'un jeton — réinstallez l'application depuis votre dashboard Mintlify.
+
+Lorsque vous réinstallez l'agent dans un espace de travail déjà connecté à votre organisation, Mintlify met à jour le bot token stocké sur place. Vos canaux, fils de discussion et intégrations par utilisateur existants restent intacts.
+
Si votre organisation dispose de plusieurs déploiements, l'agent vous demande de choisir avec quel déploiement travailler la première fois que vous envoyez une demande.
@@ -83,6 +95,20 @@ Une fois connecté, vous pouvez :
- Poursuivre les conversations dans des fils pour affiner les modifications ou poser des questions de suivi. L'agent réutilise les fichiers et images partagés plus tôt dans le fil comme contexte pour les demandes suivantes, vous n'avez donc pas besoin de les téléverser à nouveau.
- Partager des liens de pull request (demandes de fusion) avec l'agent pour mettre à jour la documentation associée.
+
+ ## Poser des questions sur votre documentation
+
+
+Posez à l'agent des questions sur votre produit ou votre documentation et recevez les réponses dans le fil.
+
+- **Nouvelle question** : Envoyez un message direct à l'agent ou mentionnez `@mintlify` dans un canal avec votre question.
+- **Fil existant** : Répondez dans le fil et mentionnez `@mintlify` avec une question de suivi.
+
+Exemples de questions :
+- « Quelles pages mentionnent la limite de débit de l'API ? »
+- « Comment configurer l'authentification ? »
+- « Comment est structurée notre navigation ? »
+
## Mettre à jour la documentation
diff --git a/fr/ai/model-context-protocol.mdx b/fr/ai/model-context-protocol.mdx
index 843cc044df..126189b6cb 100644
--- a/fr/ai/model-context-protocol.mdx
+++ b/fr/ai/model-context-protocol.mdx
@@ -94,6 +94,45 @@ 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.
+
+ ### 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.
+
+`GET /.well-known/mcp` renvoie un document JSON décrivant votre serveur MCP :
+
+```json
+{
+ "version": "1.0.0",
+ "transport": "http",
+ "url": "https://your-docs.com/mcp",
+ "servers": [
+ {
+ "name": "public",
+ "url": "https://your-docs.com/mcp",
+ "transport": "http",
+ "authentication": "none"
+ },
+ {
+ "name": "authenticated",
+ "url": "https://your-docs.com/authed/mcp",
+ "transport": "http",
+ "authentication": "oauth2"
+ }
+ ]
+}
+```
+
+| Champ | Description |
+| --- | --- |
+| `version` | La version du serveur MCP. |
+| `transport` | Le protocole de transport. Toujours `http`. |
+| `url` | L’URL publique par défaut du serveur MCP. |
+| `servers` | Serveurs MCP disponibles. Inclut toujours une entrée `public`. Lorsque l’authentification est activée sur votre site, inclut également une entrée `authenticated`. |
+| `servers[].name` | Identifiant de l’entrée du serveur. |
+| `servers[].authentication` | Méthode d’authentification de l’entrée du serveur. |
+
### Activer le MCP avec authentification
diff --git a/fr/editor/configurations.mdx b/fr/editor/configurations.mdx
index 09ec113977..3c2af946d1 100644
--- a/fr/editor/configurations.mdx
+++ b/fr/editor/configurations.mdx
@@ -92,6 +92,12 @@ Personnalisez l'expérience de recherche.
* **Texte d’indication de recherche** : Le texte qui apparaît dans le champ de recherche avant que les utilisateurs ne saisissent quoi que ce soit. La valeur par défaut est « Search or ask... ».
+
+ ## Connecter des intégrations
+
+
+Connectez des outils tiers pour Analytics, l’assistance et la conformité.
+
## Configurer les spécifications d’API
diff --git a/fr/guides/help-center.mdx b/fr/guides/help-center.mdx
index e4c9fdb486..1f31fea229 100644
--- a/fr/guides/help-center.mdx
+++ b/fr/guides/help-center.mdx
@@ -14,6 +14,20 @@ Mintlify fournit une infrastructure de centres de support qui évoluent avec la
* **Analytics** : Suivez les articles consultés, les questions posées par les clients et les points sur lesquels ils rencontrent des difficultés.
* **Authentification** : Utilisez le [SSO ou OAuth](/fr/deploy/authentication-setup) pour afficher un contenu personnalisé en fonction des formules ou types de compte des clients.
+
+ ## Démarrer à partir d’un modèle
+
+
+Le moyen le plus rapide de créer un nouveau centre d’assistance est d’utiliser la commande `mint new --template`. Exécutez la commande et sélectionnez le modèle de démarrage du centre d’assistance.
+
+```bash
+mint new your-help-center-name --template help-center-starter
+```
+
+Cela crée un nouveau projet préconfiguré pour un centre d’assistance, comprenant la structure de navigation, des pages d’exemple et des listes de répertoires. Consultez l’[exemple en ligne](https://help-center-starter.mintlify.app/) ou parcourez le [code source du modèle](https://github.com/mintlify/templates/tree/main/help-center-starter).
+
+Si vous préférez configurer un centre d’assistance dans un projet existant, poursuivez avec les étapes ci-dessous.
+
## Prérequis
diff --git a/zh/agent/slack.mdx b/zh/agent/slack.mdx
index 01b2e231a6..e6f9bb7aff 100644
--- a/zh/agent/slack.mdx
+++ b/zh/agent/slack.mdx
@@ -24,6 +24,18 @@ keywords: ["Slack 集成", "Slack 机器人", "团队协作", "agent 集成", "
- 向 agent 发送一条私信。
- 在频道中使用 `@mintlify` 提及 agent。
+
+ 每个 Slack 工作区一次只能连接到一个 Mintlify 组织。如果你尝试将 agent 安装到已经连接到其他组织的工作区，安装会失败并提示 “wrong organization” 错误。请先从其他组织卸载该应用，或使用其他 Slack 工作区。
+
+
+
+ ### 重新连接或重新安装 agent
+
+
+如果你需要重新授权 agent —— 例如，在 Slack 范围更新后授予新的权限，或在 token 被撤销后进行恢复 —— 请从你的 Mintlify dashboard 重新安装该应用。
+
+当你将 agent 重新安装到已经连接到你组织的工作区时，Mintlify 会原地刷新已存储的 bot token。你现有的频道、线程和按用户配置的集成都会保持不变。
+
如果你的组织有多个部署，agent 会在你首次发送请求时要求你选择要使用的部署。
@@ -79,6 +91,20 @@ Mintlify 会让你已连接服务的状态与 Composio 保持同步。当出现
- 在线程中继续对话，对修改内容持续迭代或提出后续问题。智能体会将该线程中先前共享的文件和图片作为后续请求的上下文重复使用，因此你无需再次上传。
- 将拉取请求（PR；亦称"合并请求"/Merge Request）链接分享给智能体，以更新相关文档。
+
+ ## 就你的文档提问
+
+
+向智能体询问关于你的产品或文档的问题，并在线程中收到回答。
+
+- **新问题**：直接给智能体发送私信，或在频道中通过 `@mintlify` 提及智能体并附上你的问题。
+- **已有线程**：在线程中回复并使用 `@mintlify` 提出后续问题。
+
+示例问题：
+- "哪些页面提到了 API 速率限制？"
+- "如何设置身份验证？"
+- "我们的导航是如何组织的？"
+
## 更新文档
diff --git a/zh/ai/model-context-protocol.mdx b/zh/ai/model-context-protocol.mdx
index 118b6b3fa3..dd51cc2ea1 100644
--- a/zh/ai/model-context-protocol.mdx
+++ b/zh/ai/model-context-protocol.mdx
@@ -94,6 +94,45 @@ Mintlify 会为你的文档生成一个 MCP 服务器，并将其托管在你的
托管的 MCP 服务器使用 `/mcp` 和 `/authed/mcp` 路径。其他导航元素不能使用这些路径。
+
+ ### 发现端点
+
+
+Mintlify 在 `/.well-known/mcp` 托管一个发现文档，便于智能体和工具在无需预先配置的情况下定位你的 MCP 服务器。
+
+`GET /.well-known/mcp` 会返回一个描述你的 MCP 服务器的 JSON 文档：
+
+```json
+{
+ "version": "1.0.0",
+ "transport": "http",
+ "url": "https://your-docs.com/mcp",
+ "servers": [
+ {
+ "name": "public",
+ "url": "https://your-docs.com/mcp",
+ "transport": "http",
+ "authentication": "none"
+ },
+ {
+ "name": "authenticated",
+ "url": "https://your-docs.com/authed/mcp",
+ "transport": "http",
+ "authentication": "oauth2"
+ }
+ ]
+}
+```
+
+| 字段 | 说明 |
+| --- | --- |
+| `version` | MCP 服务器版本。 |
+| `transport` | 传输协议。始终为 `http`。 |
+| `url` | 默认的公开 MCP 服务器 URL。 |
+| `servers` | 可用的 MCP 服务器。始终包含 `public` 条目。当你的站点启用了身份验证时，还会包含 `authenticated` 条目。 |
+| `servers[].name` | 服务器条目的标识符。 |
+| `servers[].authentication` | 服务器条目的身份验证方式。 |
+
### 启用 MCP 认证
diff --git a/zh/editor/configurations.mdx b/zh/editor/configurations.mdx
index 0fdf10b514..d5ec7d6567 100644
--- a/zh/editor/configurations.mdx
+++ b/zh/editor/configurations.mdx
@@ -92,6 +92,12 @@ boost: 3
* **搜索占位文本**：在用户输入之前显示在搜索框中的文本。默认值为“Search or ask...”。
+
+ ## 连接集成
+
+
+连接第三方工具以实现分析、支持和合规等功能。
+
## 配置 API 规范
diff --git a/zh/guides/help-center.mdx b/zh/guides/help-center.mdx
index 47a890ea20..f27a3d6ddc 100644
--- a/zh/guides/help-center.mdx
+++ b/zh/guides/help-center.mdx
@@ -14,6 +14,20 @@ Mintlify 提供可随客户规模扩展的支持中心基础设施。
* **Analytics**：跟踪哪些文章被查看、客户提出了哪些问题，以及他们在哪些地方遇到困难。
* **认证**：使用 [SSO 或 OAuth](/zh/deploy/authentication-setup) 基于客户方案或账户类型展示个性化内容。
+
+ ## 从模板开始
+
+
+创建新支持中心最快的方式是使用 `mint new --template` 命令。运行该命令并选择支持中心起始模板。
+
+```bash
+mint new your-help-center-name --template help-center-starter
+```
+
+这会创建一个为支持中心预先配置好的新项目，包含导航结构、示例页面和目录列表。查看[在线示例](https://help-center-starter.mintlify.app/)或浏览[模板源代码](https://github.com/mintlify/templates/tree/main/help-center-starter)。
+
+如果你希望在现有项目中配置支持中心，请继续按照下面的步骤操作。
+
## 前置条件
diff --git a/zh/organize/hidden-pages.mdx b/zh/organize/hidden-pages.mdx
index df4a4167c4..14fd377e7b 100644
--- a/zh/organize/hidden-pages.mdx
+++ b/zh/organize/hidden-pages.mdx
@@ -104,7 +104,13 @@ hidden: true
## 搜索、SEO 与 AI 索引编入
-默认情况下，隐藏页面不会被纳入搜索引擎的索引、文档站点的内部搜索，也不会作为 AI 助手的上下文使用。若要在搜索结果中包含隐藏页面并将其作为 AI 助手的上下文，请在你的 `docs.json` 中添加 `seo` 属性：
+默认情况下，隐藏页面不会被纳入搜索引擎的索引、文档站点的内部搜索，也不会作为 AI 助手的上下文使用。你可以通过两种方式将隐藏内容纳入搜索和索引。
+
+
+ ### 包含所有隐藏页面
+
+
+若要将站点上所有隐藏页面都纳入搜索、站点地图和 AI 上下文中，请在你的 `docs.json` 中添加 `seo` 属性：
```json
"seo": {
@@ -112,6 +118,40 @@ hidden: true
}
```
+
+ ### 仅包含特定隐藏标签页或分组下的页面
+
+
+若只想包含某个隐藏标签页或分组下的页面，请在 `docs.json` 中对应的标签页或分组上设置 `searchable: true`。当你为了控制导航布局而隐藏标签页或分组，但仍希望其下的子页面可被发现时，请使用此选项。
+
+```json highlight={5}
+"tabs": [
+ {
+ "tab": "Storage",
+ "hidden": true,
+ "searchable": true,
+ "groups": [
+ {
+ "group": "Buckets",
+ "pages": ["products/storage/buckets/create-bucket"]
+ }
+ ]
+ }
+]
+```
+
+设置 `searchable: true` 后，子页面仍会保留在以下位置：
+
+- 文档站点搜索
+- `sitemap.xml`
+- AI 助手上下文
+- MCP 服务器搜索结果
+- 搜索引擎索引（不会应用 `noindex` meta 标签）
+
+但标签页或分组本身仍会在渲染后的导航中保持隐藏。
+
+页面自身的 `hidden: true` frontmatter 始终具有最高优先级。若要重新排除某个子分组，请在其上设置 `hidden: true` 且不设置 `searchable: true`。
+
### 理解 `hidden` 与 `noindex` 的区别