Kết nối trợ lý

Khai địa chỉ máy chủ vào phần mềm trợ lý, đăng nhập một lần, rồi bắt đầu nói chuyện.

Cần gì trước khi bắt đầu

1
Một tài khoản đã có credit
Trợ lý dùng đúng tài khoản bạn đăng nhập. Không cần gói riêng — xem Gói dịch vụ.
2
Ít nhất một kênh đã nối
Không có kênh thì trợ lý đọc được số dư nhưng không tạo được video. Nối kênh trên giao diện web.
3
Một phần mềm trợ lý hỗ trợ MCP
Claude Desktop, hoặc bất cứ công cụ nào nói được giao thức MCP.

Claude Desktop

Mở Settings → Connectors → Add custom connector, dán địa chỉ máy chủ ở khối dưới đây.

Nối trợ lý vào tài khoản này

Địa chỉ dưới đây lấy theo đúng tên miền bạn đang mở, dán thẳng vào phần mềm trợ lý.

Địa chỉ máy chủ MCP

…/api/v1/public/mcp

Cấu hình cho phần mềm khai bằng tệp

{
  "mcpServers": {
    "viai-video": {
      "type": "http",
      "url": "…/api/v1/public/mcp"
    }
  }
}

Tên mục "viai-video" chỉ để bạn nhận ra, đặt khác cũng được. Lần đầu nối, trợ lý sẽ mở trình duyệt để bạn đăng nhập và bấm đồng ý.

Claude mở trình duyệt để bạn đăng nhập, rồi hiện trang hỏi đồng ý. Bấm đồng ý là xong — không phải dán khoá nào cả.

Đọc kỹ tên ứng dụng trên trang đồng ý

Trang đó nêu tên ứng dụng đang xin quyền. Nếu tên lạ so với phần mềm bạn vừa bấm, đừng đồng ý — đóng trang lại và thử nối lại từ đầu.

Phần mềm khác

Máy chủ này theo chuẩn MCP kiểu streamable HTTP với cấp quyền OAuth 2.1. Phần mềm nào hỗ trợ hai thứ đó đều nối được — khai một mục máy chủ kiểu http (không phải stdio) trỏ tới cùng địa chỉ trên — khối cấu hình mẫu đã có sẵn ở phần trên, bấm là chép được.

Tên khoá và hình dạng tệp cấu hình khác nhau giữa các phần mềm — tra tài liệu của phần mềm đó. Thứ duy nhất bạn cần từ phía chúng tôi là địa chỉ ở trên.

Kiểm tra đã nối được chưa

Hỏi trợ lý một câu chỉ đọc, không tốn gì:

Số dư credit của tôi còn bao nhiêu?

Trợ lý gọi get_credit_balance và trả về hai số: available và held. Ra được hai số đó là đường nối đã thông.

Khắc phục sự cố

Hiện tượng	Thường là vì	Xử lý
Trợ lý báo chưa được cấp quyền	Mã thông hành hết hạn, hoặc bạn đã thu hồi quyền	Nối lại và đăng nhập lần nữa
Đăng nhập xong nhưng không thấy trang đồng ý	Trình duyệt chặn cửa sổ bật lên	Cho phép cửa sổ bật lên rồi thử lại
Trợ lý không thấy công cụ nào	Khai nhầm kiểu stdio thay vì http	Sửa lại cấu hình rồi khởi động lại phần mềm
Tạo video báo thiếu kênh	Tài khoản chưa nối kênh nào	Nối kênh trên giao diện web trước
Tạo video báo không đủ credit	Số dư thấp hơn giá của video đó	Nạp thêm credit, hoặc hỏi số dư trước khi nhờ tạo

Thu hồi quyền đã cấp

Muốn cắt một trợ lý khỏi tài khoản, gỡ mục máy chủ đó trong phần mềm trợ lý. Mã thông hành cấp cho trợ lý có hạn và hết hạn thì phải xin lại.

Nghi ngờ mã thông hành rơi vào tay người khác thì báo ngay

Gỡ mục máy chủ ở máy bạn không thu hồi được mã mà bên khác đang giữ. Trường hợp đó hãy liên hệ hỗ trợ để khoá phiên cấp quyền từ phía hệ thống.