GramClaw 以两种方式暴露同一个 Telegram 引擎：一个用于自定义自动化的 REST API，以及一个供 AI 智能体使用的远程 MCP（Model Context Protocol）服务器。两者都用你在“设置”中创建的 API 密钥进行认证，都遵守同样的按账号调速以让你的 Telegram 账号保持健康，并且都要求一个有效的订阅或试用。
在实践中：REST API 是给代码用的——从你的产品同步联系人、在某个用户注册时触发一个营销活动、把对话导入你的数据仓库。MCP 服务器是给智能体用的——Claude Desktop、Claude Code、Cursor 或你自己的智能体会获得一批工具，用于列出聊天、读取消息、发送回复、运行群发消息以及管理管道，一行代码都不用写。
创建一个 API 密钥
- 1
打开“设置 → API 密钥”
生成一个密钥并选择它的作用域——read 用于列出和读取数据，send 用于任何写入或发消息的操作。把密钥的作用域限定到它所需的最小范围。
- 2
只复制这一次
完整密钥（gc_live_…）仅在创建时显示一次——请把它存进密钥管理器。如果它泄露，就在“设置”中删除它，它会立即失效。
- 3
进行认证
REST：以 Authorization: Bearer 请求头的形式发送它。MCP：把它作为 key 参数放进服务器 URL。
一分钟看懂 REST API
该 API 覆盖了平台的各个面：账号、聊天、消息、联系人、营销活动、群发消息、管道列以及分析。请求是通过 HTTPS 传输的纯 JSON。完整的端点文档——每一条路由、它的作用域，以及请求/响应示例——都在 API 文档页上，另有一份机器可读的 OpenAPI 规范可在 /openapi.json 获取，用于代码生成或交给某个 LLM。
连接 MCP 服务器
- 1
复制服务器 URL
https://gramclaw.com/api/mcp?key=gc_live_… ——该密钥既标识你的身份又授权你，并限定在它可代为操作的账号上。
- 2
把它添加到你的 MCP 客户端
Claude Desktop、Claude Code、Cursor 或任何兼容 MCP 的客户端都接受一个远程服务器 URL。无需本地安装，无需代理。
- 3
请它做真正的活
一旦连接，你的智能体就能搜索聊天、起草并发送回复、启动营销活动、查看营销活动状态，以及把交易在管道中推进——每一次发送都受到与 GramClaw 其余部分相同的账号调速约束。
良好实践
- 每个集成用一个密钥，并相应地命名，这样吊销某一样东西永远不会破坏另一样。
- 对于仪表盘和分析任务，优先使用只读作用域。
- 在同事离职时轮换密钥，并删除你不再使用的密钥——吊销是即时的。
- 记住 API 和 MCP 的发送都是来自你真实账号的真实 Telegram 消息：与在应用内一样，同样的同意与用量判断依然适用。