Usare OneMacTools come server MCP per Claude, Claude Code, Cursor e Codex

Cosa fa il server MCP di OneMacTools

Il Model Context Protocol (MCP) è il modo standard con cui gli assistenti IA usano app e strumenti. OneMacTools include un server MCP, così un assistente che già usi può rispondere a domande come “cosa c'è sulla porta 3000?”, “cosa occupa spazio nella mia cartella Inizio?” o “quando scade il mio passaporto?” in base a ciò che OneMacTools sa del tuo Mac, e può chiedere a OneMacTools di eseguire strumenti come Comprimi PDF o Trascrivi sui tuoi file.

Il server è l'app OneMacTools stessa, avviata dall'assistente con l'argomento --mcp. Comunica con l'assistente tramite input e output standard, quindi non viene aperta alcuna porta di rete e non viene caricato nulla. Non mostra una finestra propria; quando un assistente chiede un'azione, l'app OneMacTools principale apre una finestra di approvazione (aprendosi in background se non era in esecuzione).

È disattivato finché non lo attivi, e richiede una licenza attivata. Se manca una delle due cose, l'assistente riceve un messaggio chiaro che lo dice, invece di qualsiasi dato.

Quali assistenti IA può configurare OneMacTools

Impostazioni › Assistenti IA ha una riga per ogni assistente che OneMacTools può configurare per te, e uno snippet per tutto il resto:

Il pulsante Aggiungi a … di una riga è in grigio quando quell'assistente non sembra installato (OneMacTools cerca la sua app o la sua cartella delle impostazioni). Passa il puntatore sul pulsante per vedere quale file modificherà.

Come collegare Claude, Cursor o Codex al tuo Mac

1. Apri OneMacTools e scegli OneMacTools › Impostazioni (⌘,).
2. Scorri fino a Assistenti IA e attiva Consenti agli assistenti IA di usare OneMacTools.
3. Fai clic su Aggiungi a Claude Desktop… (o Claude Code, Cursor o Codex).
4. Leggi la conferma: “OneMacTools aggiunge una voce chiamata “onemactools” a … dopo aver fatto il backup del file. Nient'altro cambia.” Fai clic su Aggiungi.
5. La riga ora mostra Aggiunto con una spunta verde, e una riga sotto la sezione ti dice cosa fare dopo, per esempio “Esci e riapri Claude per caricarlo.” Indica anche il file di backup, se ce n'era già uno.
6. Riavvia o ricarica l'assistente come descritto, poi chiedigli qualcosa come “Usa OneMacTools per dirmi come sta il mio Mac.”

Aggiungere OneMacTools a un assistente attiva anche Consenti agli assistenti IA di usare OneMacTools, se era disattivato. Se sposti OneMacTools in un'altra cartella, fai clic su Aggiorna accanto all'assistente, così la voce punta alla nuova posizione dell'app.

Configurazione MCP manuale per altri assistenti

Per qualsiasi altro assistente che supporti MCP tramite stdio, fai clic su Copia snippet di configurazione accanto ad Altri assistenti e incollalo nelle impostazioni MCP di quell'assistente. Lo snippet è la stessa voce che OneMacTools scrive per Claude e Cursor:

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

Il comando è il percorso dell'app sul tuo Mac, quindi lo snippet copiato ha sempre il percorso giusto anche se tieni OneMacTools altrove rispetto ad Applicazioni. Per Claude Code la voce ha anche "type": "stdio". Codex usa TOML invece di JSON, quindi la sua voce è una tabella:

[mcp_servers.onemactools] seguito da command = "/Applications/OneMacTools.app/Contents/MacOS/OneMacTools" e args = ["--mcp"].

OneMacTools riconosce l'assistente dal nome con cui si collega e usa quel nome nelle finestre di approvazione e nella Cronologia: Claude, Claude Code, Cursor, Codex, Windsurf, Gemini CLI o VS Code, oppure il nome che l'assistente comunica.

Cosa può leggere un assistente senza chiedere

Gli strumenti di lettura rispondono subito, perché si limitano a guardare. Per l'assistente sono contrassegnati come di sola lettura:

I riepiloghi dei documenti non includono mai numeri di documenti d'identità, carte o conti; life_admin riporta solo quanti file li contengono e i loro nomi. Leggere il testo vero e proprio di un documento è un'azione e chiede sempre il permesso. Maggiori dettagli in Permessi e approvazioni degli assistenti IA. Gli strumenti basati su File dipendono da File e Pratiche.

Cosa deve chiederti un assistente

Questi strumenti modificano qualcosa, quindi ognuno apre una finestra di approvazione in OneMacTools e attende che tu faccia clic su Consenti:

• run_tool: esegue qualsiasi strumento di OneMacTools su file o testo, con opzioni. I risultati vanno in una nuova cartella; gli originali non vengono modificati. Gli strumenti che richiedono la tua presenza al Mac, come Registra schermo o Registra riunione, non possono essere eseguiti da un assistente.
• quit_app: esce da un'app nel modo normale, così può chiedere di salvare. Il Finder non può essere chiuso in questo modo.
• stop_process e stop_agent_session: interrompono uno dei tuoi processi, o una sessione di un agente IA e tutto ciò che ha avviato.
• stop_container: interrompe un container Docker in esecuzione.
• start_recording e stop_recording: registrano il Mac secondo per secondo, poi indicano cosa ha raggiunto il picco e quali app ne erano responsabili.
• read_document: fornisce all'assistente il testo di un documento.
• move_to_trash: sposta nel Cestino i file nella cartella Inizio, senza mai eliminarli.

Esempi di richieste da provare

• “Perché il mio Mac è lento in questo momento?” (usa mac_health e list_apps)
• “Cosa è in esecuzione sulla porta 5173, e quale progetto l'ha avviato? Fermalo.” (legge con whats_on_port, poi chiede di eseguire stop_process)
• “Quali dei miei progetti hanno vecchie cartelle node_modules, e quanto spazio recupererei?”
• “Registra il Mac mentre eseguo questa build, poi dimmi cosa ha raggiunto il picco.”
• “Trova i PDF che ho scaricato da Gmail questa settimana e uniscili.” (trova con find_files, poi chiede di eseguire run_tool)
• “Quanto ho speso su Amazon il mese scorso?” (richiede File)
• “Comprimi questi tre screenshot in JPEG.” (run_tool con Comprimi immagini)

Per informazioni generali su porte e agenti, vedi la guida Cosa sta usando una porta sul mio Mac? e la documentazione di Sviluppo e agenti.

Come disattivare il server MCP

Disattiva Consenti agli assistenti IA di usare OneMacTools in Impostazioni › Assistenti IA. Gli assistenti che hanno ancora la voce possono avviare il server, ma ogni lettura e azione riceve la risposta “OneMacTools non sta lasciando entrare gli assistenti IA” e nient'altro.

Per rimuovere del tutto OneMacTools da un assistente, elimina la voce onemactools dal suo file di impostazioni (i percorsi sono nella tabella qui sopra), oppure ripristina il backup creato da OneMacTools. Uscire dall'assistente chiude anche il processo del server.

Domande

Guide correlate