← Torna al blog

Come collegare Claude Desktop al server MCP di Rockxy in 3 minuti

· 6 min di lettura

Rockxy 0.9.0 include un server Model Context Protocol (MCP). Una volta collegato, Claude Desktop può leggere le flow HTTP catturate, rigiocare richieste e confrontare le risposte — senza che tu debba incollare l’output di curl nella chat. Questa guida ti porta dalla configurazione all’uso reale in 3 minuti.

Perché collegare Claude Desktop al traffico HTTP

Fare debug HTTP è sempre stato un problema di copia-incolla. Trovi una richiesta fallita nel proxy, copi header e body, incolli nella chat o in un documento, scrivi una domanda umana intorno. Ogni switch di contesto ruba tempo. E l’assistente vede solo la porzione che hai copiato.

MCP inverte il giro. Invece di copiare, dai a Claude una strada diretta verso il proxy. Claude chiama list_flows, legge le flow che gli servono e fa domande di follow-up sui byte reali. Le richieste fallite non sono più screenshot: sono tool call, rigiocabili dopo che il modello propone la correzione.

Il ciclo di debug si accorcia. Scrivi quello che sta succedendo in italiano normale, Claude legge la richiesta vera (non quella riformulata), propone una modifica e tu la esegui replay subito. L’assistente e il proxy sono sulla stessa pagina e quella pagina è sulla tua macchina. Nulla lascia il Mac.

Prerequisiti

  • macOS 14 (Sonoma) o successivo. Il binario MCP di Rockxy è universale (Apple Silicon + Intel).
  • Una versione di Claude Desktop compatibile con MCP (build di fine 2024 o successiva).
  • Rockxy 0.9.0 o successivo. Le build precedenti non includono il server MCP.
  • Cinque minuti. Il setup reale dura 3 minuti, gli altri 2 servono per il dialog Gatekeeper al primo avvio.

Step 1: installa Rockxy

Scarica il DMG da rockxy.io/it/download, montalo e trascina Rockxy.app in /Applications. Aprilo almeno una volta, così macOS lo registra come app attendibile.

Al primo avvio vedrai un dialog Gatekeeper. Rockxy è firmato e notarizzato, quindi dovresti vedere il dialog «Apri Rockxy». Se invece appare «impossibile verificare», vai in Impostazioni di sistema → Privacy e sicurezza, scorri fino alla sezione Sicurezza e clicca Apri comunque.

Una volta che Rockxy gira, il binario MCP si trova a:

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

Tienilo a portata di mano: lo userai allo Step 3.

Step 2: attiva il server MCP in Rockxy

Apri Rockxy → Settings → MCP (oppure Cmd+, e seleziona la tab MCP) e attiva Enable MCP Server.

Il server MCP di Rockxy gira come processo figlio che il client MCP spawna on-demand. Con Claude Desktop parla via stdin/stdout (stdio), quindi il trasporto MCP non è un socket di rete. Per i client che non usano stdio, Rockxy espone anche una porta HTTP locale vincolata al loopback. Né l’uno né l’altro percorso lasciano il Mac.

Una volta abilitato, Rockxy espone quattro tool: list_flows, get_flow_detail, replay_request, diff_flows. Ogni tool opera solo sul session file aperto: scegli cosa mostrare a Claude decidendo quale sessione aprire.

In breve: list_flows accetta filtri opzionali (host, method, status, time range, limit) e torna un array di riepiloghi. get_flow_detail prende un singolo flow id e torna la richiesta completa (header, body), la risposta completa (header, body) e il breakdown dei tempi (DNS, TCP, TLS, TTFB, transfer). replay_request prende un flow id con override facoltativi, rilancia la richiesta sull’host originale e torna un nuovo flow id. diff_flows prende due flow id e torna un diff strutturale (path, header, body field) così Claude ti riassume le differenze senza leggere due JSON a occhio.

Step 3: modifica claude_desktop_config.json

Claude Desktop carica la config MCP da un singolo file JSON:

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

Se il file non esiste, crealo. Se hai già altri server MCP, aggiungi il blocco Rockxy dentro l’oggetto mcpServers esistente. Config minima per il solo Rockxy:

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

Salva il file. A questo punto non serve ricaricare nulla: Claude Desktop rilegge la config solo all’avvio.

Step 4: riavvia Claude Desktop

Termina Claude Desktop con Cmd+Q. Chiudere solo la finestra non basta: l’app resta in background e i processi in background non rileggono la config. Riaprilo da Launchpad o Spotlight.

Quando Claude Desktop parte, fa lo spawn del processo MCP di Rockxy, si connette via stdio e legge il manifest dei tool. Una piccola icona a forma di spina nella chat di Claude Desktop indica che il server MCP è collegato.

Step 5: verifica la connessione

In Claude Desktop apri una nuova chat e manda:

Elenca le ultime 5 richieste HTTP che Rockxy ha catturato.

Aspettati questo: Claude chiama list_flows con limit=5. Nella chat vedi il blocco della tool call (di solito collassato) con input e output raw. Poi Claude riassume le flow in testo: method, host, path, status, size.

Se l’elenco è vuoto, genera prima del traffico. Attiva il proxy di sistema in Rockxy, apri una tab del browser e ricarica. Poi rilancia la stessa domanda.

Troubleshooting

Binario non trovato. Se i log di Claude Desktop mostrano command not found o la spina MCP non si accende, controlla il path nel file di config. È sempre /Applications/Rockxy.app/Contents/MacOS/rockxy-mcp. Se hai messo Rockxy in ~/Applications, adatta il path.

MCP non abilitato in Rockxy. Se il toggle è off, il server MCP accetta lo stdio ma torna un errore mcp_disabled. Attivalo e riavvia Claude Desktop.

I tool non vengono riconosciuti. La spina è accesa ma Claude risponde «non ho questo tool»: apri la dev console di Claude Desktop (nelle build recenti Cmd+Option+I). Il colpevole tipico è un errore di parsing JSON in claude_desktop_config.json: virgole mancanti, virgole in coda, smart quote copiate da un editor tipografico.

Cosa può fare Claude con il tuo traffico

Una volta connessi, prova prompt così:

  • «Perché l’ultima richiesta a /api/auth è fallita?» — Claude chiama list_flows, filtra per host/path, prende il dettaglio del 401 e legge l’header WWW-Authenticate per spiegare.
  • «Fai il diff delle ultime due mutation GraphQL.» — Claude elenca le flow, seleziona le due mutation, chiama diff_flows e riassume i field che sono cambiati.
  • «Rigioca la flow 42 con Authorization header Bearer eyJ....» — Claude chiama replay_request con l’override, legge la nuova risposta e dice se è ancora 401.
  • «Qual è l’endpoint più lento di questa sessione?» — Claude scorre le flow, prende i tempi da ogni dettaglio e fa la classifica.

La superficie tool è piccola di proposito: quattro funzioni. Più piccola la superficie, più facile è per il modello ragionarci sopra, e il traffico resta confinato alle operazioni che hai autorizzato.

Un comportamento utile da conoscere: ogni tool call appare come blocco espandibile nella chat di Claude Desktop. Espandilo e vedi l’input esatto che il modello ha mandato e l’output esatto che il tool ha ritornato. Se non sei sicuro che Claude stia facendo quello che pensi, lo leggi lì. Utile anche per debuggare prompt che non funzionano: vedi se list_flows sta filtrando sull’host giusto, o se get_flow_detail riceve un flow id sbagliato.

Prossimi passi

Una volta collegato, la parte interessante è ingegnerizzare i prompt. La case study sui webhook Stripe (in inglese) segue una sessione di debug reale dall’inizio alla fine. La sezione MCP della homepage elenca la reference dei tool attuali.

Rockxy è libero e open source sotto AGPL-3.0. Il sorgente del server MCP vive nello stesso repository dell’app: prima di collegare qualsiasi assistente, puoi leggere esattamente cosa viene esposto.

Scarica Rockxy Vedi i tool MCP