Skip to main content

Use VieNeu in Claude Code

Add the server​

claude mcp add --transport http vieneu https://api.vieneu.io/mcp

Then, inside Claude Code, run /mcp, pick vieneu and choose Authenticate. Your browser opens the VieNeu consent page. It shows a yellow note that the app runs on your computer (the callback is 127.0.0.1 or localhost) — that is expected for Claude Code. Press Cho phép (Allow).

From a shell you can also start the sign-in with:

claude mcp login vieneu

Where it is saved (--scope)​

ScopeStored inUse when
local (default)~/.claude.json, this project onlyJust you, just here
user~/.claude.json, every projectYou want VieNeu everywhere
project.mcp.json in the repositoryThe whole team should get it (each person still signs in)
claude mcp add --transport http --scope user vieneu https://api.vieneu.io/mcp

Using an API key instead​

For CI or machines where a browser sign-in is not possible:

claude mcp add --transport http vieneu https://api.vieneu.io/mcp \
--header "X-API-Key: vn_sk_..."

In a shared .mcp.json, reference an environment variable instead of the key:

{
"mcpServers": {
"vieneu": {
"type": "http",
"url": "https://api.vieneu.io/mcp",
"headers": { "X-API-Key": "${VIENEU_API_KEY}" }
}
}
}

Use it​

Ask in the session, for example: "Đọc README tiếng Việt này bằng giọng nữ miền Nam và cho mình link tải." Claude Code shows the reply and the download link; it has no inline player.

Remove it​

claude mcp remove vieneu

and, if you signed in, Developer → Gỡ kết nối on vieneu.io.