# MCP troubleshooting

Source: https://docs.vieneu.io/docs/integrations/mcp/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`](https://api.vieneu.io/.well-known/oauth-protected-resource)
and [`/.well-known/oauth-authorization-server`](https://api.vieneu.io/.well-known/oauth-authorization-server).