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

> Połącz Flowstep z OpenAI Codex, używając transportu Streamable HTTP MCP.

## Konfiguracja

Dodaj serwer za pomocą Codex CLI:

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

Lub edytuj plik konfiguracyjny bezpośrednio. Użyj pliku globalnego, aby włączyć go wszędzie, lub pliku projektu (tylko zaufane projekty), aby utrzymać jego zakres.

<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 automatycznie wybiera transport Streamable HTTP, gdy ustawiony jest `url` — pole transportu nie jest potrzebne.

## Uwierzytelnianie

Uruchom:

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

Codex otwiera Twoją przeglądarkę na `https://api.flowstep.ai/oauth/authorize`. Zaloguj się, używając swoich danych logowania Flowstep (email/hasło lub Google SSO). Codex przechwytuje callback i przechowuje token.

<Note>
  Musisz mieć konto Flowstep zanim się połączysz. Utwórz jedno na [app.flowstep.ai](https://app.flowstep.ai).
</Note>

## Sprawdzenie połączenia

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

Serwer powinien pojawić się ze swoim statusem OAuth. W sesji Codex wpisz `/mcp`, aby zobaczyć podłączone serwery, a następnie zapytaj:

```
List my Flowstep files
```

Jeśli wywołanie narzędzia się powiedzie, połączenie działa.

## Przykład użycia

```
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 will call `create-new-design` → `get-screen-image` and display the result.