把 Telegram 接入 Gemini

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，所以运行客户端的人是以自己的身份授权，而不是继承别人的授权。

显示全部 78 个工具（共 9 组） →

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

服务器始终不出现在 MCP 列表里

几乎总是 JSON 写坏了，一个多余的逗号就会让 CLI 悄悄丢弃整个配置文件。先校验 JSON，确认远程 HTTPS 服务器用的键是 httpUrl 而不是 command 加 args 的 stdio 写法，再确认这个条目确实位于 mcpServers 内部。

改了 settings.json 却好像没生效

配置是在启动时读取的。请彻底退出会话再重新启动；正在运行的进程会一直用它启动时构建的那份工具清单，所以文件写对了看起来也像被忽略。

无头机器上完成不了 OAuth

授权页需要浏览器。请在你看得见界面的工作机上完成授权，或者把回调端口通过 SSH 转发出来，没有显示设备的构建机自己完不成握手。

在一个目录能用，换个目录就不行

你有两个配置文件。~/.gemini 下的那个全局生效，仓库内 .gemini 下的那个只对该仓库生效。先弄清 entergram 条目到底写在哪一个里，再去改别的东西。

所有调用都返回 403

先查套餐，再查角色。MCP 访问需要 Pro，而超出个人智能体权限集的任何操作都需要 Entergram 工作区的所有者或管理员身份。

读能用，发送被拒绝

这是个人智能体的边界在起作用，不是偶发错误。发送根本不在它的权限集里，所以重试没有用，需要所有者或管理员授权一个工作区连接器，你再对着它重新走一遍授权流程。