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

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

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

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

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

GXP8

CEP는 편집 브리지로 남아 있습니다. Premiere가 확장을 노출하지 않는 경우 Premiere 환경설정에서 **> Enable developer mode**을 사용하세요. UXP 패널은 Speech-to- Text 트랜스크립션 읽기에만 필요한 별도 패널입니다.

실제 호스트 스윕을 수행하려면 임시 Premiere 프로젝트를 사용하고 `node scripts/live-tool-sweep.mjs`를 실행하세요. 현재 프로젝트에 임시 `Sweep ...` 시퀀이 생성됩니다.

선택 트랜스크립션 브리지를 사용 가능하게 하는 소스 설치에서는 추가로 다음을 수행합니다:

* 종속성 설치
* `dist/index.js` 빌드
* Adobe CEP 디버그 모드 활성 모드:
* `MCP Bridge (CEP)` 확장 기능을 설치하려면
* `/tmp/premiere-mcp-bridge` 만들기
* 트랜스크립션 큐 클리어
* Claude Desktop에 `premiere-pro` MCP 엔트리 추가

중요:

* `MCP Bridge (CEP)`는 기존 편집 도구에 대한 지원되는 브리지로 유지됩니다.
* `MCP Transcript Bridge (UXP)`는 `read_sequence_transcription`에서만 사용되는 옵션 헬퍼입니다.
* 설치 파일이 Adobe **CEP** 디버그 모드를 자동으로 활성화합니다.
* 배포 환경이 Premiere 확장을 노출하지 않으면, Premiere Pro 환경설정에서 **UXP 플러그인 > 개발자 모드**를 켠 다음 브리지를 패널을 엽니다.
* `npm run setup`은 macOS에서 Claude Desktop을 설치하는 가장 간단한 방법입니다.

macOS에서 Claude Desktop 구성은 `npm run setup`로 자동 업데이트 됩니다.

설치가 끝난 후:

설치가 끝나면:

1. 시작 시 설정을 읽는 MCP 클라이언트를 종료하고 다시 엽니다. installer 파일을 사용했으면 해당 클라이언트는 Claude Desktop입니다.
2. Premiere Pro를 종료하고 다시 엽니다.
3. macOS it's에서윈도우의 `Premiere Pro > Preferences > Plugins` 에서 **UXP 플러그인 > Enable developer mode**를 활성화합니다.
4. 변경했으면 Premiere Pro을 다시 시작합니다.
5. `Window > Extensions > MCP Bridge (CEP)`을 엽니다.
6. `Temp Directory`를 `/tmp/premiere-mcp-bridge`로 설정합니다.
7. Save Configuration(설정 저장)을 클릭합니다.
9. Start Bridge를 사용합니다.
9. 트랜스크립션을 활성화하려면 Adobe UXP Developer Tool에서 `uxp-plugin`을 불러온 다음 `Window > UXP Plugin > MCP Transcript Bridge`를 엽니다.
10. UXP 패널에서 `/tmp/premiere-mcp-bridge`를 브리지 루트로 제작하고 `Save bridge root`를 클릭한 다음 `Start Bridge`를 클릭합니다.
11. Codex, Claude Code, Claude Desktop 또는 기타 MCP 클라이언트에서 동일한 임시 디렉터리를 사용하여 연결합니다.
12. CEP 명령이 실패하면 `Run 소진`을 클릭하고 최종 `/chard` 로그를 `/tmp/premiere-mcp-bridge/premiere-mcp-diagnostics-latest.json`의경로로 표시합니다.

개미 모드 토글이 시각적으로 확인 필요:

![Premiere Pro에서 UXP 개발자 모드 사용](images/uxp-developer-mode.png)

`# Start Bridge` 이후 패널이 Premiere 준비 상태를 보고한다면 브리저가 활성 상태입니다.

## 클라이언트별 설치

### Claude Desktop

macOS에서는 아래를 사용하세요:

GXP9

이 저장소에서 MCP 추가 정보: Claude Desktop 구성까지 자동으로 기록하는 유일한 경로입니다.

### Codex

먼저 서버를 빌드하십시오:

GXP10

그런 다음 MCP 서버를 다음 한 줄로 등록하십시오:

GXP11

### Claude Code

시작 방법은 동일합니다:

GXP12

그런 다음 동일한 빌드된 `dist/index.js` 엔트리포인트와 동일한 임시 디렉터리를 사용하여 Claude Code에 MCP 서버를 등록합니다:

GXP13

도우미 명령 대신 로컬 MCP 구성 파일을 사용하는 경우, 동일한 `dist/index.js`를 가리키고 동일한 환경 변수를 설정하세요.

### 기타 MCP 클라이언트

Claude Code와 동일한 수동 등록 방식을 사용합니다:

GXP14

모든 수동 클라이언트 설정에서 중요한 사항:

* 명령을 한 줄로 유지할 것
* `dist/index.js`의 실제 절대 경로를 사용할 것
* MCP 항목을 추가하거나 업데이트한 후 클라이언트를 재시작할 것
* Premiere 내부에서 CEP 브리지를 시작하고 임시 디렉터리가 정확히 `/tmp/premiere-mcp-bridge`인지 확인할 것
* `read_sequence_transcription`의 경우, 동일한 루트 폴더로 UXP Transcript Bridge도 시작할 것

## 설치 확인

내장된 검사를 실행합니다:

GXP15

다음을 검증합니다:

* Node.js 버전
* 빌드된 서버 출력
* CEP 확장 프로그램 설치
* `/tmp/premiere-mcp-bridge`
* Adobe CEP 디버그 모드
* 설치 프로그램 경로를 사용할 때의 Claude Desktop 구성 항목
* `/tmp/premiere-mcp-bridge/premiere-mcp-diagnostics-latest.json`에 기록된 CEP 패널 진단 정보
* 선택적 헬퍼가 실행 중일 때 `/tmp/premiere-mcp-bridge/uxp/status.json`의 UXP transcript-helper 하트비트

더 깊은 종단 간 확인을 위해, 일회용 Premiere 프로젝트를 사용하여 다음을 실행하세요:

GXP16

이렇게 하면 현재 열려 있는 프로젝트에 임시 `Sweep ...` 시퀀스가 생성되어 실제 데이터로 툴체인이 실행됩니다.

## 브리지 작동 방식

GXP17

1. 클라이언트가 MCP 도구를 호출합니다.
2. 기존 편집 도구가 ExtendScript를 생성하고 CEP 패널의 명령 파일을 사용합니다.
3. `read_sequence_transcription`이 버전이 지정된 UXP 요청을 `uxp/commands`에 기록합니다.
4. UXP 패널이 Premiere의 UXP API를 통해 소스 클립 Speech-to-Text 트랜스크립트를 읽고 정규화된 응답을 `uxp/responses`에 기록합니다.
5. 서버가 구조화된 JSON을 MCP 클라이언트에 반환합니다. CEP와 UXP는 서로 호출하지 않습니다.

## 도구

광고된 `284`개 도구는 모두 구현되어 있습니다. 도구 스키마는 MCP 디스커버리를 통해 확인할 수 있습니다. 이 카탈로그는 편집 표면을 사람이 이해할 수 있는 용어로 설명합니다. `verify_premiere_connection`으로 시작한 다음, 에이전트가 프로젝트를 변경하도록 요청하기 전에 프로젝트를 검사하세요.

### 디스커버리 및 프로젝트 검사

카탈로그는 다음을 다룹니다:

* 디스커버리 및 프로젝트 검사
* 프로젝트 및 시퀀스 관리
* 미디어 가져오기 및 빈 관리
* 타임라인 배치 및 클립 작업
* 효과, 전환, 색상 및 키프레임
* 마커, 메타데이터, 레이블 및 작업 영역 제어
* 내보내기 및 교환 헬퍼
* MOGRT, 캡션, 프록시 및 재연결 헬퍼
* Speech-to-Text 트랜스크립트 읽기 (선택적 UXP 헬퍼가 있는 Premiere 25.6 이상)
* 상위 수준 광고 / 프로모 어셈블리 워크플로우

| 도구                                                                                      | 기능                                                              |
| :----------------------------------------------------------------------------------------- | :------------------------------------------------------------------ |
| `verify_premiere_connection` / `get_capabilities`                                          | 읽기 전용 호스트 준비 상태 및 로컬 런타임 기능 검사.       |
| `get_project_info` / `list_project_items` / `list_sequences`                               | 현재 프로젝트, 미디어/빈 인벤토리 및 시퀀스 검사.    |
| `get_active_sequence` / `list_sequence_tracks` / `get_sequence_settings`                   | 현재 타임라인, 클립/트랙 및 시퀀스 설정 읽기. |
| `get_full_project_overview` / `get_full_sequence_info` / `get_full_clip_info`              | 계획을 위한 더 깊은 프로젝트, 시퀀스 또는 클립 스냅샷 반환.    |
| `search_project_items` / `find_project_item_by_name` / `find_items_by_media_path`          | 이름 또는 미디어 경로로 프로젝트 항목 찾기.                         |
| `get_timeline_summary` / `get_timeline_gaps` / `get_used_media_report`                     | 편집 요약, 갭 감지, 사용 중인 미디어 보고.           |
| `get_offline_media` / `check_offline_media` / `get_unused_media` / `get_duplicate_media`   | 편집 또는 내보내기 전에 누락, 미사용 또는 중복 미디어 찾기. |
| `get_clip_properties` / `get_clip_speed` / `get_clip_at_position` / `get_clip_at_playhead` | 클립 프레이밍, 속도 및 타임라인 위치 검사. |
| `get_premiere_state` / `get_version_info` / `ping`                                         | 광범위한 호스트 상태, Premiere 버전 또는 브리지 상태 읽기. |

### 프로젝트, 미디어 및 빈

| 도구                                                                                    | 기능                                                                      |
| :--------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------- |
| `create_project` / `open_project` / `save_project` / `save_project_as` / `close_project` | 프로젝트 수명 주기 및 파일 작업.                                            |
| `import_media` / `import_folder` / `import_image_sequence`                               | 비디오, 오디오, 스틸 또는 이미지 시퀀스를 프로젝트로 가져오기. |
| `import_fcp_xml` / `import_sequences_from_project` / `import_sequences`                  | 지원되는 타임라인 교환 형식 또는 다른 프로젝트의 시퀀스 가져오기. |
| `create_bin` / `rename_bin` / `delete_bin` / `create_smart_bin`                          | 프로젝트 패널 빈 생성 및 구성. |
| `move_item_to_bin` / `move_items_to_bin` / `rename_project_item` / `rename_clip`         | 기존 프로젝트 항목 구성 및 이름 변경. |
| `delete_project_item` / `delete_multiple_project_items`                                  | 프로젝트 항목을 명시적으로 제거. 이는 파괴적인 작업입니다. |
| `create_subclip` / `refresh_media` / `relink_media` / `replace_clip_media`               | 소스 범위 생성, 미디어 새로 고침, 누락된 파일 재연결 또는 클립 미디어 교체. |
| `get_metadata` / `set_metadata` / `get_xmp_metadata` / `set_xmp_metadata`                | 프로젝트 메타데이터 및 XMP 필드 읽기/쓰기. |
| `get_footage_interpretation` / `set_footage_interpretation`                              | 푸티지 프레임 속도 및 픽셀 종횡비 해석 검사 또는 변경. |
| `set_color_label` / `get_color_label` / `set_project_panel_metadata`                     | 프로젝트 패널 항목 레이블 지정 및 주석 처리. |

### 시퀀스 및 트랙

| 도구                                                                                         | 기능                                                                                                |
| :-------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------- |
| `create_sequence` / `create_sequence_from_preset`                                             | Premiere의 새 시퀀스 대화 상자를 트리거하지 않고 설치된 `.sqpreset`에서 빈 시퀀스 만들기. |
| `create_sequence_from_clips`                                                                  | 클립 설정이 시퀀스를 정의해야 할 때 사전 가져온 미디어에서 시퀀스 파생. |
| `duplicate_sequence`                                                                          | 시퀀스 복사; `clearContents: true`는 소스 설정으로 빈 재사용 가능한 템플릿을 만듭니다. |
| `delete_sequence` / `close_sequence` / `set_active_sequence`                                  | 열려 있거나 활성화된 시퀀스 관리. |
| `get_sequence_structure` / `get_sequence_count`                                               | 시퀀스 레이아웃 검사 또는 프로젝트 시퀀스 수 계산. |
| `set_sequence_settings` / `set_sequence_frame_rate` / `set_sequence_resolution`               | 지원되는 시퀀스 설정 변경. Premiere가 변경을 양자화하거나 거부할 수 있으므로 결과를 확인하세요. |
| `set_sequence_audio_settings` / `set_sequence_pixel_aspect_ratio` / `set_sequence_field_type` | 지원되는 오디오, 픽셀 종횡비 및 필드 설정 조정. |
| `add_track` / `add_tracks` / `delete_track` / `rename_track`                                  | 오디오/비디오 트랙 생성, 제거 및 이름 지정. 캡션 트랙 삭제는 명시적으로 지원되지 않는 결과를 반환합니다. |
| `lock_track` / `toggle_track_visibility` / `set_target_track` / `set_all_tracks_targeted`     | 편집 보호, 가시성 및 트랙 대상 지정 제어. |
| `get_track_info` / `get_target_tracks` / `get_sequence_in_out_points`                         | 트랙, 대상 지정 및 시퀀스 인/아웃 범위 검사. |

### 타임라인 편집 및 트림 작업

| 도구                                                                           | 기능                                                                                                                  |
| :------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------- |
| `add_to_timeline` / `add_to_timeline_batch`                                     | 하나 또는 여러 프로젝트 클립을 클립별 소스 범위 및 오디오 연결 제어와 함께 배치. 배치 배치는 클립별 결과를 반환합니다. |
| `insert_from_source` / `overwrite_from_source` / `overwrite_clip`               | 소스 모니터에서 3점 삽입 또는 덮어쓰기 편집 수행. |
| `remove_from_timeline` / `remove_selected_clips` / `ripple_delete`              | 타임라인 클립 제거. 리플 삭제는 호스트가 지원할 때 갭을 닫습니다. |
| `move_clip` / `move_clip_to_track` / `set_clip_start_time`                      | 클립을 시간 또는 다른 트랙으로 재배치. |
| `split_clip` / `razor_timeline_at_time` / `razor_all_tracks`                    | 요청된 타임라인 지점에서 하나의 클립 또는 여러 트랙 절단. |
| `trim_clip` / `roll_edit` / `slide_edit` / `slip_edit`                          | 편집 지점 및 클립 콘텐츠 타이밍 조정. 구조적 QE 편집은 맹목적으로 신뢰하지 않고 다시 읽습니다. |
| `lift_selection` / `extract_selection` / `nest_clips` / `unnest_sequence`       | 선택 범위 리프트/추출 또는 중첩 생성/제거. |
| `duplicate_clip` / `replace_clip` / `enable_disable_clip` / `freeze_frame`      | 타임라인 자료 복제, 교체, 활성화 또는 프리즈. |
| `link_audio_video` / `link_selection` / `unlink_selection` / `get_linked_items` | 오디오/비디오 연결 관계 관리. |
| `undo` / `redo` / `multiple_undo`                                               | 최근 Premiere 작업 되돌리기 또는 다시 실행. |

### 효과, 색상, 모션 및 키프레임

| 도구 | 기능 |
| :------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------- |
| `list_available_effects` / `list_clip_effects` / `get_effect_properties` | 설치된 효과, 적용된 효과, 그리고 그 속성들을 탐색합니다. |
| `apply_effect` / `remove_effect` / `remove_effect_by_name` / `remove_all_effects` | 시각/오디오 효과 구성 요소를 추가하거나 제거합니다. `apply_effect`는 새 구성 요소를 식별하고 다시 읽어옵니다. |
| `batch_apply_effect` / `copy_effects_between_clips` / `copy_effect_values` | 클립 전반에 효과 처리를 적용하거나 복사합니다. |
| `set_effect_property` / `set_color_value` / `set_blend_mode` | 지원되는 효과 매개변수, 색상 값 및 혼합 모드를 변경합니다. |
| `color_correct` / `apply_lut` / `stabilize_clip` | 기본 보정, LUT 또는 Warp Stabilizer를 적용합니다. |
| `crop_clip` / `add_adjustment_layer` / `get_clip_adjustment_layer` | 클립을 자르거나 공통 처리를 위해 조정 레이어를 사용합니다. |
| `set_clip_properties` / `set_clip_properties_batch` | 속성별 출력을 검증하여 불투명도, 배율, 회전 및 위치를 설정합니다. |
| `set_clip_position` / `set_clip_scale` / `set_clip_rotation` / `set_clip_anchor_point` | 개별 모션 변형 값을 처리합니다. |
| `add_keyframe` / `get_keyframes` / `remove_keyframe` / `remove_keyframe_range`         | 매개변수 키프레임을 생성, 검사, 제거합니다. |
| `set_keyframe_interpolation` / `get_value_at_time` | 보간을 설정하거나 특정 시점의 매개변수 값을 조회합니다. |

### 오디오, 전환 및 자막

| Tools                                                                   | What they do                                                                                                             |
| :---------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------- |
| `adjust_audio_levels` / `set_clip_volume` / `set_clip_pan`              | 클립 게인, 볼륨 또는 팬을 설정합니다.                                                                                           |
| `add_audio_keyframes` / `setup_ducking`                                 | 볼륨 자동화 또는 지정된 구간의 오디오 덕킹 곡선을 생성합니다.                                                   |
| `mute_track` / `apply_audio_effect` / `apply_audio_effect_to_all_clips` | 트랙을 음소거하거나 하나 또는 여러 클립에 오디오 효과를 적용합니다.                                                             |
| `detect_silence`                                                        | ffmpeg를 사용하여 로컬 미디어 파일을 분석하고 무음 구간을 반환합니다. 타임라인을 편집하지 않습니다.                         |
| `list_available_transitions` / `list_available_audio_transitions`       | 설치된 전환 이름을 확인합니다.                                                                                     |
| `add_transition` / `add_transition_to_clip` / `batch_add_transitions`   | 하나 또는 여러 전환을 추가합니다. 결과는 검증된 변경 사항과 수락되었지만 검증되지 않은 변경 사항을 구분합니다. |
| `create_caption_track`                                                  | SRT와 같은 가져온 자막 프로젝트 항목에서 캡션 트랙을 생성합니다. |
| `read_sequence_captions`                                                | 시퀀스에 노출된 캡션 데이터를 보고하며, 호스트가 기존 캡션 텍스트를 읽지 못하는 경우도 있음을 명시합니다. |

### 마커, 선택 및 재생

| Tools                                                                                   | What they do                                                                                      |
| :-------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------- |
| `create_marker` / `update_marker` / `delete_marker` / `list_markers` | 마커를 생성하고 관리합니다. |
| `add_marker_to_project_item` / `get_sequence_markers` / `get_clip_markers` | 프로젝트 항목, 클립 또는 시퀀스의 마커를 처리합니다. |
| `set_sequence_in_out_points` / `clear_sequence_in_out` / `set_work_area` / `get_work_area` | 시퀀스 인/아웃 포인트와 작업 영역을 설정하거나 확인합니다. |
| `get_playhead_position` / `set_playhead_position` / `get_next_edit_point` / `move_playhead_to_edit` | 재생 헤드를 검사하거나 이동합니다. |
| `get_selected_clips` / `select_clips_by_name` / `select_clips_in_range` | 대상 타임라인 클립 선택을 검사하거나 생성합니다. |
| `select_all_clips` / `select_disabled_clips` / `clear_selection` | 더 넓은 선택 제어를 제공합니다. |
| `open_in_source` / `close_source_monitor` / `set_source_in_out` / `clear_item_in_out` | 소스 모니터 미디어 및 소스 인/아웃 포인트를 제어합니다. |
| `play_timeline` / `stop_playback`                                     | 타임라인 및 소스 재생을 시작하거나 중지합니다. |

### 내보내기, 교환 및 미디어 관리

| Tools                                                                               | What they do                                                                                |
| :---------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------ |
| `validate_project_for_export` / `get_export_presets` / `get_export_file_extension`  | 내보내기 유효성 검사, 읽을 수 있는 사용자 `.epr` 사전 설정 탐색, 출력 확장자 확인. |
| `export_sequence` / `add_to_render_queue`                                           | 실제 사전 설정 경로 또는 정확한 사전 설정 이름을 사용하여 Adobe Media Encoder에 시퀀스를 큐에 추가합니다. |
| `get_render_queue_status` / `start_render_queue` / `wait_for_render_completion`      | 렌더 큐 상태를 보고하고 처리 완료를 대기합니다. |
| `export_frame` / `export_fcpxml` / `export_final_cut_pro_xml`                       | 시퀀스에서 프레임을 내보내거나 FCP XML로 내보냅니다. |
| `export_avid_aaf` / `export_projects`                                               | AAF 또는 프로젝트 파일을 내보냅니다. |
| `import_project` / `open_project` / `close_project` / `save_project`               | 프로젝트 파일에 대한 가져오기, 열기, 닫기, 저장 등의 작업을 수행합니다. |
| `insert_project_items_into_sequence` / `ripple_insert` / `overwrite`                 | 타임라인에 클립을 배치하는 다양한 방식을 제공합니다. |
| `send_to_transcoder` / `start_offline_encoding`                                    | 미디어 인코딩을 위해 미디어 인코더에 시퀀스를 보냅니다. |
| `get_project_metadata` / `set_project_metadata` / `get_sequence_metadata`           | 프로젝트 및 시퀀스 메타데이터를 읽고 씁니다. |
| `set_work_area_start` / `set_work_area_end` / `set_work_area`                       | 작업 영역 시작/종료 지점을 설정합니다. |
| `set_track_visibility` / `get_track_names` / `set_track_name` | 트랙 이름과 가시성을 관리합니다. |
| `get_edit_points` / `get_current_edit` / `set_playhead_to_edit_point` | 편집 지점을 찾고 이동합니다. |

### 전달, 상호 교환 및 미디어 관리

| Tools                                                                               | What they do                                                                                   |
| :---------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------- |
| `validate_export` / `get_encoder_presets` / `get_export_file_extension` | 내보내기 가능 여부를 검증하고, 사용자 `.epr` 사전 설정을 확인하며, 출력 파일 확장자를 확인합니다. |
| `export_sequence` / `add_to_ame_queue`                                    | Adobe Media Encoder를 통해 시퀀스를 대기열에 추가합니다. |
| `get_render_queue_status` / `start_batch_encode`                                    | 인코딩 상태를 확인하거나 지원되는 일괄 인코딩을 시작합니다. |
| `export_frame` / `capture_frame` | 시퀀스에서 스틸 이미지를 내보내거나 프레임을 캡처합니다. |
| `export_aaf` / `export_fcpxml` / `export_fcp_xml` / `export_projects` | 지원되는 상호 교환 형식으로 내보냅니다. |
| `encode_file` / `create_web_render` / `link_media` / `relink_media`                  | 파일을 인코딩하거나 웹 렌더링을 생성하고, 미디어 링크를 관리합니다. |
| `manage_proxies` / `create_proxies` / `set_proxy_path` | 프록시를 생성하거나 연결합니다. |
| `refresh_media` / `set_offline` / `relink_media` | 미디어를 오프라인으로 전환하거나 다시 연결합니다. |
| `consolidate_project` / `consolidate_and_transfer` | 프로젝트를 정리하거나 전송 워크플로를 준비합니다. |

### 그래픽, 캡션 및 고급 작업

| Tools                                                                   | What they do                                                                                                             |
| :---------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------- |
| `add_mogrt` / `add_mogrt_from_library` / `set_mogrt_property`           | MOGRT를 추가하고 지원되는 텍스트 필드를 선택적으로 채웁니다.                                           |
| `get_mogrt_component` / `get_graphics_white_luminance` / `set_graphics_white_luminance` | 모션 그래픽 구성 요소 및 그래픽 흰색 휘도를 검사합니다. |
| `build_motion_graphics_demo`                                            | 생성된 에셋, 디졸브 및 애니메이션으로 완전한 데모 시퀀스를 생성합니다. |
| `build_brand_spot` / `build_product_spot` | 지시된 편집으로 실제 미디어를 조립합니다. |
| `auto_reframe_sequence` / `detect_scene_edits`                          | 호스트가 지원하는 경우 Premiere 지원 리프레이밍 또는 장면 변경 감지를 사용합니다. |
| `get_workspaces` / `set_workspace` / `create_workspace`                | Premiere 작업 영역 레이아웃을 검사하고 전환합니다. |
| `create_bars_and_tone` / `set_ingest_settings` / `set_scratch_disk` | 유틸리티 미디어를 생성하고 수집 설정 또는 스크래치 디스크 경로를 관리합니다. |
| `execute_script` / `evaluate_expression` / `inspect_dom` | 고급 진단 및 스크립팅 작업입니다. 신뢰할 수 있는 입력과 명시적인 사용자 의도가 있는 경우에만 사용하세요. |

### 기타 지원 작업

나머지 카탈로그는 낮은 수준의 미디어 속성, 시퀀스 설정, 안티앨리어싱, 선택, 트랙 타겟팅, 프로젝트 경로 및 프로젝트 수를 다룹니다. 여기에는 `set_override_pixel_aspect_ratio`, `set_frame_blend`, `set_time_interpolation`, `set_poster_frame`, `set_anti_alias_quality`, `set_scale_to_frame_size`, `set_scale_to_sequence_size`, `set_scale_to_comp_size`, `set_motion_quality`, `set_motion_blur`, `set_time_stretch`, `set_playback_speed`, `set_audio_channels`, `set_audio_sample_rate`, `set_audio_gain`, `set_audio_ducking`, `set_track_visibility` 등이 포함됩니다.

호스트 MCP 도구를 사용하여 각 도구의 정확한 입력/출력 스키마를 확인하세요. 에이전트는 먼저 검사하고, 집중된 변경을 수행한 후, 영향을 받은 상태를 다시 읽어야 합니다.| Tools                                                                                  | 기능                                                                                                  |
| :------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------- |
| `list_available_effects` / `list_clip_effects` / `get_effect_properties`               | 설치된 이펙트, 클립에 적용된 이펙트 및 해당 속성을 확인합니다.                                        |
| `apply_effect` / `remove_effect` / `remove_effect_by_name` / `remove_all_effects` | 시각/오디오 이펙트 구성 요소를 추가하거나 제거합니다. `apply_effect`는 새 구성 요소를 식별하고 다시 읽습니다. |
| `batch_apply_effect` / `copy_effects_between_clips` / `copy_effect_values`             | 클립 전반에 걸쳐 이펙트를 적용하거나 복사합니다.                                                            |
| `set_effect_property` / `set_color_value` / `set_blend_mode`                           | 지원되는 이펙트 매개변수, 색상 값 및 혼합 모드를 변경합니다.                                        |
| `color_correct` / `apply_lut` / `stabilize_clip`                                       | 기본 보정, LUT 또는 Warp Stabilizer를 적용합니다.                                                         |
| `crop_clip` / `add_adjustment_layer` / `get_clip_adjustment_layer`                     | 클립을 자르거나 조정 레이어를 사용하여 공통 처리를 적용합니다.                                              |
| `set_clip_properties` / `set_clip_properties_batch`                                    | 검증된 속성별 출력과 함께 불투명도, 배율, 회전 및 위치를 설정합니다.                                                  |
| `set_clip_position` / `set_clip_scale` / `set_clip_rotation` / `set_clip_anchor_point` | 개별 모션 변형 값을 설정합니다.                                                                        |
| `add_keyframe` / `get_keyframes` / `remove_keyframe` / `remove_keyframe_range`         | 매개변수 키프레임을 생성, 검사 및 제거합니다.                                                                    |
| `set_keyframe_interpolation` / `get_value_at_time`                                     | 보간을 설정하거나 특정 시점의 매개변수 값을 조회합니다.                                                               |

### 오디오, 전환 및 캡션

| Tools                                                                   | 기능                                                                                                           |
| :----------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------- |
| `adjust_audio_levels` / `set_clip_volume` / `set_clip_pan`              | 클립 게인, 볼륨 또는 팬을 설정합니다.                                                                           |
| `add_audio_keyframes` / `setup_ducking`                                 | 지정된 창에서 볼륨 자동화 또는 전체 덕킹 곡선을 생성합니다.                                                   |
| `mute_track` / `apply_audio_effect` / `apply_audio_effect_to_all_clips` | 트랙을 음소거하거나 하나 또는 여러 클립에 오디오 처리를 적용합니다.                                                             |
| `detect_silence`                                                        | ffmpeg로 로컬 미디어 파일을 분석하고 무음 구간을 반환합니다. 타임라인을 편집하지 않습니다.                                                        |
| `list_available_transitions` / `list_available_audio_transitions`       | 설치된 전환 이름을 확인합니다.                                                                                     |
| `add_transition` / `add_transition_to_clip` / `batch_add_transitions`   | 하나 또는 여러 전환을 추가합니다. 결과는 검증된 변경 사항과 수락되었지만 검증되지 않은 호스트 응답을 구분합니다. |
| `create_caption_track`                                                  | SRT와 같은 가져온 자막 프로젝트 항목에서 캡션 트랙을 생성합니다.                                           |
| `read_sequence_captions`                                                | 시퀀스에서 캡션 데이터를 읽습니다. 호스트가 기존 캡션 텍스트를 노출하지 않을 수 있습니다.                 |

### 마커, 선택 및 탐색

| Tools                                                                                   | 기능                                                                                 |
| :------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------- |
| `add_marker` / `remove_marker` / `get_markers`                                          | 타임라인에서 마커를 추가, 제거 또는 읽습니다.                                          |
| `select_clip` / `deselect_clip` / `get_selected_clips`                                  | 클립 선택을 관리하고 현재 선택 항목을 읽습니다.                                        |
| `go_to_time` / `zoom_to_time` / `set_playhead`                                        | 재생 헤드를 이동하고 보기를 특정 시간 또는 클립으로 이동합니다.                         |
| `get_sequence_info` / `get_project_info` / `get_clip_info`                              | 시퀀스, 프로젝트 또는 클립에 대한 메타데이터를 읽습니다.                                |
| `set_sequence_settings` / `set_project_settings`                                        | 시퀀스 또는 프로젝트 설정을 수정합니다.                                                 |
| `get_sequence_markers` / `get_clip_markers`                                             | 시퀀스 또는 클립과 관련된 마커를 검색합니다.                                            |

### 고급 및 진단 도구

| Tools                                                                                   | 기능                                                                                     |
| :------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------- |
| `run_extendscript` / `evaluate_expression` / `inspect_dom`                              | 고급 진단 및 스크립팅. 신뢰할 수 있는 입력에서만 사용하세요.                                |
| `get_timeline_preview` / `render_preview` / `export_frame`                              | 타임라인 또는 현재 프레임의 미리보기를 생성합니다.                                         |
| `set_render_settings` / `get_render_settings`                                           | 렌더링 및 내보내기 구성을 읽고 수정합니다.                                                 |
| `get_logs` / `clear_logs` / `set_log_level`                                             | 진단 로그를 읽고, 지우고, 상세 수준을 설정합니다.                                           |
| `get_system_info` / `get_application_info` / `get_plugin_list`                          | 시스템 및 응용 프로그램 정보를 읽거나 설치된 플러그인을 나열합니다.                          |

### 추가 지원 작업

나머지 카탈로그는 미디어 속성, 프로젝트 경로, 표시 설정, 안티앨리어싱, 포스터 프레임, 트랙 타겟팅, 프로젝트 경로, 프로젝트 수 등에 대한 하위 수준 제어를 다룹니다. 여기에는 `set_override_frame_rate`, `set_override_pixel_aspect_ratio`, `set_frame_blend`, `set_interpolation`, `set_poster_frame`, `set_anti_alias_quality`, `set_uniform_scale`, `set_scale_width_height`, `set_display_mode`, `set_scratch_disk`, `get_scratch_disks`, `get_project_paths`, `get_clip_count`, `get_active_bin`, `is_workflow_active`, `match_frame` 등이 포함됩니다.

각 도구의 정확한 입력 스키마와 반환 형태는 클라이언트에서 MCP introspection을 사용하세요. 에이전트는 먼저 검사하고, 집중된 변경을 수행한 다음, 영향을 받은 상태를 다시 읽어야 합니다.| 도구 | 기능 |
| :------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------- |
| `list_available_effects` / `get_clip_effects` / `get_effect_properties` | 설치된 효과와 클립에 적용된 효과, 해당 속성을 조회합니다. |
| `apply_effect` / `remove_effect` / `remove_effect_by_name` / `remove_all_effects` | 클립에 효과를 추가하거나 제거합니다. `apply_effect`는 새 구성 요소를 식별하고 다시 읽습니다. |
| `batch_apply_effects` / `copy_effects_between_clips` / `copy_effect_values` | 여러 클립에 걸쳐 효과를 일괄 적용하거나 복사합니다. |
| `set_effect_property` / `set_effect_color` / `set_effect_blend_mode`                   | 지원되는 효과 매개변수, 색상 값 또는 블렌드 모드를 설정합니다. |
| `color_correct` / `apply_lut` / `stabilize_motion`                                      | 색상 보정, LUT 적용, 또는 Warp Stabilizer를 적용합니다.                                   |
| `crop_clip` / `add_adjustment_layer` / `get_adjustment_layer_for_clip`                | 클립을 자르거나 조정 레이어를 사용하여 공통 처리를 적용합니다.                                |
| `set_clip_properties` / `set_clip_properties_batch`                                    | 속성별 검증된 출력으로 불투명도, 배율, 회전 및 위치를 설정합니다.                             |
| `set_clip_position` / `set_clip_scale` / `set_clip_rotation` / `set_clip_anchor`      | 개별 모션 변형 값을 처리합니다.                                                          |
| `add_keyframe` / `get_keyframes` / `remove_keyframe` / `remove_keyframe_range`         | 매개변수 키프레임을 생성, 검사 및 제거합니다.                                             |
| `set_keyframe_interpolation` / `get_value_at_time`                                     | 보간을 설정하거나 특정 시간의 매개변수 값을 쿼리합니다.                                      |

### 오디오, 전환 및 캡션

| Tools                                                                   | 기능                                                                                     |
| :----------------------------------------------------------------------- | :--------------------------------------------------------------------------------------- |
| `adjust_audio_levels` / `set_clip_volume` / `set_clip_pan`              | 클립 게인, 볼륨 또는 팬을 설정합니다.                                                      |
| `add_audio_keyframes` / `setup_ducking`                                 | 제공된 창에서 볼륨 자동화 또는 전체 오디오 덕킹 곡선을 생성합니다.                          |
| `mute_track` / `apply_audio_effect` / `apply_audio_effect_to_all_clips`  | 트랙을 음소거하거나 하나 또는 여러 클립에 오디오 처리를 적용합니다.                          |
| `detect_silence`                                                        | ffmpeg를 사용하여 로컬 미디어 파일을 분석하고 무음 구간을 반환합니다. 타임라인을 편집하지 않습니다. |
| `list_available_transitions` / `list_available_audio_transitions`        | 설치된 전환 이름을 나열합니다.                                                             |
| `add_transition` / `add_transition_to_clip` / `batch_add_transitions`    | 하나 또는 여러 전환을 추가합니다. 결과는 검증된 변경 사항과 수락되었지만 검증되지 않은 호스트 응답을 구분합니다. |
| `create_caption_track_from_file` | SRT 또는 VTT와 같은 자막 파일에서 캡션 트랙을 생성합니다.                                       |
| `read_sequence_captions`                                                | 시퀀스에서 캡션 트랙을 읽습니다.                                                             |

### 추가 지원 작업

나머지 카탈로그는 미디어 속성, 프로젝트 설정, 디스플레이 설정, 안티앨리어싱, 포스터 프레임, 색상 레이블, 선택, 트랙 타겟팅, 프로젝트 경로 및 프로젝트 수에 대한 하위 수준 제어를 다룹니다. 여기에는 `set_override_frame_rate`, `set_override_pixel_aspect_ratio`, `set_frame_blend`, `set_interpolation`, `set_poster_frame`, `set_anti_alias_quality`, `set_uniform_scale`, `set_scale_width_height`, `set_sequence_display_mode`, `set_project_scratch_disk`, `get_project_scratch_disks`, `get_all_project_paths`, `get_total_clip_count`, `get_insertion_bin`, `is_track_targeted`, 및 `match_frame`이 포함됩니다.

각 도구의 정확한 입력 및 반환 형태에 대해서는 클라이언트에서 MCP 검사를 사용하세요. 에이전트는 먼저 검사하고, 집중적으로 변경을 수행한 다음, 영향을 받은 상태를 다시 읽어야 합니다.OK — here’s the requested table and section translated into Korean. All code identifiers, tool names, and technical terms are preserved, and the markdown structure is kept identical.

---

### 오디오, 전환 및 캡션

| 도구                                                                                   | 기능                                                                                                                       |
| :------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------- |
| `adjust_audio_levels` / `set_clip_volume` / `set_clip_pan`                             | 클립 게인, 볼륨 또는 팬을 설정합니다.                                                                                      |
| `add_audio_keyframes` / `setup_ducking`                                                | 볼륨 자동화 또는 지정된 구간부터 전체 덕킹 곡선을 생성합니다.                                                              |
| `mute_track` / `apply_audio_effect` / `apply_audio_effect_to_all_clips`                | 트랙을 음소거하거나 하나 또는 여러 클립에 오디오 효과를 적용합니다.                                                          |
| `detect_silence`                                                                       | ffmpeg를 사용하여 로컬 미디어 파일을 분석하고 무음 구간을 반환합니다. 타임라인을 편집하지 않습니다.                                                       |
| `list_available_transitions` / `list_available_audio_transitions`                      | 설치된 전환 이름을 확인합니다.                                                                                     |
| `add_transition` / `add_transition_to_clip` / `batch_add_transitions`                  | 하나 또는 여러 전환을 추가합니다. 결과는 검증된 변경 사항과 수락되었으나 검증되지 않은 호스트 응답을 구분합니다.                          |
| `create_caption_track`                                                                 | SRT와 같은 가져온 자막 프로젝트 항목에서 캡션 트랙을 생성합니다.                                                            |
| `read_sequence_captions`                                                               | 시퀀스에서 캡션을 읽습니다. 호스트가 기존 캡션 텍스트를 노출하지 않는 경우도 있습니다.                                            |

### 마커, 선택 및 재생

| 도구                                                                                   | 기능                                                                                 |
| :------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------- |
| `add_marker` / `get_markers` / `remove_marker` / `clear_markers`                       | 타임라인 또는 클립에 마커를 추가, 읽기, 제거, 지웁니다.                                 |
| `set_playhead` / `get_playhead` / `go_to_time`                                         | 재생 헤드를 특정 시간으로 이동하거나 현재 위치를 읽습니다.                                |
| `select_clip` / `get_selected_clips` / `deselect_all_clips`                            | 타임라인에서 클립 선택을 관리합니다.                                                        |
| `set_track_targeting` / `get_track_targeting`                                          | 트랙 타겟팅(V1, A1 등)을 설정하거나 읽습니다.                                              |
| `get_sequence_info` / `get_project_info` / `get_clip_info`                             | 시퀀스, 프로젝트 또는 클립에 대한 메타데이터를 읽습니다.                                   |
| `set_sequence_settings` / `set_project_settings`                                       | 시퀀스 또는 프로젝트 설정을 수정합니다.                                                    |
| `get_sequence_markers` / `get_clip_markers`                                            | 시퀀스 또는 클립에서 마커를 검색합니다.                                                    |

This continues the same style as the rest of the page. If you want the tables further down (for “Audio, transitions, and captions” section) translated too, just let me know.

* Premiere 스크립팅은 여전히 모든 UI 작업을 깔끔하게 노출하지는 않습니다.
* 캡션 트랙은 Speech-to-Text 트랜스크립트와 동일하지 않습니다. `read_sequence_captions`는 CEP를 통해서는 여전히 사용할 수 없으며, `read_sequence_transcription`은 UXP를 통해 소스 클립 트랜스크립트를 읽습니다.
* 전문적인 타이틀 디자인은 여전히 실제 MOGRT 자산이나 외부 그래픽 워크플로에 의존합니다.
* `get_render_queue_status`는 Adobe Media Encoder 통합을 사용할 수 있을 때만 유용합니다.
* 최상의 결과는 실제 소스 푸티지, 실제 오디오, 실제 브랜드 자산에서 나옵니다. 자동화 레이어는 이들을 조합하고 조작할 뿐, 편집자의 판단을 대체하지는 않습니다.

## 문제 해결

도구는 표시되지만 호출이 실패하는 경우:

1. Premiere Pro가 열려 있고 프로젝트가 로드되어 있는지 확인합니다.
2. `Window > Extensions > MCP Bridge (CEP)`를 엽니다.
3. 임시 디렉터리가 정확히 `/tmp/premiere-mcp-bridge`인지 확인합니다.
4. `Start Bridge`를 클릭합니다.
5. 브리지 코드를 업데이트한 경우 패널을 마우스 오른쪽 버튼으로 클릭하고 `Reload`를 선택합니다.
6. 명령을 다시 시도합니다.

`read_sequence_transcription`이 UXP 브리지를 사용할 수 없다고 보고하는 경우:

1. Premiere Pro 25.6 이상을 사용합니다.
2. Plugins > Enable Developer Mode를 활성화한 다음 Adobe UXP Developer Tool로 `uxp-plugin`을 로드합니다.
3. `Window > UXP Plugins > MCP Transcript Bridge`를 엽니다.
4. `/tmp/premiere-mcp-bridge`를 입력하고 `Save bridge root`를 클릭한 다음 `Start Bridge`를 클릭합니다.
5. 시퀀스의 소스 클립이 Premiere의 Text 패널에서 트랜스크립션되었는지 확인합니다. 일부 소스 클립에 트랜스크립트가 없으면 도구는 부분 결과를 반환합니다.

MCP 클라이언트가 서버를 찾을 수 없는 경우:

1. `dist/index.js`의 절대 경로를 확인합니다.
2. `PREMIERE_TEMP_DIR=/tmp/premiere-mcp-bridge`를 확인합니다.
3. 구성을 변경한 후 MCP 클라이언트를 다시 시작합니다.
4. `npm run setup:doctor`를 실행합니다.

## 개발자 참고 사항

유용한 명령:

GXP18

참고:

* `QUICKSTART.md`: 가장 빠른 설치 경로
* `KNOWN_ISSUES.md`: 현재 제한 사항
* `CONTRIBUTING.md`: 개발 워크플로