Tucano Proxy

Instalação

Baixe o instalador da sua plataforma na página de download. O app é construído em Rust + Tauri 2 — binário enxuto (~10MB), sem dependências externas.

• macOS — abra o .dmg e arraste pra Aplicativos.
• Windows — rode o .msi ou o .exe de setup.
• Linux — .AppImage (chmod +x e rode) ou .deb.

Captura

Proxy MITM local que intercepta HTTP, HTTPS e WebSocket (a conexão WS é encaminhada — inspector de frames individuais está no roadmap).

• MITM em 127.0.0.1:8888 — Porta configurável em Configurações → Proxy. Tudo roda local — nada sai da sua máquina.
• CA raiz autogerada — Instalação one-click no trust store do OS. macOS via keychain (pede senha de admin), Windows via registry no store ROOT do usuário.
• Toggle de system proxy — Um clique no status bar liga/desliga o proxy do sistema (macOS via networksetup, Windows via registry). Reverte sozinho ao sair.
• SSL allowlist / blocklist — Pule MITM em hosts específicos. Útil para apps que fazem pinning ou domínios que você não quer interceptar.
• Detecção do client app — Cada flow mostra qual processo originou a request (campo clientApp, em macOS e Windows).

Inspector

Painéis lado a lado de Headers, Body e Timing. Viewers auto-detectados pelo content-type.

• Viewers — JSON tree, XML, HTML (com iframe e shadow preview), Raw, Hex, Image, Form (urlencoded + multipart).
• Layout — Posicione o inspector como painel direito, painel inferior ou esconda completamente.
• Busca dentro do body — ⌘F abre busca local com highlight via CodeMirror.
• Timing — DNS, conexão, TLS, TTFB, transferência — request e response side-by-side.

Lista de flows

Lista virtualizada (@tanstack/solid-virtual) que aguenta dezenas de milhares de capturas sem travar.

• Colunas configuráveis — Arraste para reordenar, arraste a borda direita para redimensionar, duplo clique para auto-fit.
• Marcas de cor — ⌘0–⌘6 marca o flow com cores. Útil pra agrupar visualmente o fluxo de uma feature.
• Notas inline — M abre o editor de nota por flow. Persistido na sessão .tucano.
• Category tabs — HTTP, HTTPS, WebSocket, JSON, Form, XML, JS, CSS, GraphQL, Document, Media, Other. Atalhos 1–9 alternam entre elas.
• Keep limit — Limite máximo de flows mantidos em memória — evita inchar em sessões longas.

Composer & Replay

Reproduza e modifique requests sem sair do app.

• Composer — Monte uma request do zero (método, URL, headers, body) e dispare através do Tucano — o resultado aparece como um flow normal.
• Replay — Re-dispara um flow existente, com sobrescritas opcionais em headers/body. O novo flow é logado e marcado como replay.

Sessões .tucano

Salva tudo em SQLite portátil — flows, bodies, notas, marcas de cor.

• Salvar / abrir — ⌘S salva como .tucano, ⌘O abre. Compartilhe com o time, anexe num ticket, abra meses depois — nada se perde.
• Onde os dados ficam — Sessão ativa fica em SQLite local na app data dir do Tauri. Não há sync, nem nuvem, nem telemetria.

Compare & Find All

• Compare (⌘D) — Selecione dois flows e abra um diff visual lado-a-lado — headers e body — pra entender o que mudou entre duas execuções.
• Find All (⌘⇧F) — Busca global em URL, body, notas e headers de todos os flows capturados, com highlight ao vivo.

Filtros (DSL)

A barra de filtro aceita uma DSL leve no padrão chave:valor, combinada com AND. Use -chave:valor pra negar e aspas pra valores com espaço. Texto livre vira busca full-text.

# só erros de uma API
host:api.foo.com status:>=400

# POSTs, invertendo um host
method:POST -host:cdn.foo.com

# header com espaço + duração
header:"x-trace=abc" duration:>500

Exportações

Por flow

• cURL (bash/zsh)
• cURL (Windows cmd)
• PowerShell (Invoke-WebRequest)
• JavaScript fetch
• Python requests
• HTTPie
• Raw HTTP/1.1

Em lote

• Postman Collection v2.1 .postman_collection.json
• HAR 1.2 .har
• LLM Markdown .md

Export para LLM (Markdown)

Gera um tucano.llm.md com prompt customizável, linguagem-alvo e steps estruturados. Headers sensíveis são mascarados e placeholders cross-step ({var1}) carregam dicas de locator. Linguagens-alvo: C# / .NET (HttpClient), TypeScript (fetch), Python (requests), Go (net/http), Java (HttpClient), Outro / livre.

# Tucano — Fluxo HTTP capturado

> Você é um engenheiro experiente em TypeScript (fetch).
> Antes de gerar código, siga o padrão do repo.

## Steps (estruturado)

### 1. POST auth.example.com/login → 200
| header        | value            |
| ------------- | ---------------- |
| authorization | ***REDACTED***   |

### 2. GET api.example.com/me → 200
| authorization | Bearer {var1}  |

Servidor MCP

O Tucano fala Model Context Protocol nativamente — sem Node, sem npx, sem pacote extra. Ligue a bridge MCP no app (Configurações → MCP) e ele serve o protocolo direto sobre Streamable HTTP em http://127.0.0.1:7878/mcp. Clientes LLM (Claude Desktop, Claude Code, Cursor, OpenCode, Codex) listam flows em tempo real, leem bodies, refazem com overrides e compõem requests novas.

Pré-requisitos

• Tucano Proxy aberto com a bridge MCP ligada (Configurações → MCP).
• Token Bearer copiado de Configurações → MCP (UUID gerado na primeira execução; pode rotacionar).

Instalação

O jeito mais simples é o botão Install em Configurações → MCP: ele escreve a entrada no config do cliente automaticamente, escolhendo o transporte certo. Pra configurar na mão, há dois transportes.

HTTP — Claude Code, Cursor, OpenCode, Codex

Conexão direta ao endpoint, sem processo extra. Não é suportado pelo Claude Desktop.

{
  "mcpServers": {
    "tucano": {
      "type": "http",
      "url": "http://127.0.0.1:7878/mcp",
      "headers": {
        "Authorization": "Bearer paste-the-token-from-tucano-settings"
      }
    }
  }
}

stdio — Claude Desktop

O config do Claude Desktop só aceita servidores stdio. O próprio binário do Tucano faz a ponte stdio → HTTP (sem Node/npx). Ajuste o command pro caminho do app na sua plataforma — ou deixe o botão Install preencher o caminho real automaticamente.

{
  "mcpServers": {
    "tucano": {
      "command": "/Applications/Tucano Proxy.app/Contents/MacOS/tucano-proxy",
      "args": ["mcp-stdio"],
      "env": {
        "TUCANO_MCP_URL": "http://127.0.0.1:7878/mcp",
        "TUCANO_MCP_TOKEN": "paste-the-token-from-tucano-settings"
      }
    }
  }
}

Variáveis de ambiente (transporte stdio)

• TUCANO_MCP_TOKEN — obrigatório. Bearer token gerado pelo app.
• TUCANO_MCP_URL — opcional. URL do endpoint MCP (padrão http://127.0.0.1:7878/mcp). Só mude se alterou a porta.

Ferramentas expostas

Endpoint MCP

A bridge expõe um único endpoint Streamable HTTP — POST 127.0.0.1:7878/mcp — que carrega JSON-RPC do MCP (handshake initialize, tools/list, tools/call). Toda requisição exige Authorization: Bearer <token>; no transporte stdio o token vai pela env TUCANO_MCP_TOKEN.

Atalhos

Em Linux/Windows, troque ⌘ por Ctrl. A lista completa também aparece em Configurações → Atalhos.

Instalação do certificado raiz

Pra inspecionar HTTPS, o Tucano gera um CA local e instala no trust store do OS. Sem ele, o Tucano ainda captura HTTP puro — só não decifra o TLS.

macOS

Configurações → Certificado → Install CA. Digite a senha de admin; o Tucano roda security add-trusted-cert no keychain. Safari e Chrome passam a confiar imediatamente.

Windows

Install CA grava no store ROOT do usuário via registry — sem prompt de admin. Edge e Chrome reaproveitam o store do sistema.

Firefox

Firefox tem store próprio. Em about:config, ative security.enterprise_roots.enabled = true, ou importe o certificado manualmente.

Roadmap

FAQ