opencode Telegram MCP - giao hộp thư cho agent trong terminal

Toàn cục: ~/.config/opencode/opencode.json

Một mục đi theo bạn vào mọi repository bạn mở. Đây là chỗ phù hợp cho quyền cá nhân: máy chủ có sẵn dù bạn đang ở dự án công việc hay dự án cuối tuần, và bạn chỉ cấp quyền một lần thay vì mỗi lần checkout.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "entergram": {
      "type": "remote",
      "url": "https://mcp.entergram.com/mcp",
      "enabled": true
    }
  }
}

Theo dự án: opencode.json ở thư mục gốc repo

Được commit cùng code, nên bất kỳ ai clone repository đều có máy chủ được khai báo sẵn mà không cần ai dặn. Không có gì bí mật bị chia sẻ: file chỉ ghi một endpoint, và mỗi đồng đội vẫn tự đăng nhập với quyền của riêng mình. Cấu hình dự án được chồng lên file toàn cục, nên hãy giữ một định nghĩa thay vì hai định nghĩa cạnh tranh nhau.

Không giao diện: opencode run

Đây là lý do connector này hợp với một agent trong terminal ngay từ đầu. Một lệnh gọi không tương tác duy nhất vừa với script deploy, một target trong Makefile hoặc một bước CI, và nhờ vậy thông báo phát hành không còn phụ thuộc vào việc ai đó nhớ gửi.

opencode run "đăng bản tóm tắt phát hành v2.14 lên kênh khách hàng"

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

• Lần cấp quyền đầu tiên cần trình duyệt. Một lệnh gọi theo script không thể hoàn tất màn hình đồng ý, nên hãy cấp quyền một lần trong phiên tương tác và để quyền đã lưu gánh các lần chạy sau.
• Một file opencode.json được commit chia sẻ địa chỉ, không chia sẻ quyền truy cập. Mỗi đồng đội kéo repo về đều phải tự đăng nhập, và token của họ mang quyền của họ chứ không phải của bạn.
• Phía chúng tôi không có bộ lập lịch. opencode thoát khi lần chạy kết thúc, nên mọi thứ định kỳ, như bản tổng hợp hằng đêm hay thông báo sau deploy, là mục cron hoặc bước pipeline của bạn, không bao giờ là thứ Entergram tự kích hoạt.
• MCP thuộc gói Pro. Ở các gói thấp hơn, máy chủ vẫn phản hồi bước bắt tay, khiến lỗi trông giống lỗi cấu hình trong khi thực chất là vấn đề thanh toán.
• Thao tác ghi cần cột đã tồn tại trước. Agent có thể điền một trường theo dõi phát hành trên cuộc chat, nhưng tạo trường đó là thao tác của connector workspace và quyền cá nhân sẽ không làm được.
• Bắt buộc chỉ định theo từng tài khoản. Thói quen dùng terminal khiến bạn mong đợi một giá trị mặc định hợp lý nhưng ở đây không có, nên hãy nêu tên tài khoản trong prompt, nếu không agent sẽ tự chọn từ danh sách tài khoản.

opencode khởi động nhưng không liệt kê công cụ Entergram nào

Kiểm tra mục cấu hình nằm dưới khối mcp với type là remote và enabled là true; một mục thiếu một trong hai sẽ được phân tích rồi bị bỏ qua mà không báo gì. Cấu hình được đọc lúc khởi động, nên hãy khởi động lại phiên sau khi sửa.

opencode không chịu khởi động sau khi sửa

Giữ dòng $schema và kiểm tra file bằng một trình phân tích JSON. Dấu phẩy thừa ở cuối là nguyên nhân thường gặp, và lỗi khởi động thường chỉ nêu tên file chứ không nêu dòng gây lỗi.

Một lần chạy theo script bị treo ở bước cấp quyền

Lần chạy không tương tác không thể mở màn hình đồng ý. Khởi động opencode ở chế độ tương tác một lần, hoàn tất đăng nhập Entergram, và quyền đã lưu sẽ phục vụ các lần chạy theo script từ đó trở đi.

Cấu hình đang có hiệu lực không đúng

Một file opencode.json của dự án được chồng lên file toàn cục trong ~/.config/opencode/. Nếu một đồng đội đã commit một mục, mục của họ là mục đang được dùng; hãy hợp nhất hai mục thay vì thêm máy chủ thứ hai dưới một tên khác.

Tin nhắn đến nhầm chỗ

Nêu tên cả tài khoản lẫn cuộc chat đích trong prompt. entergram_list_accounts xác định được tài khoản, nhưng không có gì trong một phiên terminal ngụ ý giá trị mặc định, và một lần chạy một lượt sẽ không dừng lại để hỏi bạn.

Lệnh gọi bắt đầu thất bại sau vài ngày

Token có hạn sử dụng. Chạy opencode ở chế độ tương tác và phê duyệt lại quyền truy cập; file cấu hình không thay đổi, chỉ có quyền đứng phía sau nó thay đổi.