Clacky MCP：所有工具，以及如何連接 Claude、Cursor 和 Codex

Q: 還需要安裝別的東西嗎？

不需要。伺服器就在 Clacky.app 裡。打開 設定 → 連接 AI 工具 (MCP)，再把一段程式碼片段貼到你的 AI App 中即可。

Q: 能用在 ChatGPT 或網頁版 Claude 上嗎？

社群行事曆可以：把 https://clacky.app/api/social/mcp 加為自訂連接器並登入。Mac 工具需要桌面 App(Claude Desktop、Claude Code、Cursor、Codex)。

它是什麼

內建於 App

伺服器是 Clacky.app 裡的一個小幫手(Contents/MacOS/clacky-mcp)。不需要 Node，也不用額外安裝。

你開啟之前都是關閉的

在 Clacky 中打開 設定 → 連接 AI 工具 (MCP)。每組工具都有自己的開關。

由你的 Mac 完成工作

幫手會把每次呼叫交給正在執行的 Clacky App，App 會在需要時先詢問你，然後完成工作。

連接你的 AI App

只需一次，兩分鐘。Clacky 在設定裡也會顯示同樣的程式碼片段，並帶上你這份 App 的路徑。

打開 Claude Desktop → Settings → Developer → Edit Config，然後把下面的內容加到 claude_desktop_config.json：

{
  "mcpServers": {
    "clacky": {
      "command": "/Applications/Clacky.app/Contents/MacOS/clacky-mcp"
    }
  }
}

1儲存檔案並重新啟動 Claude。
2試著說：「幫這個視窗截個圖。」

所有工具

三個伺服器上共有 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
用 Apple 的裝置端辨識讀取螢幕區域或圖片/PDF 中的文字，只回傳文字。
參數: source?: area | file, path?, languages?
start_recording
啟動 Clacky 的螢幕錄製(3 秒倒數)，可選擇自動停止。儲存到 ~/Movies。
參數: seconds? (3–600)
stop_recording
停止錄製並回傳影片的路徑。

Mac Health

get_mac_health
CPU、記憶體壓力、磁碟空間、電池和溫度。不含 App 或處理程序名稱。

筆記與任務

add_note
在 Clacky 筆記中新增一則筆記。
參數: 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
兩個日期之間的貼文，附帶各平台的狀態和連結。
參數: from?, to?, include_posted?
cancel_scheduled_post
取消尚未發出的內容。已發布的貼文會保留；你可以在行事曆中還原。
參數: post_id

網站統計

get_site_stats
你的某個網站的訪客、頁面瀏覽量、主要來源和頁面以及收入。只有數字。
參數: site?, period?: today | yesterday | 24h | 7d | 30d | 90d | 12m
get_live_visitors
此刻(過去 5 分鐘)在你網站上的人：只含頁面和來源，不含身分。
參數: site?

社群行事曆(線上)

https://clacky.app/api/social/mcp。Claude.ai、ChatGPT 或任何支援自訂連接器的 App。

行事曆

list_accounts
已連接的帳號、帳號組、簽名，以及即將支援的平台。
list_posts
兩個日期之間已排程和已發布的貼文，附帶狀態和連結。
參數: 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 App。
Grab Text 在你的 Mac 上用 Apple Vision 讀取，只回傳文字：不儲存任何內容，也不放進剪貼簿。
除非你開啟「不詢問直接截圖」，否則每次截圖都會詢問。用於貼文的圖片只有在你允許後才會被讀取。
立即發布一律先在 Clacky 中詢問你。已排程的貼文會向你顯示通知，並且可以取消。
只有社群和網站工具會使用你自己的 Clacky 登入與 clacky.app 通訊。你的 AI 永遠看不到權杖。
幫手透過一個只有你的使用者才能開啟的私有本機 socket 與 App 通訊。

常見問題

什麼是 MCP？

Model Context Protocol：一個開放標準，讓 Claude、Cursor 和 Codex 等 AI App 可以呼叫工具。Clacky 的 MCP 伺服器把你 Mac 上的工具提供給它們。

還需要安裝別的東西嗎？

不需要。伺服器就在 Clacky.app 裡。打開設定 → 連接 AI 工具 (MCP)，再把一段程式碼片段貼到你的 AI App 中即可。

Clacky 需要保持執行嗎？

需要。幫手會把每次呼叫交給已開啟的 Clacky App。如果 Clacky 已關閉或開關是關的，AI 會收到明確的「無法使用」提示。

我的 AI 能讀到我輸入的內容嗎？

不能。沒有任何工具會讀取按鍵、輸入的文字或剪貼簿。

它能在我不知情時發文嗎？

立即發布一律先在 Clacky 中詢問你，你說不，就不會發出任何內容。已排程的貼文會向你顯示通知，並且可以取消。

能用在 ChatGPT 或網頁版 Claude 上嗎？

社群行事曆可以：把 https://clacky.app/api/social/mcp 加為自訂連接器並登入。Mac 工具需要桌面 App(Claude Desktop、Claude Code、Cursor、Codex)。