*MCP › Introducción*

# Inicio rápido de MCP

> Conecta un asistente, compruébalo con una herramienta de lectura y elige los permisos que necesita.

## En Claude, con OAuth

1. **Añadir el conector** En Claude, añade un conector personalizado con la URL `https://app.filmo.io/api/v1/mcp`. En Team y Enterprise lo añade un Owner; consulta [Conectar Claude](https://docs.filmo.io/es/mcp/connect/claude).
2. **Conectar** Abre el conector y elige Connect. Claude abre la pantalla de consentimiento de Filmo.
3. **Elegir los scopes** Un administrador de Filmo revisa los permisos (scopes). Los permisos de lectura que el cliente pidió vienen marcados; los de escritura, `workflows:run` y `ai:ask` empiezan siempre sin marcar.
4. **Preguntar** Pregunta: «¿A qué cuenta de Filmo estoy conectado?» El asistente debería llamar a [`filmo_account_get`](https://docs.filmo.io/es/mcp/tools/account/filmo-account-get).

## En Claude Code, con una clave de API

1. **Crear una clave** En la app, en la página API y MCP de los ajustes, crea una clave con los scopes de un preset (abajo).
2. **Expórtala** Define `FILMO_API_KEY` en tu entorno. No pongas nunca el valor en un archivo de un repositorio.
3. **Añadir el servidor** Ejecuta el comando de [Conectar Claude Code](https://docs.filmo.io/es/mcp/connect/claude-code).
4. **Preguntar** Haz la misma pregunta.

## Elegir un preset

Empieza con un preajuste de lectura: el cliente lista menos herramientas y el asistente no puede cambiar nada. Añade escrituras cuando confíes en sus decisiones.

| Preajuste | Permisos | Herramientas | Definiciones (caracteres) |
| --- | --- | --- | --- |
| Disponibilidad y agenda (lectura) | `availability:read`, `schedule:read`, `planner:read`, `staff:read`, `vehicles:read`, `items:read`, `spaces:read`, `kits:read`, `account:read` | 20 | 107.420 |
| CRM (lectura) | `contacts:read`, `crm:read`, `quotes:read`, `projects:read`, `tags:read`, `notes:read`, `users:read`, `account:read` | 18 | 90.993 |
| Operaciones de alquiler | `orders:read`, `orders:write`, `availability:read`, `items:read`, `contacts:read`, `account:read` | 21 | 158.716 |
| Finanzas (lectura) | `invoices:read`, `treasury:read`, `contracts:read`, `supplier-invoices:read`, `purchase-orders:read`, `account:read` | 20 | 113.977 |
| Todos los permisos de lectura | 31 | 76 | 422.451 |
| Todos los permisos | 59 | 170 | 1.049.688 |

> **Consejo:** Con OAuth, un preajuste solo funciona si el administrador marca esos permisos a mano. Para cambiar los permisos más tarde, quita el conector y vuelve a añadirlo. Más en [Límites y contexto](https://docs.filmo.io/es/mcp/guides/limits-and-context).

## Siguiente

- Tu cliente tiene su propia página: [Conectar](https://docs.filmo.io/es/mcp/overview#connect).
- [Escrituras seguras](https://docs.filmo.io/es/mcp/guides/safe-writes) antes de dar scopes de escritura a un asistente.
- [Prompts y recetas](https://docs.filmo.io/es/mcp/guides/prompts).

---

URL canónica: https://docs.filmo.io/es/mcp/quickstart  
Última actualización: 2026-10-25