Skip to main content
← 所有 Telegram MCP 连接器

Raycast · MCP

把 Telegram 接入 Raycast

在 Raycast 中把 Entergram 添加为 MCP 服务器,一个快捷键就能触达你真实的 Telegram 账号,无需打开 Telegram,就能查看漏看的消息和苦等的客户。

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

Raycast 通过其「Manage MCP Servers」命令支持 MCP 服务器。Entergram 把你的个人 Telegram 账号暴露为一个托管的 MCP 服务器,因此 Raycast AI 能在完整的 OAuth 安全保障下操作你真实的聊天,无需机器人,也无需 API 密钥。

可直接粘贴的配置

可直接粘贴的配置
{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

三步接入 Raycast

适用于 macOS 上的 Raycast AI。

  1. 01

    在 Entergram 中复制你的 MCP 地址

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

  2. 02

    在 Raycast 中添加服务器

    运行 Raycast 的「Manage MCP Servers」命令,用 Entergram 地址添加一个服务器:https://mcp.entergram.com/mcp。

  3. 03

    授权并使用

    点击 Connect,用你的 Entergram 账号登录,然后点击 Allow access。随后 Raycast AI 就能在 Mac 上的任意位置查询你的 Telegram 账号并采取行动。

触发它的三种方式

Raycast AI Chat

默认路径,也是应该先从这里开始的方式。按下 Raycast 快捷键,打开 AI Chat,在提示词里提到 Entergram 服务器好让它的工具进入可用状态,然后在同一个窗口里读答案。屏幕上别的东西都不用动,这就是全部意义所在。

绑一个专属按键的 AI Command

把你一天要问二十遍的那个问题(现在有什么在等我)存成一个 AI Command,并给它绑一个按键。在任何应用里一次击键就能拿到答案。再加一个占位参数,同一个命令就能接受你在调用时现敲进去的客户名。

Manage MCP Servers

Raycast 把服务器列表放在 Manage MCP Servers 命令后面,每个条目都是纯 JSON。当你要在第二台 Mac 上配同样的东西时这一点很有用:粘上条目,登录一次,所有已保存的命令在那边都能直接用,不必重建。当某个命令悄悄看不到你的工作区时,也该来这里看看,列表会显示这个服务器是否还处于启用状态。

向 Raycast 询问你的 Telegram

连上你的个人账号后,一个快捷键 Raycast AI 就能查看 Telegram。试试:

  • 「过去一小时我漏看了哪些客户消息吗?」
  • 「哪些对话我忘了回复?」
  • 「这周有多少潜在客户变冷了?」
  • 「总结一下今天的客户反馈。」
  • 「为我最后一条还没回的消息草拟一条回复。」

话说到一半就能顺手打出去的问题

这里不是跑四十步长任务的地方,而是在别人把话问完之前的两秒里拿到一个事实的地方。下面每一项都是一次击键、两三次工具调用,以及一个短到能站着读完的答案,工具链之所以值得写出来,只是为了解释回复为什么能那么快。

你的提问

「Marco 最后跟我说的是什么,我回了没有?」

调用的工具

entergram_list_chatsentergram_list_messages

你会得到

两次调用,一行回复:那条消息、它的时间戳,以及会话里最后一轮是他还是你。这个查询值得单独绑一个键,因为你需要它的时候对方话还没说完,而另一个选择是当着他的面打开应用往上翻。

你的提问

「Northwind 现在有未关闭的工单吗?」

调用的工具

entergram_list_chatsentergram_list_chat_tickets

你会得到

它解析出该客户的聊天,取出挂在上面的工单,并报告所有未关闭项的状态和优先级。够你在通话中当场回答客户,也够你判断自己是不是正要重复提交一个同事一小时前刚开的工单。

你的提问

「跟站会群说一声我还有五分钟到。」

调用的工具

entergram_list_accountsentergram_list_chatsentergram_send_message

你会得到

大多数人会放到快捷键上的那一个写操作。它会先弄清那个群归属于哪个已连接账号再发送,这样消息就是以你的身份发出的,而不是以碰巧排在最前面的那个账号。这一条需要工作区连接器,个人智能体读这个群没问题,但会停在发送这一步。

你的提问

「这个联系人我们记录了什么,套餐、负责人、续约日期?」

调用的工具

entergram_list_contactsentergram_get_chat_custom_fields

你会得到

名字解析成一位联系人,然后挂在他聊天上的那些 CRM 列会返回来,空值已被剔除。在通话开始前十秒敲下它,就是「带着上下文开场」和「张口去问一个早就写下来的答案」之间的差别。

你的提问

「412 号工单归谁,他上一次动它是什么时候?」

调用的工具

entergram_get_ticketentergram_list_members

你会得到

工单记录里带的是负责人 ID;成员查询把它变成你认得的名字。负责人、状态和最后更新时间在一行里返回,而这恰好就是你原本要发到团队频道、然后干等回复的那条消息的全部内容。一天问它两次,你就替团队里的另一个人消掉了一次小而反复的打扰。

你的提问

「给发布频道的最后一条消息点个赞。」

调用的工具

entergram_list_chatsentergram_list_messagesentergram_set_message_reactions

你会得到

三次调用的确认动作,比切窗口还省时间。它找到频道,从历史里取出最新一条消息的 ID,设置回应。当你想让一个群知道你看到了、而手头的事又不想放下时,这正好合适。

Raycast 能用你的 Telegram 做什么

  • -在 macOS 上任意位置查询 Telegram 聊天
  • -即时浮现漏看的消息
  • -查询联系人和 CRM 字段
  • -经你确认后发送消息和回复
  • -量化错过的机会和反馈
  • -一个快捷键触发 Telegram 操作

一次击键被允许做什么

你只授权一次,在 Raycast 替你打开的浏览器窗口里完成,令牌保存在那台 Mac 上。Entergram 不会把你的 Telegram 手机号或会话凭证交给 Raycast,而且这一切都不依赖 Telegram 桌面客户端是否安装、是否启动、甚至是否登录。启动器快捷键按定义就很容易误触,所以除非某个具体命令确实需要更多,否则更窄的那个访问级别才是理智的默认值。

个人智能体
几乎每一套单人 Raycast 配置都应该停在这一档。任何成员都能创建,读的范围相当宽裕(聊天、消息历史、联系人、工单以及围绕它们的工作区),而它持有的唯一写权限,是你自己聊天上的自定义字段。误触的快捷键只会查一下然后停住,它没有任何通往客户的路径。
工作区连接器
一旦你想要「快速回一句」这类命令,就必须用它;它同时还解锁在任意聊天上写字段以及群组管理。由所有者和管理员创建。如果这是一台会带出门的笔记本,请拿这份权限和触发它的容易程度掂量一下。
从一台共用的 Mac 上撤销
从 Raycast 的列表里删掉服务器,只能停掉那台机器。如果这台机器已经不在你手上,请改为在 Entergram 的 Settings → Workspace → Connectors → MCP 里撤销令牌,无论本地还配着什么,那都会终止访问。

启动器不会替你做的事

Raycast 是刻意做得浅的,而下面这些边界,你在靠快捷键过日子的第一周内就会全部撞上。

  • MCP 工具调用需要 Entergram 这边的 Pro 工作区。任何套餐都能完成连接授权;但只有 Pro 才拿得回答案。
  • Raycast AI 属于 Raycast 的付费档。MCP 服务器是由 Raycast 的 AI 功能驱动的,所以在你排查工具为什么不触发之前,先确认你的 Raycast 套餐包含它们。
  • 仅限 macOS。Windows 和 Linux 上没有可以配置的 Raycast 客户端,MCP 地址到哪儿都一样,只是你会用另一个应用去指向它。
  • 后台不做任何轮询。连接器是有问才答,绝不反过来:没有推送通知,没有菜单栏红点,客户在你开会时写来消息也不会有人提醒你。
  • 问题一宽就不快了。任何覆盖整个工作区的「有什么紧急的」都要走一大堆聊天,耗时也就随之而来。点名一个人、一个群或一个时间窗,它才能保持利索。
  • 发送类命令在个人智能体上会失败。那套权限止步于出站消息,所以「从启动器回一句」的快捷键依赖工作区连接器,而它需要所有者或管理员权限。

Raycast 连接器的修复办法

Entergram 的工具从来没被用上
Raycast 只会去访问提示词真正提到的服务器。请在 AI Chat 的消息里点名 Entergram 服务器,或者把这个指代写死进保存好的 AI Command,否则模型会凭常识作答,从头到尾都不碰你的工作区。
Raycast 里到处都找不到 AI 相关选项
MCP 服务器是通过 Raycast 的 AI 功能运行的,而它们位于付费档。如果你安装的版本里没有 AI Chat 和 AI Commands,那是 Raycast 订阅的问题,而不是 Entergram 这边要修的东西。
更新之后服务器从列表里消失了
重新打开 Manage MCP Servers,重新添加条目并再登录一次。把那段 JSON 条目存在手边,这件事就变成十秒钟的小事,而且它和你配第二台机器时要粘的是同一段。
快捷键有回应,但很慢
提示词范围太宽了。点名一个聊天、一位联系人或一天的问题两三次调用就能解决,而一个「把所有东西都查一遍」的问题会遍历整个工作区。把宽泛的那个版本拆成单独的命令,按键上只留快的那个。
读没问题,发送却报错
你是以个人智能体身份连接的,它的权限止步于出站消息。发送类命令依赖的工作区连接器,必须由拥有所有者或管理员权限的人创建,无论如何,所有只读命令都照常可用。
它又要我重新登录
令牌不会永久有效。从 Manage MCP Servers 触发一次连接,再确认一遍授权页,所有保存好的命令都会恢复工作,一个都不用改。

Raycast + Telegram 常见问题

我要怎么往 Raycast 添加一个 MCP 服务器?
使用 Raycast 的「Manage MCP Servers」命令,添加 Entergram MCP 地址,并通过 OAuth 授权即可。
这是一个 Telegram 机器人吗?
不是。Entergram 通过托管的 MCP 服务器连接你真实的个人 Telegram 账号。
安全吗?
安全。OAuth 2.0 加上限定的权限范围;你的凭证留在 Entergram,访问也可撤销。

把 Telegram 接入 Raycast