clacky
Torna a Clacky
Model Context Protocol · integrato in Clacky

Clacky MCP

MCP è il modo in cui le app di IA usano gli strumenti. Clacky ha un server MCP integrato, così Claude, Cursor o Codex possono fare uno screenshot, leggere il testo dal tuo schermo, registrare, avvisarti quando un’attività è finita o programmare un post, direttamente sul tuo Mac.

claude mcp add --scope user clacky -- /Applications/Clacky.app/Contents/MacOS/clacky-mcp

Cos’è

Integrato nell’app

Il server è un piccolo assistente dentro Clacky.app (Contents/MacOS/clacky-mcp). Niente Node, nessuna installazione extra.

Spento finché non lo accendi

In Clacky, apri Impostazioni → Collega strumenti IA (MCP). Ogni gruppo di strumenti ha il suo interruttore.

Il lavoro lo fa il tuo Mac

L’assistente passa ogni chiamata all’app Clacky in esecuzione, che ti chiede conferma dove serve e svolge il lavoro.

Collega la tua app di IA

Due minuti, una volta sola. Clacky mostra gli stessi snippet nelle Impostazioni, con il percorso della tua copia dell’app.

Claude Desktop → Settings → Developer → Edit Config, poi aggiungi questo a claude_desktop_config.json:

{ "mcpServers": { "clacky": { "command": "/Applications/Clacky.app/Contents/MacOS/clacky-mcp" } } }
  1. 1Salva il file e riavvia Claude.
  2. 2Chiedi: «Fai uno screenshot di questa finestra.»

Tutti gli strumenti

27 strumenti su tre server. Nomi e parametri esattamente come li vede la tua IA.

Sul tuo Mac

L’assistente clacky-mcp (stdio). Claude Desktop, Claude Code, Cursor, Codex.

Avvisi
  • notify

    Riproduce il suono agente di Clacky e mostra una notifica, ad es. quando un’attività lunga è finita o ha bisogno di te.

    Parametri: title, message?, sound?: done | needs | error

Screenshot, Grab Text e registrazione
  • take_screenshot

    Cattura lo schermo, un’area o una finestra; restituisce il percorso del PNG e una piccola anteprima. Può chiederti prima.

    Parametri: target?: screen | area | window

  • grab_text

    Legge il testo in un’area dello schermo o in un’immagine/PDF con il riconoscimento Apple sul dispositivo; restituisce solo testo.

    Parametri: source?: area | file, path?, languages?

  • start_recording

    Avvia il registratore dello schermo di Clacky (conto alla rovescia di 3 secondi), con arresto automatico opzionale. Salvato in ~/Movies.

    Parametri: seconds? (3–600)

  • stop_recording

    Ferma la registrazione e restituisce il percorso del video.

Mac Health
  • get_mac_health

    CPU, pressione della memoria, spazio su disco, batteria e temperatura. Nessun nome di app o processo.

Note e attività
  • add_note

    Aggiunge una nota alle Note di Clacky.

    Parametri: text

  • add_task

    Aggiunge un’attività alla lista di oggi (o di domani).

    Parametri: text, day?: today | tomorrow

  • list_today_tasks

    Le attività di oggi e quali sono fatte.

Focus e Keep Awake
  • start_focus

    Avvia il timer di focus.

    Parametri: minutes? (1–180)

  • stop_focus

    Ferma il timer di focus.

  • keep_awake

    Tiene sveglio il Mac e lo schermo (per alcuni minuti o finché non lo spegni), opzionalmente con il coperchio chiuso.

    Parametri: on, minutes?, lid_closed?

Modalità
  • get_mode

    Quale modalità è attiva (Record, Code, Focus, Call, Quiet o la tua) e le modalità disponibili.

  • set_mode

    Passa a una modalità, oppure “none” per rimettere tutto a posto.

    Parametri: mode (id, name or "none")

Post social (Calendario)
  • list_social_accounts

    I tuoi account collegati, gruppi di account, firme e post rimasti questo mese.

  • schedule_post

    Programma un post (o pubblica subito, dopo il tuo sì in Clacky), con immagine e firma opzionali.

    Parametri: text, at, accounts? | set?, captions?, image_path?, signature?

  • list_scheduled_posts

    Post tra due date, con stato e link di ogni piattaforma.

    Parametri: from?, to?, include_posted?

  • cancel_scheduled_post

    Annulla ciò che non è ancora uscito. I post già pubblicati restano; puoi annullare dal Calendario.

    Parametri: post_id

Statistiche del sito
  • get_site_stats

    Visitatori, visualizzazioni di pagina, fonti e pagine principali e ricavi di uno dei tuoi siti. Solo numeri.

    Parametri: site?, period?: today | yesterday | 24h | 7d | 30d | 90d | 12m

  • get_live_visitors

    Chi è sul tuo sito proprio ora (ultimi 5 minuti): pagine e fonti, nessuna identità.

    Parametri: site?

Calendario social, online

https://clacky.app/api/social/mcp. Claude.ai, ChatGPT o qualsiasi app con connettori personalizzati.

Calendario
  • list_accounts

    Account collegati, gruppi di account, firme e piattaforme in arrivo.

  • list_posts

    Post programmati e pubblicati tra due date, con stato e link.

    Parametri: from?, to?

  • schedule_post

    Programma un post su account o un gruppo a un orario futuro, con didascalie per piattaforma.

    Parametri: text, at, accounts? | set?, captions?, signature?

  • post_now

    Pubblica subito. Solo quando l’hai chiesto chiaramente; richiede confirm: true.

    Parametri: text, confirm, accounts? | set?, captions?, signature?

  • reschedule_post

    Sposta un post non ancora uscito a un nuovo orario.

    Parametri: post_id, at

  • cancel_post

    Annulla ciò che non è ancora uscito. I post già pubblicati non vengono eliminati.

    Parametri: post_id

  • get_stats

    Statistiche per piattaforma su 7, 30 o 90 giorni: post, mi piace, commenti, condivisioni, visitatori e vendite.

    Parametri: days?: 7 | 30 | 90

Privacy e sicurezza

  • Nessuno strumento legge i tasti premuti, il testo digitato o i tuoi appunti.
  • Gli strumenti del Mac non caricano mai nulla. Screenshot e registrazioni restano sul tuo Mac; alla tua app di IA arriva solo il percorso del file (e una piccola anteprima).
  • Grab Text legge sul tuo Mac con Apple Vision e restituisce solo il testo: niente salvato, niente negli appunti.
  • Gli screenshot chiedono ogni volta, a meno che tu non attivi “Screenshot senza chiedere”. Un’immagine per un post viene letta solo dopo il tuo permesso.
  • Pubblicare ora ti chiede sempre prima conferma in Clacky. Un post programmato ti mostra una notifica e può essere annullato.
  • Solo gli strumenti social e del sito parlano con clacky.app, con il tuo accesso Clacky. La tua IA non vede mai un token.
  • L’assistente parla con l’app tramite un socket locale privato che solo il tuo utente può aprire.

Domande

Cos’è MCP?

Il Model Context Protocol: uno standard aperto che permette ad app di IA come Claude, Cursor e Codex di chiamare strumenti. Il server MCP di Clacky dà loro gli strumenti del tuo Mac.

Devo installare altro?

No. Il server è dentro Clacky.app. Attiva Impostazioni → Collega strumenti IA (MCP) e incolla uno snippet nella tua app di IA.

Clacky deve essere aperto?

Sì. L’assistente passa ogni chiamata all’app Clacky aperta. Se Clacky è chiuso o l’interruttore è spento, l’IA riceve un chiaro “non disponibile”.

La mia IA può leggere quello che scrivo?

No. Nessuno strumento legge i tasti premuti, il testo digitato o gli appunti.

Può pubblicare senza di me?

Pubblicare ora ti chiede sempre prima conferma in Clacky, e non esce nulla se dici di no. I post programmati ti mostrano una notifica e possono essere annullati.

Funziona con ChatGPT o Claude sul web?

Per il calendario social, sì: aggiungi https://clacky.app/api/social/mcp come connettore personalizzato e accedi. Gli strumenti del Mac richiedono un’app desktop (Claude Desktop, Claude Code, Cursor, Codex).