Product

如何将 Google Gemini 连接到你的 Telegram 对话

Matias 2026年6月4日 5 分钟阅读

要把 Google Gemini 连接到你的 Telegram 对话，只需把 Entergram 托管的 MCP 服务器 https://mcp.entergram.com/mcp 注册到 Gemini CLI，然后在浏览器里登录一次 Entergram。完成后，Gemini 就能通过你真实的个人 Telegram 账号读取聊天、联系人和 CRM 数据，并在你授予的权限范围内执行操作。整个设置只有三步和一小段 JSON，下文会逐一展示。

Gemini CLI 是 Gemini Telegram MCP 页面完整记录的接入方式。其他任何运行 Gemini 模型、支持 MCP 的客户端也可以使用同一个 URL，按该客户端要求的方式注册即可。

开始之前

Pro 工作空间。 API 与 MCP 是 Pro 功能。在较低的套餐上，CLI 仍会列出这个服务器，但每次调用都会被拒绝。这看起来像是配置出错，其实不是。
你的席位上至少连接了一个 Telegram 账号。 个人连接器只能使用你本人在设置 → 账号下列出的 Telegram 账号。
本机要有浏览器，用于首次登录。授权同意页面需要浏览器，所以无界面的服务器需要先在一台工作站上完成授权。

三步把 Gemini 连接到 Entergram

第一步：在 Entergram 中复制你的 MCP URL

进入设置 → 工作空间 → 连接器 → MCP，复制 MCP 服务器 URL。所有客户端用的都是同一个地址：

https://mcp.entergram.com/mcp

第二步：在 Gemini CLI 中注册服务器

在 ~/.gemini/settings.json 的 mcpServers 下添加 Entergram。因为这是一个远程 HTTPS 服务器，所以键名是 httpUrl，而不是命令加参数的写法：

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

主目录下的这个文件会作用于这台机器上的所有项目。如果只想让某一个代码仓库访问 Telegram，就把同样的配置块放到该仓库里的 .gemini/settings.json 中。

第三步：重启 CLI 并授权

CLI 只在启动时读取配置，所以要完全退出当前会话，再重新启动。在弹出的浏览器窗口中登录 Entergram，并授予你希望 Gemini 拥有的权限范围。settings.json 里没有任何凭据：这个文件只说明服务器在哪里，访问权限来自那次 OAuth 登录。

授权完成后，在 CLI 中列出已注册的 MCP 服务器，Entergram 的工具就会出现在 entergram 下面。

选择合适的权限

Gemini 能做什么，取决于你授权的是哪一类客户端，详见 MCP 连接器帮助页面：

	个人代理	工作空间连接器
谁可以创建	任何成员	仅所有者和管理员
覆盖范围	你自己的席位和已连接账号	整个工作空间，在其权限范围内
适合	读取聊天、生成摘要、导出、为你自己的聊天填写自定义字段	发送消息和媒体、编辑消息、写入工单、管理群组

个人代理不能发送 Telegram 消息。 如果读取正常而发送被拒绝，那是权限范围的边界，不是错误。需要由所有者或管理员授权一个工作空间连接器，然后你针对它重新走一遍授权同意流程。无论哪种方式，都只授予任务所需的最小权限集：messages.write 会允许代理以你的身份发送消息。

要撤销访问，请在 Entergram 的设置 → 工作空间 → 连接器 → MCP中撤销该客户端。删除 mcpServers 条目只会让 CLI 停止调用服务器，并不会使授权失效。

连接后可以让 Gemini 做什么

Entergram MCP 服务器连接的是你的个人 Telegram 账号，而不是机器人，所以 Gemini 处理的就是你看到的那些聊天。以下提示在 CLI 中效果很好：

"过去三天里，哪些聊天有尚未回答的问题？"
"列出在我的客户群里、但不在社区群里的联系人。"
"把 CHANGELOG.md 里的发布说明发到 beta 频道。"（需要工作空间连接器）
"那条公告里的版本号我打错了，帮我改正。"（需要工作空间连接器）
"用 TSV 格式给我本周按负责人统计的工单数量。"

CLI 会打印它发起的每一次工具调用，所以你可以先在只读任务上观察它的运作方式，再放心交给它写入操作。

值得了解的限制

消息工具需要明确指定账号。 没有隐式的默认账号，所以脚本应先获取账号列表，再把账号 ID 传下去。
不会主动推送任何内容。 MCP 是请求与响应模式。只有当你或你拥有的定时任务让 Gemini 去查看时，它才会知道有新消息。
没有额外的访问权限。 Gemini 看到的正是你已连接的 Telegram 账号所能看到的内容。你已经退出的群组，它也读不到；你在账号 → 排除聊天中排除的聊天，也不会出现在 MCP 结果里。

故障排查

服务器始终没有出现在 MCP 列表中。 通常是 JSON 格式有误：多一个结尾逗号，CLI 就会丢弃整个设置文件。检查条目是否使用 httpUrl，并且位于 mcpServers 之内。
修改 settings.json 似乎没有效果。 完全退出会话后重新启动。正在运行的进程会一直沿用它启动时建立的工具列表。
在一个目录下能用，换个目录就不行。 你有两个设置文件。检查 entergram 条目是放在 ~/.gemini 里，还是放在某个仓库的 .gemini 文件夹里。
每次调用都返回 403。 先检查套餐（MCP 需要 Pro），再检查角色：超出个人代理权限范围的操作都需要所有者或管理员。