Gemini Telegram MCP - cho Gemini và CLI

Gemini CLI, phạm vi người dùng

Con đường chính, và là điều hầu hết mọi người muốn nói khi nhắc đến Gemini MCP. Thêm máy chủ vào ~/.gemini/settings.json dưới mcpServers với httpUrl trỏ tới endpoint được vận hành sẵn, khởi động lại CLI, và công cụ có mặt trong mọi dự án trên máy đó. Vì đây là HTTPS từ xa nên không có lớp bọc npx hay cầu nối stdio nào phải giữ cho chạy.

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

Gemini CLI, phạm vi dự án

Cùng khối cấu hình đó đặt trong .gemini/settings.json bên trong một repository chỉ áp dụng cho bản checkout đó. Hữu ích khi một repo là pipeline deploy chuyên thông báo phát hành vào kênh Telegram, còn phần công việc khác không nên chạm vào chat. Cấu hình cũng nằm trong version control, nơi đồng đội đọc được.

mkdir -p .gemini && $EDITOR .gemini/settings.json

Bất kỳ client nào chạy mô hình Gemini

Endpoint không phụ thuộc mô hình. Một agent trong IDE, một bộ khung chạy script hay một công cụ nội bộ dùng Gemini bên dưới chỉ cần đăng ký Entergram theo cách cấu hình MCP của chính nó, và nhận đúng danh sách công cụ như vậy. Màn hình đồng ý thuộc về Entergram, nên ai chạy client thì người đó tự cấp quyền, không thừa hưởng quyền của người khác.

Hiện tất cả 78 công cụ trong 9 nhóm →

• Đăng ký máy chủ không đồng nghĩa với cấp quyền cho nó. Mỗi máy phải tự qua màn hình đồng ý ở lần đầu, nên một laptop mới hay một container dựng lại cần trình duyệt ít nhất một lần.
• Workspace Entergram phải ở gói Pro. Nếu gói thấp hơn, CLI vẫn liệt kê máy chủ rồi nhận lời từ chối ở mọi lệnh gọi. Trông giống cấu hình hỏng, nhưng không phải.
• Không có tài khoản ngầm định. Công cụ nhắn tin đòi account_id rõ ràng, nên mọi script phải lấy danh sách tài khoản trước. Trong chat thì gần như không để ý, trong pipeline thì là thêm một việc phải nhớ. Hãy lấy nó một lần ở đầu script rồi truyền xuống.
• Agent cá nhân không gửi được tin và không quản trị được nhóm. Quy trình tự động đăng release note hay tạo kênh cần connector của workspace do owner hoặc admin cấp quyền.
• Giao thức là yêu cầu và phản hồi, không phải đăng ký nhận sự kiện. Không có gì tự đến terminal của bạn; Gemini chỉ biết có tin nhắn mới khi có thứ gì đó bảo nó kiểm tra. Mọi thứ giống giám sát đều phải là một job theo lịch do bạn quản lý.
• CLI không nâng quyền gì cả. Nó thấy đúng những cuộc chat mà tài khoản Telegram của bạn thấy, và một nhóm bạn đã rời là nhóm nó không đọc được.

Máy chủ không bao giờ xuất hiện trong danh sách MCP

Gần như luôn do JSON sai cú pháp: chỉ một dấu phẩy thừa ở cuối cũng khiến CLI lặng lẽ bỏ qua cả tệp cài đặt. Kiểm tra tính hợp lệ, xác nhận khóa là httpUrl cho máy chủ HTTPS từ xa chứ không phải mục stdio dạng command và args, và chắc chắn mục đó thực sự nằm trong mcpServers.

Sửa settings.json dường như không có tác dụng

Cấu hình được đọc khi khởi động. Thoát hẳn phiên làm việc và mở lại; một tiến trình đang chạy vẫn phục vụ danh sách công cụ nó dựng lúc khởi động, nên tệp có thể đúng mà vẫn trông như bị bỏ qua.

OAuth không hoàn tất được trên máy không có màn hình

Màn hình đồng ý cần trình duyệt. Hãy cấp quyền trên một máy trạm bạn nhìn thấy được, hoặc chuyển tiếp cổng callback qua SSH. Một build agent không có màn hình không tự hoàn tất bước bắt tay được.

Chạy được ở thư mục này mà không chạy ở thư mục khác

Bạn có hai tệp cài đặt. Tệp dưới ~/.gemini áp dụng ở mọi nơi, tệp dưới .gemini trong một repository chỉ áp dụng ở đó. Kiểm tra xem tệp nào thực sự chứa mục entergram trước khi sửa bất cứ thứ gì khác.

Mọi lệnh gọi đều trả về 403

Kiểm tra gói trước, rồi đến vai trò. Quyền truy cập MCP cần gói Pro, và mọi thứ vượt quá tập phạm vi agent cá nhân đều cần quyền owner hoặc admin trong workspace Entergram.

Đọc được nhưng gửi thì bị từ chối

Đó là ranh giới của agent cá nhân, không phải lỗi tạm thời. Quyền gửi hoàn toàn không có trong tập phạm vi của nó, nên thử lại cũng vô ích. Owner hoặc admin phải cấp quyền cho connector của workspace, và bạn chạy lại luồng đồng ý với connector đó.