Skip to content

docs: add Gumloop as default allowed MCP OAuth redirect #5309

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
mintlify wants to merge 3 commits into from
+6 −6
Closed

docs: add Gumloop as default allowed MCP OAuth redirect #5309

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
21003a7
docs: add Gumloop as default allowed MCP OAuth redirect host
mintlify[bot] Apr 13, 2026
8decc8e
docs: list Gumloop as common MCP redirect domain instead of default-a…
mintlify[bot] Apr 13, 2026
0830d24
docs: update MCP defaults to include Claude, Cursor, and Gumloop as p…
mintlify[bot] Apr 13, 2026
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
6 changes: 3 additions & 3 deletions ai/model-context-protocol.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@
The MCP search tool supports optional parameters that AI applications use to control and refine search results.

- **`pageSize`**: Number of results to return, between 1 and 50. Defaults to 10.
- **`scoreThreshold`**: Minimum relevance score between 0 and 1. Only returns results at or above this threshold. Use this to filter out low-relevance matches.

Check warning on line 41 in ai/model-context-protocol.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/model-context-protocol.mdx#L41 

Use 'preceding' instead of 'above'.
- **`version`**: Filter results to a specific documentation version. For example, `'v0.7'`. Only returns content tagged with the specified version or content available across all versions.
- **`language`**: Filter results to a specific language code. For example, `'en'`, `'zh'`, or `'es'`. Only returns content in the specified language or content available across all languages.

Expand Down Expand Up @@ -88,19 +88,19 @@

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.
By default, your MCP server allows connections from localhost tools, Claude Desktop (`claude.ai`), Cursor (`cursor://anysphere.cursor-mcp`), and Gumloop (`api.gumloop.com`). To allow additional tools to connect, add the redirect domains for those AI tools. 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.

Check warning on line 91 in ai/model-context-protocol.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/model-context-protocol.mdx#L91 

Did you really mean 'Gumloop'?

<Steps>
<Step title="Enable authenticated MCP in your dashboard">
1. Navigate to the [MCP server page](https://dashboard.mintlify.com/products/mcp) in your dashboard.
2. Click the **Enable MCP Server** toggle.
</Step>
<Step title="Add redirect domains">
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`.
Add the redirect domains for any additional 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.

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:`.

Loopback addresses (`localhost`, `127.0.0.1`) are always trusted and do not need to be added.
Loopback addresses (`localhost`, `127.0.0.1`), `claude.ai`, `cursor://anysphere.cursor-mcp`, and `api.gumloop.com` are always trusted and do not need to be added.
</Step>
</Steps>

Expand Down
6 changes: 3 additions & 3 deletions fr/ai/model-context-protocol.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -105,7 +105,7 @@ Si votre documentation utilise une authentification partielle avec des pages pub

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.
Par défaut, votre serveur MCP autorise les connexions depuis les outils localhost, Claude Desktop (`claude.ai`), Cursor (`cursor://anysphere.cursor-mcp`) et Gumloop (`api.gumloop.com`). Pour autoriser d’autres outils à se connecter, ajoutez les domaines de redirection de ces 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. Les outils d’IA de vos utilisateurs ne peuvent pas finaliser l’authentification si leur domaine de redirection ne figure pas dans cette liste.

<Steps>
<Step title="Activer le MCP avec authentification dans votre Dashboard">
Expand All @@ -114,11 +114,11 @@ Par défaut, votre serveur MCP est uniquement disponible pour les outils localho
</Step>

<Step title="Ajouter des domaines de redirection">
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`.
Ajoutez les domaines de redirection de tout outil d’IA supplémentaire auxquel 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.

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:`.

Les adresses loopback (`localhost`, `127.0.0.1`) sont toujours approuvées et n’ont pas besoin d’être ajoutées.
Les adresses loopback (`localhost`, `127.0.0.1`), `claude.ai`, `cursor://anysphere.cursor-mcp` et `api.gumloop.com` sont toujours approuvées et n’ont pas besoin d’être ajoutées.
</Step>
</Steps>

Expand Down
Loading