# AVE MCP

AVE MCP connects local Codex CLI or Claude Code installations to AVE through an authenticated bridge on the same Mac.

## Supported clients

- Codex CLI
- Claude Code

AVE MCP is not a ChatGPT cloud connector, Claude Desktop integration, remote MCP endpoint, or public MCP server.

## Tool and permission surface

- Tool surface: 20 AVE tools
- Permission model: 8 access scopes
- Connection: Local authenticated bridge

The tool surface supports:

- Discover AVE projects and read their structure, assets, analysis, sequences, clips, and transitions.
- Search analyzed footage by transcript, visual evidence, detections, and timecoded frame descriptions.
- Create projects, import selected local media, and build sequences from source ranges.
- Plan or directly apply validated timeline edits, including trims, transitions, captions, graphics, motion, audio, and color work.
- Render bounded review frames so the assistant can inspect the visible result before continuing.
- Run export preflight and render finished videos through AVE on the Mac.

## Setup

1. Connect once: Open AVE Settings, choose Connections, and connect Codex CLI or Claude Code. Restart that assistant once so it can load the AVE tool surface.
2. Choose the control level: Let AVE plan edits or let the connected assistant plan them. AVE asks before consequential work by default, with an optional Approve for me setting.
3. Work from your assistant: Describe the edit in Codex or Claude Code. The assistant reads AVE project context, uses the allowed tools, checks jobs, reviews frames, and can export the result.

## Planning and approvals

- AVE plans: The connected assistant orchestrates the request while AVE uses its configured editing assistant to create the edit plan.
- Codex or Claude plans: The connected assistant reads AVE project context, authors the plan itself, and sends validated actions to AVE for local execution.

AVE asks before consequential project, import, edit, and export work by default. Approve for me is optional and configured separately for each connected assistant.

## Local boundary

- Designed for local Codex CLI and Claude Code installations on the same Mac as AVE.
- Not a ChatGPT cloud connector, Claude Desktop integration, remote MCP endpoint, or public MCP server.
- Source footage stays local. Only information and rendered review frames allowed by the selected scopes are returned to the connected assistant.
- Each assistant has its own access, planning, and approval settings, and AVE remains the execution boundary for project changes.

## Official page

- https://aivideoeditor.app/mcp/