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

可直接粘贴的配置

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

三步连接你的编辑器

适用于 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"
    }
  }
}

在编辑器里问问你的 Telegram

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

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

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

你的编辑器早就握着代码。它从来没握着的是一个 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 数据搭建内部工具

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

你粘进 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 Salesforce Telegram MCP Salesforce HubSpot Telegram MCP: 将聊天转化为客户关系管理工作 HubSpot Microsoft Dynamics 365 Telegram MCP Microsoft Zoho CRM Telegram MCP: 将聊天转化为 CRM 工作 Zoho Pipedrive Telegram MCP Pipedrive Zendesk Telegram MCP: 将聊天转化为已解决的工单 Zendesk Intercom Telegram MCP: 将聊天转化为已解决的工单 Intercom Freshdesk Telegram MCP: 将聊天转化为已解决的工单 Freshworks Jira Service Management Telegram MCP: 将聊天转化为已解决的工单 Atlassian ServiceNow Telegram MCP: 将聊天转化为已解决的工单 ServiceNow