Chuyển đến nội dung chính
Kết nối Jenkins để agent của CloudThinker liệt kê job, đọc log build và kết quả test, giải thích vì sao build thất bại, và kích hoạt build qua Approvals của workspace. CloudThinker làm việc với plugin Jenkins MCP Server trên máy chủ của bạn và đăng nhập bằng username và API token của Jenkins.

Điều kiện tiên quyết

  • Máy chủ Jenkins mà CloudThinker truy cập được từ internet, và bạn có quyền admin để cài plugin. Với máy chủ nằm sau tường lửa, hãy đưa các egress IP của CloudThinker vào danh sách cho phép. Tài liệu này không công bố danh sách egress IP của CloudThinker: hãy hỏi đầu mối liên hệ CloudThinker của bạn, hoặc liên hệ với chúng tôi. Xem Truy cập dịch vụ riêng để biết các lựa chọn khác.
  • Đã cài plugin MCP Server. Plugin này thêm endpoint mà CloudThinker gọi tới, tại <your-jenkins-url>/mcp-server/mcp.
  • Một người dùng Jenkins dành cho CloudThinker, có các quyền trong mục Quyền yêu cầu.
  • Vai trò Admin trong workspace CloudThinker, vai trò có quyền thêm và sửa kết nối. Xem Vai trò.

Thiết lập

1

Cài plugin MCP Server

Trong Jenkins, vào Manage Jenkins → Plugins → Available plugins, tìm MCP Server, cài đặt và khởi động lại Jenkins nếu được yêu cầu.
2

Đặt Jenkins URL

Vào Manage Jenkins → System và điền Jenkins URL trong mục Jenkins Location bằng địa chỉ mọi người dùng để truy cập Jenkins, ví dụ https://jenkins.acme.com/. Nhấn Save.Plugin dựng liên kết tới job và build từ giá trị này. Nếu để trống hoặc đặt là localhost, agent sẽ nhận liên kết hỏng.
3

Tạo API token

Đăng nhập Jenkins bằng người dùng CloudThinker và mở <your-jenkins-url>/user/<username>/security (với các phiên bản Jenkins cũ hơn là /user/<username>/configure). Trong mục API Token, nhấn Add new Token. Đặt tên cloudthinker, nhấn Generate, rồi sao chép token. Jenkins chỉ hiển thị token một lần.
4

Thêm kết nối trong CloudThinker

Ở thanh bên, nhấn More → Workspace settings → Connections. Trên tab Builtin Connections, tìm Jenkins, nhấn Connect, rồi điền các trường trong mục Chi tiết kết nối. Nhấn Connect.CloudThinker kiểm tra kết nối bằng cách gọi MCP endpoint với username và token của bạn. URL sai, token bị từ chối hoặc thiếu plugin sẽ hiển thị lỗi thay vì Connected.Trạng thái thành công: Jenkins hiển thị Connected trên tab Builtin Connections.
Bài kiểm tra không xét quyền của người dùng trên các job. Hãy chạy prompt xác minh bên dưới để chắc chắn agent thấy được job của bạn.

Chi tiết kết nối

Hộp thoại hiển thị các trường với đúng những tên sau. Nếu bạn bỏ qua scheme, CloudThinker dùng https://. Với địa chỉ công khai, CloudThinker luôn kết nối qua HTTPS, kể cả khi bạn nhập http://, nên máy chủ của bạn cần chứng chỉ TLS hợp lệ tại địa chỉ đó.

Quyền yêu cầu

Cấp cho người dùng CloudThinker các quyền sau trong chiến lược phân quyền của Jenkins (ví dụ Matrix-based security trong Manage Jenkins → Security): Token hành động với đúng các quyền của người dùng này. Bỏ Job / Build nếu muốn kết nối chỉ đọc. Người dùng không cần Overall / Administer, và không công cụ nào của agent đọc credential hay secret của Jenkins.
Hãy dùng một người dùng Jenkins riêng cho CloudThinker thay vì tài khoản admin. Nếu bạn dùng phân quyền theo folder, chỉ cấp quyền vào các folder mà agent cần thấy.

Khả năng của agent

Thao tác đọc chạy mà không cần hỏi. Kích hoạt build là thao tác ghi, nên phải đi qua Approvals trước. Mọi thay đổi do agent thực hiện đều đi qua Approvals của workspace trước. Ở chế độ mặc định Auto · Rules + AI · Ask me, AI judgment có thể cho một thay đổi an toàn chạy mà không cần hỏi. Allow Rule cũng vậy, sau khi CloudThinker bật Rule enforcement cho workspace của bạn. Chọn Manual nếu bạn muốn tự phê duyệt mọi thay đổi.

Xác minh kết nối

Kết nối hoạt động sẽ trả về đúng tên job và kết quả thật của bạn. Danh sách trống thường có nghĩa là người dùng thiếu Job / Read hoặc Job / Discover.

Ví dụ prompt

Khắc phục sự cố

CloudThinker không truy cập được máy chủ Jenkins của bạn. Kiểm tra URL mở được từ bên ngoài mạng của bạn và tường lửa cho phép HTTPS đi vào từ các egress IP của CloudThinker. Không dùng localhost hay địa chỉ chỉ phân giải được bên trong mạng của bạn.
Username hoặc token sai, hoặc token đã bị thu hồi. Xác nhận JENKINS_USER đúng là người dùng đã tạo token, và tạo token mới nếu cần. Để thay token, chọn Jenkins trong More → Workspace settings → Connections, nhấn biểu tượng bút chì, nhấn Replace… trong mục Credentials, rồi nhấn Save and test.
Plugin MCP Server chưa được cài hoặc chưa bật, hoặc JENKINS_URL trỏ sai đường dẫn. Cài plugin và chỉ nhập URL gốc. Nếu Jenkins chạy dưới một đường dẫn như /jenkins, hãy thêm đường dẫn đó: https://ci.acme.com/jenkins.
Người dùng thiếu Job / Read hoặc Job / Discover, hoặc Jenkins URL đang trống hay đặt là localhost. Sửa quyền, đặt Jenkins URL trong Manage Jenkins → System, rồi hỏi lại.

Bảo mật

  • Quyền tối thiểu — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
  • Chỉ đọc theo mặc định — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
  • Xoay vòng thông tin xác thực — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
  • Thu hồi khi bàn giao — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.
  • Hạn chế mức độ phơi bày trên mạng. Chỉ cho phép lưu lượng vào Jenkins từ những nguồn cần thiết, và giữ giao diện Jenkins sau các biện pháp kiểm soát truy cập thông thường của bạn.
  • Giữ build qua phê duyệt. Chỉ cấp Job / Build nếu agent cần bắt đầu build, và chọn Manual nếu cần có người xem mọi build mà CloudThinker khởi chạy.

Liên quan

Approvals

Quyết định thao tác nào của agent tự chạy và thao tác nào phải chờ bạn

Tổng quan kết nối

Xem mọi công cụ CloudThinker kết nối được và cách kết nối hoạt động