clacky
Zurück zu Clacky
Model Context Protocol · in Clacky eingebaut

Clacky MCP

MCP ist der Weg, wie KI-Apps Tools nutzen. Clacky hat einen MCP-Server eingebaut, sodass Claude, Cursor oder Codex einen Screenshot machen, Text von deinem Bildschirm lesen, aufnehmen, dich bei fertiger Aufgabe benachrichtigen oder einen Post planen können, direkt auf deinem Mac.

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

Was es ist

In die App eingebaut

Der Server ist ein kleiner Helfer in Clacky.app (Contents/MacOS/clacky-mcp). Kein Node, keine zusätzliche Installation.

Aus, bis du ihn einschaltest

Öffne in Clacky Einstellungen → KI-Tools verbinden (MCP). Jede Tool-Gruppe hat ihren eigenen Schalter.

Dein Mac erledigt die Arbeit

Der Helfer reicht jeden Aufruf an die laufende Clacky-App weiter, die dich fragt, wo nötig, und die Arbeit erledigt.

Verbinde deine KI-App

Zwei Minuten, einmalig. Clacky zeigt dieselben Snippets in den Einstellungen, mit dem Pfad zu deiner Kopie der App.

Claude Desktop → Settings → Developer → Edit Config, dann füge dies in claude_desktop_config.json ein:

{ "mcpServers": { "clacky": { "command": "/Applications/Clacky.app/Contents/MacOS/clacky-mcp" } } }
  1. 1Speichere die Datei und starte Claude neu.
  2. 2Frag: „Mach einen Screenshot von diesem Fenster.“

Alle Tools

27 Tools auf drei Servern. Namen und Parameter genau so, wie deine KI sie sieht.

Auf deinem Mac

Der Helfer clacky-mcp (stdio). Claude Desktop, Claude Code, Cursor, Codex.

Hinweise
  • notify

    Spielt den Agent-Sound von Clacky ab und zeigt eine Mitteilung, z. B. wenn eine lange Aufgabe fertig ist oder dich braucht.

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

Screenshots, Grab Text & Aufnahme
  • take_screenshot

    Nimmt den Bildschirm, einen Bereich oder ein Fenster auf; liefert den Pfad des PNG und eine kleine Vorschau. Fragt eventuell vorher nach.

    Parameter: target?: screen | area | window

  • grab_text

    Liest den Text in einem Bildschirmbereich oder einem Bild/PDF mit Apples Texterkennung auf dem Gerät; liefert nur Text.

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

  • start_recording

    Startet den Bildschirmrekorder von Clacky (3 Sekunden Countdown), optional mit automatischem Stopp. Gespeichert in ~/Movies.

    Parameter: seconds? (3–600)

  • stop_recording

    Beendet die Aufnahme und liefert den Pfad des Videos.

Mac Health
  • get_mac_health

    CPU, Speicherdruck, Speicherplatz, Akku und Temperatur. Keine App- oder Prozessnamen.

Notizen & Aufgaben
  • add_note

    Fügt den Notizen von Clacky eine Notiz hinzu.

    Parameter: text

  • add_task

    Fügt der Liste von heute (oder morgen) eine Aufgabe hinzu.

    Parameter: text, day?: today | tomorrow

  • list_today_tasks

    Die Aufgaben von heute und welche erledigt sind.

Fokus & Keep Awake
  • start_focus

    Startet den Fokus-Timer.

    Parameter: minutes? (1–180)

  • stop_focus

    Stoppt den Fokus-Timer.

  • keep_awake

    Hält Mac und Display wach (einige Minuten oder bis zum Ausschalten), optional bei geschlossenem Deckel.

    Parameter: on, minutes?, lid_closed?

Modi
  • get_mode

    Welcher Modus aktiv ist (Record, Code, Focus, Call, Quiet oder deiner) und welche Modi es gibt.

  • set_mode

    Wechselt in einen Modus, oder „none“, um alles zurückzusetzen.

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

Social Posts (Kalender)
  • list_social_accounts

    Deine verbundenen Konten, Kontogruppen, Signaturen und die in diesem Monat übrigen Posts.

  • schedule_post

    Plant einen Post (oder postet sofort, nachdem du in Clacky zugestimmt hast), mit optionalem Bild und Signatur.

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

  • list_scheduled_posts

    Posts zwischen zwei Daten, mit Status und Link je Plattform.

    Parameter: from?, to?, include_posted?

  • cancel_scheduled_post

    Storniert, was noch nicht veröffentlicht wurde. Veröffentlichte Posts bleiben stehen; im Kalender kannst du es rückgängig machen.

    Parameter: post_id

Website-Statistiken
  • get_site_stats

    Besucher, Seitenaufrufe, Top-Quellen und -Seiten und Umsatz einer deiner Websites. Nur Zahlen.

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

  • get_live_visitors

    Wer gerade auf deiner Website ist (letzte 5 Minuten): Seiten und Quellen, keine Identitäten.

    Parameter: site?

Social-Kalender, online

https://clacky.app/api/social/mcp. Claude.ai, ChatGPT oder jede App mit benutzerdefinierten Connectors.

Kalender
  • list_accounts

    Verbundene Konten, Kontogruppen, Signaturen und Plattformen, die bald kommen.

  • list_posts

    Geplante und veröffentlichte Posts zwischen zwei Daten, mit Status und Links.

    Parameter: from?, to?

  • schedule_post

    Plant einen Post für Konten oder eine Gruppe zu einem zukünftigen Zeitpunkt, mit Texten pro Plattform.

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

  • post_now

    Veröffentlicht sofort. Nur, wenn du es klar verlangt hast; braucht confirm: true.

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

  • reschedule_post

    Verschiebt einen noch nicht veröffentlichten Post auf eine neue Zeit.

    Parameter: post_id, at

  • cancel_post

    Storniert, was noch nicht veröffentlicht wurde. Veröffentlichte Posts werden nicht gelöscht.

    Parameter: post_id

  • get_stats

    Statistiken pro Plattform für 7, 30 oder 90 Tage: Posts, Likes, Kommentare, Shares, Besucher und Verkäufe.

    Parameter: days?: 7 | 30 | 90

Datenschutz und Sicherheit

  • Kein Tool liest Tastenanschläge, getippten Text oder deine Zwischenablage.
  • Die Mac-Tools laden nie etwas hoch. Screenshots und Aufnahmen bleiben auf deinem Mac; nur der Dateipfad (und eine kleine Vorschau) geht an deine KI-App.
  • Grab Text liest auf deinem Mac mit Apple Vision und liefert nur den Text: nichts wird gespeichert, nichts landet in der Zwischenablage.
  • Screenshots fragen jedes Mal nach, außer du schaltest „Screenshots ohne Nachfrage“ ein. Ein Bild für einen Post wird erst gelesen, nachdem du es erlaubt hast.
  • Sofort posten fragt dich immer zuerst in Clacky. Ein geplanter Post zeigt dir eine Mitteilung und kann storniert werden.
  • Nur die Social- und Website-Tools sprechen mit clacky.app, mit deiner eigenen Clacky-Anmeldung. Deine KI sieht nie ein Token.
  • Der Helfer spricht mit der App über einen privaten lokalen Socket, den nur dein Benutzer öffnen kann.

Fragen

Was ist MCP?

Das Model Context Protocol: ein offener Standard, mit dem KI-Apps wie Claude, Cursor und Codex Tools aufrufen können. Der MCP-Server von Clacky gibt ihnen die Tools deines Macs.

Muss ich noch etwas installieren?

Nein. Der Server steckt in Clacky.app. Schalte Einstellungen → KI-Tools verbinden (MCP) ein und füge ein Snippet in deine KI-App ein.

Muss Clacky laufen?

Ja. Der Helfer reicht jeden Aufruf an die geöffnete Clacky-App weiter. Ist Clacky geschlossen oder der Schalter aus, bekommt die KI ein klares „nicht verfügbar“.

Kann meine KI lesen, was ich tippe?

Nein. Kein Tool liest Tastenanschläge, getippten Text oder die Zwischenablage.

Kann sie ohne mich posten?

Sofort posten fragt dich immer zuerst in Clacky, und nichts geht raus, wenn du Nein sagst. Geplante Posts zeigen dir eine Mitteilung und können storniert werden.

Funktioniert es mit ChatGPT oder Claude im Web?

Für den Social-Kalender ja: Füge https://clacky.app/api/social/mcp als benutzerdefinierten Connector hinzu und melde dich an. Die Mac-Tools brauchen eine Desktop-App (Claude Desktop, Claude Code, Cursor, Codex).