Chuyển tới nội dung chính

Dùng VieNeu trong Claude

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

  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ượngCách xử lý
Báo "Couldn't reach the MCP server" khi thêmKiể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ạnQuay 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ó linkClaude 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ụ VieNeuBật connector cho cuộc trò chuyện (+ → Connectors)

Xem thêm Xử lý sự cố.