# Dùng VieNeu trong Claude Code

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

## Thêm server

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

Rồi trong Claude Code, gõ `/mcp`, chọn **vieneu** và chọn **Authenticate**. Trình
duyệt mở trang xin quyền của VieNeu. Trang có một dòng vàng báo ứng dụng chạy trên
máy tính của bạn (địa chỉ quay về là `127.0.0.1` hoặc `localhost`) — với Claude
Code thì đúng là như vậy. Bấm **Cho phép**.

Từ terminal cũng có thể bắt đầu đăng nhập bằng:

```bash
claude mcp login vieneu
```

### Lưu ở đâu (`--scope`)

| Scope | Lưu trong | Dùng khi |
|---|---|---|
| `local` (mặc định) | `~/.claude.json`, chỉ project này | Chỉ bạn, chỉ ở đây |
| `user` | `~/.claude.json`, mọi project | Muốn có VieNeu ở mọi nơi |
| `project` | `.mcp.json` trong repository | Cả team cùng dùng (mỗi người vẫn tự đăng nhập) |

```bash
claude mcp add --transport http --scope user vieneu https://api.vieneu.io/mcp
```

## Dùng API key thay cho đăng nhập

Cho CI hoặc máy không mở được trình duyệt:

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

Trong `.mcp.json` dùng chung, tham chiếu biến môi trường thay vì ghi thẳng key:

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

## Dùng

Nhắn trong phiên làm việc, ví dụ: *"Đọ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 hiện câu trả lời kèm link tải; Claude Code
không có trình phát trong khung.

## Gỡ

```bash
claude mcp remove vieneu
```

và nếu đã đăng nhập thì vào **Nhà phát triển → Gỡ kết nối** trên vieneu.io.