> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect agents outside the editor

> Register the CoClip MCP server in Claude Code, Claude Desktop, Codex, OpenCode or Antigravity started on their own.

The [AI dock](/docs/ai-agents/ai-dock.md) needs no setup. Use this page when you start an agent on your own, from a terminal, Claude Desktop or an IDE. You register the CoClip MCP server once in that agent's own configuration. CoClip never writes to your agent configuration for you.

## Before you start

CoClip installs its MCP server next to the app. You point your agent at this file:

> [tab] Windows
>
> ```text theme={null}
> <install>\resources\bin\coclip-mcp.exe
> ```
>
> `<install>` is the folder CoClip is installed in. By default it is `%LOCALAPPDATA%\Programs\CoClip`.

> [tab] macOS
>
> ```text theme={null}
> /Applications/CoClip.app/Contents/Resources/bin/coclip-mcp
> ```

In the commands below:

* Replace `<install>` with your CoClip folder (Windows).
* Replace `<project folder>` with the full path of a project folder. The `--project` part is optional: it sets the default project. Leave it out and tell the agent which project folder to open, or ask it to create a new project.
* In JSON files, write each Windows backslash twice: `\\`.

## Claude Code

**1. Register the server**

> [tab] Windows
>
> ```powershell theme={null}
> claude mcp add --transport stdio coclip -- "<install>\resources\bin\coclip-mcp.exe" --project "<project folder>"
> ```

> [tab] macOS
>
> ```bash theme={null}
> claude mcp add --transport stdio coclip -- /Applications/CoClip.app/Contents/Resources/bin/coclip-mcp --project "<project folder>"
> ```

Add `--scope project` to store the entry in the current folder's `.mcp.json` instead of your user config.

**2. Check the connection**

Start Claude Code and run `/mcp`. `coclip` shows as connected, with its tools listed.

To remove it, run `claude mcp remove coclip`.

New to Claude Code? Install it and sign in first: see [Claude Code](/docs/ai-agents/claude-code.md).

### Add the CoClip plugin (skills and agent roles)

CoClip also ships a Claude Code plugin with its video workflows: the CoClip skills and five agent roles. The plugin folder is a local plugin source on your computer; nothing is downloaded. It does not contain the MCP server, so register the server first.

> [tab] Windows
>
> ```powershell theme={null}
> claude plugin marketplace add "<install>\resources\claude-plugin"
> claude plugin install coclip@coclip
> ```

> [tab] macOS
>
> ```bash theme={null}
> claude plugin marketplace add /Applications/CoClip.app/Contents/Resources/claude-plugin
> claude plugin install coclip@coclip
> ```

* Check it with `claude plugin details coclip@coclip`. It lists the skills and the agents.
* In a session, run a skill as `/coclip:explainer-video` (and so on), or just describe the task: Claude picks the matching skill.
* After updating CoClip, run `claude plugin marketplace update coclip`, then start a new Claude Code session.
* To remove it, run `claude plugin uninstall coclip@coclip`, then `claude plugin marketplace remove coclip`.

See [Skills and agent roles](/docs/ai-agents/skills-and-agents.md) for what each skill does.

## Claude Desktop

**1. Open the config file**

In Claude Desktop, open **Settings** → **Developer** → **Edit Config**. The file is:

> [tab] Windows
>
> `%APPDATA%\Claude\claude_desktop_config.json`

> [tab] macOS
>
> `~/Library/Application Support/Claude/claude_desktop_config.json`

**2. Add the coclip server**

> [tab] Windows
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "coclip": {
>       "command": "<install>\\resources\\bin\\coclip-mcp.exe",
>       "args": ["--project", "<project folder>"]
>     }
>   }
> }
> ```

> [tab] macOS
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "coclip": {
>       "command": "/Applications/CoClip.app/Contents/Resources/bin/coclip-mcp",
>       "args": ["--project", "<project folder>"]
>     }
>   }
> }
> ```

If the file already has other servers, add `coclip` inside the existing `mcpServers` block.

**3. Restart Claude Desktop**

Quit and reopen Claude Desktop so it loads the server.

## Codex

**1. Register the server**

> [tab] Windows
>
> ```powershell theme={null}
> codex mcp add coclip -- "<install>\resources\bin\coclip-mcp.exe" --project "<project folder>"
> ```

> [tab] macOS
>
> ```bash theme={null}
> codex mcp add coclip -- /Applications/CoClip.app/Contents/Resources/bin/coclip-mcp --project "<project folder>"
> ```

**2. Check the connection**

Run `codex mcp list`, or `/mcp` inside a Codex session.

**3. Approve tool calls as they come**

Codex asks before each CoClip tool call. Approve each call when it asks. We recommend this per-call approval outside the editor.

* To remove it, run `codex mcp remove coclip`.
* **Skills (optional).** CoClip ships its skills prepared for Codex in `<install>\resources\codex-bundle\skills` (macOS: `/Applications/CoClip.app/Contents/Resources/codex-bundle/skills`). To use them outside the editor, copy those folders into your own `~/.agents/skills/` folder. The CoClip agent roles work only in the AI dock.

New to Codex? Install it and sign in first: see [Codex](/docs/ai-agents/codex.md).

## OpenCode

OpenCode v2 can use the server for one run, with nothing written to your OpenCode config. This form adds the server only; CoClip's skills and agent roles come with AI dock sessions.

> [tab] Windows
>
> In PowerShell:
>
> ```powershell theme={null}
> $env:OPENCODE_CONFIG_CONTENT = '{"mcp":{"servers":{"coclip":{"type":"local","command":["<install>\\resources\\bin\\coclip-mcp.exe","--project","<project folder>"]}}}}'
> opencode
> Remove-Item Env:OPENCODE_CONFIG_CONTENT
> ```

> [tab] macOS
>
> In Terminal:
>
> ```bash theme={null}
> OPENCODE_CONFIG_CONTENT='{"mcp":{"servers":{"coclip":{"type":"local","command":["/Applications/CoClip.app/Contents/Resources/bin/coclip-mcp","--project","<project folder>"]}}}}' opencode
> ```

OpenCode asks before each CoClip tool call. Approve each call when it asks (recommended).

> [!WARNING]
>
> Do not add a rule that approves every CoClip tool in your global OpenCode config. It would pre-approve those tools in every OpenCode session on your computer, including sessions in unrelated folders.

New to OpenCode? Install v2 and sign in first: see [OpenCode](/docs/ai-agents/opencode.md).

## Antigravity

Antigravity started on its own reads its MCP servers from your own config file. Add the entry yourself:

**1. Open the config file**

> [tab] Windows
>
> `%USERPROFILE%\.gemini\config\mcp_config.json`

> [tab] macOS
>
> `~/.gemini/config/mcp_config.json`

**2. Add the coclip server**

> [tab] Windows
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "coclip": {
>       "command": "<install>\\resources\\bin\\coclip-mcp.exe",
>       "args": ["--project", "<project folder>"]
>     }
>   }
> }
> ```

> [tab] macOS
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "coclip": {
>       "command": "/Applications/CoClip.app/Contents/Resources/bin/coclip-mcp",
>       "args": ["--project", "<project folder>"]
>     }
>   }
> }
> ```

**3. Approve for this conversation only**

Antigravity asks before each CoClip tool call (**Allow calling this tool?**). Approve it for the conversation. The approval ends with the session.

Never approve all tools of all MCP servers. That would also approve servers a project adds. This form adds the server only; CoClip's skills and agent roles come with AI dock sessions. Antigravity support is experimental: see [Antigravity](/docs/ai-agents/antigravity.md).

## How it works with the editor

| Editor state | What happens |
| - | - |
| Open on the same project | Edits go through the editor. They appear live on the timeline and in the **AI log** under the agent's name ("Claude", "Codex", "OpenCode", "Antigravity"). |
| Closed | Edits are saved straight to the project folder. You see them next time you open the project. |
| Closed, and the agent asks for a preview frame or an export | CoClip opens the normal, visible editor window on that project and renders there. Nothing renders in the background. |
| Open on another project | CoClip opens the agent's project in its own window, behind yours, and shows a notice naming the agent. It never switches your project. If you reached your open-projects limit, nothing opens and the agent tells you. |

Every edit can be undone. See [AI log and undo](/docs/ai-agents/ai-log-and-undo.md).

Screenshot coming soon

Claude Code /mcp list in a terminal
State: coclip connected
Highlight: coclip server row

## After you update CoClip

* Start a new agent session. A running session can keep the old tool list, so new options look missing until you restart it.
* Claude Code plugin: run `claude plugin marketplace update coclip` first.

## Related pages

* [MCP tools](/docs/ai-agents/mcp-tools.md)
* [Skills and agent roles](/docs/ai-agents/skills-and-agents.md)
* [Troubleshooting](/docs/reference/troubleshooting.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.