MCP Bridge para Adobe Premiere Pro

Opera proyectos locales de Adobe Premiere Pro mediante MCP.

284 herramientas, 13 recursos de contexto y 10 indicaciones guiadas para Codex, Claude Code, Claude Desktop y otros clientes MCP. CEP se encarga de la edición; la ayuda opcional de UXP lee las transcripciones de voz a texto de Premiere.

Idiomas: English | 日本語 | Tiếng Việt | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | ភាសាខ្មែរ

Empieza aquí: instala el puente local, ábrelo en Premiere y, a continuación, ejecuta verify_premiere_connection antes de editar.

Instalación | Plugin de Codex | Plugin de Claude Code | Verificar | Política de privacidad | Términos del servicio | Seguridad

Instalación

El puente compatible es el panel CEP incluido. Instala el paquete npm en el mismo equipo que Premiere Pro y tu cliente MCP:

npm install -g @compimprove/adobe-premiere-mcp
premiere-pro-mcp --install-cep
premiere-pro-mcp --doctor

--install-cep instala el puente CEP, habilita el ajuste de depuración de Adobe CEP requerido, prepara el directorio del puente y configura los clientes MCP locales compatibles. --doctor verifica la compilación del servidor, la instalación de CEP, el directorio del puente, el ajuste de depuración y la configuración del cliente.

A continuación, reinicia Premiere Pro, abre Window > Extensions > MCP Bridge (CEP), establece el directorio del puente que muestra el instalador e inicia el puente.

Requisitos:

• Node.js 20+

• Adobe Premiere Pro 2020+

• Premiere Pro, el cliente MCP y este paquete en el mismo equipo

El uxp-plugin incluido es una ayuda independiente de transcripción para Premiere 25.6+. No sustituye al puente de edición CEP y el CLI todavía no lo instala.

Plugin de Codex

Desde un clon de este repositorio, instala el plugin de Codex que agrupa la configuración de MCP y la habilidad de edición de Premiere:

codex plugin marketplace add .
codex plugin add premiere-pro-mcp@adobe-premiere-pro-mcp

El plugin sigue requiriendo el puente CEP local. Ejecuta premiere-pro-mcp --install-cep, reinicia Premiere, inicia Window > Extensions > MCP Bridge (CEP) y, a continuación, pide a Codex que ejecute get_capabilities seguido de verify_premiere_connection.

Plugin de Claude Code

Desde un clon de este repositorio:

/plugin marketplace add .
/plugin install premiere-pro-mcp@adobe-premiere-pro-mcp

Instala e inicia el puente CEP con los mismos pasos anteriores antes de usar el plugin.

Paquete integrado de Claude Desktop

Cada versión de GitHub incluye un paquete .mcpb para Claude Desktop. Descarga el archivo adobe-premiere-pro-mcp-<version>.mcpb correspondiente y ábrelo en Claude Desktop para instalar el servidor MCP local. Su primer inicio instala el puente CEP incluido para el usuario actual.

Reinicia Premiere Pro, abre Window > Extensions > MCP Bridge (CEP), establece el directorio del puente e inicia el puente. Luego pide a Claude:

Ejecuta verify_premiere_connection. No hagas cambios.

El paquete MCPB no está firmado. Instálalo solo desde las versiones de GitHub de este repositorio. Los archivos de versión de CEP están etiquetados con precisión como sin firmar o autofirmados; autofirmado no significa que sea de confianza para Adobe Marketplace.

Configuración del cliente MCP

El instalador configura Claude Desktop en macOS y Claude Desktop más GitHub Copilot en VS Code en Windows. Para otro cliente MCP, configúralo para que ejecute:

{
  "mcpServers": {
    "premiere-pro": {
      "command": "premiere-pro-mcp"
    }
  }
}

Instalar desde el código fuente

Usa la configuración de origen cuando desarrolles el MCP, modifiques el panel CEP o soluciones problemas de una instalación del paquete:

git clone https://github.com/compimprove/adobe-premiere-mcp.git
cd adobe-premiere-mcp
npm install
npm run build
npm run setup:mac # macOS

En Windows, usa npm run setup:win desde PowerShell después de npm install y npm run build.

Interfaz actual del panel CEP dentro de Premiere Pro, con los controles de puente actualizados y la distribución de estado.

Related MCP server: Premiere Pro MCP Server

Estado actual

Este repositorio está validado actualmente para:

• macOS

• comprobaciones de humo del instalador de Windows a través de GitHub Actions

• Adobe Premiere Pro 2020+ (usado y probado activamente en Premiere Pro 26.0)

• Node.js 20+

• transporte de servidor MCP v2 con descubrimiento de protocolo moderno sin estado

• la ruta de instalación de macOS incluida para Claude Desktop

• la ruta de instalación de Windows incluida para GitHub Copilot en VS Code y la configuración de Claude Desktop

• registro manual de MCP para Codex, Claude Code y clientes MCP similares

Estado actual del catálogo a 5 de agosto de 2026:

• Se exponen 284 herramientas MCP para la edición de vídeo impulsada por IA

• la cobertura abarca configuración de proyectos, ingesta de medios, contenedores, secuencias, edición de líneas de tiempo, transiciones, efectos, fotogramas clave, subtítulos, marcadores, metadatos, proxies, multicámara, color, audio, exportaciones y flujos de trabajo de ensamblaje de nivel superior

• el catálogo incluye flujos de trabajo prácticos de agente, como ensamblaje de anuncios de producto, demostraciones de gráficos animados, cortes en la línea de tiempo, lecturas de subtítulos, ajuste de audio, detección de cortes de escena, importación de EDL, validación de preparación para exportación y operaciones vinculadas de audio/vídeo

Validación local en vivo más reciente completada:

• Se exponen 284 herramientas activas; get_capabilities informa de la instalación local y del estado opcional de conexión en vivo, mientras que verify_premiere_connection es la comprobación canónica de solo lectura del puente y de preparación del host

• se anuncian 0 herramientas estacionadas o de marcador de posición conocidas

• import_ae_comps no se anuncia intencionadamente porque Premiere devolvió false para archivos .aep reales en este entorno y una importación genérica de .aep puede bloquear el puente CEP

La salida completa del barrido en vivo se escribe en /tmp/premiere-mcp-bridge/live-tool-sweep.json cuando ejecutas el verificador.

Qué incluye

El servidor cubre operaciones de proyecto, ingesta, creación de secuencias, edición de líneas de tiempo, transiciones, efectos, fotogramas clave, metadatos, exportaciones y flujos de trabajo de ensamblaje de nivel superior.

Ejemplos de indicaciones:

• "Enumera todas las secuencias y muéstrame cuál está activa."

• "Importa estas tres tomas y crea un anuncio de producto aproximado."

• "Añade encadenados a todos los cortes de la pista de vídeo 1."

• "Aplica desenfoque gaussiano al clip del medio."

• "Aplica el efecto Blanco y negro al clip de formato corto activo."

• "Corta la secuencia de la entrevista en 12,5 segundos en todas las pistas de audio y vídeo."

• "Exporta la secuencia activa como FCP XML."

Para los acabados monocromos, prefiere apply_effect con Blanco y negro en lugar de intentar forzar el blanco y negro mediante ajustes genéricos de solo saturación.

Antes de editar, también puedes adjuntar el recurso premiere://config/get_instructions para dar al modelo una guía operativa específica de Premiere.

Para un inicio predecible de cada sesión, ejecuta primero verify_premiere_connection. Confirma que el puente CEP ha respondido y devuelve la compilación de Premiere, el proyecto abierto y la secuencia activa sin modificar el proyecto.

Herramientas de flujo de trabajo de alto nivel incluidas:

• build_motion_graphics_demo

• assemble_product_spot

• build_brand_spot_from_mogrt_and_assets

assemble_product_spot y build_brand_spot_from_mogrt_and_assets ahora admiten un argumento opcional clipPlan para que un LLM pueda dirigir la sincronización por clip, la colocación en pistas, las transiciones, el movimiento, los recortes, los efectos y los ajustes de color en lugar de depender de los valores predeterminados fijos de la plantilla.

Habilidad de agente

Si quieres que Codex, Claude Code u otro agente gestionen la instalación, verificación y el uso diario correctamente, instala la habilidad de agente incluida:

npx skills add compimprove/adobe-premiere-mcp --skill premiere-pro-mcp

O instálala directamente desde la ruta de la habilidad:

npx skills add https://github.com/compimprove/adobe-premiere-mcp/tree/main/skills/premiere-pro-mcp

La habilidad enseña a los agentes a instalar el MCP, iniciar y verificar el puente CEP, usar las herramientas de Premiere de forma segura, importar medios reales antes de editar, preferir operaciones conscientes de la secuencia y ejecutar diagnósticos cuando algo falla.

Configuración y verificación avanzadas

Para instalaciones desde el código fuente, configuración de MCP específica del cliente, indicadores del instalador de Windows, diagnósticos y el barrido de herramientas en vivo, consulta QUICKSTART.md. Es la guía de configuración canónica y mantiene esta página centrada en elegir y usar el producto.

La versión resumida:

1. Instala con npm install -g @compimprove/adobe-premiere-mcp y, a continuación, ejecuta premiere-pro-mcp --install-cep.

2. Reinicia Premiere Pro y tu cliente MCP, y luego inicia Window > Extensions > MCP Bridge (CEP).

3. Ejecuta premiere-pro-mcp --doctor y, a continuación, pide al cliente que llame a verify_premiere_connection sin hacer cambios.

Para el registro manual en cualquier cliente MCP, usa el comando global después de la instalación de npm:

{
  "mcpServers": {
    "premiere-pro": {
      "command": "premiere-pro-mcp"
    }
  }
}

CEP sigue siendo el puente de edición. Si Premiere no expone la extensión, activa UXP Plugins > Enable developer mode en las preferencias de Premiere, reinicia Premiere y vuelve a abrir el panel CEP. El panel UXP independiente solo es necesario para las lecturas de transcripciones de voz a texto.

Para un barrido de host real, usa un proyecto de Premiere desechable y ejecuta node scripts/live-tool-sweep.mjs; crea secuencias temporales Sweep ... en el proyecto actual.

Para las instalaciones desde el código fuente que habilitan el puente de transcripción opcional, la configuración también:

• instala las dependencias

• compila dist/index.js

• habilita el modo de depuración de Adobe CEP

• instala la extensión MCP Bridge (CEP)

• crea /tmp/premiere-mcp-bridge

• prepara la cola de comandos de transcripción UXP

• añade la entrada MCP premiere-pro a Claude Desktop

Importante:

• MCP Bridge (CEP) sigue siendo el puente compatible para las herramientas de edición existentes

• MCP Transcript Bridge (UXP) es una ayuda opcional que solo usa read_sequence_transcription

• el instalador habilita automáticamente el modo de depuración de CEP de Adobe

• si Premiere no expone la extensión correctamente en tu equipo, activa UXP Plugins > Enable developer mode en las preferencias de Premiere Pro antes de abrir el panel del puente

• npm run setup:mac es la ruta más sencilla para Claude Desktop en macOS porque actualiza la configuración de Claude Desktop automáticamente

Después de que el instalador termine:

1. Cierra y vuelve a abrir tu cliente MCP si lee la configuración al inicio. Si usaste el instalador, eso significa Claude Desktop.

2. Cierra y vuelve a abrir Premiere Pro.

3. En Premiere Pro en macOS, abre Premiere Pro > Preferences > Plugins y activa UXP Plugins > Enable developer mode.

4. Reinicia Premiere Pro si se cambió el ajuste.

5. Abre Window > Extensions > MCP Bridge (CEP).

6. Establece Temp Directory en /tmp/premiere-mcp-bridge.

7. Haz clic en Save Configuration.

8. Haz clic en Start Bridge.

9. Para habilitar la lectura de transcripciones, carga la carpeta uxp-plugin del repositorio en Adobe UXP Developer Tool y, a continuación, abre Window > UXP Plugins > MCP Transcript Bridge.

10. En el panel UXP, introduce /tmp/premiere-mcp-bridge como raíz del puente, haz clic en Save bridge root y, a continuación, en Start Bridge.

11. Conéctate desde Codex, Claude Code, Claude Desktop u otro cliente MCP con el mismo directorio temporal.

12. Si fallan los comandos CEP, haz clic en Run Diagnostics y envía de vuelta /tmp/premiere-mcp-bridge/premiere-mcp-diagnostics-latest.json.

Si necesitas una referencia visual del conmutador de modo de desarrollador, tiene este aspecto:

Si el panel informa que Premiere está listo después de Start Bridge, el puente está activo.

Instalación por cliente

Claude Desktop

En macOS, usa:

npm run setup:mac

Esa es la única ruta de este repositorio que escribe automáticamente la entrada MCP por ti.

Codex

Compila primero el servidor:

npm install
npm run build

A continuación, añade el servidor MCP en una sola línea:

codex mcp add premiere_pro --env PREMIERE_TEMP_DIR=/tmp/premiere-mcp-bridge -- node /absolute/path/to/Adobe_Premiere_Pro_MCP/dist/index.js

Claude Code

Compila el servidor de la misma manera:

npm install
npm run build

A continuación, registra el servidor MCP en Claude Code usando el mismo punto de entrada compilado dist/index.js y el mismo directorio temporal:

command: node /absolute/path/to/Adobe_Premiere_Pro_MCP/dist/index.js
env: PREMIERE_TEMP_DIR=/tmp/premiere-mcp-bridge

Si usas un archivo de configuración MCP local en lugar de un comando auxiliar, apúntalo al mismo dist/index.js y establece la misma variable de entorno.

Otros clientes MCP

Usa el mismo método de registro manual que Claude Code:

command: node /absolute/path/to/Adobe_Premiere_Pro_MCP/dist/index.js
env: PREMIERE_TEMP_DIR=/tmp/premiere-mcp-bridge

Importante para todas las configuraciones manuales de clientes:

• mantén el comando en una sola línea

• usa la ruta absoluta real a dist/index.js

• reinicia el cliente después de añadir o actualizar la entrada MCP

• inicia el puente CEP dentro de Premiere y confirma que el directorio temporal sea exactamente /tmp/premiere-mcp-bridge

• para read_sequence_transcription, inicia también el UXP Transcript Bridge con esa misma carpeta raíz

Verificar la instalación

Ejecuta las comprobaciones integradas:

npm run setup:doctor

Eso valida:

• la versión de Node.js

• la salida del servidor compilado

• la instalación de la extensión CEP

• /tmp/premiere-mcp-bridge

• el modo de depuración de Adobe CEP

• la entrada de configuración de Claude Desktop cuando usas la ruta del instalador

• los diagnósticos del panel CEP escritos en /tmp/premiere-mcp-bridge/premiere-mcp-diagnostics-latest.json

• el latido del transcript-helper UXP en /tmp/premiere-mcp-bridge/uxp/status.json cuando el asistente opcional está en ejecución

Para una comprobación integral más profunda, usa un proyecto de Premiere desechable y ejecuta:

node scripts/live-tool-sweep.mjs

Esto crea secuencias temporales Sweep ... en el proyecto abierto actualmente, de modo que la cadena de herramientas se ponga a prueba con datos reales.

Cómo funciona el puente

+-----------+        +-----------+        +-----------+
|  Client   |  MCP   | Node.js   | Files  | CEP Panel |
| (Codex+)  |<------>| MCP Server|<------>| edits     |
+-----------+        +-----------+        +-----------+
                                  |
                                  | Files: uxp/commands + uxp/responses
                                  v
                           +-----------+
                           | UXP panel |
                           | transcripts|
                           +-----------+

1. El cliente llama a una herramienta MCP.

2. Las herramientas de edición existentes generan ExtendScript y usan los archivos de comandos del panel CEP.

3. read_sequence_transcription escribe una solicitud UXP versionada en uxp/commands.

4. El panel UXP lee las transcripciones Speech-to-Text de los clips de origen a través de la API UXP de Premiere y escribe una respuesta normalizada en uxp/responses.

5. El servidor devuelve JSON estructurado al cliente MCP. CEP y UXP no se llaman entre sí.

Herramientas

Todas las 284 herramientas anunciadas tienen una implementación. Los esquemas de las herramientas están disponibles mediante el descubrimiento MCP; este catálogo explica la superficie de edición en términos humanos. Comienza con verify_premiere_connection y luego inspecciona el proyecto antes de pedirle a un agente que lo modifique.

Descubrimiento e inspección de proyectos

El catálogo incluye:

• Descubrimiento e inspección de proyectos

• Gestión de proyectos y secuencias

• Importación de medios y gestión de contenedores (bins)

• Colocación en la línea de tiempo y operaciones con clips

• Efectos, transiciones, color y fotogramas clave

• Marcadores, metadatos, etiquetas y control del área de trabajo

• Asistentes de exportación e intercambio

• Asistentes de MOGRT, subtítulos, proxies y reenlace

• Lectura de transcripciones Speech-to-Text (Premiere 25.6+ con el asistente UXP opcional)

• Flujos de trabajo de montaje de anuncios / promociones de alto nivel

Proyectos, medios y contenedores (bins)

Secuencias y pistas

Edición de línea de tiempo y operaciones de recorte

Audio, transiciones y subtítulos

Marcadores, selección, navegación y reproducción

Entrega, intercambio y gestión de medios

Gráficos, flujos de trabajo, espacio de trabajo y operaciones avanzadas

Operaciones adicionales compatibles

El resto del catálogo abarca el control de bajo nivel de las propiedades de los medios, los ajustes del proyecto, los formatos de visualización, el suavizado de bordes, los fotogramas de póster, las etiquetas de color, la selección, el destino de pistas, las rutas del proyecto y los recuentos de proyecto. Incluye set_override_frame_rate, set_override_pixel_aspect_ratio, set_frame_blend, set_time_interpolation, set_poster_frame, set_anti_alias_quality, set_uniform_scale, set_scale_width_height, set_sequence_display_format, set_project_scratch_disk, get_project_scratch_disks, get_all_project_paths, get_total_clip_count, get_insertion_bin, is_work_area_enabled y match_frame.

Usa la introspección de MCP en tu cliente para conocer el esquema exacto de entrada y la forma de retorno de cada herramienta. Un agente debe inspeccionar primero, realizar una mutación puntual y comprobar el estado afectado antes de continuar con una edición de varios pasos.

Límites reales

• Un .zxp de CEP autofirmado confirma la integridad del archivo, pero no es una aprobación de Adobe Marketplace ni una garantía de confianza pública. El flujo de trabajo de firma reproducible requiere los secretos del certificado privado y la validación de Premiere en la plataforma de destino.

Este proyecto es mucho más utilizable que el prototipo original, pero no es magia.

• El scripting de Premiere todavía no expone todas las operaciones de la interfaz de usuario de forma limpia.

• Las pistas de subtítulos no son lo mismo que las transcripciones de voz a texto: read_sequence_captions sigue sin estar disponible a través de CEP, mientras que read_sequence_transcription lee las transcripciones de los clips de origen a través de UXP.

• El diseño profesional de títulos todavía depende de activos MOGRT reales o de flujos de trabajo de gráficos externos.

• get_render_queue_status solo es útil cuando la integración con Adobe Media Encoder está disponible.

• Los mejores resultados se obtienen con metraje de origen real, audio real y activos de marca reales. La capa de automatización los ensambla y manipula; no sustituye el criterio editorial.

Solución de problemas

Si las herramientas están visibles pero las llamadas fallan:

1. Confirma que Premiere Pro está abierto con un proyecto cargado.

2. Abre Window > Extensions > MCP Bridge (CEP).

3. Confirma que el directorio temporal es exactamente /tmp/premiere-mcp-bridge.

4. Haz clic en Start Bridge.

5. Si has actualizado el código del bridge, haz clic con el botón derecho en el panel y elige Reload.

6. Reintenta el comando.

Si read_sequence_transcription indica que el bridge de UXP no está disponible:

1. Usa Premiere Pro 25.6 o posterior.

2. Activa Plugins > Enable Developer Mode y, a continuación, carga uxp-plugin con Adobe UXP Developer Tool.

3. Abre Window > UXP Plugins > MCP Transcript Bridge.

4. Introduce /tmp/premiere-mcp-bridge, haz clic en Save bridge root y, a continuación, haz clic en Start Bridge.

5. Asegúrate de que los clips de origen de la secuencia se hayan transcrito en el panel Texto de Premiere. La herramienta devuelve un resultado parcial cuando algunos clips de origen no tienen transcripción.

Si el cliente MCP no puede encontrar el servidor:

1. Verifica la ruta absoluta a dist/index.js.

2. Verifica PREMIERE_TEMP_DIR=/tmp/premiere-mcp-bridge.

3. Reinicia el cliente MCP después de cambiar la configuración.

4. Ejecuta npm run setup:doctor.

Notas para desarrolladores

Comandos útiles:

npm run build
npm test -- --runInBand
npm run setup:doctor
node scripts/live-tool-sweep.mjs

Consulta:

• QUICKSTART.md para la ruta de instalación más corta

• KNOWN_ISSUES.md para los límites actuales

• CONTRIBUTING.md para el flujo de trabajo de desarrollo