Skip to content

Document MCP redirect domains for authenticated docs #4171

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 1 commit into from
+18 −0
Closed

Document MCP redirect domains for authenticated docs #4171

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
18 changes: 18 additions & 0 deletions ai/model-context-protocol.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,24 @@

View and copy your MCP server URL on the [MCP server page](https://dashboard.mintlify.com/products/mcp) in your dashboard.

### MCP server settings for authenticated documentation

If your documentation uses authentication, the MCP server page in your dashboard includes additional settings.

**Enable MCP server**: Toggle to allow AI applications to connect to your documentation via MCP. When disabled, AI applications cannot access your MCP server. This setting only appears for documentation with authentication enabled.

**Redirect domains**: Configure trusted domains for OAuth callbacks. When users authenticate with your MCP server, the OAuth flow redirects them back to an approved domain. Add domains where your users' AI applications are hosted to allow these redirects.

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

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/model-context-protocol.mdx#L60 

In general, use active voice instead of passive voice ('are hosted').

To add a redirect domain:

1. Navigate to the [MCP server page](https://dashboard.mintlify.com/products/mcp) in your dashboard.
2. In the **Redirect domains** section, enter a hostname (for example, `example.com`).

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

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/model-context-protocol.mdx#L65 

Did you really mean 'hostname'?
3. Select **Add domain**.

<Note>
Redirect domains only accept valid hostnames. You can enter a full URL and Mintlify extracts the hostname automatically.

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

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/model-context-protocol.mdx#L69 

Did you really mean 'hostnames'?

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

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/model-context-protocol.mdx#L69 

Did you really mean 'hostname'?
</Note>

<Frame>
<img src="/images/mcp/mcp-server-page-light.png" alt="MCP server page in the dashboard." className="block dark:hidden" />
<img src="/images/mcp/mcp-server-page-dark.png" alt="MCP server page in the dashboard." className="hidden dark:block" />
Expand Down