opencode · SST

把 Telegram 接入 opencode

在 SST 的开源终端 AI 智能体 opencode 中把 Entergram 添加为 MCP 服务器，让它处理你真实的 Telegram 账号，浮现漏看的消息、跟进变冷的潜在客户，并直接从命令行就聊天采取行动。

MCP 服务器地址 https://mcp.entergram.com/mcp

opencode 从配置文件加载 MCP 服务器。把 Entergram 注册为远程 MCP 服务器，SST 的开源智能体就能在终端里操作你真实的个人 Telegram 账号，由 OAuth 限定权限，无需机器人账号，也无需 API 密钥。

可直接粘贴的配置

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "entergram": {
      "type": "remote",
      "url": "https://mcp.entergram.com/mcp",
      "enabled": true
    }
  }
}

三步接入 opencode

适用于 opencode 的 TUI 和 CLI。

01
在 Entergram 中复制你的 MCP 地址
在 Entergram 的 Settings → Workspace → Connectors → MCP 下复制你的端点。opencode 是从 opencode.json 里读取它的，所以你会把它粘进一个文件而不是一个输入框。
02
在 opencode.json 中添加服务器
在你的 opencode.json 里，把 Entergram 添加到 "mcp" 之下，作为一个指向 Entergram MCP 地址的远程服务器：https://mcp.entergram.com/mcp。
03
授权并运行
启动 opencode，用你的 Entergram 账号登录，然后点击 Allow access 授予限定范围的访问权。之后 opencode 就能在其会话中读取你的 Telegram 账号并采取行动。

全局、按项目，还是无头运行

全局：~/.config/opencode/opencode.json

一份配置跟着你进入每一个打开的仓库。个人授权放这里最合适：无论你在公司项目还是周末项目里，服务器都可用，而且你只需授权一次，而不是每个检出授权一次。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "entergram": {
      "type": "remote",
      "url": "https://mcp.entergram.com/mcp",
      "enabled": true
    }
  }
}

按项目：仓库根目录的 opencode.json

和代码一起提交，于是任何人克隆这个仓库都会拿到已声明好的服务器，不用谁去告诉他。这里没有共享任何机密，文件里只有一个端点，除此之外什么都没有，而且每位队友仍要用自己的权限完成自己的登录。项目配置会覆盖全局文件，所以请只保留一份定义，别让两份互相打架。

无头：opencode run

这才是这个连接器一开始就适合终端智能体的原因。一次非交互调用可以塞进部署脚本、Makefile 目标或 CI 步骤里，发布通知也就不再依赖谁记得去发。

opencode run "post the release summary for v2.14 in the customer channel"

向 opencode 提那些你永远没法问 Telegram 的问题

连上你的个人账号后，opencode 就能从终端跨所有聊天采取行动。可以试试这些提示：

「开一个故障处理频道，把值班的人拉进来。」
「把部署摘要发到客户更新频道。」
「在我打发布标签之前，还有多少工单没关？」
「找出提到这次迁移的聊天，总结一下大家的顾虑。」
「在那个会话上加一条备注，写明回滚方案。」
「beta 群里有谁还没回复升级通知？」

在同一个 shell 里完成发布

终端智能体真正被用起来的时刻，正是打开聊天应用会打断专注的那些时刻：部署刚结束、故障处理途中，或者一天快结束时你想知道还有什么没关。下面这些运行都假设了这种情境，提示词很短，全靠键盘，而连接器负责那些你原本会一直拖到不再重要为止的部分。每一项都对应几次具名调用，它们会打印在会话日志里，也正因为如此，当你手动看它们跑通之后，可以直接把它们搬进脚本。

你的提问

「部署完成了。把版本号和 changelog 链接发到发布频道。」

调用的工具

entergram_list_accountsentergram_list_groupsentergram_send_message

你会得到

公告就从跑部署的那个 shell 里发出去，在成功之后几秒，而不是一小时之后。智能体先确定哪个已连接账号有发布权限，按名称找到频道（于是 ID 永远不用写进你的脚本），然后发送。把它接进部署目标，这一步就不再是可选项。

你的提问

「那条公告里的构建号我写错了，原地改掉。」

调用的工具

entergram_list_messagesentergram_get_messageentergram_edit_message

你会得到

改原文比在下面补一条更正要好。智能体回溯近期历史定位到那条消息，动手之前先确认内容，然后编辑；于是明天滚屏路过的人读到的是正确的数字，而不是一串补丁式的更正。

你的提问

「为这件事开一个故障处理房间，把值班的人拉进来。」

调用的工具

entergram_create_group_chatentergram_list_membersentergram_invite_chat_members

你会得到

三十秒的准备工作，而在系统宕着的时候没人想做它。群被建好，工作区花名册被读取以解析你点名的那些人，邀请随即发出。你回到日志前，协调工作已经安排妥当，而不是只做了一半。

你的提问

「把周五那条维护通知转发给所有还没看到的客户群。」

调用的工具

entergram_list_groupsentergram_list_messagesentergram_forward_messages

你会得到

转发原文能让每个群读到完全一致的措辞，这正是维护窗口通知需要的，也正是重新打一遍会破坏的。智能体在铺开之前会先检查哪些群已经收到过，所以没人会被同一条通知打扰两次。

你的提问

「这位报告者在我们的一些社群里，具体是哪些，我们名单上还有谁也在里面？」

调用的工具

entergram_list_contactsentergram_get_contactentergram_list_contact_shared_groups

你会得到

共同群组查询回答了一个 Telegram 自己不会回答的问题：你和某人的交集到底在哪里。当一份 bug 报告需要判断报告者的影响力时有用；当你在权衡「一个变通方案是在共享社群里发一次就够，还是要手工在十个私聊里重复十遍」时同样有用。

你的提问

「打发布标签之前，标记为这个里程碑的未关闭工单还有多少？」

调用的工具

entergram_list_ticket_custom_columnsentergram_list_ticketsentergram_get_ticket

你会得到

一行命令、零个看板的发布就绪检查。智能体读取你的工单字段结构找到里程碑那一列，按它筛选未关闭工单，并连标题一起报出数量。把它放进发布脚本的第一步，阻塞性工单就会拦住这次打标签，而不是在之后才浮出水面。

opencode 能用你的 Telegram 做什么

-全程用键盘驱动 Telegram
-发布之后把上线通告发到客户频道
-创建故障处理频道并邀请响应人员
-在打发布标签前统计未关闭的工单
-通过 opencode.json 做全局或按项目配置
-以非交互方式运行，适合脚本化任务

一段话说清终端侧的安全模型

你的 dotfiles 里不会留下任何敏感信息。opencode.json 里只有一个地址和一个开关；凭证本身在浏览器登录之后保存在 opencode 自己的认证存储里，而你的 Telegram 会话留在 Entergram 内部，SST 和模型厂商都看不到。如果某台机器丢了，或者某个 CI runner 下线了，就在 Entergram 的 Settings → Workspace → Connectors → MCP 里干掉这份授权，那台机器上的所有会话都会在下一次调用时失去访问权。

个人智能体: 单个开发者终端的默认选择，任何成员都能创建，不需要审批。读的范围覆盖工作区记录、你的已连接账号、联系人、聊天、消息历史和工单队列；写则限定在你自己账号所属聊天上的自定义字段。这足以支撑分流、日报和发布就绪检查，同时刻意止步于任何会和客户说话的能力。
工作区连接器: 由所有者或管理员创建，持有该服务器定义的全部权限：发送、编辑、转发、写工单、在工作区任意位置写自定义字段，以及群组管理。如果部署脚本要在无人介入的情况下往客户频道发消息，就需要这一档。
撤销: 立即生效，而且刻意做成单向的。你不需要能访问跑着 opencode 的那台机器就能切断它，在 Entergram 里撤销会让这份授权无论存在哪里都失效，而当运行者是一台 CI 机器而不是你桌上的笔记本时，这正是关键所在。

终端原生连接器的约束

这些大多关乎交互式会话和自动化运行之间的落差，而终端智能体一生都跨在这道落差上。它们都不是拦路虎；但在这里学会，比在流水线上学会便宜得多。

首次授权需要浏览器。脚本化调用没法完成授权页，所以请在一次交互式会话里授权一次，之后已保存的授权会带动后续的运行。
提交进仓库的 opencode.json 共享的是地址，不是访问权。拉下仓库的队友各自走自己的登录，他们的令牌带的是他们自己的权限，而不是你的。
我们这边没有调度器。opencode 在运行结束时退出，所以任何周期性的东西（每晚的摘要、部署后的通知）都是你的 cron 条目或流水线步骤，永远不是 Entergram 自己触发的。
MCP 属于 Pro 套餐。在更低档位上，服务器照样能应答握手，这会让故障看起来像配置 bug，其实是计费问题。
写入的前提是列已经存在。智能体可以在某个聊天上填写一个发布追踪字段，但创建这个字段是工作区连接器才能做的操作，个人授权做不到。
必须逐账号寻址。终端习惯期待有个合理的默认值，但这里没有，所以请在提示词里点名账号，否则智能体会自己从账号列表里解析一个出来。