Connecting Claude Desktop
Add footage.one to Claude Desktop — enter the server URL and sign in via OAuth2.
Prerequisites
- Claude Desktop installed
- footage.one account with active login
Adding the server
Claude Desktop supports adding MCP servers directly via a URL — no config file needed.
- Open Claude Desktop.
- Open Settings → Connectors (or Custom connectors).
- Click Add custom connector.
- Enter the URL:
https://mcp.footage.one/mcp - Confirm.
Login via OAuth
On the first tool call, Claude Desktop opens a browser tab with the footage.one login. Sign in with your regular account. After a successful login the tab closes automatically — Claude Desktop now has access.
OAuth tokens are securely managed by Claude Desktop and refreshed as needed.
First test
Ask Claude:
List the first five albums from footage.one and for each album show the number of assets.
Claude calls list_albums, fetches additional data for each album and responds in a structured format.
Common errors
| Symptom | Cause |
|---|---|
| "Server not found" | URL typo or network issue |
| Browser tab does not open | Check default browser setting, check pop-up blocker |
| "Unauthorised" after login | Account has no access — try a different user |
| No tools visible | Restart Claude Desktop |
API token instead of OAuth?
Currently the OAuth flow is the only supported method in Claude Desktop. API tokens (from your account) are primarily intended for headless clients — direct REST calls, custom Python scripts, n8n. Token-based auth in Claude Desktop is in progress but not yet available.