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

# Limites de utilização do MCP

> Quais as ferramentas MCP que usam mensagens, como os limites se aplicam às chamadas de ferramentas MCP e como verificar a sua quota restante.

Os limites de utilização do Flowstep aplicam-se ao nível da **organização** e são **partilhados** entre a aplicação web e o servidor MCP. Uma geração iniciada no Cursor conta para a mesma quota de uma geração iniciada a partir de app.flowstep.ai.

## Que ferramentas usam mensagens

Apenas as quatro ferramentas de design com IA usam a sua quota de mensagens:

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

Todas as outras ferramentas são gratuitas. Isto inclui listar e ler ficheiros e ecrãs, renderizar imagens de ecrãs, ler e escrever JSX com `get-screen-jsx`, `add-screen-jsx` e `replace-screen-jsx`, gerir diretrizes de design, carregar anexos, importar do Figma e verificar o seu plano com `get-plan-details`.

O servidor também indica aos agentes ligados quais as ferramentas pagas, para que o agente possa ter isso em conta antes de as chamar.

## Como funcionam os limites

Os limites são definidos por funcionalidade (a funcionalidade principal é `messages`). Cada plano define:

* Um **limite diário**, que é reposto às **00:00 UTC** todos os dias
* Um **limite mensal**, que é reposto na **data de criação da conta ou do início da subscrição paga em cada mês**

Atingir qualquer um dos limites bloqueia novas gerações até à reposição. Consulte [Preços](https://flowstep.ai/pricing) para ver o que inclui cada plano.

## Verificar a sua quota

Chame `get-plan-details` para ver o seu plano atual, os limites, a utilização e a quota restante. É gratuito, por isso o agente pode verificar antes de iniciar um lote de gerações.

| Campo | Descrição |
| - | - |
| `limits.messages` | Os limites `daily` e `monthly` do seu plano, cada um com um valor `max` e um limiar `warn`, além de uma flag `unlimited` |
| `usage.messages` | Mensagens usadas até agora hoje (`daily`) e neste período (`monthly`) |
| `remaining.messages` | Mensagens restantes hoje e neste período. Omitido se o seu plano for ilimitado |

Os valores reais dos limites dependem do seu plano. Execute a ferramenta para ver os seus números específicos. Consulte a [Referência de ferramentas](/pt/mcp/tools#get-plan-details) para a estrutura completa da resposta.

## Limites por pedido (todos os planos)

Estes limites são aplicados ao nível do pedido, independentemente do plano:

| Limite | Valor |
| - | - |
| Máximo de anexos por chamada de `ai-generate-screens` / `ai-edit-screens` | 5 |
| Tamanho máximo de anexo | 3 MB |
| Tipos de anexo suportados | `image/jpeg`, `image/png`, `image/webp`, `application/pdf`, `text/markdown`, `text/plain`, `text/javascript` (use `text/javascript` para ficheiros `.js`, `.ts`, `.jsx` e `.tsx`) |
| Comprimento máximo de texto numa chamada de `upload-attachment` em modo texto | 64.000 caracteres |
| Máximo de frames importados de uma ligação de página do Figma com `import-figma` | 20 |
| Tempo limite de geração (`ai-generate-screens`, `ai-edit-screens`, `ai-generate-screen-variant`, `ai-edit-screen-variant`) | 180 segundos |

## Quando uma chamada não usa uma mensagem

Uma mensagem só é usada quando o Flowstep constrói ou altera efetivamente ecrãs. Se uma geração falhar, devido a um erro do servidor ou a uma entrada inválida, **não** consome uma mensagem. Se `ai-generate-screens` ou `ai-edit-screens` devolverem `status: "chat"` (uma resposta sem construção), também não é usada nenhuma mensagem.

<Note>
  Quando uma chamada de ferramenta de design com IA excede o tempo limite de 180 segundos, o servidor MCP deixa de aguardar pelo resultado, mas a geração pode continuar em segundo plano. Chame `list-screens` para verificar se surgiram novos ecrãs antes de tentar de novo, para não os gerar duas vezes.
</Note>


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