← 所有 Telegram MCP 连接器

Claude · Anthropic

把 Telegram 接入 Claude

在 Claude 或 Claude Code 中把 Entergram 添加为自定义 MCP 连接器,然后用大白话和你真实的 Telegram 账号对话——找出你漏看的消息、忘了回复的客户,以及那些悄悄冷掉的机会。

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

Claude 通过自定义连接器支持 Model Context Protocol(MCP)。Entergram 把你的个人 Telegram 账号封装成托管的 MCP 服务器,让 Claude 读取并操作你真实的聊天记录——全程 OAuth 安全授权,无需机器人账号、无需写代码,也绝不接触你的手机号或 API 密钥。

可直接粘贴的配置

claude_desktop_config.json — or run `claude mcp add`
{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

问 Claude 那些 Telegram 永远答不上来的问题

连上你的个人账号后,Claude 能同时纵览每一段对话。试试这些提问:

  • 「我这周漏看了多少条消息?其中哪些是客户发来的?」
  • 「我有哪些对话忘了回复?按它们已经等了多久排个序。」
  • 「帮我量化错过的机会——那些给我发过两次消息却始终没得到回复的潜在客户。」
  • 「总结过去 7 天客户给我的反馈,按好评和差评分组。」
  • 「找出所有有人问过价格、我却一直没回的聊天。」
  • 「给我最久没回的五条客户消息各起草一条回复,让我逐条确认。」

三步连接 Claude

适用于 Claude(网页版与桌面版)和 Claude Code。

  1. 01

    在 Entergram 中复制你的 MCP 地址

    在 Entergram 中打开 Settings → Workspace → Connectors → MCP,复制你的 MCP 服务器地址。

  2. 02

    在 Claude 中添加连接器

    在 Claude 中进入 Settings → Connectors → Add custom connector,粘贴 Entergram MCP 地址:https://mcp.entergram.com/mcp。在 Claude Code 中,用同一个地址运行 `claude mcp add`。

  3. 03

    授权后开始提问

    点击 Connect,用你的 Entergram 账号登录,然后点击 Allow access,连接器即刻生效——Claude 可以马上对你的聊天、联系人、工单和数据分析进行推理。

Claude 连接器可以跑在哪里

Claude 网页版与桌面版

主路径,也是大多数人想要的方式。Settings → Connectors → Add custom connector,粘贴地址,点击 Connect。Free、Pro、Max、Team 和 Enterprise 都可用——Claude 并没有把自定义连接器锁在付费套餐之后,所以你可以先用免费账号试通再决定。

Claude Code

把同一个托管服务器加到 CLI 里,终端里的智能体就能在两次构建之间顺手分流 Telegram——当某次部署需要给客户群提前打个招呼时,这一点特别实用。

claude mcp add --transport http entergram https://mcp.entergram.com/mcp

Claude Agent SDK

打算基于 Claude 自己搭智能体?在 SDK 的 MCP 服务器配置里声明 Entergram,你的智能体就会继承同样的 70 个工具,运行它的人也会看到同样的 OAuth 授权页。

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

你提问之后,底下实际发生了什么

Claude 拿到的不是数据库的裸访问权,它调用的是结构化工具——和你用程序调用的是同一批。下面是大白话提问与其背后调用链之间的对应关系。

你的提问

「总结我今天所有未读的聊天,并标出看起来像投诉的内容。」

调用的工具

entergram_list_accountsentergram_list_live_chatsentergram_list_messages

你会得到

Claude 先解析出你的账号,拉取带未读计数的实时视图,再逐个会话读取近期历史,然后基于文本判断语气。四十个未读会话被压缩成一页简报,投诉被单独点名。

你的提问

「哪些 VIP 联系人已经 24 小时没收到我们的回复?」

调用的工具

entergram_list_custom_columnsentergram_list_contactsentergram_list_messages

你会得到

它先读取你的 CRM 字段结构,找到标记 VIP 的那一列,按该选项值筛出联系人,再逐个检查会话里最后一条消息是收到的还是发出的。返回的是一份带等待时长的名单——接着你可以追问「给每个人起草一条问候」。

你的提问

「为和 Lena 的聊天开一个高优先级的账单工单,指派给支持团队。」

调用的工具

entergram_list_chatsentergram_create_ticketentergram_list_ticket_custom_columns

你会得到

Claude 找到该聊天,读取工单字段结构,把「高优先级」和「账单」映射到你真实的选项值上,然后创建一个回链到该对话的工单。它立刻出现在你的队列里,而你根本没离开聊天。

你的提问

「把过去 7 天里提到退款的每个聊天都标记为紧急。」

调用的工具

entergram_list_messagesentergram_get_chat_custom_fieldsentergram_patch_chat_custom_fields

你会得到

这类批量操作换成手工筛选要花一下午。Claude 扫描消息内容,构建匹配列表,逐个聊天写入自定义字段——然后准确报出它改动过哪些聊天,方便你抽查。

你的提问

「本周按成员划分,我们的平均首次响应时间是多少?」

调用的工具

entergram_list_workspace_chatsentergram_list_messagesentergram_list_members

你会得到

无需事先配置的即席分析。Claude 为每个会话识别出第一条入站消息和第一条出站回复,算出时间差,再按发送人聚合——你要是问一句,它也乐意顺手和上周对比。

你的提问

「在 Acme 会话上留一条内部备注,说明我们进行到哪一步了。」

调用的工具

entergram_list_chatsentergram_create_chat_comment

你会得到

这条备注只在 Entergram 内对你的团队可见,客户永远看不到。这就是把一个会话从 Claude 交回人工的方式——推理过程始终附着在对话上。

Claude 能用你的 Telegram 做什么

  • 搜索并总结所有已连接账号里的对话
  • 自动浮现未回复和已逾期的聊天
  • 查询联系人及其自定义 CRM 字段
  • 经你确认后代你起草并发送消息
  • 量化错过的机会和客户反馈
  • 从聊天中创建并更新支持工单

Claude 能拿到的全部工具

完成连接器授权后,Claude 会获得分布在 9 个分组中的 70 个工具。这就是完整的能力面——没有任何东西被藏在更高档位背后;不过某个具体连接实际能调用哪些,取决于你在下面授予它的访问级别。

账号与工作区

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

你实际授权出去的是什么

连接就是一次标准的 OAuth 登录:Claude 把你送到 Entergram 的授权页,你确认,之后随时可以在 Settings → Workspace → Connectors → MCP 撤销。你的 Telegram 手机号和会话凭证绝不离开 Entergram——Anthropic 从头到尾都看不到它们。访问级别有两种,两者的差别很关键。

个人智能体(personal agent)
任何工作区成员都能创建。权限被限制在安全范围内:对工作区、账号、联系人、聊天、消息和工单的只读访问,外加对你自己聊天的自定义字段的读写。个人 Claude 账号选它就对了。
工作区连接器(workspace connector)
仅限所有者和管理员创建。它持有完整权限集——包括发送消息、写入任意聊天的自定义字段以及管理群组。它是与团队共享的,所以适合代表整个工作区(而不是某一个人)运行的连接器。
撤销
两边都能操作,且立即生效。在 Claude 里断开 Entergram 连接器,或者在 Entergram 打开 Settings → Workspace → Connectors → MCP 点击 Revoke。你一操作,已签发的令牌当场失效。

这个连接器做不到的事

在它之上搭工作流之前,这几条值得先知道。

  • 它需要 Pro 套餐。MCP 访问在 Entergram 属于 Pro 套餐功能——低档位可以完成连接器授权,但工具调用会失败。
  • 它不是后台智能体。只有你正在和 Claude 对话时它才会行动;除非你从 Claude Code 或 Agent SDK 驱动,否则不会有任何东西按计划自动运行。
  • 发送是按账号限定的。不存在「发给所有人」这样的调用——每个消息类工具都要求显式的 account_id,所以一次失误不会扩散到你所有已连接的账号。
  • 你读不到的聊天,它同样读不到。连接器完全继承你的 Telegram 权限:你看得到什么它才看得到什么,你从未加入过的群里的内容它一概读不到。
  • 消息历史的深度取决于 Telegram 自身的限制,而非 Entergram——大群里非常久远的历史可能无法一次性取回。
  • 写自定义字段的前提是字段已经存在。Claude 可以填写某个流程阶段列,但除非你授予工作区连接器,否则它无法凭空造出一个你工作区里没有的列。

Claude 连接器排障

Claude 提示地址无效
从 Settings → Workspace → Connectors → MCP 重新复制一次 MCP 服务器地址,并检查末尾有没有多余空格——从聊天消息里粘贴通常就是元凶。所有用户、所有应用用的都是同一个地址:https://mcp.entergram.com/mcp
Entergram 登录页始终打不开
Claude 是在弹出窗口里打开授权页的。请为 claude.ai 允许弹窗,确认你已经在同一个浏览器里登录了 Entergram,然后重新点击 Connect。
工具调用返回 403
有两种原因。要么你的 Entergram 账号不具备创建工作区连接器所需的所有者/管理员权限——那就改用个人智能体——要么你的套餐不包含 MCP 访问,它属于 Pro 套餐功能。
Claude 里看不到任何 Entergram 工具
连接器已经授权,但工具列表没刷新。在 Settings → Connectors 里把连接器关掉再打开,或者新开一段对话——Claude 是在对话开始时读取工具列表的。
它操作了错误的 Telegram 账号
让 Claude 调用 entergram_list_accounts,并在提示词里点名指定账号。任何操作都不会跨账号全局生效,所以没写明 account_id 就意味着它替你挑了一个。
连上一段时间后就断了
OAuth 令牌会过期。在 Claude 里重新点击 Connect 并再次确认授权即可——地址不用重新复制。

Claude + Telegram 常见问题

它能配合 Claude Code 使用吗?
可以。Claude Code 支持 MCP 服务器——用 `claude mcp add` 添加 Entergram MCP 地址并通过 OAuth 授权即可。同一个连接器在 Claude 桌面版和网页版中也通用。
这是一个 Telegram 机器人吗?
不是。Entergram 通过托管的 MCP 服务器连接你真实的个人 Telegram 账号,所以 Claude 看到的就是你自己看到的聊天,而不是另开一个机器人账号。
它真能告诉我漏看了哪些消息吗?
能。因为 Claude 可以一次性读取你所有已连接的聊天,它能统计未读和未回复的消息、按等待时长排序,并标出来自客户或潜在客户的那些。
安全吗?
安全。连接采用 OAuth 2.0 并限定权限范围。你精确授权 Claude 能访问什么,你的凭证绝不经过 Claude,而且你可以随时撤销访问。

把 Telegram 接入 Claude