Đ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.
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
Ví dụ prompt
Khắc phục sự cố
This connection did not respond in time. Try connecting again.
This connection did not respond in time. Try connecting again.
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.The provider rejected these credentials. Update them, then connect again.
The provider rejected these credentials. Update them, then connect again.
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.The provider endpoint was not found. Check the connection settings.
The provider endpoint was not found. Check the connection settings.
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.Danh sách job trống hoặc liên kết bị hỏng
Danh sách job trống hoặc liên kết bị hỏng
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