面向 AI 智能体的 Telegram MCP 服务器
Metricgram 将 Telegram Bot API 封装为托管的 MCP 服务器，您的 AI 智能体可以凭借限定权限的密钥读取、发布、管理和运营您的 Telegram 群组，无需维护任何机器人代码。
- 70 多个 Telegram Bot API 方法即用即调的 MCP 工具
- 支持 Claude、ChatGPT、Cursor 和 Codex
- 每次调用都锁定在您自己的群组内
- 分析数据、成员和订阅者信息集成在同一服务器
无需信用卡
2 分钟内完成设置
工作原理
1
添加机器人并连接群组
将 Metricgram 机器人（或您自己的自定义机器人）以管理员身份添加到 Telegram 群组。无需运行服务器、Webhook 或轮询。
2
创建限定权限的 API 密钥
生成 Elite API 密钥，并精确选择智能体可以做什么：从只读访问 Telegram，到发布消息、内容管理和群组设置。
3
接入您的 AI 客户端
在 Claude、Cursor、Codex 或任意 MCP 客户端中粘贴一段配置。您的智能体即可将每个已授权的 Telegram 操作视为工具。
一句指令，真实的 Telegram 操作
智能体自动选择合适的 Bot API 调用，Metricgram 在正确的群组中执行，并返回结构化结果。
metricgram · mcp
您的指令
在 Crypto Talk 发布本周 AMA 公告，静默置顶，开一个「AMA 提问」话题，并给我一个周五过期的邀请链接。
智能体调用
- send_telegram_message(group_id: 42, text: "…", buttons: [{ url: "…" }])
- pin_telegram_message(group_id: 42, action: "pin", disable_notification: true)
- manage_forum_topic(group_id: 42, action: "create", name: "…")
- create_telegram_invite_link(group_id: 42, expire_date: "2026-10-23T23:59:00Z")
连接任意 MCP 客户端
使用托管端点和您的 API 密钥即可。Claude Desktop 用户可通过 mcp-remote 进行桥接。
{
"mcpServers": {
"metricgram": {
"url": "https://metricgram.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
智能体可用的工具
消息和媒体
send_telegram_message
send_telegram_media
send_telegram_poll
edit_telegram_message
delete_telegram_messages
forward_telegram_message
react_to_telegram_message
置顶和论坛话题
pin_telegram_message
manage_forum_topic
createForumTopic
closeGeneralForumTopic
unpinAllForumTopicMessages
内容管理和入群申请
ban_member
restrict_member
promote_member
handle_telegram_join_request
banChatSenderChat
setChatAdministratorCustomTitle
群组设置和邀请链接
update_telegram_chat_settings
create_telegram_invite_link
revokeChatInviteLink
setChatPermissions
setChatStickerSet
分析和社区数据
analytics_overview
active_users
list_members
list_messages
gamification_rankings
get_subscriber_health
任意受支持的 Bot API 方法
telegram_api_methods
telegram_bot_api
get_telegram_chat
get_telegram_chat_member
为 AI 智能体封装好的 Telegram Bot API
为智能体构建 Telegram 集成，通常意味着要托管机器人、处理 Webhook、保管令牌，并为每个接口编写工具。Metricgram 的机器人已经在您的群组中运行，因此您的智能体可以通过一个托管端点直接获得现成的 Bot API MCP 工具。
类型化工具加完整的 Bot API 网关
发送消息、媒体、投票、置顶、话题和邀请链接等常见任务都有专门且描述清晰的工具。其他操作均可通过 telegram_bot_api 完成，它接受官方 Bot API 方法名和参数，支持目录中的任何功能都触手可及。
锁定在您自己的群组内
智能体从不自行选择 chat_id。Metricgram 根据您拥有的群组推导出 chat_id，会核对转发和引用的消息是否来自您的其他群组，并拒绝任何可能触达其他聊天的操作。
适配不同信任级别的权限范围
为调研类智能体授予 telegram:read，为发布消息和话题授予 telegram:write，为封禁和入群申请授予 telegram:moderate，为头衔、权限和邀请链接授予 telegram:admin。密钥可随时撤销。
安全重试，错误清晰
写入类工具支持幂等键，重试调用绝不会重复发布。Telegram 错误和频率限制会以带 retry_after 的结构化结果返回，智能体可以自行处理。
普通机器人没有的上下文
同一服务器还提供 Metricgram 分析数据、成员历史、已采集的消息、游戏化、AI 摘要以及 Stripe 订阅者健康度，让智能体先判断再行动。
Metricgram 与手动管理对比
| Metricgram | 手动 | |
|---|---|---|
| 托管 MCP 端点，无需运行机器人服务器 | ||
| 70 多个 Telegram Bot API 方法作为工具 | ||
| chat_id 锁定在您自己的群组 | ||
| 按权限范围划分、可撤销的 API 密钥 | ||
| 写入类工具支持幂等重试 | ||
| 提供分析数据和成员历史作为上下文 | ||
| 实时聊天数据、管理员和权限信息 | ||
| 支持您自己的自定义机器人 |
常见问题
什么是 Telegram MCP 服务器？
它是一个 Model Context Protocol 服务器，将 Telegram 操作暴露为 AI 智能体可以调用的工具。Metricgram 为您托管这一服务器，背后正是已经在管理您群组的那个机器人。
支持哪些 AI 客户端？
任何支持通过 HTTP 使用 MCP 的客户端，包括 Claude Code、Claude Desktop（通过 mcp-remote）、Cursor、Codex，以及基于 OpenAI 或 Anthropic SDK 构建的自定义智能体。
它覆盖完整的 Telegram Bot API 吗？
它覆盖 70 多个与群组相关的方法，包括消息、媒体、投票、编辑、表情回应、置顶、论坛话题、内容管理、入群申请、群组设置和邀请链接。会影响其他聊天或机器人本身的方法（例如 Webhook、支付或退出群组）被有意排除。
智能体能在我不拥有的群组里发消息吗？
不能。每次调用都绑定到您已连接的某个群组。chat_id 由 Metricgram 设置，转发或回复只能引用您自己的群组。
这是 Telegram 用户 API（MTProto）吗？
不是。它通过您的群组机器人使用官方 Bot API，因此智能体以机器人身份操作，绝不会使用您的个人 Telegram 账号。
哪个套餐包含 MCP 服务器？
MCP 和 API 访问属于 Elite 套餐。14 天免费试用包含 Elite 级别的访问权限，您可以在付费前先接入智能体。
我可以限制智能体的操作范围吗？
可以。每个 API 密钥都有自己的权限范围，您可以分别为只读调研、发布消息、内容管理和群组管理创建不同的密钥。
继续探索
查找实用指南、浏览活跃社区，或发现更多使用 Metricgram 的方式。