# Use VieNeu in Claude Code

Source: https://docs.vieneu.io/docs/integrations/mcp/claude-code

## Add the server

```bash
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:

```bash
claude mcp login vieneu
```

### Where it is saved (`--scope`)

| Scope | Stored in | Use when |
|---|---|---|
| `local` (default) | `~/.claude.json`, this project only | Just you, just here |
| `user` | `~/.claude.json`, every project | You want VieNeu everywhere |
| `project` | `.mcp.json` in the repository | The whole team should get it (each person still signs in) |

```bash
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:

```bash
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:

```json
{
  "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

```bash
claude mcp remove vieneu
```

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