Cài agent
Kết nối agent của bạn
Thêm URL connector dưới đây vào agent và đăng nhập bằng tài khoản Google đã mua template. Agent sẽ thấy thư viện template của bạn và tự tải template về máy khi cần.
Khác
VS Code (GitHub Copilot ở chế độ Agent) hoặc bất kỳ agent nào hỗ trợ MCP qua Streamable HTTP + OAuth 2.1.
Cần VS Code bản mới có hỗ trợ MCP.
VS Code: bấm “Thêm vào VS Code”
Hoặc mở Command Palette → “MCP: Add Server…” → chọn HTTP → dán URL bên dưới, đặt tên snp.
URL connectorhttps://api.snp.aiedit.vn/mcp/v2Cho phép đăng nhập
Khi VS Code hỏi xác thực, đồng ý và đăng nhập Google trong trình duyệt, rồi bấm “Cho phép”.
Agent khác
Thêm một MCP server kiểu Streamable HTTP với URL ở trên. Máy chủ dùng OAuth 2.1 — agent sẽ tự mở trang đăng nhập khi kết nối lần đầu.
Cấu hình thủ công cho VS Code
{
"servers": {
"snp": {
"type": "http",
"url": "https://api.snp.aiedit.vn/mcp/v2"
}
}
}Câu lệnh mẫu
Câu lệnh mẫu cho agent
Dán vào khung chat sau khi kết nối. Agent sẽ hỏi thêm thông tin và chờ bạn duyệt kịch bản trước khi render.
Dựng video review quán
“Dùng template food-review-pin dựng video review quán từ các clip trong thư mục ~/Videos/quan-bun-cha”
Xem thư viện của tôi
“Liệt kê các template tôi đang có và cho biết mỗi template cần tôi chuẩn bị những gì.”
Tìm template phù hợp
“Tìm template du lịch tỷ lệ 9:16 phù hợp để làm video Đà Lạt khoảng 30 giây, rồi hỏi tôi những gì cần chuẩn bị.”
Duyệt kịch bản trước khi render
“Viết kịch bản và lời thoại trước, gửi tôi duyệt. Chỉ render khi tôi trả lời “OK”.”
Kiểm tra máy
“Kiểm tra máy tôi đã có đủ Node.js, ffmpeg (và Python nếu template cần) để render template food-review-pin chưa.”
Hỏi đáp
Xử lý sự cố
Connector cũ báo lỗi hoặc không thấy công cụ mới
Chúng tôi đã nâng cấp phiên bản công cụ. Hãy xoá connector cũ trong agent rồi thêm lại với URL kết thúc bằng /mcp/v2:
https://api.snp.aiedit.vn/mcp/v2Agent báo hết phiên đăng nhập / lỗi 401
Đăng nhập lại: Claude app — ngắt kết nối connector rồi Connect lại; Claude Code — /mcp → snp → Authenticate; Codex — codex mcp login snp; Gemini CLI — /mcp auth snp.
Báo vượt quá số agent được kết nối
Mỗi tài khoản kết nối tối đa 2 agent cùng lúc. Vào trang Tài khoản, bấm “Thu hồi” với agent bạn không dùng nữa rồi kết nối lại.
Render lỗi hoặc thiếu công cụ trên máy
Template render ngay trên máy bạn nên cần Node.js 18 trở lên và ffmpeg. Một số template cần thêm Python (có ghi rõ trên trang template). Kiểm tra bằng:
node -v
ffmpeg -version
python3 --version