> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowstep.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Giới hạn sử dụng MCP

> Các công cụ MCP nào sử dụng tin nhắn, giới hạn áp dụng cho lệnh gọi công cụ MCP như thế nào, và cách kiểm tra hạn ngạch còn lại.

Giới hạn sử dụng của Flowstep áp dụng ở cấp **tổ chức** và được **chia sẻ** giữa ứng dụng web và máy chủ MCP. Một lần tạo được khởi chạy từ Cursor sẽ tính vào cùng hạn mức với một lần tạo được bắt đầu từ app.flowstep.ai.

## Công cụ nào sử dụng tin nhắn

Chỉ bốn công cụ thiết kế AI mới sử dụng hạn mức tin nhắn của bạn:

* `ai-generate-screens`
* `ai-edit-screens`
* `ai-generate-screen-variant`
* `ai-edit-screen-variant`

Tất cả các công cụ khác đều miễn phí, bao gồm liệt kê và đọc tệp và màn hình, kết xuất hình ảnh màn hình, đọc và ghi JSX bằng `get-screen-jsx`, `add-screen-jsx` và `replace-screen-jsx`, quản lý nguyên tắc thiết kế, tải tệp đính kèm, nhập từ Figma, và kiểm tra gói của bạn bằng `get-plan-details`.

Máy chủ cũng cho các tác nhân đã kết nối biết công cụ nào là có phí, để tác nhân của bạn có thể tính đến điều đó trước khi gọi chúng.

## Cách giới hạn hoạt động

Giới hạn áp dụng theo từng tính năng (tính năng chính là `messages`). Mỗi gói xác định:

* **Giới hạn hằng ngày**: được đặt lại vào **00:00 UTC** mỗi ngày
* **Giới hạn hằng tháng**: được đặt lại vào **ngày đăng ký tài khoản hoặc ngày bắt đầu gói trả phí** mỗi tháng

Khi chạm tới một trong hai giới hạn, các lần tạo tiếp theo sẽ bị chặn cho đến khi giới hạn được đặt lại. Xem [Bảng giá](https://flowstep.ai/pricing) để biết mỗi gói bao gồm những gì.

## Kiểm tra hạn ngạch

Gọi `get-plan-details` để xem gói hiện tại, giới hạn, mức sử dụng và hạn ngạch còn lại. Công cụ này có thể gọi miễn phí, vì vậy tác nhân của bạn có thể kiểm tra trước khi bắt đầu một loạt lần tạo.

| Trường | Mô tả |
| - | - |
| `limits.messages` | Giới hạn `daily` và `monthly` của gói, mỗi giới hạn có ngưỡng `max` và `warn`, cùng cờ `unlimited` |
| `usage.messages` | Số tin nhắn đã dùng hôm nay (`daily`) và trong kỳ này (`monthly`) |
| `remaining.messages` | Số tin nhắn còn lại hôm nay và trong kỳ này. Bị bỏ qua nếu gói của bạn không giới hạn |

Giá trị giới hạn thực tế phụ thuộc vào gói của bạn. Hãy chạy công cụ để xem số liệu cụ thể. Xem [Tham chiếu công cụ](/vi/mcp/tools#get-plan-details) để biết cấu trúc phản hồi đầy đủ.

## Giới hạn theo từng yêu cầu (mọi gói)

Các giới hạn này được áp dụng ở cấp yêu cầu, bất kể gói nào:

| Giới hạn | Giá trị |
| - | - |
| Số tệp đính kèm tối đa cho mỗi lệnh gọi `ai-generate-screens` / `ai-edit-screens` | 5 |
| Dung lượng tệp đính kèm tối đa | 3 MB |
| Loại tệp đính kèm được hỗ trợ | `image/jpeg`, `image/png`, `image/webp`, `application/pdf`, `text/markdown`, `text/plain`, `text/javascript` (dùng `text/javascript` cho tệp `.js`, `.ts`, `.jsx` và `.tsx`) |
| Độ dài văn bản tối đa cho lệnh gọi `upload-attachment` ở chế độ văn bản | 64.000 ký tự |
| Số khung tối đa được nhập từ liên kết trang Figma bằng `import-figma` | 20 |
| Thời gian chờ tạo (`ai-generate-screens`, `ai-edit-screens`, `ai-generate-screen-variant`, `ai-edit-screen-variant`) | 180 giây |

## Khi một lệnh gọi không sử dụng tin nhắn

Một tin nhắn chỉ được dùng khi Flowstep thực sự xây dựng hoặc thay đổi màn hình. Nếu một lần tạo thất bại do lỗi máy chủ hoặc đầu vào không hợp lệ, lần tạo đó **không** tiêu tốn tin nhắn. Nếu `ai-generate-screens` hoặc `ai-edit-screens` trả về `status: "chat"` (một câu trả lời mà không xây dựng gì), cũng không dùng tin nhắn nào.

<Note>
  Khi một lệnh gọi công cụ thiết kế AI hết thời gian sau 180 giây, máy chủ MCP ngừng chờ kết quả, nhưng quá trình tạo vẫn có thể hoàn tất ở chế độ nền. Hãy gọi `list-screens` để kiểm tra xem có màn hình mới nào đã xuất hiện chưa trước khi thử lại, để bạn không tạo chúng hai lần.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.