Connecting MCP via OAuth (Claude Desktop / Claude.ai)

Metapad supports OAuth authentication for MCP connections. This means you can connect Claude Desktop or Claude.ai to your Metapad models by simply logging in with your existing Metapad account — no need to create or manage API tokens.

How It Works

When you add Metapad as an MCP server in Claude Desktop or Claude.ai:

The MCP client (Claude) discovers Metapad's authentication requirements automatically
A login window opens where you sign in with your existing Metapad credentials
After login, Claude receives a secure token and can access your models
You get access to all models you own or are a member of — same as in the web app

Connecting Claude Desktop via OAuth

Open Claude Desktop settings
Add a new MCP Server:
- Type: HTTP
- URL: https://app.metapad.ai/mcp/{model_id}
When Claude Desktop connects, it will detect OAuth support and open a browser window
Log in with your Metapad credentials
Authorize the connection
Claude Desktop is now connected and can query/edit your model

Connecting Claude.ai Custom Connector

In Claude.ai, go to Integrations or Custom Connectors
Add Metapad's MCP endpoint URL
Claude.ai will handle the OAuth flow automatically
Log in when prompted
Your Metapad tools are now available in Claude.ai conversations

OAuth vs API Tokens

Feature	OAuth	API Token (`mpt_...`)
Setup	Just log in	Create and copy token
Scope	All your models	One specific model
Identity	Your name shown to collaborators	Generic "mcp-api" label
Rotation	Automatic (tokens refresh)	Manual rotation
Best for	Interactive use (Claude Desktop, Claude.ai)	CI/CD, scripts, automation

Collaboration Attribution

When you connect via OAuth, your changes are attributed to your name — other collaborators will see "Alice is editing via MCP" instead of the generic "mcp-api" label used with API tokens.

Requirements

A Metapad account (same credentials you use for the web app)
Pro plan or higher
Claude Desktop or Claude.ai with MCP support

Tips

OAuth is the easiest way to connect — no tokens to manage
Your session stays active with automatic token refresh
For scripts and automation, API tokens (mpt_...) are still the better choice
Both authentication methods can be used simultaneously