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

> Ligue o Flowstep ao Claude Desktop usando o transporte HTTP MCP Streamable.

## Configuração

Edite `claude_desktop_config.json`. A localização do ficheiro depende do seu SO:

* **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 (versões mais antigas)">
    Requer Node.js instalado.

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

Reinicie o Claude Desktop após guardar.

## Autenticação

O Claude Desktop abre o seu navegador em `https://api.flowstep.ai/oauth/authorize` na primeira ligação. Inicie sessão com as suas credenciais do Flowstep e a aplicação captura a chamada de retorno.

<Note>
  Precisa de uma conta do Flowstep antes de se ligar. Crie uma em [app.flowstep.ai](https://app.flowstep.ai).
</Note>

## Verifique a ligação

Numa conversa do Claude Desktop:

```
Listar os meus ficheiros do Flowstep
```

Se vir uma lista de ficheiros (ou uma matriz vazia se ainda não tiver ficheiros), a ligação está a funcionar.

## Exemplo de utilização

```
Crie um ficheiro do Flowstep chamado "Página de perfil", gere um ecrã de perfil móvel
com um avatar, nome de utilizador, biografia e um botão de edição. Mostre-me a imagem renderizada.
```

O Claude Desktop chamará `create-file` → `ai-prompt` → `get-screen-image` em sequência.