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

> Claude Desktop에서 Streamable HTTP MCP 전송을 사용하여 Flowstep을 연결합니다.

## 설정

`claude_desktop_config.json`을 편집합니다. 파일 위치는 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)">
    Node.js가 필요합니다.

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

저장 후 Claude Desktop을 다시 시작합니다.

## 인증

Claude Desktop이 처음 연결할 때 브라우저를 `https://api.flowstep.ai/oauth/authorize`로 엽니다. Flowstep 자격 증명으로 로그인하면 앱이 콜백을 캡처합니다.

<Note>
  연결하기 전에 Flowstep 계정이 필요합니다. [app.flowstep.ai](https://app.flowstep.ai)에서 만들 수 있습니다.
</Note>

## 연결 확인

Claude Desktop 대화에서:

```
List my Flowstep files
```

파일 목록이 표시되면(아직 파일이 없으면 빈 배열) 연결이 작동하는 것입니다.

## 사용 예제

```
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은 `create-file` → `ai-prompt` → `get-screen-image` 순서대로 호출합니다.