Xử lý sự cố
Khi kết nối
| Hiện tượng | Nguyên nhân | Cách xử lý |
|---|---|---|
| "Couldn't reach the MCP server" / kết nối thất bại | Sai URL | Dùng đúng https://api.vieneu.io/mcp — không có / cuối, không có /api |
| Trang VieNeu báo yêu cầu đã hết hạn hoặc đã được xử lý | Trang đăng nhập để mở quá 30 phút, hoặc bấm cho phép hai lần | Quay lại app và kết nối lại |
| Trang VieNeu báo "Tài khoản chưa có gói token còn hạn" | Chưa có gói còn hạn | Mua hoặc gia hạn gói trên vieneu.io rồi kết nối lại |
| "Tài khoản đã có 20 ứng dụng kết nối" | Quá nhiều kết nối | Gỡ bớt ở Nhà phát triển → Gỡ kết nối |
| Trang VieNeu đăng nhập nhầm tài khoản | Trình duyệt đó đang đăng nhập sẵn vieneu.io bằng tài khoản khác | Bấm Đổi tài khoản trên trang |
| Cảnh báo đỏ: app "tự xưng là Claude/ChatGPT" nhưng chuyển đi nơi khác | Yêu cầu không đến từ app đó | Bấm Từ chối. Claude thật quay về claude.ai, ChatGPT về chatgpt.com |
| Dòng vàng: ứng dụng chạy trên máy tính của bạn | Bình thường với Claude Code, Cursor, VS Code và các công cụ trên máy | Cho phép nếu bạn vừa bấm kết nối từ công cụ đó |
Khi dùng
| Hiện tượng | Nguyên nhân | Cách xử lý |
|---|---|---|
| Trợ lý nói không có công cụ VieNeu | Connector đang tắt trong cuộc trò chuyện này | Bật lên (Claude: + → Connectors; ChatGPT: + → Developer mode) |
| Không thấy tính năng mới của VieNeu (sách nói, "VieNeu làm được gì?") | App giữ danh sách công cụ lấy từ lúc bạn kết nối | Ngắt kết nối VieNeu rồi kết nối lại, sau đó mở chat mới (Claude: Settings → Connectors → VieNeu → Disconnect, rồi Connect). App tải công cụ lúc khởi động (Claude Code, Cursor, VS Code) chỉ cần mở lại |
| Tự nhiên bị yêu cầu đăng nhập lại | Kết nối đã bị gỡ trên vieneu.io, hoặc phiên hết hạn | Kết nối lại từ app |
| "Voice … is not available" | Trợ lý đoán id giọng | Nhờ trợ lý tìm bằng list_voices trước |
| "Tài khoản không đủ quyền hoặc hết token…" | Hết token hoặc gói hết hạn | Nạp thêm hoặc gia hạn — thử lại không giúp gì |
| "Audio đang được tạo…" kèm mã job | Văn bản dài chưa tạo xong | Nhờ trợ lý kiểm tra lại sau giây lát (dùng get_speech_status, miễn phí) |
| Không có trình phát, chỉ có link | App không hỗ trợ MCP Apps (Claude Code và các CLI khác), hoặc bạn đã từ chối | Dùng link; trong Claude chọn Allow khi được hỏi hiện app |
| Link hết dùng được | Link có hạn 24 giờ | Tải sớm hơn, hoặc tìm audio trong Thư viện trên vieneu.io |
Tính phí
Mỗi lần gọi text_to_speech là một lần tạo audio, tính theo ký tự (tối thiểu 50).
Trợ lý đôi khi đề nghị đọc cùng một câu bằng vài giọng khác nhau — mỗi lần như vậy
đều bị tính. Tạo audio thất bại thì token tự được hoàn. Xem lượt dùng ở Nhà phát
triển → Sử dụng trên vieneu.io.
Vẫn chưa được?
Liên hệ hỗ trợ VieNeu trên vieneu.io, kèm thời điểm thử và app bạn dùng. Dành cho
lập trình viên: tài liệu khám phá của server nằm ở
/.well-known/oauth-protected-resource
và /.well-known/oauth-authorization-server.