Skip to main content
The AI dock 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:
<install> is the folder CoClip is installed in. By default it is %LOCALAPPDATA%\Programs\CoClip.
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

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.

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.
  • 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 for what each skill does.

Claude Desktop

1

Open the config file

In Claude Desktop, open Settings → Developer → Edit Config. The file is:
%APPDATA%\Claude\claude_desktop_config.json
2

Add the coclip server

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

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.

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.
In PowerShell:
OpenCode asks before each CoClip tool call. Approve each call when it asks (recommended).
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.

Antigravity

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

Open the config file

%USERPROFILE%\.gemini\config\mcp_config.json
2

Add the coclip server

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.

How it works with the editor

Every edit can be undone. See AI log and undo.

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.