Máy chủ MCP Telegram cho AI agent
Metricgram đóng gói Telegram Bot API thành một máy chủ MCP được lưu trữ sẵn, để AI agent của bạn có thể đọc, đăng bài, kiểm duyệt và quản trị nhóm Telegram bằng khóa có phạm vi quyền rõ ràng, không cần duy trì mã bot nào.
- Hơn 70 phương thức Telegram Bot API dưới dạng công cụ MCP
- Hoạt động với Claude, ChatGPT, Cursor và Codex
- Mọi lệnh gọi đều bị khóa trong nhóm của chính bạn
- Phân tích, thành viên và người đăng ký trong cùng một máy chủ
Không cần thẻ tín dụng
Thiết lập trong 2 phút
Cách thức hoạt động
1
Thêm bot và kết nối nhóm
Thêm bot Metricgram (hoặc bot tùy chỉnh của bạn) vào nhóm Telegram với quyền quản trị viên. Không cần vận hành máy chủ, webhook hay polling.
2
Tạo khóa API có phạm vi quyền
Tạo khóa API Elite và chọn chính xác những gì agent được phép làm, từ quyền chỉ đọc Telegram đến đăng bài, kiểm duyệt và cài đặt nhóm.
3
Kết nối với client AI của bạn
Dán một khối cấu hình vào Claude, Cursor, Codex hoặc bất kỳ client MCP nào. Từ đó, agent sẽ thấy mọi thao tác Telegram được cho phép dưới dạng công cụ.
Một câu lệnh, thao tác Telegram thật
Agent chọn đúng lệnh gọi Bot API, Metricgram thực thi trong đúng nhóm và trả về kết quả có cấu trúc.
metricgram · mcp
Bạn yêu cầu
Đăng thông báo AMA tuần này trong Crypto Talk, ghim im lặng, mở chủ đề “Câu hỏi AMA” và tạo cho tôi một liên kết mời hết hạn vào thứ Sáu.
Agent gọi
- 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")
Kết nối mọi client MCP
Dùng endpoint được lưu trữ sẵn với khóa API của bạn. Người dùng Claude Desktop có thể kết nối qua mcp-remote.
{
"mcpServers": {
"metricgram": {
"url": "https://metricgram.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Công cụ agent nhận được
Tin nhắn và media
send_telegram_message
send_telegram_media
send_telegram_poll
edit_telegram_message
delete_telegram_messages
forward_telegram_message
react_to_telegram_message
Ghim và chủ đề diễn đàn
pin_telegram_message
manage_forum_topic
createForumTopic
closeGeneralForumTopic
unpinAllForumTopicMessages
Kiểm duyệt và yêu cầu tham gia
ban_member
restrict_member
promote_member
handle_telegram_join_request
banChatSenderChat
setChatAdministratorCustomTitle
Cài đặt nhóm và liên kết mời
update_telegram_chat_settings
create_telegram_invite_link
revokeChatInviteLink
setChatPermissions
setChatStickerSet
Phân tích và dữ liệu cộng đồng
analytics_overview
active_users
list_members
list_messages
gamification_rankings
get_subscriber_health
Mọi phương thức Bot API được hỗ trợ
telegram_api_methods
telegram_bot_api
get_telegram_chat
get_telegram_chat_member
Telegram Bot API, đóng gói sẵn cho AI agent
Xây dựng tích hợp Telegram cho một agent thường đồng nghĩa với việc lưu trữ bot, xử lý webhook, bảo quản token và viết công cụ cho từng endpoint. Bot của Metricgram đã chạy sẵn trong nhóm của bạn, nên agent nhận được Bot API dưới dạng các công cụ MCP dùng ngay từ một endpoint duy nhất.
Công cụ có kiểu dữ liệu cùng cổng Bot API đầy đủ
Các tác vụ phổ biến như gửi tin nhắn, media, bình chọn, ghim, chủ đề và liên kết mời đều có công cụ riêng, mô tả rõ ràng. Mọi thứ khác đi qua telegram_bot_api, nhận đúng tên phương thức và tham số chính thức của Bot API, nên không có gì trong danh mục được hỗ trợ nằm ngoài tầm với.
Khóa trong nhóm của chính bạn
Agent không bao giờ tự chọn chat_id. Metricgram suy ra chat_id từ nhóm bạn sở hữu, kiểm tra tin nhắn được chuyển tiếp và trích dẫn so với các nhóm khác của bạn, và từ chối mọi thao tác có thể chạm tới cuộc trò chuyện khác.
Phạm vi quyền cho mọi mức độ tin cậy
Cấp telegram:read cho agent nghiên cứu, telegram:write để đăng bài và quản lý chủ đề, telegram:moderate để cấm thành viên và xử lý yêu cầu tham gia, và telegram:admin cho danh hiệu, quyền hạn và liên kết mời. Khóa có thể thu hồi bất cứ lúc nào.
Thử lại an toàn, lỗi rõ ràng
Các công cụ ghi chấp nhận khóa idempotency, nên một lệnh gọi được thử lại sẽ không bao giờ đăng hai lần. Lỗi Telegram và giới hạn tần suất được trả về dưới dạng kết quả có cấu trúc kèm retry_after, để agent tự xử lý.
Ngữ cảnh mà bot thông thường không có
Cùng máy chủ này còn cung cấp phân tích của Metricgram, lịch sử thành viên, tin nhắn đã ghi nhận, gamification, tóm tắt AI và tình trạng người đăng ký Stripe, để agent quyết định nên làm gì trước khi hành động.
Metricgram so với Quản Lý Thủ Công
| Metricgram | Thủ Công | |
|---|---|---|
| Endpoint MCP lưu trữ sẵn, không cần chạy máy chủ bot | ||
| Hơn 70 phương thức Telegram Bot API dưới dạng công cụ | ||
| chat_id bị khóa trong nhóm của bạn | ||
| Khóa API theo phạm vi quyền, có thể thu hồi | ||
| Thử lại idempotent cho công cụ ghi | ||
| Phân tích và lịch sử thành viên làm ngữ cảnh | ||
| Dữ liệu trò chuyện, quản trị viên và quyền theo thời gian thực | ||
| Hoạt động với bot tùy chỉnh của bạn |
Câu Hỏi Thường Gặp
Máy chủ MCP Telegram là gì?
Đó là một máy chủ Model Context Protocol cung cấp các thao tác Telegram dưới dạng công cụ mà AI agent có thể gọi. Metricgram lưu trữ sẵn máy chủ này cho bạn, chạy bằng chính bot đang quản lý nhóm của bạn.
Máy chủ hoạt động với những client AI nào?
Bất kỳ client nào hỗ trợ MCP qua HTTP, bao gồm Claude Code, Claude Desktop (qua mcp-remote), Cursor, Codex và các agent tùy chỉnh xây dựng bằng SDK của OpenAI hoặc Anthropic.
Máy chủ có bao quát toàn bộ Telegram Bot API không?
Máy chủ hỗ trợ hơn 70 phương thức liên quan đến nhóm, gồm tin nhắn, media, bình chọn, chỉnh sửa, cảm xúc, ghim, chủ đề diễn đàn, kiểm duyệt, yêu cầu tham gia, cài đặt nhóm và liên kết mời. Các phương thức có thể ảnh hưởng đến cuộc trò chuyện khác hoặc chính bot, như webhook, thanh toán hay rời nhóm, được loại trừ có chủ đích.
Agent có thể đăng bài trong nhóm tôi không sở hữu không?
Không. Mọi lệnh gọi đều gắn với một trong các nhóm bạn đã kết nối. chat_id do Metricgram đặt, và chuyển tiếp hay trả lời chỉ có thể tham chiếu đến nhóm của chính bạn.
Đây có phải là Telegram user API (MTProto) không?
Không. Máy chủ dùng Bot API chính thức thông qua bot của nhóm, nên agent hoạt động với tư cách bot, không bao giờ dưới tài khoản Telegram cá nhân của bạn.
Gói nào bao gồm máy chủ MCP?
Quyền truy cập MCP và API thuộc gói Elite. Bản dùng thử miễn phí 14 ngày bao gồm quyền truy cập cấp Elite, nên bạn có thể kết nối agent trước khi thanh toán.
Tôi có thể giới hạn những gì agent được phép làm không?
Có. Mỗi khóa API có phạm vi quyền riêng, và bạn có thể tạo các khóa riêng cho nghiên cứu chỉ đọc, đăng bài, kiểm duyệt và quản trị.
Tiếp tục khám phá
Tìm hướng dẫn thực tế, khám phá các cộng đồng đang hoạt động hoặc tìm thêm cách dùng Metricgram.
Hướng dẫn
Blog
Đọc các cẩm nang thực tiễn về tăng trưởng, kiếm tiền, kiểm duyệt và vận hành cộng đồng Telegram.
Khám pháDanh bạ cộng đồng
Thư mục Cộng đồng Telegram
Duyệt các cộng đồng Telegram hoạt động theo danh mục, ngôn ngữ và cách định vị.
Khám pháTrung tâm mục
Giải Pháp
Xem tất cả các trang trong mục này cùng một chỗ.
Khám pháKhám Phá Thêm
Công Cụ Quản Lý Nhóm Telegram
Phân tích & Chỉ số Nhóm Telegram
Telegram Bot cho Quản lý Nhóm
Tự động hóa nhóm Telegram của bạn
Bot Thành viên Telegram cho Cộng đồng Trả phí
Bot Thanh Toán Telegram cho Nhóm và Kênh
Bot Đăng Ký Telegram cho Doanh Thu Định Kỳ
Dùng kênh Telegram để phát triển nhóm trả phí
Tạo và Quản lý Nhóm VIP Telegram
Biến hỗ trợ Telegram thành account intelligence
MCP
API
Chatbot AI Trợ lý