Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 6 additions & 4 deletions ai/model-context-protocol.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -190,16 +190,18 @@ If your site has partial authentication with both public and protected pages, yo

The `/authed/mcp` endpoint uses its own OAuth flow at `/authed/mcp/oauth/*`. Redirect domains configured for your MCP server apply to both `/mcp` and `/authed/mcp`.

By default, your MCP server is only available for localhost tools. To allow web-based tools to connect, add the redirect domains for the AI tools. A redirect domain is the hostname that an AI tool uses after a user completes authentication like `claude.ai` or `app.cursor.ai`. Your users' AI tools cannot complete authentication unless their redirect domain is on this list.
Popular MCP clients such as Claude, ChatGPT, Cursor, and Devin are always allowed to complete authentication against your MCP server. You do not need to add these clients to any allowlist.

Mintlify enables your hosted MCP server automatically when your site has [authentication](/deploy/authentication-setup) configured. To allow AI tools to complete authentication, add their redirect domains in your dashboard.
To let other web-based tools connect, add their redirect domains in your dashboard. A redirect domain is the hostname that an AI tool uses after a user completes authentication. Your users' AI tools cannot complete authentication unless their redirect domain is on this list or the tool is one of the always-allowed clients.

Mintlify enables your hosted MCP server automatically when your site has [authentication](/deploy/authentication-setup) configured.

<Steps>
<Step title="Open the hosted MCP settings">
In your dashboard, go to **Settings → Security & access → MCP**.
</Step>
<Step title="Add allowed OAuth redirect URIs">
Under **Allowed OAuth redirect URIs**, add the redirect domains for the AI tools you want to grant your users access to. Your users' AI tools cannot complete authentication unless their redirect domain is on this list. Common redirect domains include `claude.ai` and `vscode.dev/redirect`.
<Step title="Add custom redirect domains">
Under **Allowed OAuth redirect URIs**, add the redirect domains for any additional AI tools you want to grant your users access to. You only need to add domains for clients that aren't already on the always-allowed list.

By default, redirect domains use `https://`. To allow a custom protocol scheme, include the full protocol in the domain entry. For example, a native app callback like `myapp://callback`. Mintlify always blocks dangerous protocols such as `javascript:`, `data:`, and `file:`.

Expand Down
10 changes: 6 additions & 4 deletions es/ai/model-context-protocol.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -208,17 +208,19 @@ Si tu sitio tiene autenticación parcial con páginas públicas y protegidas, di

El endpoint `/authed/mcp` utiliza su propio flujo OAuth en `/authed/mcp/oauth/*`. Los dominios de redirección configurados para tu servidor MCP se aplican tanto a `/mcp` como a `/authed/mcp`.

De forma predeterminada, tu servidor MCP solo está disponible para herramientas en localhost. Para permitir que se conecten herramientas basadas en la web, agrega los dominios de redirección de las herramientas de IA. Un dominio de redirección es el nombre de host que usa una herramienta de IA después de que un usuario completa la autenticación, como `claude.ai` o `app.cursor.ai`. Las herramientas de IA de tus usuarios no pueden completar la autenticación a menos que su dominio de redirección esté en esta lista.
Los clientes MCP populares como Claude, ChatGPT, Cursor y Devin siempre están permitidos para completar la autenticación contra tu servidor MCP. No necesitas agregar estos clientes a ninguna lista de permitidos.

Mintlify habilita tu servidor MCP alojado automáticamente cuando tu sitio tiene [autenticación](/es/deploy/authentication-setup) configurada. Para permitir que las herramientas de IA completen la autenticación, agrega sus dominios de redirección en tu dashboard.
Para permitir que otras herramientas basadas en la web se conecten, agrega sus dominios de redirección en tu dashboard. Un dominio de redirección es el nombre de host que usa una herramienta de IA después de que un usuario completa la autenticación. Las herramientas de IA de tus usuarios no pueden completar la autenticación a menos que su dominio de redirección esté en esta lista o la herramienta sea uno de los clientes siempre permitidos.

Mintlify habilita tu servidor MCP alojado automáticamente cuando tu sitio tiene [autenticación](/es/deploy/authentication-setup) configurada.

<Steps>
<Step title="Abrir la configuración del MCP alojado">
En tu dashboard, ve a **Settings → Security & access → MCP**.
</Step>

<Step title="Agregar URIs de redirección OAuth permitidos">
En **Allowed OAuth redirect URIs**, agrega los dominios de redirección de las herramientas de IA a las que quieres dar acceso a tus usuarios. Las herramientas de IA de tus usuarios no pueden completar la autenticación a menos que su dominio de redirección esté en esta lista. Entre los dominios de redirección más comunes están `claude.ai` y `vscode.dev/redirect`.
<Step title="Agregar dominios de redirección personalizados">
En **Allowed OAuth redirect URIs**, agrega los dominios de redirección de las herramientas de IA adicionales a las que quieres dar acceso a tus usuarios. Solo necesitas agregar dominios para clientes que no estén ya en la lista de siempre permitidos.

De forma predeterminada, los dominios de redirección utilizan `https://`. Para permitir un esquema de protocolo personalizado, incluye el protocolo completo en la entrada del dominio. Por ejemplo, un callback de aplicación nativa como `myapp://callback`. Mintlify siempre bloquea protocolos peligrosos como `javascript:`, `data:` y `file:`.

Expand Down
10 changes: 6 additions & 4 deletions fr/ai/model-context-protocol.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -208,17 +208,19 @@ Si votre site utilise une authentification partielle avec des pages publiques et

L’endpoint `/authed/mcp` utilise son propre flux OAuth à `/authed/mcp/oauth/*`. Les domaines de redirection configurés pour votre serveur MCP s’appliquent à la fois à `/mcp` et à `/authed/mcp`.

Par défaut, votre serveur MCP est uniquement disponible pour les outils localhost. Pour autoriser les outils web à se connecter, ajoutez les domaines de redirection des outils d’IA. Un domaine de redirection est le nom d’hôte qu’un outil d’IA utilise une fois l’authentification terminée, comme `claude.ai` ou `app.cursor.ai`. Les outils d’IA de vos utilisateurs ne peuvent pas finaliser l’authentification si leur domaine de redirection ne figure pas dans cette liste.
Les clients MCP populaires tels que Claude, ChatGPT, Cursor et Devin sont toujours autorisés à finaliser l’authentification auprès de votre serveur MCP. Vous n’avez pas besoin d’ajouter ces clients à une liste d’autorisations.

Mintlify active automatiquement votre serveur MCP hébergé lorsque votre site a l'[authentification](/fr/deploy/authentication-setup) configurée. Pour permettre aux outils d'IA de terminer l'authentification, ajoutez leurs domaines de redirection dans votre Dashboard.
Pour permettre à d’autres outils web de se connecter, ajoutez leurs domaines de redirection dans votre Dashboard. Un domaine de redirection est le nom d’hôte qu’un outil d’IA utilise une fois l’authentification terminée. Les outils d’IA de vos utilisateurs ne peuvent pas finaliser l’authentification si leur domaine de redirection ne figure pas dans cette liste ou si l’outil ne fait pas partie des clients toujours autorisés.

Mintlify active automatiquement votre serveur MCP hébergé lorsque votre site a l'[authentification](/fr/deploy/authentication-setup) configurée.

<Steps>
<Step title="Ouvrir les paramètres du MCP hébergé">
Dans votre Dashboard, accédez à **Settings → Security & access → MCP**.
</Step>

<Step title="Ajouter des URIs de redirection OAuth autorisés">
Sous **Allowed OAuth redirect URIs**, ajoutez les domaines de redirection des outils d’IA auxquels vous souhaitez donner accès à vos utilisateurs. Les outils d’IA de vos utilisateurs ne peuvent pas finaliser l’authentification si leur domaine de redirection ne figure pas dans cette liste. Les domaines de redirection courants incluent `claude.ai` et `vscode.dev/redirect`.
<Step title="Ajouter des domaines de redirection personnalisés">
Sous **Allowed OAuth redirect URIs**, ajoutez les domaines de redirection des outils d’IA supplémentaires auxquels vous souhaitez donner accès à vos utilisateurs. Vous n’avez besoin d’ajouter que les domaines des clients qui ne figurent pas déjà dans la liste des clients toujours autorisés.

Par défaut, les domaines de redirection utilisent `https://`. Pour autoriser un schéma de protocole personnalisé, incluez le protocole complet dans l’entrée du domaine. Par exemple, un callback d’application native comme `myapp://callback`. Mintlify bloque toujours les protocoles dangereux tels que `javascript:`, `data:` et `file:`.

Expand Down
10 changes: 6 additions & 4 deletions zh/ai/model-context-protocol.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -207,17 +207,19 @@ MCP 客户端可以利用这些注解向用户呈现工具的安全性信息,

`/authed/mcp` 端点使用其专属的 OAuth 流程,位于 `/authed/mcp/oauth/*`。为你的 MCP 服务器配置的重定向域名同时适用于 `/mcp` 和 `/authed/mcp`。

默认情况下,你的 MCP 服务器仅适用于 localhost 工具。要允许基于 Web 的工具连接,请添加这些 AI 工具的重定向域名。重定向域名是指用户完成认证后,AI 工具使用的主机名,例如 `claude.ai` 或 `app.cursor.ai`。如果用户的 AI 工具的重定向域名不在此列表中,就无法完成认证
Claude、ChatGPT、Cursor 和 Devin 等常见 MCP 客户端始终被允许对你的 MCP 服务器完成认证。你无需将这些客户端添加到任何允许列表

当你的站点配置了[认证](/zh/deploy/authentication-setup)时,托管 MCP 服务器会自动启用。要允许 AI 工具完成认证,请在控制台中添加它们的重定向域。
要允许其他基于 Web 的工具连接,请在控制台中添加它们的重定向域名。重定向域名是指用户完成认证后,AI 工具使用的主机名。如果用户的 AI 工具的重定向域名不在此列表中,且该工具不属于始终允许的客户端,就无法完成认证。

当你的站点配置了[认证](/zh/deploy/authentication-setup)时,托管 MCP 服务器会自动启用。

<Steps>
<Step title="打开托管 MCP 设置">
在控制台中,前往 **Settings → Security & access → MCP**。
</Step>

<Step title="添加允许的 OAuth 重定向 URI">
在 **Allowed OAuth redirect URIs** 下,添加你希望向用户开放访问权限的 AI 工具的重定向域名。如果用户的 AI 工具的重定向域名不在此列表中,就无法完成认证。常见的重定向域名包括 `claude.ai` 和 `vscode.dev/redirect`
<Step title="添加自定义重定向域名">
在 **Allowed OAuth redirect URIs** 下,添加你希望向用户开放访问权限的其他 AI 工具的重定向域名。你只需为不在始终允许列表中的客户端添加域名

默认情况下,重定向域名使用 `https://`。要允许自定义协议方案,请在域名条目中包含完整协议。例如,原生应用回调如 `myapp://callback`。Mintlify 始终阻止危险协议,如 `javascript:`、`data:` 和 `file:`。

Expand Down
Loading