> ## 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 — Claude Desktop

> Connetti Flowstep a Claude Desktop utilizzando il trasporto HTTP MCP Streamable.

## Configurazione

Modifica `claude_desktop_config.json`. La posizione del file dipende dal tuo sistema operativo:

* **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

<Tabs>
  <Tab title="HTTP nativo (Claude Desktop v0.9+)">
    ```json theme={"system"}
    {
      "mcpServers": {
        "flowstep": {
          "type": "http",
          "url": "https://api.flowstep.ai/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="mcp-remote (versioni precedenti)">
    Richiede Node.js installato.

    ```json theme={"system"}
    {
      "mcpServers": {
        "flowstep": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://api.flowstep.ai/mcp"]
        }
      }
    }
    ```
  </Tab>
</Tabs>

Riavvia Claude Desktop dopo aver salvato.

## Autenticazione

Claude Desktop apre il browser su `https://api.flowstep.ai/oauth/authorize` al primo collegamento. Accedi con le tue credenziali Flowstep e l'app acquisisce il callback.

<Note>
  Hai bisogno di un account Flowstep prima di connetterti. Creane uno su [app.flowstep.ai](https://app.flowstep.ai).
</Note>

## Verifica il collegamento

In una conversazione di Claude Desktop:

```
List my Flowstep files
```

Se vedi un elenco di file (o un array vuoto se non hai ancora file), il collegamento funziona.

## Esempio di utilizzo

```
Create a Flowstep file called "Profile page", generate a mobile profile screen
with an avatar, display name, bio, and an edit button. Show me the rendered image.
```

Claude Desktop chiamerà `create-file` → `ai-prompt` → `get-screen-image` in sequenza.