Introduction
MCP quickstart
Connect one assistant, check it with a read tool and choose the scopes it needs.
In Claude, with OAuth
Link to this section: In Claude, with OAuthAdd the connector
In Claude, add a custom connector with the URL
https://. On Team and Enterprise an Owner adds it; see Connect Claude.app. filmo. io /api /v1 /mcp Connect
Open the connector and choose Connect. Claude opens Filmo's consent screen.
Choose the scopes
A Filmo administrator checks the scopes. Read scopes the client asked for come checked; writes,
workflows:runandai:askalways start unchecked.Ask
Ask: “Which Filmo account am I connected to?” The assistant should call
filmo_account_get.
In Claude Code, with an API key
Link to this section: In Claude Code, with an API keyCreate a key
In the app, in the API and MCP page of the settings, create a key with a preset's scopes (below).
Export it
Set
FILMO_API_KEYin your environment. Never put the value in a file of a repository.Add the server
Run the command from Connect Claude Code.
Ask
Ask the same question.
Choose a preset
Link to this section: Choose a presetStart with a read preset: the client lists fewer tools and the assistant cannot change anything. Add writes when you trust its choices.
| Preset | Scopes | Tools | Definitions (characters) |
|---|---|---|---|
| Availability and schedule (read) | availability:read, schedule:read, planner:read, staff:read, vehicles:read, items:read, spaces:read, kits:read, account:read | 20 | 107,420 |
| CRM (read) | contacts:read, crm:read, quotes:read, projects:read, tags:read, notes:read, users:read, account:read | 18 | 90,993 |
| Rental operations | orders:read, orders:write, availability:read, items:read, contacts:read, account:read | 21 | 158,716 |
| Finance (read) | invoices:read, treasury:read, contracts:read, supplier-invoices:read, purchase-orders:read, account:read | 20 | 113,977 |
| Every read scope | 31 | 76 | 422,451 |
| Every scope | 59 | 170 | 1,049,688 |
With OAuth, a preset only works if the administrator checks those scopes by hand. To change scopes later, remove the connector and add it again. More in Limits and context.
- Your client has its own page: Connect.
- Safe writes before you give an assistant write scopes.
- Prompts and recipes.
Related pages
Link to this section: Related pagesIntroduction
MCP server
Connect an AI assistant to your Filmo account. It can use exactly the tools its key or connection allows.
Connect
Connect Claude
Add Filmo to Claude on the web or the desktop app as a custom connector.
Connect
Connect Claude Code
Add Filmo to Claude Code with OAuth, or with an API key that stays out of your repository.
Was this page helpful?