Telegram MCP by usefulapi

usefulapi 的 Telegram MCP

通过 Claude、Cursor 或任何 MCP 客户端使用你的 Telegram 账号。读取聊天、成员和机器人管理员信息，并通过机器人发送、编辑和删除消息。托管服务，无需本地安装：使用你自己的凭据连接。

在线端点： https://telegram.usefulapi.io/mcp · 主页： https://usefulapi.io

连接

• Claude（claude.ai、Desktop）：打开 Customize → Connectors，点击 + Add → Add custom connector，然后粘贴 https://telegram.usefulapi.io/mcp。
• Claude Code： 运行 claude mcp add --transport http telegram https://telegram.usefulapi.io/mcp，然后运行 /mcp 登录。
• VS Code： 添加到 VS Code。
• Cursor 和其他客户端： 将 URL 添加为远程 MCP 服务：

{
  "mcpServers": {
    "telegram": {
      "url": "https://telegram.usefulapi.io/mcp"
    }
  }
}

只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥：服务会通过 OAuth 为你登录，登录页面会要求你提供 Telegram 凭据。

分步设置指南、凭据查找方式和常见问题解答：https://usefulapi.io/telegram/

首次连接时，你需要提供Telegram 机器人令牌（在 Telegram 中打开 @BotFather，发送 /newbot 或 /mybots，然后选择 API Token）。服务会验证令牌并按用户保存。配置文件中无需填写任何密钥。

工具

工具	类型	功能
telegram_get_me	read	获取机器人信息
telegram_get_chat	read	获取聊天信息
telegram_get_chat_member_count	read	统计聊天成员人数
telegram_get_chat_member	read	获取聊天成员信息
telegram_get_chat_administrators	read	列出聊天管理员
telegram_get_updates	write	获取待处理的更新
telegram_send_message	write	发送消息
telegram_edit_message_text	write	编辑消息
telegram_delete_message	write	删除消息
telegram_usage_status	meta	使用情况状态（免费套餐用量计数）
telegram_request_feature	meta	请求添加缺失功能
telegram_upgrade	meta	升级到 Pro（无限*）
telegram_cancel_subscription	meta	取消 Pro 订阅

read 工具为只读工具；write 工具会修改数据（客户端应在执行前确认）；meta 工具用于报告使用情况、管理订阅或发送功能请求。

定价

套餐	价格	限制
Free	$0	每月 50 次工具调用
Pro（按用户计费）	$9/mo 或 $90/yr（免费 2 个月）	无限*

*Pro 在此服务上的公平使用上限为每月 10,000 次工具调用。如需更多，请发送邮件至 [email protected]。

Pro 仅适用于此服务。使用 telegram_upgrade 订阅（该工具会返回 Stripe Checkout 链接）。可随时使用 telegram_cancel_subscription 取消：Pro 将持续到已付费周期结束，当前周期不予退款；在此之前运行 telegram_upgrade 可撤销取消操作。也可以发送邮件至 [email protected]。

许可证

MIT — 请参阅 LICENSE。仅提供文档；服务由托管方运行。