mirror of
https://github.com/PrefectHQ/fastmcp.git
synced 2026-08-09 07:09:11 +02:00
9b248a15b3* Update repository references from jlowin/fastmcp to prefecthq/fastmcp * Retrigger CI after repo transfer * chore: Update SDK documentation * Only run deep triage on bug issues for jlowin --------- Co-authored-by: marvin-context-protocol[bot] <225465937+marvin-context-protocol[bot]@users.noreply.github.com>
60 lines
2.2 KiB
Text
60 lines
2.2 KiB
Text
---
|
|
title: descope
|
|
sidebarTitle: descope
|
|
---
|
|
|
|
# `fastmcp.server.auth.providers.descope`
|
|
|
|
|
|
Descope authentication provider for FastMCP.
|
|
|
|
This module provides DescopeProvider - a complete authentication solution that integrates
|
|
with Descope's OAuth 2.1 and OpenID Connect services, supporting Dynamic Client Registration (DCR)
|
|
for seamless MCP client authentication.
|
|
|
|
|
|
## Classes
|
|
|
|
### `DescopeProvider` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/src/fastmcp/server/auth/providers/descope.py#L25" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
|
|
|
|
|
|
Descope metadata provider for DCR (Dynamic Client Registration).
|
|
|
|
This provider implements Descope integration using metadata forwarding.
|
|
This is the recommended approach for Descope DCR
|
|
as it allows Descope to handle the OAuth flow directly while FastMCP acts
|
|
as a resource server.
|
|
|
|
IMPORTANT SETUP REQUIREMENTS:
|
|
|
|
1. Create an MCP Server in Descope Console:
|
|
- Go to the [MCP Servers page](https://app.descope.com/mcp-servers) of the Descope Console
|
|
- Create a new MCP Server
|
|
- Ensure that **Dynamic Client Registration (DCR)** is enabled
|
|
- Note your Well-Known URL
|
|
|
|
2. Note your Well-Known URL:
|
|
- Save your Well-Known URL from [MCP Server Settings](https://app.descope.com/mcp-servers)
|
|
- Format: ``https://.../v1/apps/agentic/P.../M.../.well-known/openid-configuration``
|
|
|
|
For detailed setup instructions, see:
|
|
https://docs.descope.com/identity-federation/inbound-apps/creating-inbound-apps#method-2-dynamic-client-registration-dcr
|
|
|
|
|
|
**Methods:**
|
|
|
|
#### `get_routes` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/src/fastmcp/server/auth/providers/descope.py#L154" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
|
|
|
|
```python
|
|
get_routes(self, mcp_path: str | None = None) -> list[Route]
|
|
```
|
|
|
|
Get OAuth routes including Descope authorization server metadata forwarding.
|
|
|
|
This returns the standard protected resource routes plus an authorization server
|
|
metadata endpoint that forwards Descope's OAuth metadata to clients.
|
|
|
|
**Args:**
|
|
- `mcp_path`: The path where the MCP endpoint is mounted (e.g., "/mcp")
|
|
This is used to advertise the resource URL in metadata.
|
|
|