Kết nối VocaLingo với Claude, ChatGPT và Cursor qua MCP

Sau khi kết nối VocaLingo, trợ lý AI của bạn có thể dịch tin nhắn thoại bằng chính giọng người nói, tóm tắt video YouTube, lồng tiếng cho văn bản bằng giọng của bạn, lồng tiếng video hoặc thêm phụ đề. AI sẽ dùng token từ số dư VocaLingo thông thường của bạn, và mọi kết quả đều xuất hiện trong lịch sử ứng dụng: bắt đầu lồng tiếng từ máy tính và xem tiếp trên điện thoại.

Chi tiết máy chủ

Bước 1. Mở màn hình AI agents

1. Mở VocaLingo trên iOS, Android hoặc web.vocalingo.app và đăng nhập.

2. Vào Cài đặt → AI agents (MCP). Màn hình có tên là “Connect VocaLingo to your AI”.

3. Dưới mục “Choose your AI”, nhấn vào trợ lý của bạn: Claude, ChatGPT, Cursor, VS Code, Claude Code hoặc Other. Màn hình sẽ hiển thị các bước tương ứng.

Kết nối Claude

Cách này hoạt động trên claude.ai, Claude Desktop và các ứng dụng di động Claude.

1. Trên màn hình AI agents, nhấn Mở Claude. Cửa sổ “Add custom connector” sẽ mở ra với tên và địa chỉ đã được điền sẵn.

2. Nhấn Thêm, sau đó nhấn Kết nối.

3. Claude sẽ mở trang đăng nhập VocaLingo. Hãy đăng nhập giống như trong ứng dụng: bằng mã gửi về email, bằng Google, hoặc bằng mã từ ứng dụng.

Thủ công: trong Claude mở Customize → Connectors → Add custom connector, dán https://nodejs.vocalingo.app/mcp và nhấn Connect. Sau đó, VocaLingo sẽ hoạt động trong Claude trên tất cả thiết bị của bạn.

Kết nối ChatGPT

1. Sao chép địa chỉ máy chủ trên màn hình AI agents.

2. Mở chatgpt.com/plugins trong trình duyệt, trên điện thoại hoặc máy tính của bạn.

3. Nhấn + → Add custom MCP server.

4. Nhập tên VocaLingo, dán địa chỉ, chọn đăng nhập bằng OAuth, xác nhận “I understand and want to continue” và nhấn Create.

5. Đăng nhập vào VocaLingo trên trang vừa mở ra.

Máy chủ MCP tùy chỉnh không khả dụng trên tất cả các gói ChatGPT.

Cách đăng nhập từ Claude hoặc ChatGPT

Trang đăng nhập hỗ trợ các phương thức giống như trong ứng dụng: mã gửi về email hoặc Google. Nếu bạn đăng nhập vào ứng dụng bằng Apple hoặc không nhớ mình đã đăng nhập bằng cách nào, hãy nhấn Lấy mã đăng nhập trên màn hình AI agents. Trên trang đăng nhập, chọn “Sign in with a code from the VocaLingo app” và nhập mã 8 ký tự. Mã này chỉ dùng được một lần và có hiệu lực trong 10 phút.

Kết nối Cursor hoặc VS Code

1. Mở web.vocalingo.app trên máy tính đã cài đặt Cursor hoặc VS Code và đăng nhập.

2. Vào Cài đặt → AI agents (MCP) và chọn Cursor hoặc VS Code.

3. Nhấp vào Cài đặt trong Cursor hoặc Cài đặt trong VS Code. Trình soạn thảo sẽ mở ra và đề xuất thêm máy chủ VocaLingo: hãy xác nhận.

Cài đặt bằng một cú nhấp chuột chỉ hoạt động trên máy tính. Bạn cũng có thể nhấn Sao chép cấu hình và dán vào ~/.cursor/mcp.json đối với Cursor, hoặc vào mcp.json đối với VS Code (lệnh “MCP: Open User Configuration”). Cấu hình đã bao gồm sẵn token của bạn.

Kết nối Claude Code

1. Trên màn hình AI agents, chọn Claude Code và nhấn Sao chép lệnh.

2. Chạy lệnh đó trong terminal. Lệnh có dạng như sau:

claude mcp add --transport http vocalingo https://nodejs.vocalingo.app/mcp --header "Authorization: Bearer vlmcp_YOUR_TOKEN"

Khởi động lại Claude Code. VocaLingo sẽ xuất hiện trong danh sách /mcp.

Các MCP client khác

Windsurf, Cline và bất kỳ client nào hỗ trợ máy chủ MCP từ xa đều kết nối bằng địa chỉ https://nodejs.vocalingo.app/mcp và tiêu đề Authorization: Bearer vlmcp_…. Chọn Other trên màn hình AI agents để sao chép token và cấu hình có sẵn. Tiện ích mở rộng cho Claude Code, Cursor, Codex và Gemini CLI có sẵn các kỹ năng mẫu nằm trong kho lưu trữ vocalingo-mcp trên GitHub.

Các công cụ MCP của VocaLingo

AI sẽ tự chọn công cụ phù hợp với yêu cầu của bạn. Các công cụ trả phí sử dụng token VocaLingo, đơn vị tiền tệ trong ứng dụng.

translate_video, caption_video và change_voice yêu cầu tệp dữ liệu. Đối với liên kết YouTube hoặc TikTok, AI sẽ gọi download_media trước rồi mới chuyển tiếp tệp đã tải xuống. Giá của các công cụ trả phí giống hệt như trong ứng dụng, xem bảng giá token cho từng công cụ.

Cách AI xác nhận chi phí

• Tác vụ có chi phí từ 50 token trở lên sẽ hiển thị giá trước, và chỉ bắt đầu sau khi bạn đồng ý. AI không thể tự xác nhận thay bạn.

• Bạn có thể hỏi giá trước: “Lồng tiếng video này tốn bao nhiêu token?”. AI sẽ ước tính chi phí mà không khởi chạy tác vụ.

• Lặp lại cùng một yêu cầu trong vòng 10 phút sẽ không bị trừ phí hai lần: AI sẽ lấy lại đúng tác vụ đó.

• Nếu hết số dư, AI sẽ thông báo “insufficient balance”. Bạn hãy nạp thêm trong ứng dụng, xem cách mua token. Không có cổng thanh toán riêng cho MCP.

Cách gửi âm thanh, ảnh và video cho AI

Tệp đã tải lên được lưu giữ trong 48 giờ, và AI có thể tái sử dụng mà không cần tải lên lại. Giới hạn dung lượng: tối đa 150 MB cho translate_audio, 50 MB cho speech_to_text và save_voice, 100 MB cho các công cụ video và change_voice, 20 MB cho hình ảnh.

Nếu bạn chỉ cần đọc hoặc dịch chữ trên ảnh, Claude và ChatGPT có thể tự thực hiện miễn phí. Công cụ translate_image dùng khi bạn muốn nhận lại chính bức ảnh đó với phần chữ đã được vẽ lại tương ứng.

Các tác vụ dài

Các công cụ xử lý lâu sẽ đợi khoảng 25 giây và trả về kết quả nếu đã hoàn thành. Nếu chưa xong, AI sẽ nhận một jobId và định kỳ kiểm tra bằng check_job. Quá trình lồng tiếng có thể mất tới 30 phút. Nếu bạn đã lỡ đóng đoạn chat trong khi đang xử lý, hãy bảo AI gọi lệnh check_job mà không cần kèm jobId: hệ thống sẽ liệt kê các tác vụ gần nhất. Liên kết đến tệp kết quả có hiệu lực trong 24 giờ; bản thân các kết quả vẫn được lưu trong lịch sử ứng dụng (nếu không có gói Premium, ứng dụng sẽ lưu 3 mục gần nhất cho mỗi công cụ).

Quyền truy cập, token và cách tắt

Bất kỳ ai có token của bạn đều có thể dùng token từ số dư của bạn, vì vậy hãy giữ bí mật. Mục Access and tokens trên màn hình AI agents có hai thao tác:

• Tạo token mới: token cũ sẽ ngừng hoạt động trong vòng một phút. Hãy thay thế token mới vào các AI đã kết nối bằng token.

• Tắt quyền truy cập MCP: tất cả AI sẽ mất quyền truy cập trong vòng một phút, bao gồm cả các kết nối Claude và ChatGPT. Để kết nối lại, nhấn Bật quyền truy cập MCP, và một token mới sẽ được cấp.

Chỉ nhân bản giọng nói của chính bạn hoặc giọng nói mà bạn đã được cho phép rõ ràng bằng văn bản. Quy định này cũng được áp dụng tương tự trên ứng dụng.

Câu hỏi thường gặp