clacky
Terug naar Clacky
Model Context Protocol · ingebouwd in Clacky

Clacky MCP

MCP is hoe AI-apps tools gebruiken. Clacky heeft een MCP-server ingebouwd, zodat Claude, Cursor of Codex een screenshot kunnen maken, tekst van je scherm kunnen lezen, opnemen, je een seintje geven als een taak klaar is of een post kunnen inplannen, direct op je Mac.

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

Wat het is

Ingebouwd in de app

De server is een kleine helper in Clacky.app (Contents/MacOS/clacky-mcp). Geen Node, geen extra installatie.

Uit totdat jij het aanzet

Open in Clacky Instellingen → AI-tools koppelen (MCP). Elke groep tools heeft een eigen schakelaar.

Je Mac doet het werk

De helper geeft elke aanroep door aan de draaiende Clacky-app, die je waar nodig om toestemming vraagt en het werk uitvoert.

Koppel je AI-app

Twee minuten, eenmalig. Clacky toont dezelfde snippets in Instellingen, met het pad naar jouw kopie van de app.

Claude Desktop → Settings → Developer → Edit Config, en voeg dit toe aan claude_desktop_config.json:

{ "mcpServers": { "clacky": { "command": "/Applications/Clacky.app/Contents/MacOS/clacky-mcp" } } }
  1. 1Bewaar het bestand en herstart Claude.
  2. 2Vraag: “Maak een screenshot van dit venster.”

Alle tools

27 tools op drie servers. Namen en parameters precies zoals je AI ze ziet.

Op je Mac

De clacky-mcp-helper (stdio). Claude Desktop, Claude Code, Cursor, Codex.

Meldingen
  • notify

    Speelt het agentgeluid van Clacky af en toont een melding, bijv. als een lange taak klaar is of jou nodig heeft.

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

Screenshots, Grab Text en opname
  • take_screenshot

    Legt het scherm, een gebied of een venster vast; geeft het pad van de PNG en een kleine voorvertoning terug. Kan eerst om toestemming vragen.

    Parameters: target?: screen | area | window

  • grab_text

    Leest de tekst in een schermgebied of een afbeelding/PDF met Apples tekenherkenning op het apparaat; geeft alleen tekst terug.

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

  • start_recording

    Start de schermopname van Clacky (aftelling van 3 seconden), optioneel met automatisch stoppen. Opgeslagen in ~/Movies.

    Parameters: seconds? (3–600)

  • stop_recording

    Stopt de opname en geeft het pad van de video terug.

Mac Health
  • get_mac_health

    Processor, geheugendruk, schijfruimte, batterij en temperatuur. Geen app- of procesnamen.

Notities en taken
  • add_note

    Voegt een notitie toe aan de Notities van Clacky.

    Parameters: text

  • add_task

    Voegt een taak toe aan de lijst van vandaag (of morgen).

    Parameters: text, day?: today | tomorrow

  • list_today_tasks

    De taken van vandaag en welke klaar zijn.

Focus en Keep Awake
  • start_focus

    Start de focustimer.

    Parameters: minutes? (1–180)

  • stop_focus

    Stopt de focustimer.

  • keep_awake

    Houdt de Mac en het scherm wakker (enkele minuten of tot uit), optioneel met dichte klep.

    Parameters: on, minutes?, lid_closed?

Modi
  • get_mode

    Welke modus aan staat (Record, Code, Focus, Call, Quiet of jouw eigen) en welke modi er zijn.

  • set_mode

    Schakelt naar een modus, of “none” om alles terug te zetten.

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

Social posts (Kalender)
  • list_social_accounts

    Je gekoppelde accounts, accountsets, handtekeningen en posts die je deze maand nog hebt.

  • schedule_post

    Plant een post in (of post meteen, nadat je in Clacky ja zegt), met optionele afbeelding en handtekening.

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

  • list_scheduled_posts

    Posts tussen twee datums, met de status en link per platform.

    Parameters: from?, to?, include_posted?

  • cancel_scheduled_post

    Annuleert wat nog niet is verstuurd. Gepubliceerde posts blijven staan; je kunt het ongedaan maken in de Kalender.

    Parameters: post_id

Sitestatistieken
  • get_site_stats

    Bezoekers, paginaweergaven, topbronnen en -pagina’s en omzet van een van je sites. Alleen cijfers.

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

  • get_live_visitors

    Wie er nu op je site is (laatste 5 minuten): pagina’s en bronnen, geen identiteiten.

    Parameters: site?

Socialekalender, online

https://clacky.app/api/social/mcp. Claude.ai, ChatGPT of elke app met aangepaste connectors.

Kalender
  • list_accounts

    Gekoppelde accounts, accountsets, handtekeningen en platforms die nog komen.

  • list_posts

    Geplande en geplaatste posts tussen twee datums, met status en links.

    Parameters: from?, to?

  • schedule_post

    Plant een post voor accounts of een set op een tijdstip in de toekomst, met bijschriften per platform.

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

  • post_now

    Publiceert meteen. Alleen als je dat duidelijk hebt gevraagd; vereist confirm: true.

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

  • reschedule_post

    Verplaatst een post die nog niet is verstuurd naar een nieuw tijdstip.

    Parameters: post_id, at

  • cancel_post

    Annuleert wat nog niet is verstuurd. Gepubliceerde posts worden niet verwijderd.

    Parameters: post_id

  • get_stats

    Statistieken per platform over 7, 30 of 90 dagen: posts, likes, reacties, shares, bezoekers en verkopen.

    Parameters: days?: 7 | 30 | 90

Privacy en veiligheid

  • Geen enkele tool leest toetsaanslagen, getypte tekst of je klembord.
  • De Mac-tools uploaden nooit iets. Screenshots en opnames blijven op je Mac; alleen het bestandspad (en een kleine voorvertoning) gaat naar je AI-app.
  • Grab Text leest op je Mac met Apple Vision en geeft alleen de tekst terug: niets opgeslagen, niets op het klembord.
  • Screenshots vragen elke keer toestemming, tenzij je “Screenshots zonder te vragen” aanzet. Een afbeelding voor een post wordt pas gelezen nadat je dat toestaat.
  • Nu posten vraagt je altijd eerst in Clacky. Een geplande post toont je een melding en kan worden geannuleerd.
  • Alleen de social- en sitetools praten met clacky.app, met je eigen Clacky-login. Je AI ziet nooit een token.
  • De helper praat met de app via een privé lokale socket die alleen jouw gebruiker kan openen.

Vragen

Wat is MCP?

Het Model Context Protocol: een open standaard waarmee AI-apps zoals Claude, Cursor en Codex tools kunnen aanroepen. De MCP-server van Clacky geeft ze de tools van je Mac.

Moet ik nog iets installeren?

Nee. De server zit in Clacky.app. Zet Instellingen → AI-tools koppelen (MCP) aan en plak één snippet in je AI-app.

Moet Clacky draaien?

Ja. De helper geeft elke aanroep door aan de geopende Clacky-app. Als Clacky dicht is of de schakelaar uit staat, krijgt de AI een duidelijk “niet beschikbaar”.

Kan mijn AI lezen wat ik typ?

Nee. Geen enkele tool leest toetsaanslagen, getypte tekst of het klembord.

Kan hij zonder mij posten?

Nu posten vraagt je altijd eerst in Clacky, en er gaat niets uit als je nee zegt. Geplande posts tonen je een melding en kunnen worden geannuleerd.

Werkt het met ChatGPT of Claude op het web?

Voor de socialekalender wel: voeg https://clacky.app/api/social/mcp toe als aangepaste connector en log in. De Mac-tools hebben een desktop-app nodig (Claude Desktop, Claude Code, Cursor, Codex).