# Use VieNeu in Claude

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

Works in Claude on the **web** (claude.ai), **Claude Desktop** and the **Claude
mobile** apps — one connector, added once, available everywhere you sign in to
Claude. The audio plays in a small [player](./index.md#the-inline-player)
right under the reply.

**You need:** a Claude account (Free plans can add **one** custom connector;
Pro and Max can add more) and a VieNeu account with an active token plan.

## Add the connector (Free, Pro, Max)

1. In Claude, open **Customize → Connectors**
   ([claude.ai/customize/connectors](https://claude.ai/customize/connectors)).
2. Click **Add custom connector** (on some screens: **+** first).
3. Fill in:
   - **Name:** `VieNeu`
   - **URL:** `https://api.vieneu.io/mcp`

   Leave any OAuth client fields empty — Claude identifies itself to VieNeu on
   its own.
4. Click **Add**, then **Connect**.
5. A VieNeu page opens. Sign in if asked, check that the **account** shown is
   the one you want, and press **Cho phép** (Allow). You land back in Claude.

Add it on the web or in Claude Desktop; the mobile apps then use the same
connector.

## Add the connector (Team, Enterprise)

Only an organization **Owner** can add a custom connector.

1. The Owner opens **Organization settings → Connectors**, chooses **Add →
   Custom** (then **Web** if asked), enters `https://api.vieneu.io/mcp` and
   clicks **Add**.
2. Each member then opens **Customize → Connectors**, finds **VieNeu** (marked
   *Custom*), clicks **Connect**, and approves their **own** VieNeu account on
   the VieNeu page. Each member's usage is billed to their own VieNeu plan.

## Use it in a chat

1. In the chat box, click **+** → **Connectors** and make sure **VieNeu** is
   switched on for this conversation.
2. Ask in plain language, for example:
   - "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. The first time, Claude asks permission to use a VieNeu tool — choose
   **Allow once** or **Always allow**. It also asks once before showing the
   player — choose **Allow** (or **Always allow**).

Each `text_to_speech` call spends tokens. Claude may offer a couple of voices to
compare; each one it reads is a separate charge.

## Using an API key instead

Claude's connector dialog can send a fixed request header only for a limited set
of organizations (a beta feature, Owners only). If your organization has a
**Request headers** section when adding the connector, choose **No sign-in** and
add the header `x-api-key` with your key, or `authorization` with the value
`Bearer vn_sk_...`. The key is shared by everyone in the organization — use
sign-in unless you specifically need this.

## Remove it

- From Claude: **Customize → Connectors → VieNeu → Remove** (or disconnect).
- From VieNeu: **Developer → Dùng VieNeu trong Claude, ChatGPT → Gỡ kết nối**.
  This signs Claude out immediately, even on other devices.

## Problems

| Symptom | Fix |
|---|---|
| "Couldn't reach the MCP server" when adding | Check the URL is exactly `https://api.vieneu.io/mcp` (no trailing slash, no spaces) |
| The VieNeu page says the request expired | Go back to Claude and click **Connect** again — a request is valid for 30 minutes |
| "Tài khoản chưa có gói token còn hạn" on the VieNeu page | Buy or renew a plan on vieneu.io, then connect again |
| No player, only a link | Claude asks once before showing it — choose **Allow**. The link always works |
| Claude says it has no VieNeu tools | Turn the connector on for the conversation (**+ → Connectors**) |

More in [Troubleshooting](./troubleshooting.md).