Conecta Gemini CLI

verificado el 2026-10-09: Servidores MCP en Gemini CLI

1. 1

   Añadir el servidor

   Ejecuta gemini mcp add --transport http filmo https://app.filmo.io/api/v1/mcp.

2. 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.

• 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.

1. 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. 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.

{
  "mcpServers": {
    "filmo": {
      "httpUrl": "https://app.filmo.io/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer <your-filmo-api-key>"
      }
    }
  }
}

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.

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.

• Cualquier uso de las anotaciones de herramienta para la aprobación: no está documentado por el proveedor.

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.