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

# Tham chiếu công cụ MCP

> Các nhóm công cụ agent dùng để chỉnh dự án CoClip của bạn, kèm một prompt mẫu cho mỗi nhóm.

Agent chỉnh dự án của bạn thông qua MCP server của CoClip. Mọi agent đều có cùng bộ công cụ, trong [AI dock](/docs/vi/ai-agents/ai-dock.md) lẫn [bên ngoài editor](/docs/vi/ai-agents/outside-the-editor.md). Bạn không tự gọi công cụ: bạn chỉ cần nói bằng lời thường, agent sẽ chọn công cụ.

Trang này liệt kê các nhóm công cụ theo đúng thứ tự agent nhìn thấy, kèm tên công cụ của mỗi nhóm và một prompt để thử. Danh sách chính xác có thể thay đổi giữa các bản phát hành CoClip. Để xem các công cụ trong phiên bản của bạn, chạy `/mcp` trong Claude Code.

> [!TIP]
>
> Trong Claude Code, công cụ hiện kèm tiền tố, ví dụ `mcp__coclip__clip_add`. Phần tên sau tiền tố chính là tên được liệt kê ở đây.

## Các nhóm công cụ

| Nhóm | Dùng để | Công cụ | Thử hỏi |
| - | - | - | - |
| Dự án | Tạo, mở, đọc và kiểm tra dự án. | `project_create`, `project_open`, `project_get`, `project_validate`, `project_schema` | "Mở dự án và cho tôi biết trên timeline đang có gì." |
| Clip script | Đọc và ghi clip script theo từng dòng. | `script_get`, `script_set`, `script_edit_line` | "Viết clip script cho video mẹo 30 giây từ ghi chú của tôi." |
| Media | Nhập, đổi tên, liên kết lại, kiểm tra và xoá media trong Library. | `media_import`, `media_remove`, `media_remove_unused`, `media_rename`, `media_relink`, `media_inspect`, `media_list` | "Nhập mọi video trong thư mục Downloads và liệt kê chúng." |
| Timeline | Thêm track; đặt, di chuyển, cắt, tách, xoá và căn khung clip. | `track_add`, `track_reorder`, `track_remove_empty`, `track_compact_lanes`, `clip_add`, `clip_move`, `clip_move_many`, `clip_trim`, `clip_split`, `clip_delete`, `timeline_ripple`, `clip_extend_to_source`, `clip_replace_asset`, `clip_set_transform`, `clip_set_framing`, `clip_set_transform_many` | "Tách clip mở đầu ở giây thứ 3 và xoá phần đầu." |
| Thời gian | Đổi tốc độ clip, frame rate và kích thước canvas. | `clip_set_speed`, `canvas_set_fps`, `canvas_set_size` | "Cho clip này chạy ở tốc độ 1.5×." |
| Chữ và kiểu chữ | Chèn và sửa chữ; tạo và áp dụng kiểu chữ. | `text_insert`, `text_update`, `style_create`, `style_update`, `style_apply` | "Thêm tiêu đề "3 lỗi người mới hay mắc" ở trên cùng trong 4 giây." |
| Phông chữ | Liệt kê phông chữ có sẵn trong CoClip và thêm vào dự án. | `font_list`, `font_use` | "Dùng một phông chữ đậm, bo tròn, hỗ trợ tiếng Việt cho tiêu đề." |
| Google Fonts | Tìm, tải và xem trước Google Fonts. | `font_search`, `font_download`, `font_preview` | "Tìm ba phông viết tay trên Google Fonts và cho tôi xem thử." |
| Mẫu chữ | Lưu kiểu chữ thành mẫu và áp dụng lại. | `template_save`, `template_apply` | "Lưu tiêu đề này thành mẫu và dùng cho mọi tiêu đề phần." |
| Phụ đề | Lưu transcript, tìm từ, tạo và sửa phụ đề. | `transcript_set`, `transcript_find`, `captions_from_transcript`, `captions_edit_word`, `captions_retime` | "Tạo phụ đề từ voice-over và làm nổi bật các từ khoá." |
| Hiệu ứng | Âm lượng và fade, chuyển cảnh, keyframe, zoom, tách và khôi phục âm thanh. | `audio_set`, `transition_set`, `transition_list`, `transition_apply`, `keyframe_set`, `zoom_from_events`, `fx_delete`, `clip_extract_audio`, `clip_restore_audio` | "Thêm chuyển cảnh nhẹ ở mọi điểm cắt trên track video chính." |
| Camera | Thêm hoặc đổi chuyển động camera cho các track bên dưới. | `camera_set` | "Zoom chậm vào biểu đồ từ giây 10 đến giây 14." |
| Bộ lọc | Liệt kê các tông màu và thêm hoặc đổi bộ lọc. | `filter_list`, `filter_add`, `filter_update` | "Cho cả video tông màu phim ấm." |
| Xem trước và xuất | Xem trước khung hình, chụp màn hình editor, bắt đầu, theo dõi và huỷ xuất video. | `preview_frame`, `editor_screenshot`, `export_start`, `export_status`, `export_cancel` | "Cho tôi xem contact sheet của 10 giây đầu." |
| Hoà âm | Đo độ to và kiểm tra giọng so với nhạc. | `audio_mix_check`, `audio_measure` | "Kiểm tra nhạc không bao giờ lấn át giọng nói." |
| Bố cục | Kiểm tra chồng lấn, chữ nhỏ, đối tượng ra ngoài khung và vùng an toàn mà không cần render. | `layout_check` | "Kiểm tra bố cục theo vùng an toàn TikTok và sửa lỗi nếu có." |
| Lịch sử | Liệt kê chỉnh sửa, hoàn tác và làm lại. | `history_list`, `history_undo`, `history_redo` | "Hoàn tác chỉnh sửa gần nhất của bạn." |
| Vùng chọn | Đọc những gì bạn đã chọn trên timeline. | `selection_get` | "Giảm âm lượng các clip đang chọn 20%." |
| Tự động hoá | Áp dụng nhiều chỉnh sửa một lần, cắt đoạn, tìm khoảng lặng và chuyển cảnh, chuyển giọng nói thành chữ. | `commands_apply`, `clip_remove_ranges`, `audio_detect_silence`, `media_detect_scenes`, `transcript_generate` | "Tìm các khoảng lặng trong bản ghi và cắt bỏ." |
| Giọng đọc và nhạc | Tạo và kiểm tra voice-over, từ điển phát âm và nhạc qua connector của bạn. | `connectors_list`, `tts_voices`, `tts_generate`, `tts_generate_script`, `tts_verify`, `tts_dictionary_create`, `tts_dictionary_add_rules`, `music_plan`, `music_generate`, `jobs_wait` | "Tạo voice-over cho từng dòng script bằng giọng quen thuộc của tôi." |
| Hiệu ứng âm thanh | Tìm, tạo, đặt và kiểm tra hiệu ứng âm thanh theo điểm nhấn hình ảnh. | `sfx_search`, `sfx_generate`, `sfx_insert`, `visual_cues`, `sfx_check` | "Thêm tiếng "whoosh" mỗi khi tiêu đề xuất hiện." |
| Tạo ảnh và video | Liệt kê model và tạo ảnh hoặc video ngắn. | `media_models`, `image_generate`, `video_generate` | "Tạo ảnh nền đường chân trời thành phố về đêm, tỉ lệ 9:16." |
| Element và widget | Xem danh mục element, chèn và sửa element, dựng Threads story. | `widget_types`, `widget_insert`, `widget_update`, `template_thread_story`, `template_thread_story_update` | "Thêm biểu đồ cột so sánh ba mức giá tại 0:12." |
| Element tuỳ chỉnh | Vẽ thử element ngoài timeline, định nghĩa, đọc và xoá element tuỳ chỉnh. | `element_render`, `element_define`, `element_remove`, `element_source` | "Tạo element vòng tiến độ tuỳ chỉnh theo màu thương hiệu của tôi." |
| Danh sách element | Liệt kê element tuỳ chỉnh của dự án và trạng thái. | `element_list` | "Dự án này có những element tuỳ chỉnh nào?" |
| Preset element | Liệt kê, lưu, áp dụng và xoá các kiểu element đã lưu. | `element_preset_list`, `element_preset_save`, `element_preset_apply`, `element_preset_delete` | "Lưu lower third này thành preset tên "Guest name"." |
| Sticker | Xem và chèn sticker. | `sticker_list`, `sticker_insert` | "Thêm sticker giơ ngón cái khi tôi nói "tuyệt"." |
| Đồ hoạ | Vẽ HTML hoặc SVG thành ảnh nền trong suốt. | `graphic_render` | "Vẽ một tờ giấy note ghi "Mẹo #1" ở góc trên." |
| Bản đồ | Tra cứu các quốc gia và tỉnh thành Việt Nam mà bản đồ vệ tinh hiển thị được. | `map_places` | "Thêm bản đồ vệ tinh bay từ Việt Nam đến Đà Nẵng." |
| Video tham khảo | Nhập và phân tích video tham khảo, đọc và cập nhật blueprint, dựng khung dự án. | `reference_import`, `reference_list`, `reference_analyze`, `reference_frames`, `reference_blueprint`, `reference_blueprint_update`, `blueprint_to_project` | "Phân tích video tham khảo này và cho tôi biết vì sao đoạn hook hiệu quả." |
| Brand kit | Tạo, đọc, sửa, liên kết và áp dụng brand kit. | `brand_list`, `brand_get`, `brand_create`, `brand_update`, `brand_delete`, `brand_link`, `brand_apply` | "Áp dụng brand kit của tôi cho dự án này." |
| Kiểm tra video | Kiểm tra video đã render có nhấp nháy, khung đen hay khung đứng hình. | `video_check` | "Kiểm tra video đã xuất có khung đen hay đứng hình không." |
| Xem trước chuyển động | Render bản nháp ngắn, không tiếng, độ phân giải thấp để kiểm tra chuyển động. | `preview_motion` | "Render bản nháp chuyển động phần mở đầu để tôi kiểm tra nhịp." |
| Dựng song song | Điều phối các agent phụ dựng nhiều phần cùng lúc. | `parallel_build` | "Script đã duyệt: dựng song song cả bốn phần." |
| Sprite | Vẽ một bộ sprite SVG cùng phong cách. | `sprite_render` | "Vẽ năm biểu tượng phẳng cho các bước: ý tưởng, kế hoạch, dựng, kiểm tra, ra mắt." |

## Những điều công cụ không bao giờ làm

* **Xuất video khi chưa hỏi bạn.** Skill của CoClip dặn agent hỏi bạn trước khi bắt đầu xuất. Việc xuất video và khung hình preview luôn render trong cửa sổ editor nhìn thấy được, không bao giờ chạy ngầm.
* **Hỏi API key.** Công cụ giọng đọc, nhạc, hình ảnh và âm thanh dùng key bạn đã lưu trong **Settings** → **Connectors**. Nếu thiếu key, agent cho bạn biết cần mở bước nào trong **Settings**. Xem [Connector](/docs/vi/reference/connectors.md).
* **Âm thầm tiêu tín dụng trả phí.** Khi một lần tạo nội dung tốn nhiều hơn mức giới hạn, agent hỏi bạn trước.
* **Sửa track bị khoá mà không báo.** Agent vẫn sửa được track bị khoá, nhưng được dặn phải báo cho bạn khi làm vậy.
* **Chạy mã chưa được tin cậy.** Element tuỳ chỉnh do agent viết sẽ không được vẽ cho tới khi bạn tin cậy nó trong editor.

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

## Trang liên quan

* [Prompt mẫu](/docs/vi/ai-agents/example-prompts.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.