mintlify · ethanpalm · Jul 8, 2026 · Jul 8, 2026 · Jul 8, 2026
diff --git a/assistant/use.mdx b/assistant/use.mdx
@@ -123,3 +123,17 @@ Limits:
   Submit a false positive report to [EasyList](https://github.com/easylist/easylist) to request removal of the rule. This resolves the issue for all users once the filter list updates.
 
 </Accordion>
+
+<Accordion title="Assistant blocked on a corporate network, VPN, or firewall">
+  If the assistant loads on personal networks but fails on a work network, VPN, or other restricted network, the block is happening at the network level rather than on the documentation site itself. Corporate proxies, VPNs, and firewalls sometimes block the outbound requests the assistant needs to make, so the chat panel cannot connect even though the rest of the site loads normally.
+
+  **For readers:** Ask your IT team to allow outbound HTTPS requests to the following hostnames from your network. If you can, try the assistant from a personal network to confirm the issue is network-specific.
+
+  - `leaves.mintlify.com` — assistant API
+  - `*.mintlify.dev` — assistant streaming and supporting services
+  - `*.mintlify.com` — dashboard, API, and analytics
+  - `hcaptcha.com` and `*.hcaptcha.com` — CAPTCHA verification for the assistant
+
+  **For site owners:** If a reader reports that the assistant does not load on their corporate network or VPN, this is almost always an outbound network block rather than a problem with your documentation. Point them at the hostnames above and suggest they share the list with their IT team. This is a network-level allowlist that applies to the visitor's device or network, not something you can configure from your site. If you self-host behind a reverse proxy that overwrites the default CSP, see [CSP configuration](/deploy/csp-configuration) for the domains to allow.
+
+</Accordion>
diff --git a/es/assistant/use.mdx b/es/assistant/use.mdx
@@ -139,3 +139,17 @@ Límites:
   Envía un reporte de falso positivo a [EasyList](https://github.com/easylist/easylist) para solicitar la eliminación de la regla. Esto resuelve el problema para todos los usuarios una vez que se actualice la lista de filtros.
 
 </Accordion>
+
+<Accordion title="Assistant bloqueado en una red corporativa, VPN o firewall">
+  Si el assistant se carga en redes personales pero falla en una red del trabajo, VPN u otra red restringida, el bloqueo está ocurriendo a nivel de red y no en el sitio de documentación. Los proxies corporativos, las VPN y los firewalls a veces bloquean las solicitudes salientes que el assistant necesita hacer, por lo que el panel de chat no puede conectarse aunque el resto del sitio se cargue con normalidad.
+
+  **Para lectores:** Pídele a tu equipo de TI que permita solicitudes HTTPS salientes a los siguientes hosts desde tu red. Si puedes, prueba el assistant desde una red personal para confirmar que el problema es específico de la red.
+
+  - `leaves.mintlify.com` — API del assistant
+  - `*.mintlify.dev` — streaming del assistant y servicios de soporte
+  - `*.mintlify.com` — dashboard, API y analíticas
+  - `hcaptcha.com` y `*.hcaptcha.com` — verificación CAPTCHA para el assistant
+
+  **Para propietarios del sitio:** Si un lector informa que el assistant no se carga en su red corporativa o VPN, casi siempre se trata de un bloqueo de red saliente y no de un problema con tu documentación. Indícale los hosts anteriores y sugiérele que comparta la lista con su equipo de TI. Se trata de una lista de permitidos a nivel de red que se aplica al dispositivo o la red del visitante, no algo que puedas configurar desde tu sitio. Si tu documentación está autoalojada detrás de un proxy inverso que sobrescribe la CSP predeterminada, consulta [Configuración de CSP](/es/deploy/csp-configuration) para conocer los dominios que debes permitir.
+
+</Accordion>
diff --git a/fr/assistant/use.mdx b/fr/assistant/use.mdx
@@ -139,3 +139,17 @@ Limites :
   Signalez un faux positif à [EasyList](https://github.com/easylist/easylist) pour demander la suppression de la règle. Cela résout le problème pour tous les utilisateurs une fois la liste de filtres mise à jour.
 
 </Accordion>
+
+<Accordion title="Assistant bloqué sur un réseau d'entreprise, un VPN ou un pare-feu">
+  Si l'assistant se charge sur des réseaux personnels mais échoue sur un réseau professionnel, un VPN ou un autre réseau restreint, le blocage se produit au niveau du réseau et non sur le site de documentation lui-même. Les proxys d'entreprise, les VPN et les pare-feu bloquent parfois les requêtes sortantes dont l'assistant a besoin, de sorte que le panneau de chat ne peut pas se connecter même si le reste du site se charge normalement.
+
+  **Pour les lecteurs :** Demandez à votre équipe informatique d'autoriser les requêtes HTTPS sortantes vers les hôtes suivants depuis votre réseau. Si vous le pouvez, essayez l'assistant depuis un réseau personnel pour confirmer que le problème est spécifique au réseau.
+
+  - `leaves.mintlify.com` — API de l'assistant
+  - `*.mintlify.dev` — streaming de l'assistant et services associés
+  - `*.mintlify.com` — tableau de bord, API et analyses
+  - `hcaptcha.com` et `*.hcaptcha.com` — vérification CAPTCHA pour l'assistant
+
+  **Pour les propriétaires de site :** Si un lecteur signale que l'assistant ne se charge pas sur son réseau d'entreprise ou son VPN, il s'agit presque toujours d'un blocage réseau sortant et non d'un problème avec votre documentation. Indiquez-lui les hôtes ci-dessus et suggérez-lui de partager la liste avec son équipe informatique. Il s'agit d'une liste d'autorisation au niveau réseau qui s'applique à l'appareil ou au réseau du visiteur, et non de quelque chose que vous pouvez configurer depuis votre site. Si votre documentation est auto-hébergée derrière un proxy inverse qui écrase la CSP par défaut, consultez [Configuration de la CSP](/fr/deploy/csp-configuration) pour les domaines à autoriser.
+
+</Accordion>
diff --git a/zh/assistant/use.mdx b/zh/assistant/use.mdx
@@ -139,3 +139,17 @@ https://yourdocs.mintlify.site/quickstart?assistant=How%20do%20I%20get%20started
   向 [EasyList](https://github.com/easylist/easylist) 提交误报报告以请求移除该规则。一旦过滤列表更新，这将为所有用户解决此问题。
 
 </Accordion>
+
+<Accordion title="AI 助手在公司网络、VPN 或防火墙下被阻止">
+  如果 AI 助手在个人网络上可以加载，但在工作网络、VPN 或其他受限网络下无法加载，则该阻止发生在网络层面，而不是文档站点本身。企业代理、VPN 和防火墙有时会阻止 AI 助手需要发起的出站请求，因此即使站点的其他部分能够正常加载，聊天面板也无法连接。
+
+  **对读者：** 请你的 IT 团队允许从你的网络向以下主机发起出站 HTTPS 请求。如果可以，请尝试从个人网络使用 AI 助手，以确认问题是网络特定的。
+
+  - `leaves.mintlify.com` — AI 助手 API
+  - `*.mintlify.dev` — AI 助手流式传输和相关服务
+  - `*.mintlify.com` — 仪表盘、API 和分析
+  - `hcaptcha.com` 和 `*.hcaptcha.com` — AI 助手的 CAPTCHA 验证
+
+  **对站点所有者：** 如果读者报告 AI 助手在其公司网络或 VPN 下无法加载，几乎总是出站网络阻止的问题，而不是你的文档存在问题。请将上述主机告知他们，并建议他们把该列表分享给其 IT 团队。这是应用于访问者设备或网络的网络层允许列表，无法通过你的站点进行配置。如果你在覆盖默认 CSP 的反向代理后自托管，请参阅 [CSP 配置](/zh/deploy/csp-configuration)，了解需要允许的域名。
+
+</Accordion>