# Dùng VieNeu trong Claude

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

Dùng được trên **Claude web** (claude.ai), **Claude Desktop** và **app Claude
trên điện thoại** — thêm connector một lần là dùng ở mọi nơi bạn đăng nhập Claude.
Audio phát trong một [trình phát nhỏ](./index.md#the-inline-player) ngay dưới câu
trả lời.

**Cần có:** tài khoản Claude (gói Free thêm được **một** connector tuỳ chỉnh; Pro
và Max thêm được nhiều hơn) và tài khoản VieNeu có gói token còn hạn.

## Thêm connector (gói Free, Pro, Max)

1. Trong Claude, mở **Customize → Connectors**
   ([claude.ai/customize/connectors](https://claude.ai/customize/connectors)).
2. Bấm **Add custom connector** (một số màn hình phải bấm **+** trước).
3. Điền:
   - **Name:** `VieNeu`
   - **URL:** `https://api.vieneu.io/mcp`

   Để trống các ô OAuth client — Claude tự giới thiệu với VieNeu.
4. Bấm **Add**, rồi **Connect**.
5. Một trang VieNeu mở ra. Đăng nhập nếu được hỏi, kiểm tra đúng **tài khoản**
   bạn muốn dùng, rồi bấm **Cho phép**. Bạn được đưa về lại Claude.

Thêm trên web hoặc Claude Desktop; app điện thoại dùng luôn connector đó.

## Thêm connector (gói Team, Enterprise)

Chỉ **Owner** (chủ tổ chức) mới thêm được connector tuỳ chỉnh.

1. Owner mở **Organization settings → Connectors**, chọn **Add → Custom** (rồi
   **Web** nếu được hỏi), nhập `https://api.vieneu.io/mcp` và bấm **Add**.
2. Từng thành viên mở **Customize → Connectors**, tìm **VieNeu** (có nhãn
   *Custom*), bấm **Connect**, rồi cho phép bằng tài khoản VieNeu **của chính
   mình**. Ai dùng thì trừ token trong gói VieNeu của người đó.

## Dùng trong cuộc trò chuyện

1. Trong khung chat, bấm **+** → **Connectors** và bật **VieNeu** cho cuộc trò
   chuyện này.
2. Nhắn bằng lời thường, ví dụ:
   - "Tìm giọng nữ miền Bắc rồi đọc câu: Xin chào, đây là VieNeu."
   - "Đọc đoạn này bằng giọng Thu Trang, tốc độ 1.1."
3. Lần đầu, Claude hỏi quyền dùng công cụ của VieNeu — chọn **Allow once** hoặc
   **Always allow**. Claude cũng hỏi một lần trước khi hiện trình phát — chọn
   **Allow** (hoặc **Always allow**).

Mỗi lần `text_to_speech` là một lần trừ token. Claude có thể đề nghị đọc thử vài
giọng để so sánh; mỗi giọng đọc là một lần tính phí riêng.

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

Hộp thoại connector của Claude chỉ cho gửi header cố định với một số tổ chức (tính
năng beta, chỉ Owner). Nếu khi thêm connector bạn thấy mục **Request headers**,
chọn **No sign-in** rồi thêm header `x-api-key` với key của bạn, hoặc
`authorization` với giá trị `Bearer vn_sk_...`. Key này dùng chung cho cả tổ chức
— chỉ nên dùng khi thật sự cần, còn lại hãy đăng nhập.

## Gỡ kết nối

- Trong Claude: **Customize → Connectors → VieNeu → Remove** (hoặc Disconnect).
- Trên VieNeu: **Nhà phát triển → Dùng VieNeu trong Claude, ChatGPT → Gỡ kết
  nối**. Claude bị đăng xuất ngay, kể cả trên thiết bị khác.

## Trục trặc

| Hiện tượng | Cách xử lý |
|---|---|
| Báo "Couldn't reach the MCP server" khi thêm | Kiểm tra URL đúng là `https://api.vieneu.io/mcp` (không có `/` cuối, không có khoảng trắng) |
| Trang VieNeu báo yêu cầu đã hết hạn | Quay lại Claude bấm **Connect** lần nữa — mỗi yêu cầu có hạn 30 phút |
| Trang VieNeu báo "Tài khoản chưa có gói token còn hạn" | Mua hoặc gia hạn gói trên vieneu.io rồi kết nối lại |
| Không thấy trình phát, chỉ có link | Claude hỏi một lần trước khi hiện — chọn **Allow**. Link thì lúc nào cũng dùng được |
| Claude nói không có công cụ VieNeu | Bật connector cho cuộc trò chuyện (**+ → Connectors**) |

Xem thêm [Xử lý sự cố](./troubleshooting.md).