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

> Connecta Flowstep a OpenAI Codex usant el transport HTTP Streamable de MCP.

## Configuració

Afegeix el servidor amb l'CLI de Codex:

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

O edita el fitxer de configuració directament. Utilitza el fitxer global per habilitar-lo a tot arreu, o el fitxer del projecte (només projectes de confiança) per mantenir-lo limitat.

<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 selecciona el transport HTTP Streamable automàticament quan es defineix un `url` — no es necessita cap camp de transport.

## Autenticació

Executa:

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

Codex obri el teu navegador a `https://api.flowstep.ai/oauth/authorize`. Inicia sessió amb les teves credencials de Flowstep (email/contrasenya o Google SSO). Codex captura la resposta i emmagatzema el token.

<Note>
  Necessites una compte de Flowstep abans de connectar. Crea una a [app.flowstep.ai](https://app.flowstep.ai).
</Note>

## Verifica la connexió

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

El servidor hauria d'apareixer amb el seu estat OAuth. Dins d'una sessió de Codex, escriu `/mcp` per veure els servidors connectats, després pregunta:

```
List my Flowstep files
```

Si la crida a l'eina té èxit, la connexió està funcionant.

## Exemple d'ús

```
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 cridarà a `create-new-design` → `get-screen-image` i mostrarà el resultat.