Skip to main content

Use VieNeu in Claude

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 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).

  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​

SymptomFix
"Couldn't reach the MCP server" when addingCheck the URL is exactly https://api.vieneu.io/mcp (no trailing slash, no spaces)
The VieNeu page says the request expiredGo 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 pageBuy or renew a plan on vieneu.io, then connect again
No player, only a linkClaude asks once before showing it — choose Allow. The link always works
Claude says it has no VieNeu toolsTurn the connector on for the conversation (+ → Connectors)

More in Troubleshooting.