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

# Kết nối agent bên ngoài editor

> Đăng ký MCP server của CoClip trong Claude Code, Claude Desktop, Codex, OpenCode hoặc Antigravity khi bạn tự mở chúng.

[AI dock](/docs/vi/ai-agents/ai-dock.md) không cần thiết lập gì. Dùng trang này khi bạn tự mở agent, từ terminal, Claude Desktop hoặc một IDE. Bạn đăng ký MCP server của CoClip một lần trong cấu hình riêng của agent đó. CoClip không bao giờ tự ghi vào cấu hình agent của bạn.

## Trước khi bắt đầu

CoClip cài MCP server ngay cạnh ứng dụng. Bạn trỏ agent tới tệp này:

> [tab] Windows
>
> ```text theme={null}
> <install>\resources\bin\coclip-mcp.exe
> ```
>
> `<install>` là thư mục cài CoClip. Mặc định là `%LOCALAPPDATA%\Programs\CoClip`.

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

Trong các lệnh bên dưới:

* Thay `<install>` bằng thư mục CoClip của bạn (Windows).
* Thay `<project folder>` bằng đường dẫn đầy đủ tới một thư mục dự án. Phần `--project` là tuỳ chọn: nó đặt dự án mặc định. Nếu bỏ đi, hãy nói với agent thư mục dự án cần mở, hoặc nhờ agent tạo dự án mới.
* Trong tệp JSON, mỗi dấu gạch ngược của Windows phải viết hai lần: `\\`.

## Claude Code

**1. Đăng ký 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>"
> ```

Thêm `--scope project` để lưu mục này vào tệp `.mcp.json` của thư mục hiện tại thay vì cấu hình người dùng.

**2. Kiểm tra kết nối**

Mở Claude Code và chạy `/mcp`. `coclip` hiện trạng thái đã kết nối, kèm danh sách công cụ.

Để gỡ, chạy `claude mcp remove coclip`.

Mới dùng Claude Code? Hãy cài và đăng nhập trước: xem [Claude Code](/docs/vi/ai-agents/claude-code.md).

### Thêm plugin CoClip (skill và vai trò agent)

CoClip cũng kèm một plugin Claude Code chứa các quy trình làm video: skill CoClip và năm vai trò agent. Thư mục plugin là một nguồn plugin cục bộ trên máy bạn; không có gì được tải về. Plugin không chứa MCP server, nên hãy đăng ký server trước.

> [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
> ```

* Kiểm tra bằng `claude plugin details coclip@coclip`. Lệnh này liệt kê skill và agent.
* Trong phiên, chạy skill bằng `/coclip:explainer-video` (và tương tự), hoặc chỉ cần mô tả việc cần làm: Claude tự chọn skill phù hợp.
* Sau khi cập nhật CoClip, chạy `claude plugin marketplace update coclip`, rồi mở phiên Claude Code mới.
* Để gỡ, chạy `claude plugin uninstall coclip@coclip`, rồi `claude plugin marketplace remove coclip`.

Xem [Skill và vai trò agent](/docs/vi/ai-agents/skills-and-agents.md) để biết mỗi skill làm gì.

## Claude Desktop

**1. Mở tệp cấu hình**

Trong Claude Desktop, mở **Settings** → **Developer** → **Edit Config**. Tệp đó là:

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

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

**2. Thêm server coclip**

> [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>"]
>     }
>   }
> }
> ```

Nếu tệp đã có server khác, hãy thêm `coclip` vào trong khối `mcpServers` sẵn có.

**3. Khởi động lại Claude Desktop**

Thoát hẳn rồi mở lại Claude Desktop để nạp server.

## Codex

**1. Đăng ký 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. Kiểm tra kết nối**

Chạy `codex mcp list`, hoặc `/mcp` trong một phiên Codex.

**3. Duyệt từng lần gọi công cụ**

Codex hỏi trước mỗi lần gọi công cụ CoClip. Hãy duyệt từng lần khi được hỏi. Chúng tôi khuyên dùng cách duyệt từng lần này khi chạy bên ngoài editor.

* Để gỡ, chạy `codex mcp remove coclip`.
* **Skill (tuỳ chọn).** CoClip kèm sẵn skill đã chuẩn bị cho Codex trong `<install>\resources\codex-bundle\skills` (macOS: `/Applications/CoClip.app/Contents/Resources/codex-bundle/skills`). Để dùng chúng bên ngoài editor, hãy chép các thư mục đó vào thư mục `~/.agents/skills/` của bạn. Vai trò agent của CoClip chỉ hoạt động trong AI dock.

Mới dùng Codex? Hãy cài và đăng nhập trước: xem [Codex](/docs/vi/ai-agents/codex.md).

## OpenCode

OpenCode v2 có thể dùng server cho một lần chạy, không ghi gì vào cấu hình OpenCode của bạn. Cách này chỉ thêm server; skill và vai trò agent của CoClip đi kèm các phiên trong AI dock.

> [tab] Windows
>
> Trong 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
>
> Trong 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 hỏi trước mỗi lần gọi công cụ CoClip. Hãy duyệt từng lần khi được hỏi (khuyên dùng).

> [!WARNING]
>
> Đừng thêm quy tắc cho phép mọi công cụ CoClip vào cấu hình OpenCode toàn cục. Quy tắc đó sẽ cho phép sẵn các công cụ này trong mọi phiên OpenCode trên máy bạn, kể cả phiên mở trong thư mục không liên quan.

Mới dùng OpenCode? Hãy cài v2 và đăng nhập trước: xem [OpenCode](/docs/vi/ai-agents/opencode.md).

## Antigravity

Khi bạn tự mở Antigravity, nó đọc MCP server từ tệp cấu hình riêng của bạn. Hãy tự thêm mục này:

**1. Mở tệp cấu hình**

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

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

**2. Thêm server coclip**

> [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. Chỉ duyệt cho cuộc trò chuyện này**

Antigravity hỏi trước mỗi lần gọi công cụ CoClip (**Allow calling this tool?**). Hãy duyệt cho cuộc trò chuyện. Quyền này hết hiệu lực khi phiên kết thúc.

Không bao giờ cho phép mọi công cụ của mọi MCP server. Làm vậy sẽ cho phép cả các server mà một dự án tự thêm vào. Cách này chỉ thêm server; skill và vai trò agent của CoClip đi kèm các phiên trong AI dock. Hỗ trợ Antigravity đang thử nghiệm: xem [Antigravity](/docs/vi/ai-agents/antigravity.md).

## Cách hoạt động cùng editor

| Trạng thái editor | Điều gì xảy ra |
| - | - |
| Đang mở đúng dự án | Chỉnh sửa đi qua editor. Chúng hiện ngay trên timeline và trong **AI log** dưới tên agent ("Claude", "Codex", "OpenCode", "Antigravity"). |
| Đang đóng | Chỉnh sửa được lưu thẳng vào thư mục dự án. Bạn thấy chúng ở lần mở dự án tiếp theo. |
| Đang đóng, và agent cần khung hình preview hoặc xuất video | CoClip mở cửa sổ editor bình thường, nhìn thấy được, trên dự án đó và render ở đó. Không có gì render ngầm. |
| Đang mở dự án khác | CoClip mở dự án của agent trong một cửa sổ riêng, phía sau cửa sổ của bạn, và hiện thông báo nêu tên agent. CoClip không bao giờ đổi dự án bạn đang làm. Nếu bạn đã đạt giới hạn số dự án mở, không có gì được mở và agent sẽ báo bạn. |

Mọi chỉnh sửa đều hoàn tác được. Xem [AI log và hoàn tác](/docs/vi/ai-agents/ai-log-and-undo.md).

Ảnh minh hoạ sẽ được bổ sung

Danh sách /mcp của Claude Code trong terminal
Trạng thái: coclip đã kết nối
Làm nổi bật: Dòng server coclip

## Sau khi cập nhật CoClip

* Mở một phiên agent mới. Phiên đang chạy có thể giữ danh sách công cụ cũ, nên tuỳ chọn mới có vẻ bị thiếu cho tới khi bạn khởi động lại phiên.
* Plugin Claude Code: chạy `claude plugin marketplace update coclip` trước.

## Trang liên quan

* [Công cụ MCP](/docs/vi/ai-agents/mcp-tools.md)
* [Skill và vai trò agent](/docs/vi/ai-agents/skills-and-agents.md)
* [Khắc phục sự cố](/docs/vi/reference/troubleshooting.md)


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