← 所有 Telegram MCP 连接器

Gemini · Google

把 Telegram 接入 Gemini

把 Entergram 用作 Google Gemini 和 Gemini CLI 的 Telegram MCP 服务器——通过 OAuth 限定授权，让 Gemini 安全访问你真实的 Telegram 聊天，从而浮现漏看的消息、等待中的客户和变冷的潜在客户。

MCP 服务器地址 https://mcp.entergram.com/mcp
免费开始 查看所有连接器

Gemini CLI 和兼容 MCP 的 Gemini 工具可以连接外部 MCP 服务器。Entergram 把你的个人 Telegram 账号封装成托管的 MCP 服务器，让 Gemini 在 OAuth 安全授权下读取并操作你真实的聊天记录——无需机器人、无需写代码、没有 API 密钥。

可直接粘贴的配置

~/.gemini/settings.json 
{
  "mcpServers": {
    "entergram": {
      "httpUrl": "https://mcp.entergram.com/mcp"
    }
  }
}

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

连上你的个人账号后，Gemini 能一次性分析每一段对话。试试这些提问：

  • 「我这周漏看了多少条消息？其中哪些是客户发来的？」
  • 「我有哪些对话忘了回复？」
  • 「量化一下那些因为没跟进而变冷的潜在客户。」
  • 「总结过去一个月客户给我的反馈。」
  • 「找出我所有聊天里没回复的提问。」
  • 「把我最久没回的消息各起草一条回复，供我审阅。」

三步连接 Gemini

适用于 Gemini CLI 和兼容 MCP 的 Gemini 客户端。

  1. 01

    在 Entergram 中复制你的 MCP 地址

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

  2. 02

    把 MCP 服务器注册到 Gemini

    在你的 Gemini CLI MCP 配置中添加 Entergram，地址为：https://mcp.entergram.com/mcp。

  3. 03

    授权后运行

    点击 Connect，用你的 Entergram 账号登录，然后点击 Allow access。随后 Gemini 即可查询并操作你的 Telegram 账号。

服务器该注册在哪里

Gemini CLI，用户级

主路径，也是大多数人说「Gemini MCP」时指的东西。在 ~/.gemini/settings.json 的 mcpServers 下添加该服务器，用 httpUrl 指向托管端点，重启 CLI，这台机器上的每个项目就都能用这些工具。因为它是远程 HTTPS，不需要 npx 包装器，也没有 stdio 桥接进程要保活。

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

Gemini CLI，项目级

同样一段配置放进仓库内的 .gemini/settings.json，就只对这个检出生效。适合这种情况：某一个仓库是负责把发布消息通知到 Telegram 频道的部署流水线，而你其余的工作根本不该碰聊天——同时配置还留在版本控制里，队友一看就懂。

mkdir -p .gemini && $EDITOR .gemini/settings.json

任何驱动 Gemini 模型的客户端

这个端点与模型无关。IDE 智能体、脚本化框架，或者底层跑 Gemini 的自研工具，都可以按各自的 MCP 配置格式注册 Entergram，并拿到完全相同的工具清单。授权页属于 Entergram，所以运行客户端的人是以自己的身份授权，而不是继承别人的授权。

值得接进终端的活儿

在 CLI 里，这些都是一行调用，可以塞进 shell 别名或 git 钩子。每一句大白话请求都会展开成一串工具调用，而 CLI 会把它调了哪些打印出来——所以你可以先看清机制，再放心把写操作交给它。下面所有例子都假设服务器已注册并授权过一次；此后就只剩敲字了。

你的提问

「把 CHANGELOG.md 里的发布说明发到 beta 频道。」

调用的工具

entergram_list_accountsentergram_list_groupsentergram_send_message

你会得到

那个人人都会忘的部署后步骤。Gemini 已经从仓库把 changelog 读进了上下文，它挑出管理该频道的账号，按名称匹配频道，然后发布。把它挂在构建成功之后，发布通告就不再依赖谁记性好。

你的提问

「beta 频道里有哪些人，我们从来没标记过是付费客户？」

调用的工具

entergram_list_group_membersentergram_list_contactsentergram_get_chat_custom_fields

你会得到

跨两套系统求差集，平时这两套系统分别开在不同的浏览器标签页里。它枚举频道成员，与你的联系人列表匹配，再读 CRM 字段看谁带有客户标记。返回的就是你社区里尚未转化的那一半人，一个个点名。

你的提问

「把失败的测试输出发到 Acme 会话，并附一句简短说明。」

调用的工具

entergram_list_chatsentergram_send_media_message

你会得到

文件本来就在你手边的磁盘上，整个上传流程都省了。Gemini 附上产物，自己写好那句说明——这就是客户看到一大段堆栈跟踪，和客户看到「哪里坏了、什么时候修好」之间的区别。

你的提问

「建一个发布频道，起个规范的名字，把发布团队拉进去。」

调用的工具

entergram_create_channelentergram_update_chat_infoentergram_invite_chat_members

你会得到

在 Telegram 自己的界面里要三步，这里压缩成一句话。频道被创建，标题和描述按你的说法设置好，邀请名单从联系人里解析出来。这一条需要工作区连接器——群组管理不在个人智能体的权限集里。

你的提问

「那条公告里的版本号我打错了，改一下。」

调用的工具

entergram_list_messagesentergram_edit_message

你会得到

它回读近期历史确认你指的是哪条消息，然后原地编辑，而不是在下面补发一条更正。Telegram 会把消息留在原处，已经读过的人不会再被提醒一次，频道历史也保持干净。

你的提问

「把本周按负责人统计的工单数量给我，输出成 TSV。」

调用的工具

entergram_list_ticketsentergram_list_ticket_custom_columnsentergram_list_members

你会得到

输出格式正是终端客户端的价值所在。它拉取队列，把分类和严重程度列解析成真实的选项值，把负责人 ID 映射成人名，然后打印制表符分隔的行，可以直接管道送进表格或绘图脚本。即席报表，且不需要谁先去建一张报表。

Gemini 能用你的 Telegram 做什么

  • —读取并总结 Telegram 对话
  • —浮现漏看的消息和逾期的回复
  • —查询联系人和自定义 CRM 字段
  • —经你确认后发送消息和回复
  • —量化错过的机会和反馈
  • —创建并更新支持工单

CLI 里的工具面

连接完成后列出已注册的 MCP 服务器，全部 70 个工具都会出现在 entergram 之下，分组方式和下面一致。工具名是字面标识符，这一点在终端里比在聊天窗口里更值钱：当你想要确定性行为、不希望模型自己选路线时，可以在提示词里直接点名某个调用。CLI 会边执行边打印每次调用及其参数，这让一份陌生的工具清单很快就能摸熟。

账号与工作区

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

授权是按机器给的

settings.json 里没有任何凭证。这个文件只告诉 CLI 服务器在哪里；访问权来自你在浏览器里完成的一次 OAuth 登录，而由此得到的令牌属于你本人，而不属于这个代码检出。Google 全程拿不到任何 Telegram 凭证——手机号和会话都留在 Entergram 内部。权限集有两套，用哪一套取决于这个 CLI 是否需要写。

个人智能体权限集
任何成员都能自行创建，不用找管理员。它涵盖读取工作区、已连接账号、联系人、聊天、消息和工单，外加在你自己的聊天上写入自定义字段值。本页所有分析和导出类任务用它足够；但不足以发出一条消息。
工作区连接器权限集
仅限所有者和管理员，也是自动化真正需要的那一档。它额外包含发送、媒体、编辑、写工单、跨工作区写自定义字段，以及 Telegram 群组管理。因为它是共享的而非个人的，你授权它的那台机器也要按同等标准来对待。
掐断连接
删掉 mcpServers 条目只会让 CLI 不再去调用服务器，但它并不使任何东西失效。要真正切断访问，请在 Entergram 侧的 Settings → Workspace → Connectors → MCP 撤销该客户端——这会立即生效，覆盖所有在用的机器。

需要绕开设计的约束

这些大多只有在你想让 CLI 无人值守运行时才会咬人。

  • 注册服务器不等于已授权。每台机器第一次都要各自走一遍授权页，所以新笔记本或重建过的容器至少需要一次浏览器。
  • Entergram 工作区必须在 Pro 档。档位不够时，CLI 会照常把服务器列出来，然后每次调用都收到拒绝——看起来像配置坏了，其实不是。
  • 没有隐含账号。消息类工具要求显式的 account_id，所以任何脚本都得先解析账号列表——在聊天里几乎无感，在流水线里就多了一件要记的事。在脚本开头解析一次，然后一路传下去。
  • 个人智能体不能发送，也不能管理群组。发布说明推送、创建频道这类自动化，需要由所有者或管理员授权的工作区连接器。
  • 协议是请求—响应，不是订阅。不会有东西自己跳进你的终端；只有当有人让 Gemini 去看时，它才知道有新消息。任何类似监控的东西，都得是你自己拥有的定时任务。
  • CLI 不会提权。它看到的聊天和你自己的 Telegram 账号看到的完全一致，你退出过的群它就读不到。

CLI 常见问题及其成因

服务器始终不出现在 MCP 列表里
几乎总是 JSON 写坏了——一个多余的逗号就会让 CLI 悄悄丢弃整个配置文件。先校验 JSON，确认远程 HTTPS 服务器用的键是 httpUrl 而不是 command 加 args 的 stdio 写法，再确认这个条目确实位于 mcpServers 内部。
改了 settings.json 却好像没生效
配置是在启动时读取的。请彻底退出会话再重新启动；正在运行的进程会一直用它启动时构建的那份工具清单，所以文件写对了看起来也像被忽略。
无头机器上完成不了 OAuth
授权页需要浏览器。请在你看得见界面的工作机上完成授权，或者把回调端口通过 SSH 转发出来——没有显示设备的构建机自己完不成握手。
在一个目录能用，换个目录就不行
你有两个配置文件。~/.gemini 下的那个全局生效，仓库内 .gemini 下的那个只对该仓库生效。先弄清 entergram 条目到底写在哪一个里，再去改别的东西。
所有调用都返回 403
先查套餐，再查角色。MCP 访问需要 Pro，而超出个人智能体权限集的任何操作都需要 Entergram 工作区的所有者或管理员身份。
读能用，发送被拒绝
这是个人智能体的边界在起作用，不是偶发错误。发送根本不在它的权限集里，所以重试没有用——需要所有者或管理员授权一个工作区连接器，你再对着它重新走一遍授权流程。

Gemini + Telegram 常见问题

它能配合 Gemini CLI 使用吗？
可以。Gemini CLI 支持 MCP 服务器——在你的 MCP 配置中注册 Entergram MCP 地址并通过 OAuth 授权即可。
这是一个 Telegram 机器人吗？
不是。Entergram 通过托管的 MCP 服务器连接你真实的个人 Telegram 账号，所以 Gemini 处理的是你自己的聊天。
Gemini 能告诉我漏了什么吗？
能。它可以读取你所有已连接的聊天，统计未回复和未读的消息，并突出显示来自客户和潜在客户的那些。
安全吗？
安全。连接采用 OAuth 2.0 并限定权限范围；由你决定 Gemini 能访问什么，并可随时撤销。

其他连接器

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

把 Telegram 接入 Claude Anthropic 把 Telegram 接入 ChatGPT OpenAI 把 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 接入 Cline Cline (VS Code) 把 Telegram 接入 opencode SST

把 Telegram 接入 Gemini

免费开始 查看所有连接器