clacky
Model Context Protocol · Clacky に内蔵

Clacky MCP

MCP は、AI アプリがツールを使うための仕組みです。Clacky には MCP サーバーが内蔵されているので、Claude、Cursor、Codex が Mac 上でスクリーンショットを撮ったり、画面のテキストを読んだり、録画したり、タスクの完了を知らせたり、投稿を予約したりできます。

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

MCP とは

アプリに内蔵

サーバーは Clacky.app の中の小さなヘルパー(Contents/MacOS/clacky-mcp)です。Node も追加インストールも不要です。

オンにするまでオフ

Clacky で 設定 → AIツールを接続 (MCP) を開きます。ツールのグループごとにスイッチがあります。

処理は Mac が行います

ヘルパーは各リクエストを起動中の Clacky アプリに渡し、必要な場面ではあなたに確認したうえで処理します。

AI アプリを接続する

一度だけ、2 分で完了します。Clacky の設定にも、お使いのアプリのパス入りで同じスニペットが表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json に次を追加します。

{ "mcpServers": { "clacky": { "command": "/Applications/Clacky.app/Contents/MacOS/clacky-mcp" } } }
  1. 1ファイルを保存して Claude を再起動します。
  2. 2「このウィンドウのスクリーンショットを撮って」と頼んでみましょう。

すべてのツール

3 つのサーバーに 27 個のツール。名前とパラメータは、AI から見えるとおりです。

Mac 上

clacky-mcp ヘルパー(stdio)。Claude Desktop、Claude Code、Cursor、Codex。

通知
  • notify

    Clacky のエージェント音を鳴らして通知を表示します。長いタスクが終わったときや、あなたの対応が必要なときなどに使います。

    パラメータ: title, message?, sound?: done | needs | error

スクリーンショット、Grab Text、録画
  • take_screenshot

    画面、範囲、ウィンドウをキャプチャし、PNG のパスと小さなプレビューを返します。先に確認する場合があります。

    パラメータ: target?: screen | area | window

  • grab_text

    画面の範囲や画像/PDF のテキストを、Apple のオンデバイス認識で読み取り、テキストだけを返します。

    パラメータ: source?: area | file, path?, languages?

  • start_recording

    Clacky の画面収録を開始します(3 秒カウントダウン)。自動停止も指定できます。保存先は ~/Movies。

    パラメータ: seconds? (3–600)

  • stop_recording

    録画を停止し、動画のパスを返します。

Mac Health
  • get_mac_health

    CPU、メモリ負荷、ディスク容量、バッテリー、温度。アプリ名やプロセス名は含みません。

メモとタスク
  • add_note

    Clacky のメモに 1 件追加します。

    パラメータ: text

  • add_task

    今日(または明日)のリストにタスクを追加します。

    パラメータ: text, day?: today | tomorrow

  • list_today_tasks

    今日のタスクと、完了しているものを返します。

集中と Keep Awake
  • start_focus

    集中タイマーを開始します。

    パラメータ: minutes? (1–180)

  • stop_focus

    集中タイマーを停止します。

  • keep_awake

    Mac とディスプレイをスリープさせません(数分間、またはオフにするまで)。蓋を閉じた状態も選べます。

    パラメータ: on, minutes?, lid_closed?

モード
  • get_mode

    オンのモード(Record、Code、Focus、Call、Quiet、またはあなたのモード)と、利用できるモードを返します。

  • set_mode

    モードを切り替えます。“none” を指定するとすべて元に戻します。

    パラメータ: mode (id, name or "none")

ソーシャル投稿(カレンダー)
  • list_social_accounts

    接続済みのアカウント、アカウントセット、署名、今月の残り投稿数を返します。

  • schedule_post

    投稿を予約します(Clacky で承認した後は即時投稿も可)。画像と署名は任意です。

    パラメータ: text, at, accounts? | set?, captions?, image_path?, signature?

  • list_scheduled_posts

    2 つの日付の間の投稿を、各プラットフォームのステータスとリンク付きで返します。

    パラメータ: from?, to?, include_posted?

  • cancel_scheduled_post

    まだ投稿されていないものをキャンセルします。公開済みの投稿はそのままで、カレンダーから取り消せます。

    パラメータ: post_id

サイトの統計
  • get_site_stats

    あなたのサイト 1 つの訪問者、ページビュー、上位の流入元とページ、収益。数字のみです。

    パラメータ: site?, period?: today | yesterday | 24h | 7d | 30d | 90d | 12m

  • get_live_visitors

    今(直近 5 分)サイトにいる人: ページと流入元のみで、個人は特定しません。

    パラメータ: site?

ソーシャルカレンダー(オンライン)

https://clacky.app/api/social/mcp。Claude.ai、ChatGPT、カスタムコネクタ対応のアプリ。

カレンダー
  • list_accounts

    接続済みのアカウント、アカウントセット、署名、近日対応予定のプラットフォーム。

  • list_posts

    2 つの日付の間の予約済み・投稿済みの投稿を、ステータスとリンク付きで返します。

    パラメータ: from?, to?

  • schedule_post

    アカウントまたはセット宛てに、未来の日時で投稿を予約します。プラットフォームごとのキャプションも指定できます。

    パラメータ: text, at, accounts? | set?, captions?, signature?

  • post_now

    すぐに公開します。はっきり頼んだ場合のみで、confirm: true が必要です。

    パラメータ: text, confirm, accounts? | set?, captions?, signature?

  • reschedule_post

    まだ投稿されていない投稿を新しい時刻に移します。

    パラメータ: post_id, at

  • cancel_post

    まだ投稿されていないものをキャンセルします。公開済みの投稿は削除されません。

    パラメータ: post_id

  • get_stats

    7、30、90 日のプラットフォーム別統計: 投稿数、いいね、コメント、シェア、訪問者、売上。

    パラメータ: days?: 7 | 30 | 90

プライバシーと安全性

  • どのツールも、キー入力、入力したテキスト、クリップボードを読みません。
  • Mac のツールは何もアップロードしません。スクリーンショットと録画は Mac に残り、AI アプリに渡るのはファイルのパス(と小さなプレビュー)だけです。
  • Grab Text は Mac 上で Apple Vision を使って読み取り、テキストだけを返します。何も保存せず、クリップボードにも入れません。
  • 「確認なしでスクリーンショット」をオンにしない限り、スクリーンショットは毎回確認します。投稿用の画像は、あなたが許可した後にだけ読み込まれます。
  • 今すぐ投稿は、必ず先に Clacky で確認します。予約投稿は通知が表示され、キャンセルできます。
  • ソーシャルとサイトのツールだけが、あなた自身の Clacky サインインで clacky.app と通信します。AI がトークンを見ることはありません。
  • ヘルパーは、あなたのユーザーだけが開けるプライベートなローカルソケットでアプリと通信します。

よくある質問

MCP とは何ですか?

Model Context Protocol のことで、Claude、Cursor、Codex などの AI アプリがツールを呼び出すためのオープンな標準です。Clacky の MCP サーバーは、Mac のツールを AI に提供します。

他に何かインストールが必要ですか?

いいえ。サーバーは Clacky.app の中にあります。設定 → AIツールを接続 (MCP) をオンにして、スニペットを 1 つ AI アプリに貼り付けるだけです。

Clacky は起動している必要がありますか?

はい。ヘルパーは各リクエストを起動中の Clacky アプリに渡します。Clacky が閉じているかスイッチがオフの場合、AI には「利用できません」とはっきり返ります。

AI は私が入力した内容を読めますか?

いいえ。どのツールも、キー入力、入力したテキスト、クリップボードを読みません。

私の知らないうちに投稿できますか?

今すぐ投稿は必ず先に Clacky で確認し、断れば何も投稿されません。予約投稿は通知が表示され、キャンセルできます。

ChatGPT や Web 版 Claude でも使えますか?

ソーシャルカレンダーなら使えます。https://clacky.app/api/social/mcp をカスタムコネクタとして追加し、サインインしてください。Mac のツールにはデスクトップアプリ(Claude Desktop、Claude Code、Cursor、Codex)が必要です。