Cline · VS Code

把 Telegram 接入 Cline

在 VS Code 的 AI 智能体 Cline 中把 Entergram 添加为 MCP 服务器，从编辑器里就能触达你真实的 Telegram 账号——不打断心流，就能捕捉漏看的消息和等你回复的客户。

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

Cline 在 VS Code 内部连接 MCP 服务器。Entergram 把你的个人 Telegram 账号暴露为一个托管的 MCP 服务器，因此 Cline 能在完整的 OAuth 安全保障下读取你真实的聊天并采取行动——无需机器人，也无需 API 密钥。

可直接粘贴的配置

cline_mcp_settings.json

{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

向 Cline 询问你的 Telegram

连上你的个人账号后，无需离开 VS Code，Cline 就能查看 Telegram。试试：

「我写代码的时候漏看了哪些客户消息吗？」
「哪些对话我忘了回复？」
「这周有多少潜在客户变冷了？」
「总结一下今天的客户反馈。」
「为最后一条还没回的消息草拟一条回复，并展示给我看。」

三步接入 Cline

适用于 VS Code 中的 Cline 扩展。

01
在 Entergram 中复制你的 MCP 地址
在 Entergram 中打开 Settings → Workspace → Connectors → MCP，复制你的 MCP 服务器地址。
02
在 Cline 中添加服务器
在 Cline 的 MCP 设置（cline_mcp_settings.json）中，注册 Entergram MCP 地址：https://mcp.entergram.com/mcp。
03
授权并使用
点击 Connect，用你的 Entergram 账号登录，然后点击 Allow access。随后在你于 VS Code 中工作时，Cline 就能查询你的 Telegram 账号并采取行动。

在 Cline 里注册它的三种方式

MCP Servers 面板 —— Remote Servers

完全不用碰 JSON 的路径。点击 Cline 面板顶部的服务器图标，打开 Remote Servers 标签页，把条目命名为 entergram，粘贴地址，点击 Add。Cline 会替你写好配置，并在服务器旁边显示一个状态灯——这是区分「粘错了地址」和「计划本身有问题」的最快方式。

cline_mcp_settings.json

这个文件位于扩展的全局存储目录里——在 macOS 上是 ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json，Windows 和 Linux 上则是 VS Code 用户目录下同样形状的路径。当你想把 autoApprove 数组和其余机器配置一起纳入版本控制时，手工编辑它就很值得。

{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

自动批准，只放行读操作

这个设置决定了连接器用起来是顺手还是折磨。在 autoApprove 里逐个点名工具，可以让查询类调用免确认直接跑，而任何写入、发送或删除仍然会停下来等人。先从下面这四个开始，等某个工作流被验证过了再放宽。

"autoApprove": [
  "entergram_list_accounts",
  "entergram_list_chats",
  "entergram_list_messages",
  "entergram_get_contact"
]

六次运行，以及 Cline 会在哪里停下来问你

Cline 是一个会提前规划好几步、然后一次一个调用地执行的智能体，每个调用前都摆着 Approve 或 Reject。这种节奏改变了连接器的用法：读操作一晃而过，而写操作才是你真正要盯的地方。下面这些运行值得交给它。

你的提问

「把今天上午的 bug 报告逐条变成工单。」

调用的工具

entergram_list_live_chatsentergram_list_messagesentergram_create_ticket

你会得到

Cline 读取未读视图，把找到的内容归拢成一个个独立问题，然后为每个问题提出一个工单。每次创建都是一次单独的确认，所以拒掉其中一个只会跳过它，计划的其余部分照常进行。原本四十分钟的复制粘贴，变成一串是与否的选择。

你的提问

「我们二十分钟前发布了。有什么坏掉了吗？」

调用的工具

entergram_list_live_chatsentergram_get_live_chatentergram_list_messages

你会得到

对着唯一能抓到看板漏掉的那类故障的「监控」做一次冒烟测试。Cline 收窄到发布时间窗之后有活动的会话，读取新进来的内容，把日常流量和看起来像回归缺陷的东西区分开。全是读操作，所以开着自动批准时它能一路跑完不打断。

你的提问

「昨晚故障产生的工单都还标着普通。把付费客户那几条的严重程度提上去。」

调用的工具

entergram_list_ticketsentergram_list_ticket_custom_columnsentergram_update_ticket

你会得到

它先读工单字段结构再写入，让严重程度映射到你真实的选项值而不是靠猜，然后逐条更新匹配项。因为每次更新都是一次独立确认，你可以一行一行地看过去，一发现哪条不对就立刻停下。

你的提问

「给每个报过导出 bug 的人一个回应，让他们知道我们看到了。」

调用的工具

entergram_list_messagesentergram_set_message_reactions

你会得到

表情回应是成本最低的一种回复，也是开发者永远抽不出空去做的那种。Cline 跨会话找到这些报告消息并逐一回应，代价是零，换来的却是那些原本以为自己被无视的人多出来的几个小时耐心。

你的提问

「给 beta 群起草发布说明，发送前停下。」

调用的工具

entergram_list_groupsentergram_list_group_membersentergram_send_message

你会得到

这个计划以一次发送收尾，而在你按下 Approve 之前它绝不会触发，草稿就摆在那里等你先改。事先检查成员名单是真正关键的细节：你正是靠它发现这条公告马上要发进一个还留着上季度客户的群。

你的提问

「把你这次运行做了什么，写成内部备注留在你碰过的每个聊天上。」

调用的工具

entergram_list_chat_commentsentergram_create_chat_comment

你会得到

一份由智能体自己生成、并且挂在对话上而不是丢在某个已关闭编辑器标签页里的审计轨迹。它先读已有的备注以免和同事重复，再把自己的小结作为评论追加上去——这条评论在你工作区之外没人看得到。

Cline 能用你的 Telegram 做什么

—从编辑器查询 Telegram 聊天
—在你工作时浮现漏看的消息
—就地查询联系人和 CRM 字段
—经你确认后发送消息和回复
—量化错过的机会和反馈
—基于真实的 Telegram 数据搭建内部工具

Cline 可以调用什么

服务器暴露 9 个分组共 70 个工具，Cline 会把它们全部列在该服务器条目下，方便你在批准任何操作之前先读一遍这份能力面。读的那几组是编程会话里会不断用到的；写的那几组，值得先让它们保持手动确认一段时间。

账号与工作区

5 个工具

用于确认身份和权限范围。每次消息类调用都必须先通过 list_accounts 取得 account_id——跳过这一步的 AI 客户端会把请求发到错误的 Telegram 账号上。

entergram_get_me
entergram_list_accounts
entergram_get_workspace
entergram_get_member
entergram_list_members

聊天与查找

8 个工具

用于定位会话。工作区视图携带 CRM 状态（工单、评论、自定义字段）；实时视图携带 Telegram 当前的传输状态和未读计数。

entergram_list_chats
entergram_get_chat
entergram_list_live_chats
entergram_get_live_chat
entergram_list_workspace_chats
entergram_get_workspace_chat
entergram_update_workspace_chat
entergram_get_chat_management

消息

9 个工具

读写消息历史，包括编辑、转发和表情回应。发送操作按账号划定范围，因此任何操作都不会跨越你已连接的多个账号生效。

entergram_list_messages
entergram_get_message
entergram_send_message
entergram_send_media_message
entergram_edit_message
entergram_delete_message
entergram_forward_messages
entergram_get_message_reactions
entergram_set_message_reactions

联系人

3 个工具

你在和谁对话，以及你们还在哪些地方有交集。共同群组查询正是让「我的哪些潜在客户在同一个社群里？」这类问题变得可回答的关键。

entergram_list_contacts
entergram_get_contact
entergram_list_contact_shared_groups

工单

10 个工具

完整的客服工单控制：创建、指派、设置优先级、评论和关闭。工单会关联回它所来自的聊天，因此 AI 客户端可以一步之内从会话转入工单队列。

entergram_list_tickets
entergram_get_ticket
entergram_create_ticket
entergram_update_ticket
entergram_delete_ticket
entergram_list_chat_tickets
entergram_list_ticket_comments
entergram_create_ticket_comment
entergram_update_ticket_comment
entergram_delete_ticket_comment

CRM 自定义字段

11 个工具

你的销售流程结构。写入数值前先读取列定义——复选框接受布尔值，多选字段接受由选项值组成的数组，日期字段接受 ISO 8601 字符串。

entergram_list_custom_columns
entergram_get_custom_column
entergram_create_custom_column
entergram_update_custom_column
entergram_delete_custom_column
entergram_list_custom_column_options
entergram_create_custom_column_option
entergram_update_custom_column_option
entergram_delete_custom_column_option
entergram_get_chat_custom_fields
entergram_patch_chat_custom_fields

工单自定义字段

9 个工具

工单侧的同一套结构控制——分类、严重级别、SLA 等级，以及你的客服团队在状态和优先级之外跟踪的任何字段。

entergram_list_ticket_custom_columns
entergram_get_ticket_custom_column
entergram_create_ticket_custom_column
entergram_update_ticket_custom_column
entergram_delete_ticket_custom_column
entergram_list_ticket_custom_column_options
entergram_create_ticket_custom_column_option
entergram_update_ticket_custom_column_option
entergram_delete_ticket_custom_column_option

内部备注

4 个工具

写在聊天上、客户永远看不到的评论。适合让 AI 客户端把自己的推理过程留下来，交给人类同事接手。

entergram_list_chat_comments
entergram_create_chat_comment
entergram_update_chat_comment
entergram_delete_chat_comment

群组与频道

11 个工具

创建和管理 Telegram 群组与频道——成员、权限、隐私和资料——另外还提供一个原始命令通道，用于处理其余情况。

entergram_list_groups
entergram_get_group
entergram_list_group_members
entergram_create_group_chat
entergram_create_channel
entergram_invite_chat_members
entergram_remove_chat_member
entergram_update_chat_info
entergram_update_chat_permissions
entergram_update_chat_privacy
entergram_run_chat_command

两道闸，而不是一道

Cline 的确认弹窗是你看得见的那道闸。OAuth 权限范围是你设置一次之后就不再想起的那道，而它是两者中更严格的一道——批准某次调用，永远不可能授予令牌本身没有的权限。请先决定访问级别，再去调 autoApprove，因为令牌是天花板，而批准清单只决定「已被允许的事」要问你多少次。撤销只需在 Entergram 的 Settings → Workspace → Connectors → MCP 里点两下。

个人智能体: 每个工作区成员都能自行创建，不用问任何人。它涵盖对聊天、消息、联系人、工单、已连接账号和工作区记录的读权限，外加对你自己聊天的自定义字段的写权限。配上 Cline 的确认循环，再野心勃勃的智能体也是无害的：最坏的结果不过是它读得比需要的多。
工作区连接器: 只有所有者或管理员能创建，它才是解锁工具清单中「写」那一半的档位——发送和编辑消息、修改不属于你的聊天上的自定义字段、管理群组。整个团队共享它，这也让一份宽松的 autoApprove 清单变成团队决策，而不是个人偏好。
撤销: 从 Cline 里删掉服务器，客户端就不再发问。在 Entergram 里撤销，服务器就不再作答，包括另一台机器上仍然开着的会话。当你是在轮换访问权限而不只是收拾编辑器时，请做后者。

确认循环的代价

一个把人放在中间的编辑器内智能体，如实说来有这些取舍。

确认是按工具调用来的，不是按计划来的。一个六步任务就意味着面板里六次弹窗，而中途走开会让这次运行无限期地停在下一次确认上。
autoApprove 匹配的是工具名，永远不匹配参数。把 entergram_send_message 放进那份清单，等于对所有聊天都批准了它，而不只是你心里想的那一个——所以在某个工作流真正挣到位置之前，别把写工具放进去。
运行是活在你的编辑器窗口里的。关掉 VS Code 或重载扩展宿主，任务就停在原地——服务端不会有东西继续跑，也不会有东西接着往下做。
低于 Pro 的工作区可以走完 OAuth 登录，然后在第一次调用时失败，而 Cline 会把这显示成一次失败的工具结果，而不是连接问题。MCP 访问属于 Pro 套餐功能。
账号选择是显式的。如果你的提示词没有点名账号，智能体会从列表里解析一个然后继续，而确认对话框不会告诉你它挑了哪个。
历史深度取决于 Telegram 自身的留存策略而非 Entergram，所以一个积压多年的活跃群不会在一次调用里把全部内容交出来。限定日期范围的问题，得到的答案比开放式提问好得多。

Cline 连接器排障

MCP Servers 面板显示 Disconnected

用那个条目上的 Restart Server 按钮，而不是重装什么东西。Cline 每个服务器只保持一条连接，网络中断或笔记本从睡眠中唤醒之后，它不会自己重试。

Cline 每读一次都要我批准

这是默认行为。在 MCP Servers 面板里打开该服务器的条目，把你已经确认烦了的只读工具移进它的自动批准清单，发送、编辑和删除类的则留在外面。

手工改完配置文件之后什么都没出现

一个多余的逗号或一个杂字符会让整份文档失效，而 Cline 会退回到空的服务器列表，不会抱怨。请把 JSON 过一遍校验器，然后重新加载 VS Code 窗口，让扩展宿主重新读取它。

任务跑到一半停住了，也没有报错

要么是某次确认弹窗没人回答，要么是窗口在运行途中重载了。Cline 不会跨重启恢复任务——重新发起这次运行即可，它会基于你聊天的当前状态重新规划。

回复从错误的 Telegram 账号发出去了

让 Cline 调用 entergram_list_accounts，然后把账号名写进提示词本身。账号是隐含的时候，智能体会自己挑一个，而确认对话框不会把这个选择呈现出来。

刚干净连上就出现 403

授权成功了，权限没有。个人智能体不能发送消息，也不能写别的成员的自定义字段；如果这次运行确实需要这些，请向所有者或管理员申请工作区连接器。

Cline + Telegram 常见问题

我要怎么往 Cline 添加一个 MCP 服务器？

打开 Cline 的 MCP 设置（cline_mcp_settings.json），添加 Entergram MCP 地址，并通过 OAuth 授权即可。

这是一个 Telegram 机器人吗？

不是。Entergram 通过托管的 MCP 服务器连接你真实的个人 Telegram 账号。

安全吗？

安全。OAuth 2.0 加上限定的权限范围；你的凭证绝不会到达编辑器厂商手中，访问也可撤销。

其他连接器

Entergram 适用于任何兼容 MCP 的 AI 工具。

把 Telegram 接入 Claude Anthropic 把 Telegram 接入 ChatGPT OpenAI 把 Telegram 接入 Gemini Google 把 Telegram 接入 n8n n8n.io 把 Telegram 接入 Make.com Celonis 把 Telegram 接入 Cursor 与各类 IDE Cursor, Zed, Windsurf 把 Telegram 接入 Perplexity Perplexity AI 把 Telegram 接入 Goose Block 把 Telegram 接入 Raycast Raycast 把 Telegram 接入 opencode SST