如何通过 MCP 将 Raycast 连接到 Telegram

Raycast 是一款以键盘为先的启动器，已悄然成为众多 Mac 高级用户的指挥中心。你按下一个热键，输入几个字符，就能进行搜索、计算、运行脚本，或与 Raycast AI 对话——全程无需双手离开键盘，也无需切换应用。借助 MCP 支持，Raycast AI 如今可以触达外部工具，而这正是 Entergram 的用武之地。Entergram 的 Telegram MCP 服务器通过 Model Context Protocol 将你的个人 Telegram 账户（而非机器人）连接到 Raycast，因此你可以用平时处理一切事务的同一次按键，来询问你真实的 Telegram 聊天并对其采取行动。

本指南是我们将任意 AI 工具连接到 Telegram MCP 中心的一部分，而专门的 Raycast Telegram MCP 页面会完整介绍该连接器。要了解更宏观的图景，Telegram MCP 中心解释了 Entergram 如何将 Telegram 暴露给每一个兼容 MCP 的客户端。

MCP 是一项开放标准，让 Raycast AI 能够按需加载外部能力。Raycast 无需构建一次性的 Telegram 集成，只需指向单一的 MCP 端点——https://mcp.entergram.com/mcp——并自动发现可用的工具。连接成功后，Raycast AI 就可以：

• 列出并读取聊天——来自你已连接账户的私信、群组和频道。
• 查询联系人与自定义字段——阶段、负责人、标签，以及某条聊天上的任何结构化 CRM 数据。
• 创建并更新工单——在你发现需要跟进的那一刻立即记录下来。
• 发送消息与群发——快速发出一条回复或一条模板化群发。

这是你真实的 Telegram 账户，通过一个带权限控制的 CRM 层暴露出来，而不是功能受限的 Bot API。Raycast 看到的聊天与你看到的完全一致，并限定在你所允许的范围之内。

Raycast 的超能力在于访问速度。它存在的全部意义，就是消除打开应用、找到正确窗口、四处点击所带来的摩擦。而对许多人来说，Telegram 恰恰就是这样一种摩擦：一个塞满客户、线索和群组的繁忙收件箱，它需要持续的关注，并把你拖出专注状态。

把 Telegram 放在一次 Raycast 按键之后，则彻底扭转了这种局面。你不再"只是为了看看"而打开 Telegram，而是直接向 Raycast AI 提出一个问题，并得到一个直接的答案：

• "过去一小时内有谁给我发了消息，而我还没回复？"
• "现在有哪些客户正在等我？"
• "本周 Demo 阶段里有没有人变得沉默了？"

你继续做手头正在做的事，在一个面板里得到答案，只有在确有需要时才采取行动。对于整天都生活在 Raycast 里的人来说，这是一个 Telegram 助手所能栖身的最自然的地方——没有新窗口，没有上下文切换，也没有无尽的刷屏。

在你的 Entergram 工作区中，打开 Settings → Developer，点击 Create new OAuth client，并选择 Custom 预设。请审慎地选择权限范围。由于 Raycast 常常是一种快速、临时查看事物的方式，许多人会先以只读方式启用它（chats.read、contacts.read、custom_fields.read），只有在想直接从某个 Raycast 命令发送回复或开工单时，才会添加诸如 chats.write 之类的写入范围。最小权限原则能让暴露面保持很小。

你的 MCP 服务器 URL 为：

https://mcp.entergram.com/mcp

打开 Raycast 设置，进入 AI 部分，Raycast 在那里管理它的 MCP 服务器。新增一个指向上面端点的服务器，并提供你刚刚创建的 OAuth 客户端的凭据，以便 Raycast 进行身份验证。Raycast Telegram MCP 页面提供了需要填入的确切值。Raycast AI 会加载 Entergram 工具，并将它们提供给 AI Chat 和 AI Commands 使用。

请注意，Raycast AI 功能需要 Raycast Pro 套餐；MCP 服务器在此基础之上运行。一旦添加了服务器，你无需为每个命令单独配置任何内容——只要你与 Raycast AI 对话，这些工具便随时可用。

Raycast 第一次连接时，请在 Entergram 的授权界面上批准请求，该界面会列出正在授予的具体权限。点击 Allow access。

现在，你的 Telegram 工具只需一次按键即可触达，而你随时都可以从 Settings → Developer 中即时撤销它们。

由于 Raycast 专为快速调用而打造，这里最好的 Telegram 工作流都是简短的、以答案为形态的：

• "现在有多少人正在等我回复？" 在你决定是否要打开 Telegram 之前，做一次一行字的状态检查。
• "总结一下我过去两小时内的未读聊天。" 无需滚动即可完成分流。
• "找到与 Acme 的那条聊天，告诉我这笔交易进展到哪了。" Raycast 读取聊天和 CRM 字段，用一句话告诉你当前的状态。
• "回复 Jordan 的最后一条消息，告诉他发票已经发出。" 在已授予写入范围的情况下，Raycast 会草拟并发送，全程你都无需打开应用。
• "在那条关于退款投诉的聊天上开一个高优先级工单。" 在你注意到的那一刻立即记录下需要跟进的事项。

以上每一项都是针对你工作区的一次真实 MCP 工具调用，并在 Raycast 内部返回结果。其价值不在于深度——而在于，答案会在你打出问题所需的那两秒钟内到达，而不是在你打开 Telegram、并因此打断思路所需的那两分钟里到达。

把你真实的 Telegram 账户连接到一个你每天会触发几十次的工具，理应与对待任何其他集成一样谨慎。访问由 **OAuth 权限范围（scopes）**控制，因此你可以精确决定 Raycast 可以读取和写入哪些内容。对于一个快速查看类的工具来说，只读设置是一个很棒的默认选择；只有在你真的想从 Raycast 发送内容时，才授予写入范围。每个用户只有一个 OAuth 客户端，可从 Settings → Developer 中即时撤销。

Entergram 在服务器端中转你的 Telegram 会话，并以加密方式存储凭据，因此 Raycast 通过 CRM 层来工作，而不是持有你原始的 Telegram 登录凭据。消息内容不会被保留用于训练，而每一次写入操作都会记录在工作区活动日志中，附带操作者和时间戳。如果你哪天不再使用 Raycast，撤销它的 OAuth 客户端就会一次性地移除它在各处的访问权限。

一旦该连接在 AI Chat 中可用，自然的下一步就是把你反复使用的提示词捕获为 AI Commands。将"总结我过去两小时内的未读 Telegram 聊天"保存为一个绑定了热键的命令，你的晨间分流就变成了一次按键。对"列出正在等待回复的客户"或"显示本周变得沉默的交易"也照此办理。由于 AI Commands 可以接受选中的文本和参数，你还可以构建诸如"为选中的文本草拟一条 Telegram 回复"这样的命令，让它在 macOS 上的任何地方都能工作。这些 Telegram 工具会一直对每个命令可用，无需额外设置，因此每个新命令都只是一段你写一次、却能永远触发的提示词——这正是把 Raycast 理念应用到你最繁忙的收件箱上。一周下来，你保存的那寥寥几个命令，会悄悄取代你过去打开 Telegram 的大部分理由。

如果你的 Entergram 套餐包含 API 访问权限，那么 MCP 连接器已经就绪。立即创建你的连接，在 Raycast Telegram MCP 页面上跟随完整的操作演示，或在连接任意 AI 中心中浏览每一个受支持的客户端。关于底层的设置细节——OAuth 客户端、权限范围和故障排查——请参阅分步 MCP 指南。Raycast 为你提供触达工具的最快方式；Entergram 让你真实的 Telegram CRM 成为其中之一，于是，查看你那个最需要操心的收件箱，终于只需付出一次按键，而不是你的专注力。