mintlify · mintlify · Mar 25, 2026 · Mar 25, 2026
diff --git a/docs.json b/docs.json
@@ -468,6 +468,7 @@
                       "fr/agent/index",
                       "fr/agent/slack",
                       "fr/agent/linear",
+                      "fr/agent/notion",
                       "fr/agent/customize",
                       "fr/agent/effective-prompts",
                       "fr/agent/workflows"
@@ -838,6 +839,7 @@
                       "es/agent/index",
                       "es/agent/slack",
                       "es/agent/linear",
+                      "es/agent/notion",
                       "es/agent/customize",
                       "es/agent/effective-prompts",
                       "es/agent/workflows"
@@ -1208,6 +1210,7 @@
                       "zh/agent/index",
                       "zh/agent/slack",
                       "zh/agent/linear",
+                      "zh/agent/notion",
                       "zh/agent/customize",
                       "zh/agent/effective-prompts",
                       "zh/agent/workflows"

diff --git a/es/agent/index.mdx b/es/agent/index.mdx
@@ -56,6 +56,9 @@ El agente solo puede acceder a los repositorios que conectes mediante la Aplicac
 <Card title="Conectar Linear" horizontal icon="linear" href="/es/agent/linear">
   Añade el agente a tu espacio de trabajo de Linear.
 </Card>
+<Card title="Conectar Notion" horizontal icon="file-lines" href="/es/agent/notion">
+  Otorga al agente acceso a tu espacio de trabajo de Notion.
+</Card>
 
 <Card title="Personalizar comportamiento" horizontal icon="wrench" href="/es/agent/customize">
   Configura el agente con un archivo `AGENTS.md`.

diff --git a/es/agent/linear.mdx b/es/agent/linear.mdx
@@ -13,8 +13,8 @@ Conecta tu espacio de trabajo de Linear al agente para realizar actualizaciones
 1. Ve a la página de [Agent](https://dashboard.mintlify.com/products/agent) en tu dashboard.
 2. En la sección "Agent settings", haz clic en **Install Linear app**.
   <Frame>
-    <img src="/images/agent/install-apps-light.png" alt="La sección de configuración de aplicaciones con los botones de instalación de Slack y Linear." className="block dark:hidden" />
-    <img src="/images/agent/install-apps-dark.png" alt="La sección de configuración de aplicaciones con los botones de instalación de Slack y Linear." className="hidden dark:block" />
+    <img src="/images/agent/install-apps-light.png" alt="La sección de configuración de aplicaciones con los botones de instalación de Slack, Linear y Notion." className="block dark:hidden" />
+    <img src="/images/agent/install-apps-dark.png" alt="La sección de configuración de aplicaciones con los botones de instalación de Slack, Linear y Notion." className="hidden dark:block" />
   </Frame>
 3. Sigue las indicaciones de Linear para autorizar la aplicación de Mintlify en tu espacio de trabajo.
 

diff --git a/es/agent/notion.mdx b/es/agent/notion.mdx
@@ -0,0 +1,50 @@
+---
+title: "Conectar Notion al agente"
+description: "Otorga al agente acceso a tu espacio de trabajo de Notion para que consulte páginas y bases de datos al actualizar la documentación."
+keywords: ["Notion", "integration", "knowledge base", "context"]
+---
+
+Conecta tu espacio de trabajo de Notion al agente para que pueda buscar en tu contenido de Notion y usarlo como contexto al crear actualizaciones de documentación. El contexto adicional proveniente de la base de conocimiento de tu equipo, las especificaciones de producto y la documentación interna almacenada en Notion ayuda al agente a crear documentación más precisa y completa.
+
+<div id="connect-your-notion-workspace">
+  ## Conecta tu espacio de trabajo de Notion
+</div>
+
+1. Ve a la página de [Agent](https://dashboard.mintlify.com/products/agent) en tu dashboard.
+2. En la sección "Agent settings", haz clic en **Install Notion app**.
+  <Frame>
+    <img src="/images/agent/install-apps-light.png" alt="La sección de configuración de aplicaciones con los botones de instalación de Slack, Linear y Notion." className="block dark:hidden" />
+    <img src="/images/agent/install-apps-dark.png" alt="La sección de configuración de aplicaciones con los botones de instalación de Slack, Linear y Notion." className="hidden dark:block" />
+  </Frame>
+3. Sigue las indicaciones para autorizar a Mintlify a acceder a tu espacio de trabajo de Notion.
+4. En la pantalla de autorización de Notion, selecciona qué páginas y bases de datos compartir con Mintlify.
+
+<div id="what-the-agent-can-do-with-notion">
+  ## Qué puede hacer el agente con Notion
+</div>
+
+La integración con Notion utiliza las [herramientas MCP](https://developers.notion.com/guides/mcp/mcp-supported-tools#mcp-tools) de Notion para buscar y leer el contenido de tu espacio de trabajo.
+
+Tu contenido en Notion se convierte en contexto adicional para que el agente lo use al generar documentación.
+
+Cuando el agente tiene acceso a tu espacio de trabajo de Notion, puede:
+
+- **Buscar en Notion**: Encontrar páginas y bases de datos relevantes en tu espacio de trabajo de Notion conectado, según el contexto de tu solicitud.
+- **Leer páginas de Notion**: Acceder al contenido de las páginas de Notion para usarlo como material de referencia al generar documentación.
+- **Consultar bases de datos**: Obtener datos estructurados de las bases de datos de Notion para informar las actualizaciones de documentación.
+
+<div id="use-cases">
+  ## Casos de uso
+</div>
+
+- **Sincronizar especificaciones de producto con la documentación**: Consultar documentos de requisitos de producto y especificaciones de diseño almacenados en Notion al redactar documentación de funcionalidades.
+- **Documentar a partir de notas de reuniones**: Indicar al agente notas de reuniones o registros de decisiones en Notion para redactar documentación basada en las discusiones del equipo.
+- **Consultar bases de conocimiento internas**: Usar wikis internos y bases de conocimiento en Notion como material de referencia para la documentación pública.
+
+<div id="best-practices">
+  ## Mejores prácticas
+</div>
+
+- **Delimita el acceso cuidadosamente**: Otorga acceso solo a las páginas y bases de datos de Notion que contengan información relevante para tu documentación.
+- **Proporciona referencias específicas**: Al dar instrucciones al agente, menciona la página o base de datos de Notion específica que deseas que consulte para obtener mejores resultados.
+- **Revisa el contenido generado**: Siempre revisa las solicitudes de extracción para asegurarte de que la información de Notion se haya adaptado adecuadamente para tu documentación pública.
diff --git a/es/agent/slack.mdx b/es/agent/slack.mdx
@@ -15,8 +15,8 @@ keywords: ["Integración con Slack", "Bot de Slack", "Colaboración en equipo",
 1. Ve a la página de [Agent](https://dashboard.mintlify.com/products/agent) en tu dashboard.
 2. En la sección "Agent settings", haz clic en **Install Slack app**.
   <Frame>
-    <img src="/images/agent/install-apps-light.png" alt="La sección de configuración de aplicaciones con los botones de instalación de Slack y Linear." className="block dark:hidden" />
-    <img src="/images/agent/install-apps-dark.png" alt="La sección de configuración de aplicaciones con los botones de instalación de Slack y Linear." className="hidden dark:block" />
+    <img src="/images/agent/install-apps-light.png" alt="La sección de configuración de aplicaciones con los botones de instalación de Slack, Linear y Notion." className="block dark:hidden" />
+    <img src="/images/agent/install-apps-dark.png" alt="La sección de configuración de aplicaciones con los botones de instalación de Slack, Linear y Notion." className="hidden dark:block" />
   </Frame>
 3. Sigue las indicaciones de Slack para instalar la app `mintlify` en tu espacio de trabajo.
 4. Sigue las indicaciones de Slack para vincular tu cuenta de Mintlify con tu espacio de trabajo de Slack.

diff --git a/fr/agent/index.mdx b/fr/agent/index.mdx
@@ -56,6 +56,9 @@ L’agent ne peut accéder qu’aux dépôts que vous connectez via la GitHub Ap
 <Card title="Connecter Linear" horizontal icon="linear" href="/fr/agent/linear">
   Ajoutez l'agent à votre espace de travail Linear.
 </Card>
+<Card title="Connecter Notion" horizontal icon="file-lines" href="/fr/agent/notion">
+  Donnez à l'agent accès à votre espace de travail Notion.
+</Card>
 
 <Card title="Personnaliser le comportement" horizontal icon="wrench" href="/fr/agent/customize">
   Configurez l&#39;agent avec un fichier `AGENTS.md`.

diff --git a/fr/agent/linear.mdx b/fr/agent/linear.mdx
@@ -13,8 +13,8 @@ Connectez votre espace de travail Linear à l'agent pour effectuer des mises à
 1. Accédez à la page [Agent](https://dashboard.mintlify.com/products/agent) de votre Dashboard.
 2. Dans la section "Agent settings", cliquez sur **Install Linear app**.
   <Frame>
-    <img src="/images/agent/install-apps-light.png" alt="La section des paramètres d'application avec les boutons d'installation de Slack et Linear." className="block dark:hidden" />
-    <img src="/images/agent/install-apps-dark.png" alt="La section des paramètres d'application avec les boutons d'installation de Slack et Linear." className="hidden dark:block" />
+    <img src="/images/agent/install-apps-light.png" alt="La section des paramètres d'application avec les boutons d'installation de Slack, Linear et Notion." className="block dark:hidden" />
+    <img src="/images/agent/install-apps-dark.png" alt="La section des paramètres d'application avec les boutons d'installation de Slack, Linear et Notion." className="hidden dark:block" />
   </Frame>
 3. Suivez les instructions de Linear pour autoriser l'application Mintlify dans votre espace de travail.
 

diff --git a/fr/agent/notion.mdx b/fr/agent/notion.mdx
@@ -0,0 +1,50 @@
+---
+title: "Connecter Notion à l'agent"
+description: "Donnez à l'agent accès à votre espace de travail Notion pour qu'il puisse consulter des pages et des bases de données lors de la mise à jour de la documentation."
+keywords: ["Notion", "integration", "knowledge base", "context"]
+---
+
+Connectez votre espace de travail Notion à l'agent pour qu'il puisse rechercher dans votre contenu Notion et l'utiliser comme contexte lors de la création de mises à jour de documentation. Le contexte supplémentaire provenant de la base de connaissances de votre équipe, des spécifications produit et de la documentation interne stockée dans Notion aide l'agent à créer une documentation plus précise et complète.
+
+<div id="connect-your-notion-workspace">
+  ## Connectez votre espace de travail Notion
+</div>
+
+1. Accédez à la page [Agent](https://dashboard.mintlify.com/products/agent) de votre Dashboard.
+2. Dans la section "Agent settings", cliquez sur **Install Notion app**.
+  <Frame>
+    <img src="/images/agent/install-apps-light.png" alt="La section des paramètres d'application avec les boutons d'installation de Slack, Linear et Notion." className="block dark:hidden" />
+    <img src="/images/agent/install-apps-dark.png" alt="La section des paramètres d'application avec les boutons d'installation de Slack, Linear et Notion." className="hidden dark:block" />
+  </Frame>
+3. Suivez les instructions pour autoriser Mintlify à accéder à votre espace de travail Notion.
+4. Sur l'écran d'autorisation de Notion, sélectionnez les pages et les bases de données à partager avec Mintlify.
+
+<div id="what-the-agent-can-do-with-notion">
+  ## Ce que l'agent peut faire avec Notion
+</div>
+
+L'intégration Notion utilise les [outils MCP](https://developers.notion.com/guides/mcp/mcp-supported-tools#mcp-tools) de Notion pour rechercher et lire le contenu de votre espace de travail.
+
+Votre contenu dans Notion devient un contexte supplémentaire que l'agent peut utiliser lors de la génération de documentation.
+
+Lorsque l'agent a accès à votre espace de travail Notion, il peut :
+
+- **Rechercher dans Notion** : Trouver des pages et des bases de données pertinentes dans votre espace de travail Notion connecté, en fonction du contexte de votre demande.
+- **Lire des pages Notion** : Accéder au contenu des pages Notion pour l'utiliser comme matériel de référence lors de la génération de documentation.
+- **Consulter des bases de données** : Extraire des données structurées des bases de données Notion pour alimenter les mises à jour de documentation.
+
+<div id="use-cases">
+  ## Cas d'utilisation
+</div>
+
+- **Synchroniser les spécifications produit avec la documentation** : Consulter les documents d'exigences produit et les spécifications de conception stockés dans Notion lors de la rédaction de la documentation des fonctionnalités.
+- **Documenter à partir de notes de réunion** : Indiquer à l'agent des notes de réunion ou des journaux de décisions dans Notion pour rédiger de la documentation à partir des discussions de l'équipe.
+- **S'appuyer sur les bases de connaissances internes** : Utiliser les wikis internes et les bases de connaissances dans Notion comme matériel source pour la documentation destinée au public.
+
+<div id="best-practices">
+  ## Bonnes pratiques
+</div>
+
+- **Délimitez l'accès avec soin** : N'accordez l'accès qu'aux pages et bases de données Notion contenant des informations pertinentes pour votre documentation.
+- **Fournissez des références spécifiques** : Lorsque vous donnez des instructions à l'agent, mentionnez la page ou la base de données Notion spécifique que vous souhaitez qu'il consulte pour obtenir de meilleurs résultats.
+- **Relisez le contenu généré** : Relisez toujours les pull requests (demandes de fusion) pour vous assurer que les informations provenant de Notion ont été correctement adaptées pour votre documentation publique.
diff --git a/fr/agent/slack.mdx b/fr/agent/slack.mdx
@@ -15,8 +15,8 @@ keywords: ["Intégration Slack", "Bot Slack", "Collaboration d'équipe", "Intég
 1. Accédez à la page [Agent](https://dashboard.mintlify.com/products/agent) de votre Dashboard.
 2. Dans la section "Agent settings", cliquez sur **Install Slack app**.
   <Frame>
-    <img src="/images/agent/install-apps-light.png" alt="La section des paramètres d'application avec les boutons d'installation de Slack et Linear." className="block dark:hidden" />
-    <img src="/images/agent/install-apps-dark.png" alt="La section des paramètres d'application avec les boutons d'installation de Slack et Linear." className="hidden dark:block" />
+    <img src="/images/agent/install-apps-light.png" alt="La section des paramètres d'application avec les boutons d'installation de Slack, Linear et Notion." className="block dark:hidden" />
+    <img src="/images/agent/install-apps-dark.png" alt="La section des paramètres d'application avec les boutons d'installation de Slack, Linear et Notion." className="hidden dark:block" />
   </Frame>
 3. Suivez les instructions Slack pour installer l'application `mintlify` dans votre espace de travail.
 4. Suivez les instructions Slack pour lier votre compte Mintlify à votre espace de travail Slack.

diff --git a/zh/agent/index.mdx b/zh/agent/index.mdx
@@ -56,6 +56,9 @@ Agent 只能访问你通过 Mintlify GitHub 应用连接的仓库。你可以在
 <Card title="连接 Linear" horizontal icon="linear" href="/zh/agent/linear">
   将 agent 添加到你的 Linear 工作区。
 </Card>
+<Card title="连接 Notion" horizontal icon="file-lines" href="/zh/agent/notion">
+  为 agent 授予对你的 Notion 工作区的访问权限。
+</Card>
 
 <Card title="自定义行为" horizontal icon="wrench" href="/zh/agent/customize">
   使用 `AGENTS.md` 文件配置 agent。

diff --git a/zh/agent/linear.mdx b/zh/agent/linear.mdx
@@ -13,8 +13,8 @@ keywords: ["issue tracking", "project management"]
 1. 在控制台中进入 [Agent](https://dashboard.mintlify.com/products/agent) 页面。
 2. 在 "Agent settings" 部分，点击 **Install Linear app**。
   <Frame>
-    <img src="/images/agent/install-apps-light.png" alt="应用设置区域，包含 Slack 和 Linear 安装按钮。" className="block dark:hidden" />
-    <img src="/images/agent/install-apps-dark.png" alt="应用设置区域，包含 Slack 和 Linear 安装按钮。" className="hidden dark:block" />
+    <img src="/images/agent/install-apps-light.png" alt="应用设置区域，包含 Slack、Linear 和 Notion 安装按钮。" className="block dark:hidden" />
+    <img src="/images/agent/install-apps-dark.png" alt="应用设置区域，包含 Slack、Linear 和 Notion 安装按钮。" className="hidden dark:block" />
   </Frame>
 3. 按照 Linear 的提示授权 Mintlify 应用访问你的工作区。
 

diff --git a/zh/agent/notion.mdx b/zh/agent/notion.mdx
@@ -0,0 +1,50 @@
+---
+title: "将 Notion 连接到 agent"
+description: "为 agent 授予对你的 Notion 工作区的访问权限，以便在更新文档时引用页面和数据库。"
+keywords: ["Notion", "integration", "knowledge base", "context"]
+---
+
+将你的 Notion 工作区连接到 agent，使其能够搜索你的 Notion 内容，并在创建文档更新时将其用作上下文。来自团队知识库、产品规格说明和存储在 Notion 中的内部文档的额外上下文，有助于 agent 创建更准确、更完整的文档。
+
+<div id="connect-your-notion-workspace">
+  ## 连接你的 Notion 工作区
+</div>
+
+1. 在控制台中进入 [Agent](https://dashboard.mintlify.com/products/agent) 页面。
+2. 在 "Agent settings" 部分，点击 **Install Notion app**。
+  <Frame>
+    <img src="/images/agent/install-apps-light.png" alt="应用设置区域，包含 Slack、Linear 和 Notion 安装按钮。" className="block dark:hidden" />
+    <img src="/images/agent/install-apps-dark.png" alt="应用设置区域，包含 Slack、Linear 和 Notion 安装按钮。" className="hidden dark:block" />
+  </Frame>
+3. 按照提示授权 Mintlify 访问你的 Notion 工作区。
+4. 在 Notion 的授权页面上，选择要与 Mintlify 共享的页面和数据库。
+
+<div id="what-the-agent-can-do-with-notion">
+  ## agent 可以用 Notion 做什么
+</div>
+
+Notion 集成使用 Notion 的 [MCP 工具](https://developers.notion.com/guides/mcp/mcp-supported-tools#mcp-tools) 来搜索和读取你工作区中的内容。
+
+你在 Notion 中的内容将成为 agent 生成文档时可使用的额外上下文。
+
+当 agent 可以访问你的 Notion 工作区时，它可以：
+
+- **搜索 Notion**：根据你请求的上下文，在已连接的 Notion 工作区中查找相关页面和数据库。
+- **阅读 Notion 页面**：访问 Notion 页面的内容，将其作为生成文档时的参考资料。
+- **查询数据库**：从 Notion 数据库中提取结构化数据，为文档更新提供依据。
+
+<div id="use-cases">
+  ## 使用场景
+</div>
+
+- **将产品规格同步到文档**：在编写功能文档时，引用存储在 Notion 中的产品需求文档和设计规格。
+- **根据会议记录编写文档**：将 agent 指向 Notion 中的会议记录或决策日志，基于团队讨论起草文档。
+- **利用内部知识库**：将 Notion 中的内部 wiki 和知识库作为面向公众的文档的素材来源。
+
+<div id="best-practices">
+  ## 最佳实践
+</div>
+
+- **谨慎控制访问范围**：仅授予 agent 对包含与你文档相关信息的 Notion 页面和数据库的访问权限。
+- **提供具体引用**：在给 agent 下达指令时，提及你希望它参考的具体 Notion 页面或数据库，以获得最佳效果。
+- **审查生成的内容**：始终审查拉取请求，确保来自 Notion 的信息已被恰当地调整，适用于你的公开文档。
diff --git a/zh/agent/slack.mdx b/zh/agent/slack.mdx
@@ -15,8 +15,8 @@ keywords: ["Slack 集成", "Slack 机器人", "团队协作", "agent 集成", "
 1. 在控制台中进入 [Agent](https://dashboard.mintlify.com/products/agent) 页面。
 2. 在 "Agent settings" 部分，点击 **Install Slack app**。
   <Frame>
-    <img src="/images/agent/install-apps-light.png" alt="应用设置区域，包含 Slack 和 Linear 安装按钮。" className="block dark:hidden" />
-    <img src="/images/agent/install-apps-dark.png" alt="应用设置区域，包含 Slack 和 Linear 安装按钮。" className="hidden dark:block" />
+    <img src="/images/agent/install-apps-light.png" alt="应用设置区域，包含 Slack、Linear 和 Notion 安装按钮。" className="block dark:hidden" />
+    <img src="/images/agent/install-apps-dark.png" alt="应用设置区域，包含 Slack、Linear 和 Notion 安装按钮。" className="hidden dark:block" />
   </Frame>
 3. 按照 Slack 的提示将 `mintlify` 应用安装到你的工作区。
 4. 按照 Slack 的提示将你的 Mintlify 账户关联到你的 Slack 工作区。