fastmcp/examples/auth/scalekit_oauth/README.md

Scalekit OAuth Example

Demonstrates FastMCP server protection with Scalekit OAuth.

Setup

1. Configure MCP server in Scalekit environment

Create a Scalekit Account:

• Go to Scalekit Dashboard
• Copy your Environment URL from Developers → Settings
• Copy Resource ID (res_xxx) from Developers → MCP Servers

Register Your MCP Server:

• Go to MCP Servers → Create New Server
• Fill in your MCP server details
• Note the Resource ID (e.g., res_123)

Create a .env file:

# Required Scalekit credentials
SCALEKIT_ENVIRONMENT_URL=<YOUR_APP_ENVIRONMENT_URL>
SCALEKIT_RESOURCE_ID=<YOUR_APP_RESOURCE_ID> # res_926EXAMPLE5878
BASE_URL=http://127.0.0.1:8000/
# Optional: additional scopes tokens must include (comma-separated)
# SCALEKIT_REQUIRED_SCOPES=read,write

2. Run the Example

Start the server:

# From this directory
uv run python server.py

The server will start on http://127.0.0.1:8000/mcp with Scalekit OAuth authentication enabled.

Test with client:

uv run python client.py

The client.py will:

1. Attempt to connect to the server
2. Detect that OAuth authentication is required
3. Open a browser for Scalekit authentication
4. Complete the OAuth flow and connect to the server
5. Demonstrate calling authenticated tools