Troubleshooting
Connecting
| Symptom | Cause | Fix |
|---|---|---|
| "Couldn't reach the MCP server" / connection failed | Wrong URL | Use exactly https://api.vieneu.io/mcp — no trailing slash, no /api |
| The VieNeu page says the request expired or was already handled | The sign-in page was left open more than 30 minutes, or approved twice | Go back to the app and connect again |
| "Tài khoản chưa có gói token còn hạn" on the VieNeu page | No active plan | Buy or renew a plan on vieneu.io, then connect again |
| "Tài khoản đã có 20 ứng dụng kết nối" | Too many connections | Remove old ones under Developer → Gỡ kết nối |
| The VieNeu page signs in a different account than you expected | You were already signed in to vieneu.io in that browser | Click Đổi tài khoản on the page |
| A red warning: the app "calls itself Claude/ChatGPT" but returns elsewhere | The request did not come from that app | Press Từ chối (Deny). Real Claude returns to claude.ai, ChatGPT to chatgpt.com |
| A yellow note: the app runs on your computer | Normal for Claude Code, Cursor, VS Code and other desktop tools | Allow it if you just clicked connect in that tool |
Using it
| Symptom | Cause | Fix |
|---|---|---|
| The assistant says it has no VieNeu tools | The connector is off for this chat | Turn it on (Claude: + → Connectors; ChatGPT: + → Developer mode) |
| New VieNeu features (audiobooks, "what can VieNeu do?") don't show up | The app keeps the list of tools it fetched when you connected | Disconnect VieNeu and connect again, then start a new chat (Claude: Settings → Connectors → VieNeu → Disconnect, then Connect). Apps that load their tools when they start (Claude Code, Cursor, VS Code) only need a restart |
| Suddenly asked to sign in again | Removed on vieneu.io, or the sign-in expired | Reconnect from the app |
| "Voice … is not available" | The assistant guessed a voice id | Ask it to search with list_voices first |
| "Tài khoản không đủ quyền hoặc hết token…" | Out of tokens or plan expired | Top up or renew — retrying does not help |
| "Audio đang được tạo…" with a job id | Long text still rendering | Ask the assistant to check again in a moment (it uses get_speech_status, free) |
| No player, only a link | The app does not show MCP Apps (Claude Code and other CLIs), or you declined it | Use the link; in Claude choose Allow when asked to show the app |
| The link stopped working | Links expire after 24 hours | Download it sooner, or find the audio in your Library on vieneu.io |
Charges
Every text_to_speech call is one synthesis, billed per character (minimum
50). Assistants sometimes offer to read the same sentence with a few different
voices — each of those is charged. A failed synthesis is refunded
automatically. See usage under Developer → Usage on vieneu.io.
Still stuck?
Contact VieNeu support from vieneu.io with the time of the attempt and the app
you used. For developers: the server's discovery documents are at
/.well-known/oauth-protected-resource
and /.well-known/oauth-authorization-server.