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

# Flowstep MCP — Codex

> Ligue Flowstep ao Codex OpenAI utilizando o transporte MCP HTTP Streamable.

## Configuração

Adicione o servidor com a Codex CLI:

```bash theme={"system"}
codex mcp add flowstep --url https://api.flowstep.ai/mcp
```

Ou edite o ficheiro de configuração diretamente. Use o ficheiro global para ativá-lo em todo o lado, ou o ficheiro do projeto (apenas projetos de confiança) para o manter circunscrito.

<Tabs>
  <Tab title="Global (~/.codex/config.toml)">
    ```toml theme={"system"}
    [mcp_servers.flowstep]
    url = "https://api.flowstep.ai/mcp"
    ```
  </Tab>

  <Tab title="Project (.codex/config.toml)">
    ```toml theme={"system"}
    [mcp_servers.flowstep]
    url = "https://api.flowstep.ai/mcp"
    ```
  </Tab>
</Tabs>

Codex seleciona o transporte HTTP Streamable automaticamente quando um `url` é definido — nenhum campo de transporte necessário.

## Autenticação

Execute:

```bash theme={"system"}
codex mcp login flowstep
```

Codex abre o seu navegador para `https://api.flowstep.ai/oauth/authorize`. Inicie sessão com as suas credenciais Flowstep (email/palavra-passe ou Google SSO). Codex captura o callback e armazena o token.

<Note>
  Precisa de uma conta Flowstep antes de se ligar. Crie uma em [app.flowstep.ai](https://app.flowstep.ai).
</Note>

## Verifique a ligação

```bash theme={"system"}
codex mcp list
```

O servidor deve aparecer com o seu estado OAuth. Dentro de uma sessão Codex, escreva `/mcp` para ver os servidores ligados, depois pergunte:

```
List my Flowstep files
```

Se a chamada da ferramenta for bem-sucedida, a ligação está funcionando.

## Exemplo de uso

```
Create a Flowstep file called "Checkout flow", generate a mobile payment screen
with a card form and an order summary, then show me the rendered image.
```

Codex chamará `create-new-design` → `get-screen-image` e exibirá o resultado.