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 密钥。

可直接粘贴的配置

Raycast → Manage MCP Servers → Add

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

向 Raycast 询问你的 Telegram

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

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

三步接入 Raycast

适用于 macOS 上的 Raycast AI。

01
在 Entergram 中复制你的 MCP 地址
在 Entergram 中打开 Settings → Workspace → Connectors → MCP，复制你的 MCP 服务器地址。
02
在 Raycast 中添加服务器
运行 Raycast 的「Manage MCP Servers」命令，用 Entergram 地址添加一个服务器：https://mcp.entergram.com/mcp。
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 上配同样的东西时这一点很有用：粘上条目，登录一次，所有已保存的命令在那边都能直接用，不必重建。当某个命令悄悄看不到你的工作区时，也该来这里看看——列表会显示这个服务器是否还处于启用状态。

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

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

你的提问

「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 的，是完整智能体拿到的那同一份 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

一次击键被允许做什么

你只授权一次，在 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，访问也可撤销。

其他连接器

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

把 Telegram 接入 Claude Anthropic 把 Telegram 接入 ChatGPT OpenAI 把 Telegram 接入 Gemini Google 把 Telegram 接入 n8n n8n.io 把 Telegram 接入 Make.com Celonis 把 Telegram 接入 Cursor 与各类 IDE Cursor, Zed, Windsurf 把 Telegram 接入 Perplexity Perplexity AI 把 Telegram 接入 Goose Block 把 Telegram 接入 Cline Cline (VS Code) 把 Telegram 接入 opencode SST