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

> Conecte Flowstep ao OpenAI Codex usando o transporte HTTP MCP Streamable.

## Configuração

Adicione o servidor com a CLI do Codex:

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

Ou edite o arquivo de configuração diretamente. Use o arquivo global para ativá-lo em qualquer lugar, ou o arquivo de projeto (apenas projetos confiáveis) para mantê-lo no escopo.

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

O Codex escolhe 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
```

O Codex abre seu navegador para `https://api.flowstep.ai/oauth/authorize`. Faça login com suas credenciais do Flowstep (email/senha ou Google SSO). O Codex captura o retorno de chamada e armazena o token.

<Note>
  Você precisa de uma conta do Flowstep antes de conectar. Crie uma em [app.flowstep.ai](https://app.flowstep.ai).
</Note>

## Verificar a conexão

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

O servidor deve aparecer com seu status OAuth. Dentro de uma sessão do Codex, digite `/mcp` para ver os servidores conectados, depois pergunte:

```
List my Flowstep files
```

Se a chamada da ferramenta for bem-sucedida, a conexã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.
```

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