Máy chủ MCP của ToRun
Cập nhật lần cuối: 11 thg 11 2026
Đây là gì
Máy chủ MCP của ToRun cho phép tác nhân lập trình dùng ToRun trong khi làm việc với dự án của bạn. Một tác nhân hỗ trợ máy chủ MCP từ xa, như Claude Code, Cursor hoặc opencode, có thể tạo hình ảnh, giọng nói, âm nhạc và video, chỉnh sửa hình ảnh, chép lời âm thanh, chạy nghiên cứu chuyên sâu và các mẫu quy trình làm việc của ToRun, và xuất bản một trang HTML hoặc trò chơi trên trình duyệt dưới dạng liên kết, mà bạn không cần rời khỏi trình soạn thảo. Những gì tác nhân tạo ra được thanh toán từ tài khoản ToRun của bạn theo cùng mức giá như trong ứng dụng, và được lưu vào tài khoản ToRun của bạn như mọi thứ bạn tạo trong ứng dụng.
Địa chỉ và đăng nhập
| Địa chỉ máy chủ | https://mcp.torun.ai/mcp |
| Giao thức truyền | HTTP (máy chủ MCP từ xa) |
| Đăng nhập | Authorization: Bearer <your developer key> |
Khóa nhà phát triển bắt đầu bằng trn_live_. Bạn tạo khóa trên trang Nhà phát triển trong tài khoản ToRun của mình: xem Khóa nhà phát triển. Thiết lập cho từng công cụ:
Công cụ
| Công cụ | Chức năng | Trả phí |
|---|---|---|
image_generate |
Tạo hình ảnh từ một câu lệnh: sprite, biểu tượng, hình nền, hình minh họa. Trả về hình ảnh, hoặc một mã công việc khi việc tạo mất lâu hơn thời gian tác nhân chọn chờ. | Có |
image_edit |
Thay đổi một hình ảnh theo hướng dẫn bằng văn bản: nền mới, màu khác, thêm hoặc bỏ một vật thể, phong cách khác. Hình ảnh là ảnh tác nhân đã tạo bằng ToRun hoặc liên kết tới một tệp PNG, JPEG hoặc WebP tối đa 20 MB; hình ảnh đưa qua liên kết sẽ được lưu vào thư viện ToRun của bạn trước. Trả về hình ảnh hoặc mã công việc, giống như image_generate. |
Có |
tts_generate |
Chuyển văn bản thành giọng nói và trả về tệp âm thanh cùng thời lượng phát, được đo từ tệp. | Có |
stt_transcribe |
Chuyển lời nói trong tệp âm thanh hoặc video thành văn bản, kèm các đoạn có mốc thời gian cho phụ đề khi tác nhân yêu cầu. Nhận các tệp mp3, m4a, wav, webm, ogg, opus, flac, aac và mp4 tối đa 25 MB. | Có |
music_generate |
Sáng tác một bản nhạc, có hoặc không có giọng hát, và trả về một mã công việc. | Có |
video_generate |
Tạo một clip ngắn từ một câu lệnh và trả về một mã công việc. | Có |
job_status |
Báo tiến độ của công việc tạo hình ảnh, nhạc hoặc video và trả về tệp khi đã xong. | Miễn phí |
deep_research_start |
Bắt đầu một lượt nghiên cứu chuyên sâu về một câu hỏi: tìm kiếm trên web qua nhiều nguồn và viết báo cáo có trích dẫn nguồn. Trả về một mã công việc. | Có |
deep_research_status |
Báo tiến độ của lượt nghiên cứu chuyên sâu và trả về báo cáo khi đã xong. | Miễn phí |
workflow_template_search |
Tìm các mẫu quy trình làm việc của ToRun, tức các quy trình nhiều bước dựng sẵn, và cho biết mỗi mẫu tạo ra gì, thường tốn bao nhiêu và nhận những dữ liệu đầu vào nào. | Miễn phí |
workflow_run |
Chạy một mẫu quy trình làm việc với dữ liệu đầu vào tác nhân cung cấp và trả về một mã công việc. | Có |
workflow_run_status |
Báo tiến độ của một lượt chạy quy trình làm việc và số Runs đã tốn cho đến lúc đó, và trả về kết quả khi đã xong. | Miễn phí |
canvas_publish |
Xuất bản một trang HTML một tệp hoặc trò chơi trên trình duyệt dưới dạng liên kết. | Miễn phí |
account_balance |
Hiển thị phần còn lại của hạn mức gói và ví, cùng giới hạn hằng tháng và mức đã chi của khóa này. | Miễn phí |
Liên kết tệp mà công cụ trả về tải xuống được mà không cần đăng nhập, nên tác nhân có thể lưu tệp vào dự án của bạn. Hãy giữ nguyên toàn bộ liên kết, kể cả phần sau dấu chấm hỏi.
Trang đã xuất bản là không công khai: ai có liên kết đều mở được, nhưng trang không hiển thị trong mục Khám phá của ToRun và các công cụ tìm kiếm không lập chỉ mục trang đó.
Công việc dài
Âm nhạc, video, nghiên cứu chuyên sâu và các lượt chạy quy trình làm việc mất nhiều thời gian hơn một lệnh gọi. Công cụ trả về một mã công việc, và tác nhân hỏi lại cho đến khi kết quả xong: job_status cho hình ảnh, nhạc và video, deep_research_status cho báo cáo nghiên cứu và workflow_run_status cho lượt chạy quy trình làm việc. Một hình ảnh chưa xong trong thời gian chờ mà tác nhân chọn cũng được trả về dưới dạng mã công việc.
Một lượt nghiên cứu mất từ 1 đến 10 phút và vẫn tiếp tục nếu cuộc trò chuyện với tác nhân kết thúc; báo cáo cũng xuất hiện như một cuộc trò chuyện riêng trong danh sách trò chuyện ToRun của bạn. Một lượt chạy quy trình làm việc mất từ một phút đến vài chục phút, và lượt chạy cùng các tệp của nó xuất hiện trong tài khoản ToRun của bạn. Báo cáo dài hoặc tập kết quả dài được gửi thành nhiều phần, và tác nhân sẽ yêu cầu phần còn lại.
Các lệnh gọi được thanh toán thế nào
- Mỗi lệnh gọi trả phí được tính bằng Runs theo cùng mức giá như trong ứng dụng.
- Lệnh gọi được trả trước tiên từ hạn mức gói của bạn, sau đó từ ví nếu bạn đã cho phép điều đó trên khóa.
- Hạn mức miễn phí không bao giờ trả cho lệnh gọi API.
- Một lượt chạy quy trình làm việc được tính phí theo từng bước trong khi chạy.
- Mọi khoản phí đều xuất hiện trên trang thanh toán của bạn, dưới khóa đã tạo ra khoản phí đó.
Lệnh gọi vượt ngưỡng của khóa sẽ hỏi trước
Mỗi khóa có một ngưỡng. Khi một lệnh gọi sẽ tốn nhiều hơn ngưỡng đó, công cụ chưa chạy nó. Với một lượt chạy quy trình làm việc, chi phí ước tính của lượt chạy là thứ được so sánh.
- Nếu công cụ của bạn có thể hiển thị biểu mẫu khi máy chủ MCP đặt câu hỏi (MCP elicitation), ToRun sẽ hỏi bạn ở đó: biểu mẫu hiển thị giá và hỏi có tiếp tục không. Lệnh gọi sẽ chạy nếu bạn đồng ý; nếu bạn từ chối, không có gì được chạy.
- Nếu không, công cụ trả lời bằng giá, tác nhân cho bạn xem giá đó, và lệnh gọi chỉ chạy khi tác nhân gọi lại sau khi bạn đồng ý.
Việc hỏi không bị tính phí.
Giới hạn
Mỗi khóa có giới hạn chi tiêu hằng tháng và hằng ngày, cùng giới hạn số lệnh gọi mỗi phút. Mỗi tài khoản cũng có giới hạn hằng ngày về số trang được xuất bản. Bạn đặt giới hạn hằng tháng và ngưỡng của khóa khi tạo khóa; giá trị mặc định được liệt kê tại torun.ai/developers. Để thay đổi, hãy tạo một khóa mới với cài đặt bạn muốn và thu hồi khóa cũ.
Khi lệnh gọi bị từ chối
| Tác nhân được thông báo | Cần làm gì |
|---|---|
| Lệnh gọi cần khóa nhà phát triển | Kiểm tra rằng TORUN_API_KEY chứa toàn bộ khóa và khóa chưa bị thu hồi. |
| Hạn mức gói đã hết và khóa không được chi từ ví | Chờ hạn mức được làm mới, hoặc tạo một khóa được phép chi từ ví. |
| Khóa nhà phát triển chỉ chi hạn mức của gói trả phí hoặc ví | Nạp thêm tiền hoặc đăng ký gói. |
| Khóa đã đạt giới hạn chi tiêu hằng tháng hoặc hằng ngày | Chờ đến ngày hoặc tháng tiếp theo, hoặc tạo một khóa có giới hạn cao hơn. |
| Khóa đã thực hiện quá nhiều lệnh gọi trong một phút | Chờ một lát rồi thử lại. |
| Khóa không có phạm vi mà công cụ cần | Không thể thay đổi phạm vi của khóa. Hãy tạo khóa mới: khóa mới có mọi phạm vi. |
| Tệp phải được cung cấp dưới dạng mã thư viện ToRun hoặc liên kết https, không phải cả hai | Chỉ cung cấp đúng một trong hai. |
| Không có tệp như vậy trong thư viện ToRun của tài khoản | Dùng một tệp của tài khoản này. Liên kết ToRun tới tệp của tài khoản khác cũng bị từ chối theo cách tương tự. |
| Tệp quá lớn, không ở định dạng mà công cụ nhận, hoặc không tải xuống được | Hình ảnh cho image_edit: PNG, JPEG hoặc WebP, tối đa 20 MB. Tệp cho stt_transcribe: mp3, m4a, wav, webm, ogg, opus, flac, aac hoặc mp4, tối đa 25 MB. Liên kết phải tải xuống được mà không cần đăng nhập. |