Cách kết nối Google Gemini với các cuộc chat Telegram của bạn

Bạn kết nối Google Gemini với các cuộc chat Telegram bằng cách đăng ký máy chủ MCP được lưu trữ của Entergram, https://mcp.entergram.com/mcp, với Gemini CLI rồi đăng nhập Entergram một lần trong trình duyệt. Sau đó, Gemini có thể đọc chat, danh bạ và dữ liệu CRM thông qua tài khoản Telegram cá nhân thật của bạn, và thao tác trên chúng trong phạm vi quyền (scope) bạn đã cấp. Việc thiết lập gồm ba bước và một đoạn JSON nhỏ, trình bày bên dưới.

Gemini CLI là cách được trang Gemini Telegram MCP mô tả đầy đủ. Bất kỳ ứng dụng khách tương thích MCP nào khác chạy mô hình Gemini cũng có thể dùng cùng URL này, đăng ký theo cách mà ứng dụng đó yêu cầu.

• Một workspace gói Pro. API & MCP là tính năng của gói Pro. Ở gói thấp hơn, CLI vẫn liệt kê máy chủ nhưng mọi lệnh gọi đều bị từ chối, trông giống cấu hình hỏng nhưng thực ra không phải.
• Ít nhất một tài khoản Telegram đã kết nối trên seat của bạn. Trình kết nối cá nhân chỉ dùng được các tài khoản Telegram được liệt kê trong Settings → Accounts (Cài đặt → Tài khoản) cho chính thành viên của bạn.
• Một trình duyệt trên máy cho lần đăng nhập đầu tiên. Màn hình cấp quyền cần trình duyệt, nên một máy chủ không có giao diện phải được cấp quyền từ một máy trạm trước.

Bước 1: Sao chép URL MCP trong Entergram

Vào Settings → Workspace → Connectors → MCP (Cài đặt → Workspace → Trình kết nối → MCP) và sao chép URL máy chủ MCP. URL này giống nhau cho mọi ứng dụng khách:

https://mcp.entergram.com/mcp

Bước 2: Đăng ký máy chủ với Gemini CLI

Thêm Entergram vào mục mcpServers trong ~/.gemini/settings.json. Vì đây là máy chủ HTTPS từ xa, khóa cần dùng là httpUrl, không phải một mục gồm lệnh và tham số:

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

Tệp trong thư mục home áp dụng cho mọi dự án trên máy đó. Để giới hạn quyền truy cập Telegram trong một repository, hãy đặt cùng đoạn cấu hình này vào .gemini/settings.json bên trong repository đó.

Bước 3: Khởi động lại CLI và cấp quyền

CLI đọc cấu hình khi khởi động, nên hãy thoát hẳn phiên làm việc rồi mở lại. Đăng nhập Entergram trong cửa sổ trình duyệt vừa mở và cấp những scope bạn muốn Gemini có. Không có gì trong settings.json là thông tin đăng nhập: tệp này chỉ cho biết máy chủ nằm ở đâu, còn quyền truy cập đến từ lần đăng nhập OAuth đó.

Sau khi cấp quyền, hãy liệt kê các máy chủ MCP đã đăng ký trong CLI và các công cụ của Entergram sẽ xuất hiện dưới tên entergram.

Những gì Gemini làm được phụ thuộc vào loại ứng dụng khách bạn cấp quyền, như mô tả trên trang trợ giúp về trình kết nối MCP:

Agent cá nhân không gửi được tin nhắn Telegram. Nếu đọc được nhưng gửi bị từ chối, đó là ranh giới của scope, không phải lỗi. Chủ sở hữu hoặc admin phải cấp quyền cho một trình kết nối workspace, và bạn chạy lại luồng cấp quyền với trình kết nối đó. Dù theo cách nào, hãy cấp tập scope nhỏ nhất mà công việc cần: messages.write cho phép agent gửi tin nhắn dưới danh nghĩa của bạn.

Để cắt quyền truy cập, hãy thu hồi ứng dụng khách trong Entergram tại Settings → Workspace → Connectors → MCP. Xóa mục trong mcpServers chỉ khiến CLI ngừng gọi máy chủ; nó không làm mất hiệu lực quyền đã cấp.

Máy chủ MCP của Entergram kết nối với tài khoản Telegram cá nhân của bạn, không phải bot, nên Gemini làm việc với chính những cuộc chat bạn thấy. Một số câu lệnh hoạt động tốt trong CLI:

• "Những chat nào có câu hỏi chưa được trả lời trong ba ngày qua?"
• "Liệt kê các liên hệ trong nhóm khách hàng của tôi mà chưa có trong nhóm cộng đồng."
• "Đăng release notes từ CHANGELOG.md lên kênh beta." (cần trình kết nối workspace)
• "Tôi gõ sai số phiên bản trong thông báo đó, hãy sửa lại." (cần trình kết nối workspace)
• "Cho tôi số ticket tuần này theo người được giao, định dạng TSV."

CLI in ra từng lệnh gọi công cụ mà nó thực hiện, nên bạn có thể quan sát cơ chế hoạt động trên một tác vụ chỉ đọc trước khi tin tưởng giao cho nó một tác vụ ghi.

• Công cụ tin nhắn cần chỉ định tài khoản rõ ràng. Không có tài khoản mặc định ngầm định, nên script nên lấy danh sách tài khoản trước rồi truyền id tài khoản xuống.
• Không có gì tự đến. MCP hoạt động theo kiểu yêu cầu và phản hồi. Gemini chỉ biết có tin nhắn mới khi bạn hoặc một tác vụ định kỳ của bạn yêu cầu nó kiểm tra.
• Không có quyền truy cập vượt mức. Gemini thấy đúng những gì các tài khoản Telegram đã kết nối của bạn thấy. Nhóm bạn đã rời là nhóm nó không đọc được, và các chat bạn loại trừ trong Accounts → Exclude chats (Tài khoản → Loại trừ chat) sẽ không xuất hiện trong kết quả MCP.

• Máy chủ không bao giờ xuất hiện trong danh sách MCP. Thường do JSON sai định dạng: chỉ một dấu phẩy thừa ở cuối cũng khiến CLI bỏ qua toàn bộ tệp cài đặt. Hãy kiểm tra mục cấu hình dùng httpUrl và nằm bên trong mcpServers.
• Sửa settings.json dường như không có tác dụng. Thoát hẳn phiên làm việc rồi mở lại. Tiến trình đang chạy giữ nguyên danh sách công cụ đã tạo lúc khởi động.
• Chạy được ở thư mục này nhưng không chạy ở thư mục khác. Bạn có hai tệp cài đặt. Hãy kiểm tra mục entergram nằm trong ~/.gemini hay trong thư mục .gemini của một repository.
• Mọi lệnh gọi đều trả về 403. Kiểm tra gói trước (MCP cần gói Pro), sau đó đến vai trò: mọi thứ vượt ngoài tập scope của agent cá nhân đều cần chủ sở hữu hoặc admin.

Máy chủ MCP của Entergram giống nhau cho mọi ứng dụng khách. Thiết lập một lần và bạn có thể kết nối ứng dụng AI mình thích, hoặc nhiều ứng dụng cùng lúc:

• Kết nối Claude với Telegram qua Entergram
• Kết nối ChatGPT với Telegram qua Entergram
• Kết nối bất kỳ công cụ AI nào với Telegram MCP

Để xem danh sách công cụ đầy đủ cho Gemini, ví dụ về phạm vi dự án và tác vụ định kỳ, hãy xem trang Gemini Telegram MCP. Để biết máy chủ làm được gì trên mọi ứng dụng khách, hãy bắt đầu từ trang máy chủ Telegram MCP.