MCP server TaiKhoanGiaRe: 10 tool cho agent chat, ảnh, video, giọng nói

Khám phá 10 tool MCP của TaiKhoanGiaRe: chat, tạo ảnh, video, giọng nói. Hướng dẫn thêm vào Claude Code, ví dụ prompt và theo dõi job bằng job_status.

MCP (Model Context Protocol) là cách để agent như Claude Code gọi trực tiếp các công cụ bên ngoài, thay vì bạn phải tự viết code gọi API. TaiKhoanGiaRe có sẵn một MCP server công khai tại https://taikhoangiare.vn/mcp, gom đủ chat, tạo ảnh, tạo video, chuyển văn bản thành giọng nói và kiểm tra số dư thành 10 tool. Bài này đi thẳng vào cách thêm server này vào Claude Code, ví dụ prompt cho từng tool, và cách theo dõi job video bằng job_status.

MCP server của TaiKhoanGiaRe có gì

Khác với việc gọi trực tiếp /v1/chat/completions hay /v1/messages, khi dùng MCP bạn không cần viết code gọi HTTP. Agent (Claude Code, Claude Desktop, Cursor...) tự quyết định khi nào cần gọi tool nào, dựa trên yêu cầu bằng ngôn ngữ tự nhiên của bạn. Toàn bộ 10 tool nằm trong một server duy nhất, dùng chung một API key của tài khoản.

Hướng dẫn đầy đủ kèm ảnh chụp màn hình cho MCP nằm ở /integrations.html?app=mcp. Trang này cũng là nơi lấy đúng cú pháp thêm server cho từng client, vì mỗi app có cách khai báo MCP server hơi khác nhau.

10 tool MCP có sẵn

Đây là danh sách đầy đủ, không nhiều hơn không ít hơn:

Nhóm chat và list_models dùng cho văn bản. Nhóm generate_image/list_image_models và generate_video/list_video_models dùng cho hình ảnh và video. text_to_speech/list_voices cho giọng nói. job_status và balance là hai tool tiện ích, dùng chung cho mọi thứ ở trên.

Thêm MCP server vào Claude Code

Trước tiên, lấy secret key của tài khoản: vào /dashboard.html, tab API keys, bấm Show. Mỗi tài khoản chỉ có một key duy nhất, được tạo tự động khi đăng ký, bạn không tạo thêm key mới mà chỉ Show hoặc Rotate (Rotate sẽ vô hiệu key cũ).

Sau đó, trong terminal có Claude Code, thêm MCP server dạng remote qua HTTP:

claude mcp add taikhoangiare --transport http https://taikhoangiare.vn/mcp --header "Authorization: Bearer YOUR_API_KEY"

Thay YOUR_API_KEY bằng key vừa Show. Khởi động lại Claude Code, gõ /mcp để xác nhận server taikhoangiare đã kết nối và 10 tool hiện ra. Nếu bạn mới làm quen Claude Code, có thể xem thêm bước cài đặt cơ bản ở bài hướng dẫn cài Claude Code với TaiKhoanGiaRe trước khi thêm MCP.

Thử ngay bằng một câu hỏi đơn giản: "Kiểm tra số dư credit tài khoản của tôi". Claude Code sẽ tự gọi tool balance và trả lời bằng con số thật, không cần bạn gõ lệnh API nào.

MCP cũng chạy được trong Blender và AutoCAD

MCP không chỉ dùng trong Claude Code. TaiKhoanGiaRe có installer riêng cho Blender (cài MCP server và add-on, đăng ký sẵn vào Claude Desktop, Cursor, Codex, Claude Code) và cho AutoCAD bản đầy đủ 2018+ (không phải LT). Chi tiết hai hướng dẫn này ở bài điều khiển Blender bằng Claude qua MCP và trang /integrations.html?app=autocad.

Ví dụ prompt cho từng tool

Một khi server đã kết nối, bạn chỉ cần nói chuyện bình thường, agent tự chọn tool phù hợp. Vài ví dụ thực tế:

• Liệt kê model: "Cho tôi danh sách model có hỗ trợ vision đang bán" → gọi list_models.
• Chat nhanh: "Dùng model deepseek-v4-flash tóm tắt đoạn văn bản sau trong 3 câu" → gọi chat.
• Tạo ảnh: "Vẽ một quán cà phê nhỏ ở Hà Nội, phong cách màu nước, tỉ lệ vuông, dùng model nano-banana-2" → gọi generate_image.
• Xem giá ảnh trước khi tạo: "Model tạo ảnh nào đang rẻ nhất?" → gọi list_image_models.
• Tạo video: "Tạo video 5 giây một chiếc thuyền trên sông lúc hoàng hôn, dùng model veo3.1-lite" → gọi generate_video, trả về một job id.
• Giọng nói: "Đọc đoạn văn bản này thành giọng nói, cho tôi xem danh sách giọng có sẵn trước" → gọi list_voices rồi text_to_speech.

Vì giá tạo ảnh và video tính theo credit cố định cho mỗi job (không phải theo token), bạn không cần quan tâm độ dài prompt văn bản ảnh hưởng tới chi phí như khi dùng model ngôn ngữ.

Theo dõi job video bằng job_status

Video studio ghi rõ: video mất vài phút để xử lý, không trả về ngay như ảnh. Khi agent gọi generate_video, nó nhận lại một job id, chưa có video. Bạn (hoặc agent, nếu bạn bảo nó tự kiểm tra lại) cần gọi job_status với job id đó để biết video đã xong chưa.

Một đoạn hội thoại thực tế với Claude Code có thể như sau:

Bạn: Tạo video 5 giây cảnh phố cổ Hội An về đêm, dùng model kling-2.5-turbo.
Claude Code: Đã gửi job, id là job_xxxx, đang xử lý...

Bạn: Kiểm tra job job_xxxx đã xong chưa.
Claude Code: [gọi job_status] Job đã hoàn tất, video sẵn sàng tải xuống.

Nếu job lỗi, credit đã trừ sẽ được hoàn lại theo chính sách của site, bạn không cần làm gì thêm ngoài tạo lại job. Video và ảnh được giữ trong Media library trên dashboard trong một thời gian giới hạn, nên tải về sớm nếu cần lưu lâu dài. Có thể xem thêm cách dùng ảnh, video, giọng nói qua API thường (không qua MCP) ở bài hướng dẫn tạo ảnh, video và giọng nói bằng API AI.

Chi phí khi dùng qua MCP

MCP không có giá riêng, chi phí tính như gọi API trực tiếp: model ngôn ngữ theo token, ảnh/video theo credit cố định mỗi job, giọng nói theo ký tự. 1 credit = 55,8đ, không có hình thức trả theo tháng.

Một vài mốc giá credit cho ảnh và video (giá thấp nhất của từng model, theo /models.html):

Với tool chat, nếu agent dùng ngữ cảnh lớn (ví dụ 100.000 token đọc từ cache, 5.000 token input mới, 1.000 token output trong một lượt), chi phí theo model claude-sonnet-5 là 180đ cho một lượt, 1.000 lượt như vậy là 179.997đ. Với một tin nhắn chat ngắn (1.000 token input + 500 token output) trên cùng model, chi phí là 29đ, 1.000 tin nhắn là 29.401đ.

Nạp credit qua VietQR, xử lý bởi PayOS, trong tab Billing của dashboard. Các gói hiện có: Starter 99.000đ = 1.500 credit, Pro 279.000đ = 5.000 credit, Business 679.000đ = 13.000 credit, Enterprise 1.339.000đ = 30.000 credit. Xem đầy đủ các gói ở /pricing.html, hoặc đọc chi tiết cách nạp ở bài hướng dẫn nạp credit bằng VietQR qua PayOS.

Thực hành nhanh

Để bắt đầu dùng MCP server của TaiKhoanGiaRe: lấy API key ở dashboard, thêm server bằng claude mcp add với transport http và header Authorization, kiểm tra bằng /mcp, rồi thử lần lượt balance, chat, generate_image, generate_video cùng job_status. Mười tool này đủ để một agent vừa trả lời câu hỏi, vừa tạo ảnh/video/giọng nói, mà bạn không cần viết thêm một dòng code gọi API nào.

Câu hỏi thường gặp

MCP server của TaiKhoanGiaRe có cần cài thêm gì không?

Không, bạn chỉ cần thêm địa chỉ https://taikhoangiare.vn/mcp cùng API key vào client hỗ trợ MCP như Claude Code, không cần cài server riêng cho trường hợp dùng chat/ảnh/video/giọng nói qua API.

Dùng 10 tool MCP này có cần nhiều API key không?

Không, mỗi tài khoản chỉ có một secret key duy nhất, dùng chung cho mọi tool MCP cũng như mọi endpoint API khác.

Nếu job tạo video qua MCP bị lỗi thì có mất credit không?

Không, job lỗi được hoàn lại credit theo chính sách của site, bạn chỉ cần tạo job mới bằng generate_video.

MCP server này chỉ dùng được với Claude Code?

Không, cùng một MCP server có thể đăng ký vào nhiều client khác như Claude Desktop, Cursor, Blender, AutoCAD, chi tiết từng app nằm ở /integrations.html?app=mcp.

← Về trang Blog