*MCP › Conectar*

# Conecta Gemini CLI

> Añade Filmo a Gemini CLI con OAuth, o con una clave guardada en tu fichero de ajustes de usuario.

## Antes de empezar

| Qué | Lo que documenta el proveedor |
| --- | --- |
| Plan | Planes: no documentado por el proveedor. |
| Quién añade el conector | Tú, con `gemini mcp add` o `settings.json`. Los administradores pueden restringir servidores con `mcp.allowed` en el archivo de ajustes del sistema. |
| Quién conecta | `/mcp auth filmo` para OAuth (necesita un navegador: no sirve en una máquina sin pantalla). |
| Administración | `mcp.allowed` e `includeTools` en los ajustes del sistema. |

verificado el 2026-10-09: [Servidores MCP en Gemini CLI](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md)

> **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** Ejecuta `gemini mcp add --transport http filmo https://app.filmo.io/api/v1/mcp`.
2. **Autenticar** Ejecuta `/mcp auth filmo` en una sesión. El 401 dispara el descubrimiento y el registro dinámico; da tu consentimiento en Filmo.

- Cómo usa Gemini CLI el `scope` de un desafío 401: no está documentado por el proveedor.

## 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. **Usa el archivo de usuario** Edita `~/.gemini/settings.json`, nunca el fichero de proyecto `.gemini/settings.json`, que es el ámbito por defecto de `gemini mcp add` y puede acabar en git.
2. **Sustituye el marcador de posición** La documentación de Gemini CLI expande `$VAR` solo en el bloque `env`, no en `headers`, así que la clave vive únicamente en ese fichero de nivel de usuario.

*~/.gemini/settings.json*

```json
{
  "mcpServers": {
    "filmo": {
      "httpUrl": "https://app.filmo.io/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer <your-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.

## Límites de este cliente

| Qué | Lo que documenta el proveedor |
| --- | --- |
| Herramientas | Límite de herramientas: no documentado por el proveedor. |
| Salida | Un límite de salida de herramientas: no documentado por el proveedor. |
| Tiempo | `timeout` por servidor, 600,000 ms por defecto. |

## Preajuste recomendado

Operaciones de alquiler (21): `orders:read`, `orders:write`, `availability:read`, `items:read`, `contacts:read`, `account:read`. Incluye las escrituras de pedidos, la cancelación incluida. Combínalo con `includeTools` para listar solo lo que necesitas, o elige un preajuste marcado (read).

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»

Gemini CLI ofrece proceder una vez, permitir siempre la herramienta, permitir siempre el servidor o cancelar. `trust: true` omite las confirmaciones de un servidor: no lo actives para Filmo. `includeTools` y `excludeTools` limitan las herramientas.

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 las anotaciones de herramienta 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/gemini-cli  
Última actualización: 2026-10-25