# Proxy de navegador

O Browser Proxy é um **serviço Docker separado** que oferece automação de
navegador headless via Playwright. Ele não faz parte diretamente da API do
Synapse — os endpoints do Synapse não incluem caminhos `/browser/*`.

## Arquitetura

```
┌──────────────┐                ┌──────────────────┐
│  Synapse API │                │  Browser Proxy   │
│  port 12800  │                │  port 13000      │
│              │                │  (Playwright)    │
└──────────────┘                └──────────────────┘
       ▲                                ▲
       │                                │
       └──────────┌─────────────┐──────┘
                  │  MCP Server │
                  │  port 13100 │
                  └─────────────┘
```

## Métodos de acesso

### Método 1: Via servidor MCP do Synapse (recomendado)

O servidor MCP do Synapse expõe ferramentas de navegador como ferramentas MCP.
Use isto para automação de navegador orientada por LLM:

```json
// Claude Desktop config
{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-mcp-api@latest"],
      "env": {
        "SYNAPSE_MIND_KEY": "mk_...",
        "SYNAPSE_URL": "https://synapse.schaefer.zone"
      }
    }
  }
}
```

Ferramentas MCP de navegador disponíveis:

- `browser_new` — abre uma nova aba do navegador
- `browser_navigate` — navega para uma URL
- `browser_click` — clica em um elemento
- `browser_type` — digita texto em um campo
- `browser_screenshot` — captura uma screenshot
- `browser_close` — fecha a aba
- (e mais — consulte [Integração MCP](/docs/mcp/what-is-mcp))

### Método 2: Acesso direto ao Browser Proxy

Para integrações não-MCP, conecte-se diretamente ao serviço browser-proxy:

```bash
# Health check
curl http://browser-proxy.schaefer.zone:13000/health

# Open a page
curl -X POST http://browser-proxy.schaefer.zone:13000/navigate \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'
```

## Casos de uso comuns

### Web scraping

```python
# Via MCP (Claude Desktop)
"Use browser_navigate to open https://news.ycombinator.com, 
 then extract the top 10 story titles."
```

### Automação de formulário

```python
# Via MCP
"Use browser_navigate to open the login page,
 browser_type to fill username and password,
 browser_click to submit the form."
```

### Captura de screenshot

```python
# Via MCP
"Take a screenshot of https://example.com and save it."
```

## Serviços relacionados

| Serviço | Porta | Finalidade |
|---------|-------|------------|
| Synapse API | 12800 | Memória, chat, tarefas |
| Synapse MCP | 13100 | Servidor MCP (79 ferramentas) |
| Browser Proxy | 13000 | Automação de navegador headless |
| SSH Proxy | 12900 | Acesso SSH a máquinas remotas |

## Próximos passos

- [Integração MCP](/docs/mcp/what-is-mcp) — como usar ferramentas de navegador via MCP
- [API de Controle de Computadores](/docs/api/computers) — para automação de GUI em máquinas registradas