Clacky MCP：全部工具，以及如何连接 Claude、Cursor 和 Codex

Q: 还需要安装别的东西吗？

不需要。服务器就在 Clacky.app 里。打开 设置 → 连接 AI 工具 (MCP)，再把一段代码片段粘贴到你的 AI 应用中即可。

Q: 能用在 ChatGPT 或网页版 Claude 上吗？

社交日历可以：把 https://clacky.app/api/social/mcp 添加为自定义连接器并登录。Mac 工具需要桌面应用(Claude Desktop、Claude Code、Cursor、Codex)。

它是什么

内置于应用

服务器是 Clacky.app 里的一个小助手(Contents/MacOS/clacky-mcp)。不需要 Node，也不用额外安装。

你打开之前都是关闭的

在 Clacky 中打开 设置 → 连接 AI 工具 (MCP)。每组工具都有自己的开关。

由你的 Mac 完成工作

助手把每次调用交给正在运行的 Clacky 应用，应用会在需要时先询问你，然后完成任务。

连接你的 AI 应用

只需一次，两分钟。Clacky 在设置里也会显示同样的代码片段，并带上你这份应用的路径。

打开 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、内存压力、磁盘空间、电池和温度。不含应用或进程名称。

笔记与任务

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 或任何支持自定义连接器的应用。

日历

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 应用。
Grab Text 在你的 Mac 上用 Apple Vision 读取，只返回文字：不保存任何内容，也不放进剪贴板。
除非你开启 “不询问直接截图”，否则每次截图都会询问。用于帖子的图片只有在你允许后才会被读取。
立即发布总是先在 Clacky 中询问你。已安排的帖子会向你显示通知，并且可以取消。
只有社交和网站工具会使用你自己的 Clacky 登录与 clacky.app 通信。你的 AI 永远看不到令牌。
助手通过一个只有你的用户才能打开的私有本地套接字与应用通信。

常见问题

什么是 MCP？

Model Context Protocol：一个开放标准，让 Claude、Cursor 和 Codex 等 AI 应用可以调用工具。Clacky 的 MCP 服务器把你 Mac 上的工具提供给它们。

还需要安装别的东西吗？

不需要。服务器就在 Clacky.app 里。打开设置 → 连接 AI 工具 (MCP)，再把一段代码片段粘贴到你的 AI 应用中即可。

Clacky 需要保持运行吗？

需要。助手会把每次调用交给已打开的 Clacky 应用。如果 Clacky 已关闭或开关是关的，AI 会得到明确的 “不可用” 提示。

我的 AI 能读到我输入的内容吗？

不能。没有任何工具会读取按键、输入的文字或剪贴板。

它能在我不知情时发帖吗？

立即发布总是先在 Clacky 中询问你，你说不，就不会发出任何内容。已安排的帖子会向你显示通知，并且可以取消。

能用在 ChatGPT 或网页版 Claude 上吗？

社交日历可以：把 https://clacky.app/api/social/mcp 添加为自定义连接器并登录。Mac 工具需要桌面应用(Claude Desktop、Claude Code、Cursor、Codex)。