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

# Servidor MCP do Flowstep

> Conecte seu agente de programação ao Flowstep via MCP para gerar, editar, inspecionar e gerenciar telas no canvas de design, a partir do Claude, do Cursor, do Codex ou de qualquer cliente compatível com MCP.

O Flowstep é o canvas de design para software construído por agentes. O servidor MCP do Flowstep expõe esse canvas pelo [Model Context Protocol](https://modelcontextprotocol.io/), para que os agentes que a sua equipe já usa possam criar telas, observar o resultado renderizado e construir a partir dele, sem sair do editor ou do terminal.

As telas que um agente cria pelo MCP ficam nos mesmos arquivos do Flowstep em que a sua equipe trabalha. Elas continuam editáveis no canvas, podem ser compartilhadas e estão prontas para serem exportadas ou copiadas para o Figma.

O servidor está hospedado em `https://api.flowstep.ai/mcp` (transporte Streamable HTTP). Não há processo local para executar nem chave de API para gerenciar. Os clientes fazem login com a sua conta do Flowstep por OAuth.

## O que você pode fazer

O servidor expõe 22 ferramentas em oito categorias:

| Categoria | Ferramentas |
| - | - |
| **Arquivos** | `list-files`, `get-file`, `create-file`, `update-file`, `delete-file` |
| **Telas** | `list-screens`, `get-screen-image`, `get-screen-jsx`, `add-screen-jsx`, `replace-screen-jsx`, `rename-screen`, `delete-screen` |
| **Instruções do arquivo** | `get-file-instructions`, `update-file-instructions`, `delete-file-instructions` |
| **Chat** | `get-chat-history` |
| **Anexos** | `upload-attachment` |
| **Figma** | `import-figma` |
| **Plano e cobrança** | `get-plan-details` |
| **Design com IA** | `ai-design-screens`, `ai-generate-screen-variant`, `ai-edit-screen-variant` |

As três ferramentas de **Design com IA** consomem a mesma cota de mensagens do app do Flowstep. Todas as outras ferramentas são gratuitas. Veja [Limites de uso](https://docs.flowstep.ai/pt-BR/mcp/usage-limits.md).

## Casos de uso comuns

**Gerar telas a partir de um prompt**: chame `ai-design-screens` com uma descrição. Se você omitir `fileId`, o Flowstep cria o arquivo e as telas em uma única etapa. Chame `get-screen-image` para cada `screenId` retornado e ver o resultado na própria conversa.

**Visualizar um componente React**: envie o seu código-fonte `.jsx` ou `.tsx` com `upload-attachment` (`mimeType: text/javascript`) e, em seguida, passe o anexo retornado para `ai-design-screens` com uma mensagem que descreva a tela. O Flowstep lê o código e gera um design correspondente.

**Iterar sobre um design**: chame `ai-design-screens` com uma ou mais `screenId`s (ou IDs de elementos individuais) em `elementIds` e instruções em texto livre para alterá-los no lugar. A mesma chamada também pode adicionar novas telas, então uma única solicitação pode editar uma tela e criar a próxima. Use `ai-edit-screen-variant` para aplicar um preset, como um tema escuro ou um layout diferente, a uma tela inteira.

**Expandir um fluxo**: chame `ai-generate-screen-variant` para adicionar a próxima tela, um estado de erro ou vazio, ou uma versão web, tablet ou mobile de uma tela existente.

**Trabalhar com código primeiro**: leia qualquer tela como JSX com `get-screen-jsx` e depois grave o seu próprio JSX de volta com `add-screen-jsx` (nova tela) ou `replace-screen-jsx` (sobrescreve uma tela existente). Para usar as suas próprias imagens, envie-as com `upload-attachment` e coloque o `assetUrl` retornado no seu JSX. Essas ferramentas são gratuitas.

**Manter a saída alinhada à marca**: use `update-file-instructions` para armazenar as regras do produto, o tom de voz e as convenções de layout de um arquivo como markdown simples. As gerações e edições de IA nesse arquivo seguem essas regras. Leia-as de volta com `get-file-instructions` ou limpe-as com `delete-file-instructions`. Cores, arredondamento e fontes vêm do tema do arquivo.

**Importar do Figma**: chame `import-figma` com o link de um frame do Figma e um `fileId` para trazer o frame para o canvas como elementos editáveis. A organização do arquivo precisa ter o Figma conectado antes.

**Verificar a sua cota**: chame `get-plan-details` para ver o seu plano, o uso e as mensagens restantes antes de um lote de gerações.

## Endpoint

```
https://api.flowstep.ai/mcp
```

Transporte: Streamable HTTP. Modelo de sessão: sem estado (cada solicitação é independente, sem ID de sessão).

O servidor oferece suporte à versão do protocolo MCP `2026-07-28`, anunciada em `https://api.flowstep.ai/.well-known/mcp.json`. Clientes que usam o protocolo anterior, `2025-11-25`, se conectam ao mesmo endpoint.

## Próximos passos

> [card] [Início rápido](https://docs.flowstep.ai/pt-BR/mcp/quickstart.md)
>
> Conecte um cliente e faça a sua primeira chamada de ferramenta.

> [card] [Autenticação](https://docs.flowstep.ai/pt-BR/mcp/authentication.md)
>
> Como funcionam o login OAuth 2.1 com PKCE e a aprovação.

> [card] [Ferramentas](https://docs.flowstep.ai/pt-BR/mcp/tools.md)
>
> Referência completa de entrada e saída de todas as 22 ferramentas.

> [card] [Exemplos](https://docs.flowstep.ai/pt-BR/mcp/examples.md)
>
> Fluxos de trabalho completos para tarefas comuns.


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