# Xử lý sự cố MCP

Source: https://docs.vieneu.io/vi/docs/integrations/mcp/troubleshooting

## 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`](https://api.vieneu.io/.well-known/oauth-protected-resource)
và [`/.well-known/oauth-authorization-server`](https://api.vieneu.io/.well-known/oauth-authorization-server).