Cursor、Zed 与 Windsurf

把 Telegram 接入 Cursor 与各类 IDE

在 Cursor、Zed 或 Windsurf 中把 Entergram 添加为 MCP 服务器，从编辑器里直达你真实的 Telegram 账号——不打断心流就能查看漏看的消息和等你的客户。

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

Cursor、Zed 和 Windsurf 都通过 mcp.json 配置支持 MCP 服务器。Entergram 把你的个人 Telegram 账号封装成托管的 MCP 服务器，让编辑器里的 AI 在 OAuth 安全授权下操作你真实的聊天记录——无需机器人、没有 API 密钥。

可直接粘贴的配置

mcp.json (Cursor / Zed / Windsurf)

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

在编辑器里问问你的 Telegram

连上你的个人账号后，IDE 里的 AI 不用切换应用就能查看 Telegram。试试：

「我埋头写代码的时候，有漏看哪些客户消息吗？」
「我有哪些对话忘了回复？」
「这周有多少潜在客户变冷了？」
「总结一下今天的客户反馈。」
「给最后一条没回复的消息起草一条回复，拿给我看。」

三步连接你的编辑器

适用于 Cursor、Zed 和 Windsurf。

01
在 Entergram 中复制你的 MCP 地址
在 Entergram 中打开 Settings → Workspace → Connectors → MCP，复制你的 MCP 服务器地址。
02
把服务器添加到 mcp.json
在你编辑器的 MCP 设置（mcp.json）中，注册 Entergram MCP 地址：https://mcp.entergram.com/mcp。
03
授权后即可使用
点击 Connect，用你的 Entergram 账号登录，然后点击 Allow access。你编辑器的 AI 助手即可查询并操作你的 Telegram 账号。

三个编辑器，三份配置文件

Cursor —— ~/.cursor/mcp.json

Cursor 从 ~/.cursor/mcp.json 加载服务器，对你打开的每个项目都生效；如果你只想让某个代码库用到它，就把 .cursor/mcp.json 提交进那个仓库。菜单路径是 Cursor Settings → MCP & Integrations → New MCP server，走这条路它会替你写同一个文件。项目级条目在智能体第一次要用它时会请求信任，所以拉下仓库的队友仍然要做一次明确的选择。

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

Zed —— ~/.config/zed/settings.json

Zed 把 MCP 服务器放在主设置文件的 context_servers 块里，而不是 mcpServers 块——就这一个词，让大多数人的第一次尝试失败：把 Cursor 的片段原样粘过去什么都不会加载，而且不会有任何报错解释原因。Agent Panel 的设置页里有一个 Add Custom Server 按钮，如果你不想手写 JSON，它会写出正确的结构。

{
  "context_servers": {
    "entergram": {
      "source": "custom",
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

Windsurf —— ~/.codeium/windsurf/mcp_config.json

Windsurf 读的是 ~/.codeium 下的一个专用文件，而不是你可能以为的编辑器设置；而且 Cascade 是按需重新扫描它的：保存之后要在 Cascade 里打开 MCP 面板点刷新，否则这些工具会一直不可见，直到下次重启。JSON 结构本身与 Cursor 一致，所以条目可以在两者之间直接搬。

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

从堆栈跟踪，到发这份报告的人

你的编辑器早就握着代码。它从来没握着的是一个 bug 的另一半——谁踩到了、有多少人踩到、以及支持团队已经答应过他们什么。下面每个问题都会展开成一小串具名的工具调用，在智能体面板里滚过，而你继续读你的文件。

你的提问

「有人发来了账单页面的一个 TypeError。找到那条消息，告诉我是谁报的。」

调用的工具

entergram_list_messagesentergram_get_contactentergram_list_chat_tickets

你会得到

智能体在近期历史里扫描这段报错文本，把发送者解析成一条联系人记录，再检查这个会话是否已经产生过工单。你会拿到报告者的姓名、他的原话，以及支持是否已经登记过的明确答案——而这时你连仓库里的一个文件都还没打开。

你的提问

「这个今天值得修吗？统计一下有多少人报过同一件事。」

调用的工具

entergram_list_workspace_chatsentergram_list_messagesentergram_get_chat

你会得到

用数量而不是直觉来定优先级。它扫的是共享的工作区视图而不是单个会话，按你描述的症状匹配，报告有多少个不同会话提到过它，以及第一次是什么时候出现的。一个月两例和两天九例，读起来完全是两回事。

你的提问

「把客户贴的那份日志拉出来，我要在本地复现。」

调用的工具

entergram_list_chatsentergram_list_messagesentergram_get_message

你会得到

智能体定位到会话，回溯到承载那段内容的消息，并取回完整正文而不是被截断的预览。接下来你可以让它把日志变成一个失败用例，直接写进你已经打开的那个文件里——这一步才是真正比在第二块屏幕上读 Telegram 更快的部分。

你的提问

「把这些复现步骤贴到这个 bug 对应的工单上。」

调用的工具

entergram_list_ticketsentergram_get_ticketentergram_create_ticket_comment

你会得到

你的笔记落在支持团队会去找的地方，而且是在上下文还在你脑子里的时候写的。这条评论是挂在工单上而不是发给客户的，所以工程师可以直白地讲清成因，不用先有人把它翻译成一版得体的说法。

你的提问

「提这个问题的人用的是哪个套餐？我们之前跟他说过什么？」

调用的工具

entergram_list_custom_columnsentergram_get_chat_custom_fieldsentergram_list_chat_comments

你会得到

它读取你的字段结构，取出该聊天上设置的值，然后再读同事留在上面的内部备注。答案是一段话：他的档位、你如果有记录的话还有他的续约状态，以及某人上周在电话里做出的、从没有人告诉过你的承诺。

你的提问

「修复已合并。通知这两位报告者，然后把工单关掉。」

调用的工具

entergram_list_accountsentergram_send_messageentergram_update_ticket

你会得到

所有人都会跳过的那一步。它先确定每个会话归属于哪个已连接账号，为每位报告者写一条简短通知交给你确认，等消息发出后再把工单置为已关闭。从发布到告知受影响客户的这段闭环，从一条待办变成一次提问。

你的编辑器能用 Telegram 做什么

—从编辑器查询 Telegram 聊天
—在你工作时浮现漏看的消息
—就地查询联系人和 CRM 字段
—经你确认后发送消息和回复
—量化错过的机会和反馈
—基于真实的 Telegram 数据搭建内部工具

编辑器能拿到的 70 个工具

Cursor、Zed 和 Windsurf 拿到的是同一份清单——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

配置文件里放了什么，又没放什么

你粘进 mcp.json 的条目只包含一样东西：一个地址。没有令牌、没有手机号、没有 API key——这正是项目级的 .cursor/mcp.json 可以安全地和代码一起提交的原因。授权本身是在浏览器里完成的，属于你个人而不是这个仓库，并由编辑器保存。要收回，请在 Entergram 的 Settings → Workspace → Connectors 下的 MCP 页面撤销该连接；编辑器手里那个令牌会在下一次调用时失效。访问级别有两种，且不可互换。

个人智能体: 任何成员都能给自己开一个，而在开发笔记本上，这通常就是合适的上限。它可以读取工作区、账号、联系人、聊天、消息和工单，写入仅限于你自己已连接账号所属聊天的自定义字段。持有它的智能体可以把一个 bug 查个底朝天，却没法给报告者发一条消息。
工作区连接器: 仅限所有者和管理员。它持有完整权限集——发送、在任意聊天上写自定义字段、群组管理——而且是与团队共享的，不归某一位开发者所有。当编辑器是在代表公司干活而不是代表你干活时，才用它。
撤销: 两端都能做，且立即生效。从 mcp.json 里删掉服务器，编辑器就不再发问；在 Entergram 里撤销，服务器就不再作答。当笔记本已经不在你手上时，重要的是后者。

编辑器集成的边界

在把它变成习惯之前，这些值得先知道。

MCP 访问位于 Pro 套餐，编辑器这一侧改变不了这一点——档位不够的工作区可以注册服务器、完成登录，然后依然从调用里拿不回任何有用的东西。
没有东西会自己送上门。编辑器只在你发起的那一轮对话里去查询 Entergram，所以你在重构途中收到的消息会安静地等着，直到你下次问起。
配置是按机器来的。mcp.json 不会跟着你的编辑器账号走，OAuth 授权也不会——第二台笔记本意味着第二份文件和第二次授权。
工具输出留在对话里。智能体可以把客户的日志引用进一条评论或一份测试夹具，但只有你要求时它才写你的文件，反方向则永远不会。
每次发送都要点名一个账号。account_id 是必填参数而不是默认值，所以一个走错分支的智能体，也没法顺势即兴给你整个通讯录发消息。
连接器看到的东西和你的 Telegram 账号完全一致。你从没被拉进过的群，在编辑器里同样看不到，提示词怎么写都一样。

编辑器看不到 Entergram 时

Cursor 的 MCP 面板里那个服务器显示红点

Cursor 缓存的是上一次握手成功时的工具清单。在 Cursor Settings → MCP & Integrations 里把服务器关掉再打开；如果红点还在，重新加载窗口——智能体是在窗口启动时读清单的，不是在你改文件时。

Zed 完全无视这个条目

你八成写成了 mcpServers。Zed 的键是 context_servers，而无法识别的顶层键会被静默丢弃，不会报错。改正键名，保存，重启 Zed。

Windsurf 保存后看不到 Entergram 工具

先确认你改的是 ~/.codeium/windsurf/mcp_config.json 而不是设置界面，然后在 Cascade 里打开 MCP 面板并刷新。Windsurf 只在被要求时才重新读取那个文件。

授权页打开了，编辑器却仍然显示未连接

授权是在你操作系统的默认浏览器里完成的。请在那个浏览器里用已登录 Entergram 的同一个配置文件走完登录，然后回来重新触发一次连接动作。

智能体回答了 Telegram 相关问题，却一个调用都没发

注册的服务器太多，工具清单在送到模型之前被裁剪了。把这次任务用不到的 MCP 服务器禁用掉，并在提示词里点名 Entergram，让选择变得没有歧义。

调用返回 403

按顺序查两件事。先看角色：工作区连接器需要所有者或管理员，其余人用个人智能体。再看套餐：MCP 访问位于 Pro，档位不够会在这里失败，而不是在连接时失败。

Cursor / Zed / Windsurf + Telegram 常见问题

支持哪些编辑器？

任何通过 mcp.json 支持 MCP 的编辑器都行——包括 Cursor、Zed 和 Windsurf。注册 Entergram MCP 地址并通过 OAuth 授权即可。

这是一个 Telegram 机器人吗？

不是。Entergram 通过托管的 MCP 服务器连接你真实的个人 Telegram 账号。

它能告诉我写代码时漏了什么吗？

能。问你编辑器里的 AI，它会读取你的聊天、统计未回复的消息，并标出来自客户的那些。

安全吗？

安全。OAuth 2.0 加上限定的权限范围；你的凭证绝不会到达编辑器厂商手中，访问也可撤销。

其他连接器

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

把 Telegram 接入 Claude Anthropic 把 Telegram 接入 ChatGPT OpenAI 把 Telegram 接入 Gemini Google 把 Telegram 接入 n8n n8n.io 把 Telegram 接入 Make.com Celonis 把 Telegram 接入 Perplexity Perplexity AI 把 Telegram 接入 Goose Block 把 Telegram 接入 Raycast Raycast 把 Telegram 接入 Cline Cline (VS Code) 把 Telegram 接入 opencode SST