Máy chủ MCP Telegram: cung cấp trọn bộ Telegram Bot API cho AI agent một cách an toàn

Vì sao AI agent cần một lớp đóng gói cho Telegram

AI agent ngày càng giỏi vận hành các công cụ thật. Chúng có thể đọc bảng điều khiển, xác định điều gì quan trọng và thực hiện bước tiếp theo. Nhưng để hành động bên trong Telegram, chúng cần một cầu nối: thứ biến một câu như "ghim thông báo AMA và mở chủ đề hỏi đáp" thành đúng các lệnh gọi Telegram API.

Cầu nối đó chính là máy chủ MCP Telegram.

Model Context Protocol (MCP) là một tiêu chuẩn mở cho phép các client AI như Claude, ChatGPT, Cursor và Codex khám phá và gọi công cụ. Máy chủ MCP Telegram cung cấp các thao tác Telegram dưới dạng những công cụ đó, kèm mô tả rõ ràng và lược đồ đầu vào mà mô hình có thể làm theo.

Giờ đây Metricgram vận hành sẵn một máy chủ như vậy cho bạn, chạy bằng chính bot đang quản lý nhóm của bạn.

"Đóng gói Telegram Bot API" thực sự bao gồm những gì

Trên lý thuyết, đóng gói Bot API cho agent nghe có vẻ đơn giản. Trên thực tế, bạn cần:

• Lưu trữ một bot, giữ bí mật token và duy trì bot hoạt động liên tục.
• Nhận cập nhật qua webhook hoặc polling.
• Viết định nghĩa công cụ cho từng endpoint bạn muốn agent sử dụng.
• Ngăn agent đăng bài vào những cuộc trò chuyện mà nó không bao giờ được chạm tới.
• Xử lý giới hạn tần suất, siêu nhóm đã di chuyển và thông báo lỗi của Telegram.
• Làm cho việc thử lại an toàn, để một lệnh gọi mạng chập chờn không khiến cùng một tin nhắn bị đăng hai lần.
• Ghi lại những gì agent đã làm, phòng khi bạn cần giải thích sau này.

Hầu hết các đội dừng lại ở bước "gửi tin nhắn" vì mọi thứ còn lại là một khối lượng lớn công việc hạ tầng. Kết quả là một agent biết nói nhưng không thực sự quản lý được cộng đồng.

Cách máy chủ MCP Telegram của Metricgram hoạt động

Metricgram đã có mặt trong các nhóm Telegram của bạn dưới dạng bot quản trị (hoặc bot tùy chỉnh của riêng bạn). Máy chủ MCP chỉ đơn giản cho phép client AI của bạn sử dụng bot đó thông qua một endpoint được lưu trữ sẵn:

1. Kết nối các nhóm với Metricgram và cấp quyền quản trị cho bot.
2. Thêm endpoint https://metricgram.com/api/v1/mcp vào client AI của bạn, ví dụ dưới dạng connector tùy chỉnh trong Claude.
3. Đăng nhập và phê duyệt quyền truy cập bằng OAuth. Vậy là xong: không có máy chủ, webhook hay token nào phải quản lý. Client không hỗ trợ OAuth có thể dùng khóa API thay thế, với cấu hình bên dưới.

{
  "mcpServers": {
    "metricgram": {
      "url": "https://metricgram.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Người dùng Claude Desktop có thể kết nối cùng endpoint này qua mcp-remote. Đoạn cấu hình chính xác cho từng client có trong trang MCP của bảng quản lý.

Hơn 70 phương thức Bot API, hai cách gọi

Máy chủ cung cấp Telegram Bot API theo hai lớp.

Công cụ có kiểu dữ liệu cho công việc hằng ngày

Các tác vụ phổ biến có công cụ riêng với tham số được mô tả rõ, giúp mô hình dễ sử dụng đúng:

• send_telegram_message với chủ đề, trả lời và nút URL
• send_telegram_media cho ảnh, video, GIF, tài liệu, âm thanh và sticker
• send_telegram_poll cho bình chọn và câu đố
• edit_telegram_message, delete_telegram_messages, react_to_telegram_message
• pin_telegram_message và forward_telegram_message
• manage_forum_topic để tạo, đổi tên, đóng, mở lại hoặc xóa chủ đề
• get_telegram_chat và get_telegram_chat_member cho dữ liệu trò chuyện theo thời gian thực
• handle_telegram_join_request, create_telegram_invite_link và update_telegram_chat_settings

Cổng Bot API đầy đủ

Mọi thứ khác đi qua telegram_bot_api. Agent truyền tên phương thức Bot API chính thức cùng các tham số, ví dụ setChatPermissions, banChatSenderChat, editMessageMedia, hideGeneralForumTopic hoặc revokeChatInviteLink. Công cụ đi kèm telegram_api_methods liệt kê mọi phương thức mà khóa hiện tại được dùng, nên agent luôn biết những gì có sẵn.

Bảo mật: vì sao agent không bao giờ tự chọn chat_id

Quyết định thiết kế quan trọng nhất là những gì agent không thể làm.

• Cuộc trò chuyện bị khóa. Agent truyền group_id của Metricgram. Máy chủ suy ra chat_id Telegram từ một nhóm bạn sở hữu và từ chối mọi cuộc trò chuyện khác.
• Chuyển tiếp và trích dẫn được kiểm tra. Tin nhắn chỉ có thể được chuyển tiếp, sao chép hoặc trích dẫn từ nhóm của chính bạn.
• Loại trừ các thao tác ảnh hưởng toàn bot. Webhook, thanh toán, thay đổi hồ sơ bot và rời nhóm không được cung cấp.
• Nút bấm an toàn. Nút inline có thể mở URL hoặc sao chép văn bản, nhưng không thể kích hoạt callback vào bot.
• Phạm vi quyền tương ứng mức độ tin cậy. telegram:read, telegram:write, telegram:moderate và telegram:admin tách biệt nhau, và bạn có thể giữ nhiều khóa với quyền hạn khác nhau.
• Thử lại có tính idempotent. Công cụ ghi chấp nhận idempotency_key, nên một lệnh gọi được thử lại sẽ trả về kết quả đầu tiên thay vì thực hiện hai lần.
• Mọi lệnh gọi đều được ghi nhật ký kèm công cụ và phương thức Bot API đã dùng.

Agent hoạt động với tư cách bot thông qua Bot API chính thức, không bao giờ dưới tài khoản Telegram cá nhân của bạn.

Ngữ cảnh mà một bot thông thường không có

Một lớp đóng gói Bot API đơn thuần có thể hành động nhưng không nhìn thấy được nhiều. Máy chủ MCP của Metricgram còn cung cấp thông tin chuyên sâu về cộng đồng:

• Tổng quan phân tích và chuỗi thời gian hoạt động
• Thành viên tích cực, lịch sử thành viên và tin nhắn đã ghi nhận
• Bảng xếp hạng gamification và phần thưởng
• Tóm tắt AI về những gì đã diễn ra trong nhóm
• Tình trạng người đăng ký Stripe và các lượt gia hạn có nguy cơ rời bỏ

Điều đó có nghĩa là agent có thể trả lời "ai đã ngừng tham gia trong tháng này?" rồi gửi cho họ một tin nhắn chu đáo, tất cả trong cùng một cuộc trò chuyện.

Ví dụ quy trình làm việc

Thông báo hằng tuần. "Đăng thông báo AMA hằng tuần trong Crypto Talk, ghim mà không thông báo cho mọi người, mở chủ đề câu hỏi AMA và tạo liên kết mời hết hạn vào thứ Sáu."

Dọn dẹp kiểm duyệt. "Kiểm tra 200 tin nhắn gần nhất để tìm liên kết spam, xóa chúng và hạn chế người gửi trong 24 giờ."

Báo cáo cộng đồng. "So sánh hoạt động tuần này với tuần trước, liệt kê năm thành viên tích cực nhất và đăng một lời cảm ơn ngắn trong chủ đề General."

Phân loại yêu cầu tham gia. "Duyệt các yêu cầu tham gia đang chờ từ những người dùng là người đăng ký đang hoạt động và từ chối phần còn lại."

Dành cho ai

• Chủ cộng đồng muốn có trợ lý xử lý công việc quản trị thường ngày.
• Agency quản lý nhiều nhóm khách hàng và muốn một agent cho tất cả.
• Đội hỗ trợ và chăm sóc khách hàng vận hành cộng đồng khách hàng trên Telegram.
• Lập trình viên muốn đưa Telegram vào hệ thống agent mà không phải vận hành hạ tầng bot.

Bắt đầu

Máy chủ MCP có trong mọi gói Metricgram và trong bản dùng thử miễn phí 14 ngày, nên bạn có thể kết nối agent trước khi thanh toán. Hầu hết client kết nối bằng OAuth: dán URL máy chủ, đăng nhập và phê duyệt quyền truy cập. Khóa API vẫn có sẵn cho các client không hỗ trợ OAuth.

Tìm hiểu thêm trên trang máy chủ MCP Telegram và tổng quan tính năng MCP, sau đó tạo khóa đầu tiên của bạn trong bảng quản lý.