← Voltar para o blog

Conectar o Claude Desktop ao servidor MCP do Rockxy em 3 minutos

· leitura de 6 min

O Rockxy 0.9.0 traz um servidor Model Context Protocol (MCP) embutido. Uma vez conectado, o Claude Desktop lê flows HTTP que você já capturou, refaz requisições e tira diff entre respostas — sem precisar colar saída de curl no chat. Este guia mostra a configuração de 3 minutos e o que o Claude efetivamente faz com o tráfego.

Por que conectar o Claude Desktop ao seu tráfego HTTP

Depurar HTTP sempre foi um problema de copia-e-cola. Você acha uma requisição falha no proxy, copia headers e body, cola em um chat ou num doc, escreve em volta uma pergunta legível. O context switching custa tempo. E o assistente só enxerga aquilo que você escolheu colar.

MCP inverte isso. Em vez de copiar e colar, você dá ao Claude um caminho direto para o proxy. O Claude chama list_flows, lê os flows que precisa, e faz perguntas de acompanhamento olhando os bytes reais. Uma requisição que falhou não é mais um screenshot; é uma tool call que ele pode refazer depois de sugerir uma correção.

Conectar os dois encurta o ciclo de depuração. Você descreve em português simples o que está acontecendo. O Claude lê a requisição real, não uma parafraseada. Quando ele propõe um ajuste, você pode refazer a requisição alterada para validar na hora. Assistente e proxy ficam na mesma página — e essa página está no seu Mac. Nada sai da máquina.

Pré-requisitos

  • macOS 14 (Sonoma) ou posterior. O binário MCP do Rockxy é universal (Apple Silicon + Intel).
  • Claude Desktop com suporte a MCP (builds de fim de 2024 em diante).
  • Rockxy 0.9.0 ou superior. Builds anteriores não incluem o servidor MCP.
  • 5 minutos. O trabalho são 3 minutos, mas reserve uma folga para o diálogo do Gatekeeper na primeira execução.

Passo 1: instalar o Rockxy

Baixe o DMG em rockxy.io/pt-br/download, monte e arraste Rockxy.app para /Applications. Abra uma vez para o macOS registrar o app como confiável.

Na primeira execução o Gatekeeper aparece. O Rockxy é assinado e notarizado, então você deve ver "Abrir Rockxy". Se aparecer "não foi possível verificar o desenvolvedor", vá em Ajustes do Sistema → Privacidade e Segurança, role até a seção de segurança e clique em Abrir assim mesmo.

Com o Rockxy em execução, o binário MCP fica em:

/Applications/Rockxy.app/Contents/MacOS/rockxy-mcp

Vamos usar esse caminho no Passo 3 — anote.

Passo 2: ativar o servidor MCP no Rockxy

Abra Rockxy → Ajustes → MCP (ou Cmd+, e clique na aba MCP) e ligue Enable MCP Server.

O servidor MCP do Rockxy roda como subprocesso, criado sob demanda pelo cliente MCP. Ele conversa com o Claude Desktop por stdio (entrada e saída padrão), então o transporte MCP em si não é um socket de rede. Para clientes que não usam stdio, o Rockxy também expõe uma porta HTTP local restrita ao loopback. Nenhuma das duas vias sai do seu Mac.

Com MCP ativo, o Rockxy expõe quatro ferramentas: list_flows, get_flow_detail, replay_request e diff_flows. Cada ferramenta trabalha sobre o arquivo de sessão aberto no momento, então você controla o escopo do que o Claude enxerga pelo arquivo que mantiver aberto.

Em resumo: list_flows aceita filtros (host, método, status, intervalo de tempo, limite) e devolve um array de resumos de flow. get_flow_detail recebe um ID e devolve requisição completa (headers + body), resposta completa (headers + body) e detalhamento de tempo (DNS, TCP, TLS, TTFB, transferência). replay_request recebe um ID mais overrides opcionais, refaz a requisição contra o host original e devolve um novo ID. diff_flows recebe dois IDs e devolve um diff estruturado (path, headers, campos do body), então o Claude resume mudanças sem você comparar dois JSONs no olho.

Passo 3: editar claude_desktop_config.json

O Claude Desktop lê a configuração MCP de um único arquivo:

~/Library/Application Support/Claude/claude_desktop_config.json

Se não existir, crie. Se você já tem outros servidores MCP registrados, adicione o Rockxy ao objeto mcpServers existente. Configuração mínima só com Rockxy:

{
  "mcpServers": {
    "rockxy": {
      "command": "/Applications/Rockxy.app/Contents/MacOS/rockxy-mcp",
      "args": []
    }
  }
}

Salve. Não precisa recarregar nada agora — o Claude Desktop só relê a configuração no boot.

Passo 4: reiniciar o Claude Desktop

Feche o Claude Desktop por completo com Cmd+Q. Fechar a janela não basta — o app fica em background, e processos em background não releem configuração. Abra de novo via Launchpad ou Spotlight.

Ao subir, o Claude Desktop inicia o processo Rockxy MCP como filho, conecta por stdio e lê o manifesto de ferramentas. Um pequeno ícone de plug aparece na conversa do Claude Desktop quando um servidor MCP está conectado.

Passo 5: validar a conexão

Abra uma conversa nova no Claude Desktop e envie:

Liste os 5 flows HTTP mais recentes capturados pelo Rockxy.

Esperado: o Claude chama a tool list_flows com limit=5. A conversa mostra um bloco de tool call (geralmente recolhido) com entrada e saída brutas. Depois o Claude resume os flows em texto: método, host, path, status, tamanho.

Se a lista sair vazia, gere tráfego primeiro. Ative o proxy do sistema do Rockxy, abra uma aba e dê reload. Repita a pergunta.

Troubleshooting

Binário não encontrado. Se o log do Claude Desktop mostra command not found ou o plug do MCP não acende, revise o caminho no arquivo de configuração. O caminho correto é sempre /Applications/Rockxy.app/Contents/MacOS/rockxy-mcp. Se você instalou o Rockxy em ~/Applications, ajuste a entrada.

MCP não ativado no Rockxy. Sem ativar em Ajustes, o servidor MCP aceita stdio mas devolve mcp_disabled. Ligue a chave e reinicie o Claude Desktop.

Ferramentas não reconhecidas. Se o plug acende mas o Claude diz "não tenho essa ferramenta", abra o console de desenvolvedor do Claude Desktop (Cmd+Option+I em builds recentes). A causa comum é erro de parse no JSON de claude_desktop_config.json — vírgula faltando, vírgula sobrando no final, ou aspas "smart" coladas de um editor de texto rico.

O que o Claude faz com o seu tráfego

Com a conexão firme, experimente prompts assim:

  • "Por que a última requisição para /api/auth falhou?" — o Claude chama list_flows, filtra por host e path, busca o detalhe do 401 e lê o header WWW-Authenticate para explicar.
  • "Diff entre as duas últimas mutations GraphQL." — o Claude lista flows, seleciona as duas mutations, chama diff_flows e resume quais campos mudaram.
  • "Refaça o flow 42 com header Authorization Bearer eyJ...." — o Claude usa replay_request com override, lê a nova resposta e diz se ainda deu 401.
  • "Qual endpoint foi o mais lento nesta sessão?" — o Claude percorre a lista, puxa timing de cada detalhe e monta um ranking.

A superfície do servidor MCP é intencionalmente pequena — só quatro ferramentas. Menor a superfície, mais fácil o modelo trabalha com ela, e você mantém o tráfego dentro de operações que autorizou explicitamente.

Um detalhe útil: toda tool call aparece na conversa do Claude Desktop como bloco recolhível. Expanda e você vê exatamente qual input foi enviado e qual output a tool devolveu. Se tem dúvida se o Claude fez o que você pediu, é aqui que você checa. Também ajuda a depurar prompts que não fluem: você vê se o list_flows filtrou pelo host certo ou se o ID passado ao get_flow_detail está errado.

Próximos passos

Com tudo ligado, a parte divertida é a engenharia de prompt. Veja o estudo de caso de webhook do Stripe (em inglês) para uma sessão de depuração de ponta a ponta. A seção MCP da home tem a referência atualizada das ferramentas.

O Rockxy é livre e de código aberto sob AGPL-3.0. O código do servidor MCP vive no mesmo repositório do app — antes de conectar a qualquer assistente, dá para ler exatamente o que está exposto.

Baixar o Rockxy Ver as ferramentas MCP