*MCP › Conectar*

# Conecta Cursor

> Añade Filmo a Cursor con OAuth o con una clave de API leída de tu entorno.

## Antes de empezar

| Qué | Lo que documenta el proveedor |
| --- | --- |
| Plan | La página de MCP no indica ningún requisito de plan. |
| Quién añade el conector | Tú, en `mcp.json`. Los equipos aprueban los servidores en Dashboard › Plugins & MCPs; los administradores pueden restringir las URL remotas a patrones. |
| Quién conecta | Cada usuario se autentica en el cliente. |
| Administración | Lista de URL permitidas, listas de herramientas permitidas para ejecución automática y lista de red denegada. |

verificado el 2026-10-09: [MCP en Cursor](https://cursor.com/docs/context/mcp) · [Enlaces de instalación](https://cursor.com/docs/context/mcp/install-links)

> **Usa exactamente esta URL:** Escribe `https://app.filmo.io/api/v1/mcp` tal cual. No uses el dominio de Filmo de tu empresa ni otro host: los metadatos de OAuth nombran este origen, y un cliente que lo compara con lo que escribiste rechaza uno distinto.

## Conecta con OAuth

1. **Añadir el servidor sin cabeceras** Pon una entrada solo con `url` en `~/.cursor/mcp.json` (todos los proyectos) o `.cursor/mcp.json` (un proyecto). Cursor ejecuta el flujo de OAuth para los servidores que lo necesitan.
2. **Autenticar** Inicia sesión cuando Cursor te lo pida y da tu consentimiento en Filmo.

- `auth.scopes` fija los permisos (scopes); sin él, Cursor descubre `scopes_supported` a partir de los metadatos del servidor de autorización.
- Qué hace Cursor con el `scope` de un desafío 401: el proveedor no lo documenta.

## La pantalla de consentimiento

- Solo vienen marcados los permisos `*:read` que pidió el cliente (todos los de lectura si no pide ninguno).
- Los de escritura, `workflows:run` y `ai:ask` salen siempre desmarcados, aunque el cliente los pida; los que pidió llevan la etiqueta «Lo pide la integración».
- Marca a mano solo lo que el asistente necesita y deja `ai:ask` desmarcado salvo que quieras que gaste créditos de IA.

Para cambiar los permisos más adelante, quita el conector y vuelve a añadirlo.

Antes de aprobar, lee [Autenticación](https://docs.filmo.io/es/mcp/authentication#before-you-approve).

## Conecta con una clave de API

1. **Exportar la clave** Define `FILMO_API_KEY` en el entorno desde el que arranca Cursor.
2. **Haz referencia a ella** Cursor resuelve `${env:NAME}` en `url` y `headers`, así que el fichero no contiene ningún valor. Prefiere `~/.cursor/mcp.json`, que no forma parte de ningún repositorio.

*mcp.json*

```json
{
  "mcpServers": {
    "filmo": {
      "url": "https://app.filmo.io/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:FILMO_API_KEY}"
      }
    }
  }
}
```

> **Deja la clave fuera del repositorio:** No pegues nunca una clave de API en un fichero que vaya a control de versiones. Los ejemplos la leen del entorno o la piden; si una se filtra, revócala y crea otra.

## Instalación con un clic

El enlace instala la entrada de OAuth (sin clave). Cursor lo construye a partir de la configuración del servidor, codificada en base64.

*Link*

```text
cursor://anysphere.cursor-deeplink/mcp/install?name=filmo&config=eyJ1cmwiOiJodHRwczovL2FwcC5maWxtby5pby9hcGkvdjEvbWNwIn0=
```

## Límites de este cliente

| Qué | Lo que documenta el proveedor |
| --- | --- |
| Herramientas | El personal de Cursor dice en hilos del foro que envía unas 40 herramientas en total entre todos los servidores; no figura en la documentación oficial, así que elige un preset y desactiva herramientas en los ajustes de MCP. |
| Salida | Un límite de salida de herramientas: no documentado por el proveedor. |

## Preajuste recomendado

Disponibilidad y agenda (lectura) (20): `availability:read`, `schedule:read`, `planner:read`, `staff:read`, `vehicles:read`, `items:read`, `spaces:read`, `kits:read`, `account:read`. Unas 40 herramientas es el límite orientativo: elige un preset de 20 a 30.

Todos los presets y su peso, en [Límites y contexto](https://docs.filmo.io/es/mcp/guides/limits-and-context).

## Qué poner en «preguntar antes de ejecutar»

Cursor pide aprobación antes de usar herramientas MCP por defecto; los administradores pueden incluir herramientas en una lista de permitidas para que se ejecuten solas.

Las herramientas que deben pedir aprobación están en [Escrituras seguras](https://docs.filmo.io/es/mcp/guides/safe-writes#requires-confirmation).

- Cualquier uso de `readOnlyHint` o `destructiveHint` para la aprobación: no está documentado por el proveedor.

## Comprueba la conexión

Pregunta al asistente: «¿A qué cuenta de Filmo estoy conectado?». Debería llamar a `filmo_account_get`, una herramienta de lectura que no devuelve datos personales.

---

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