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

> Connect Flowstep to Claude Desktop using the Streamable HTTP MCP transport.

## Configuration

Edit `claude_desktop_config.json`. The file location depends on your OS:

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

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

  <Tab title="mcp-remote (older versions)">
    Requires Node.js installed.

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

Restart Claude Desktop after saving.

## Authentication

Claude Desktop opens your browser to `https://api.flowstep.ai/oauth/authorize` on first connection. Sign in with your Flowstep credentials and the app captures the callback.

<Note>
  You need a Flowstep account before connecting. Create one at [app.flowstep.ai](https://app.flowstep.ai).
</Note>

## Verify the connection

In a Claude Desktop conversation:

```
List my Flowstep files
```

If you see a file list (or an empty array if you have no files yet), the connection is working.

## Usage example

```
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 will call `create-file` → `ai-prompt` → `get-screen-image` in sequence.