Chip MCP

Chip MCP

为你的编码 Agent 提供项目记忆、任务和 Telegram 通知。

俄语版 · chip-ai.digital/mcp

Chip 是一个运行在 Telegram 中的助手。这个 MCP 服务会将你的 IDE Agent—— Claude Code、Cursor，以及任何支持 MCP 的产品——连接到同一个账号。你昨天做出的决定、Agent 上次会话中记录的笔记、你通过手机分配的任务：在下一次会话以空白上下文窗口启动时，它们依然都在。

语言说明。 Chip 是一款俄语产品：工具使用俄语回复，账单以卢布结算。你可以在任何国家使用，但如果你不懂 俄语，回复对你来说就没有用处。

为什么值得使用

返回项目只需 63 个 token，而不是 2538 个。 你的 Agent 会调用 whats_new，只获取上次访问以来的变更，而不是重新获取整个项目。这项测量于 2026-09-10 在一个成熟的参考项目上进行，使用真实的 tiktoken o200k_base 计数，并非估算：

场景	之前	之后
首次访问项目	2538 个 token	2284 个 token
返回时没有任何变更	2538 个 token	63 个 token
一天编辑后返回	2538 个 token	295 个 token

只读 token 连列出工具的成本都更低。 每次会话在首次调用前都要为工具列表付费：27 个工具需要 2905 个 token，11 个只读工具需要 1155 个。如果你的 Agent 只读取项目，请发放一个 read token，每次会话节省 1750 个 token。

你的 Agent 可以联系你。 长时间运行的构建完成时，notify_me 会向你的 Telegram 推送消息；ask_user 会通过按钮提问，check_confirmation 稍后获取答案——因此，独自工作的 Agent 可以等待人工决策，而不是猜测。

安装

你需要一个免费账号：在 Telegram 中打开 @ChipAI_robot → 迷你应用 → Chip MCP → 发放一个 token（chip_mcp_…）。如果你希望 Agent 只查看而不做任何修改，请选择 read。

Claude Code

claude mcp add --transport http chip https://chip-ai.digital/mcp --header "Authorization: Bearer chip_mcp_YOUR_TOKEN"

Cursor — ~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）：

{
  "mcpServers": {
    "chip": {
      "url": "https://chip-ai.digital/mcp",
      "headers": { "Authorization": "Bearer chip_mcp_YOUR_TOKEN" }
    }
  }
}

其他任何支持使用包含 url 和 headers 的 mcpServers 条目的客户端也能以相同方式工作。更多信息请参阅 docs/clients.md。

然后告诉你的 Agent 从 whats_new 开始——服务自身的说明也会这样要求，因此大多数 Agent 无需提示就会执行。

Claude Code 插件

Claude Code 可以一次性安装所有内容——服务器、会话流程和两个 命令，无需你手动配置。

export CHIP_MCP_TOKEN=chip_mcp_YOUR_TOKEN
claude plugin marketplace add zapret-digital/chip-mcp
claude plugin install chip@chip-ai

令牌仅存放在 CHIP_MCP_TOKEN 中。它绝不会写入插件 文件，也不会写入 .chip.json。

插件会添加：

• chip MCP 服务，指向 https://chip-ai.digital/mcp/——该地址是 插件中的固定值，无法通过环境变量重新指定；
• /chip:start 和 /chip:finish——与服务器的 start 和 finish 提示词相同的会话流程，供无法显示提示词的客户端使用；
• 三个钩子：会话开始时，项目变更会加入上下文；上下文压缩前和停止时，会提醒 Agent 保存摘要。

钩子需要仓库根目录中的 .chip.json，以确定当前项目：

{ "project_id": 12 }

小程序会将它发送给你——位于项目设置中的 «Правила для IDE-агента»，与 AGENTS.md 放在一起。Telegram 会移除附件名称开头的点，因此保存后请将文件名改回 .chip.json。如果没有此文件，钩子会保持静默——但会在会话开始时提示一行，说明此仓库没有 .chip.json。插件仍可正常工作，只是会话开始时不会加载项目变更。

钩子绝不会阻止会话——无论缺少令牌、网络、python3 还是 curl，都会显示一行说明，而不是导致启动失败。

本地开发： CHIP_MCP_URL 仅会重新指定钩子的地址，且只允许使用生产地址或环回测试环境（http://127.0.0.1:PORT/mcp/）；其他地址均会被拒绝。MCP 通道会忽略此变量，因此没有仓库能通过 .claude/settings.json 将你的令牌发送到自己的主机。

工具

共有 27 个工具。read 令牌可使用标记为 read 的 11 个工具；full 令牌可使用所有工具。

工具	访问权限	参数
add_note	写入	project_id、text、kind
add_task	写入	project_id、text
archive_project	写入	project_id
ask_user	写入	question、options
attach_file	写入	filename、size_bytes
check_confirmation	写入	ask_id
complete_task	写入	task_id、result
create_project	写入	name
finalize_upload	写入	upload_id
generate_image	写入	prompt、project_id
get_project_context	读取	project_id、depth
get_project_map	写入	project_id
list_files	读取	project_id
list_projects	读取	—
list_tasks	读取	project_id
notify_me	写入	text、upload_id
read_journal	读取	project_id、offset
read_map_section	读取	project_id、section
read_project_dialog	读取	project_id、session_id
read_project_file	读取	project_id、filename、page
rename_project	写入	project_id、name
save_session_summary	写入	project_id、text
search_project	读取	query、project_id、kind、since
set_reminder	写入	text、when
upload_project_file	写入	project_id、filename、size_bytes、content
whats_new	读取	project_id、since、session
whoami	读取	—

get_project_map 会读取目录，但被列为 write，这是有意为之：获取目录时也会刷新项目地图，因此只读令牌无法使用它。read_map_section 只读取单个条目，不会产生副作用。

机器可读版本：spec.json，由服务器自身的工具注册表生成——详见下文。

服务端可以和不可以看到的内容

• 它无法访问你的文件系统。 它只会接收你的 Agent 明确传入的参数。不会扫描你的代码库。
• 调用参数和结果不会被记录。 使用日志只存储工具名称、耗时和成功标志，不包含其他内容。
• read 令牌无法写入。 这一点在调用本身强制执行，而不只是通过隐藏工具列表中的工具来实现。
• 令牌以 SHA-256 形式存储。 原始值仅在签发时显示一次。
• 列出工具无需令牌，因此目录可以索引此服务端。每次实际调用则需要令牌。

自行验证规范

此代码库中的 spec.json 根据实时服务端的工具注册表生成，因此不会悄然偏离实际情况。你可以自行对照生产环境进行检查：

./scripts/verify.sh

它会将已提交的规范与 https://chip-ai.digital/mcp/spec.json 进行比较。

定价

连接免费。读取你自己的项目免费。写入、Telegram 消息和图像生成会按用量计入你的 Chip 套餐——工具会告知你的 Agent 何时达到限额，以及该如何处理。套餐信息可在 Telegram 机器人中查看。

链接

• 落地页和文档
• Telegram 机器人
• 实时规范

许可证

本代码库的内容（规范、文档、脚本）采用 MIT 许可证。Chip 服务本身为专有服务。