Conecta Claude Code

verificado el 2026-10-09: Conectar Claude Code a servidores MCP · Permisos

1. 1

   Añadir el servidor

   Ejecuta el comando de abajo.

2. 2

   Autenticar

   En una sesión ejecuta /mcp, elige filmo y autentícate; o ejecuta claude mcp login filmo en una shell.

3. 3

   Consentimiento en Filmo

   Un administrador elige la suscripción y los scopes en la pantalla de consentimiento de Filmo; mira más abajo.

• Cuando oauth.scopes no está definido, Claude Code solicita el scope de la cabecera WWW-Authenticate del 401 o de los metadatos del recurso, y no envía ninguno cuando ninguno de los dos lo tiene. El 401 de Filmo lleva los permisos de lectura.
• Ante un 403 insufficient_scope falla con “needs additional permissions”; no hay step-up automático. Añade el scope a oauth.scopes y autentícate de nuevo.
• Usa una redirección de loopback (http://localhost:<port>/callback); --callback-port fija el puerto.

• 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

   Pon la clave en tu entorno

   Exporta FILMO_API_KEY desde el perfil de tu shell o desde un gestor de secretos. Usa ese nombre exacto o uno propio: los nombres con aspecto de credencial que Claude Code reserva (como ANTHROPIC_API_KEY o NPM_TOKEN) se leen vacíos en las cabeceras remotas.

2. 2

   Añadir el servidor en el ámbito de usuario

   El comando siguiente guarda la entrada en tu configuración de usuario, fuera de cualquier repositorio.

3. 3

   O comparte un archivo de proyecto sin la clave

   En .mcp.json la cabecera lleva ${FILMO_API_KEY}, nunca el valor, así que el fichero es seguro de commitear.

claude mcp add --transport http filmo --scope user https://app.filmo.io/api/v1/mcp \
  --header "Authorization: Bearer $FILMO_API_KEY"

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

• No uses nunca --scope project con una clave literal: ese scope escribe .mcp.json, que la documentación de Claude Code sugiere subir al control de versiones.

Operaciones de alquiler (21): orders:read, orders:write, availability:read, items:read, contacts:read, account:read. Claude Code difiere las definiciones de las herramientas, así que el preset trata de lo que la clave puede hacer, no del contexto. Incluye las escrituras de pedidos, cancelar incluido; para trabajo de solo lectura elige un preset marcado (read).

Todos los presets y su peso, en Límites y contexto.

Reglas de permisos mcp__filmo (todo el servidor) o mcp__filmo__<tool>. Una herramienta con _meta["anthropic/requiresUserInteraction"]: true pregunta en cada llamada, en todos los modos, sin “no volver a preguntar”.

Las herramientas que deben pedir aprobación están en Escrituras seguras.

• Claude Code no aprueba automáticamente según readOnlyHint ni destructiveHint: no figura en su documentació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.