Chuyển đến nội dung chính
Kết nối Jenkins server tự lưu trữ của bạn để cho phép các agent CloudThinker giám sát build, phân tích kết quả test, xem xét log pipeline và quản lý các thao tác job. Jenkins xác thực bằng tên đăng nhập và API token qua Jenkins MCP Server Plugin.

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

  • Một instance Jenkins tự lưu trữ chạy phiên bản 2.x trở lên (Jenkins được lưu trữ trên đám mây không được hỗ trợ).
  • Jenkins MCP Server Plugin được cài đặt trên server của bạn; cổng MCP mặc định là 9090.
  • Quyền admin trên Jenkins để cấu hình root URL và tạo thông tin xác thực.
Các dịch vụ Jenkins được lưu trữ trên đám mây không được hỗ trợ. Kết nối này yêu cầu Jenkins MCP Server Plugin.

​
Thiết lập

1

Cấu hình root URL

Jenkins MCP Server Plugin yêu cầu Jenkins phải có root URL được cấu hình để trả về các đường dẫn job đúng. Chạy lệnh sau trong Jenkins Script Console:
COOKIE_JAR=/tmp/jenkins_cookies
CRUMB=$(curl -s -c $COOKIE_JAR -u "admin:<password>" \
  'http://<host-ip>:9090/crumbIssuer/api/json' | python3 -c "import json,sys; print(json.load(sys.stdin)['crumb'])")

curl -s -X POST "http://<host-ip>:9090/scriptText" \
  -b $COOKIE_JAR -u "admin:<password>" -H "Jenkins-Crumb: $CRUMB" \
  --data-urlencode "script=
import jenkins.model.JenkinsLocationConfiguration
def loc = JenkinsLocationConfiguration.get()
loc.setUrl('http://<host-ip>:9090/')
loc.save()
println('Root URL set to: ' + loc.getUrl())
"
2

Xác minh MCP endpoint

Xác nhận plugin đang chạy trước khi kết nối:
curl -s http://<host-ip>:9090/mcp-health/
3

Thêm kết nối trong CloudThinker

Điều hướng đến Connections → Jenkins và nhập:
  • URL: http://<host-ip>:9090
  • Username: admin
  • API Token: mật khẩu admin hoặc API token Jenkins của bạn
Nhấn Connect. CloudThinker xác minh thông tin xác thực và hiển thị trạng thái Connected.

​
Chi tiết kết nối

TrườngMô tảVí dụ
URLURL cơ sở của instance Jenkinshttp://192.168.1.100:9090
UsernameTên đăng nhập Jenkinsadmin
API TokenMật khẩu admin hoặc API token Jenkins—

​
Quyền yêu cầu

Cấp cho người dùng Jenkins các quyền sau:
  • Overall: Read
  • Job: Read, Discover
  • View: Read
Tạo một người dùng Jenkins riêng cho CloudThinker chỉ với các quyền này. Giữ các thao tác ghi (kích hoạt build, replay pipeline) được kiểm soát bởi phê duyệt.

​
Khả năng của agent

Sau khi kết nối, các agent có thể giám sát và điều tra các pipeline Jenkins của bạn.
Khả năngMô tả
Giám sát buildLiệt kê job và kiểm tra trạng thái build
Phân tích logLấy và tìm kiếm build log
Kết quả testXem kết quả test
Tích hợp SCMXem các thay đổi và commit Git
Điều khiển jobKích hoạt build và replay pipeline — yêu cầu phê duyệt

​
Xác minh kết nối

@alex list all Jenkins jobs and show the last build status for each

​
Ví dụ lệnh

@alex search Jenkins build logs for errors in the last 10 builds and #recommend fixes
@alex show test results for the main project's recent builds and #report failures
@alex check the Jenkins build queue and identify any stuck jobs

​
Khắc phục sự cố

Xác minh Jenkins đang chạy và cổng 9090 có thể truy cập từ CloudThinker. Dùng địa chỉ IP của host (không phải localhost) trong trường URL.
Root URL chưa được cấu hình hoặc lệnh Script Console thất bại. Chạy lại lệnh Script Console trong phần Thiết lập và kết nối lại.
Tên đăng nhập hoặc API token không đúng, hoặc người dùng thiếu quyền yêu cầu. Xác minh thông tin xác thực và người dùng Jenkins có quyền Overall Read, Job Read và View Read.

​
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.
  • Người dùng riêng biệt — tạo người dùng Jenkins riêng cho CloudThinker được giới hạn phạm vi theo chỉ các job và view nó cần.
  • Cách ly mạng — giới hạn cổng Jenkins 9090 theo dải IP của CloudThinker hoặc dùng VPN; tránh để lộ giao diện Jenkins ra internet công cộng.

​
Liên quan

https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/mcp.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=c89b6087a9d233901dea5e354452eff6

Kết nối MCP

Kết nối các công cụ tùy chỉnh qua Model Context Protocol
https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/kubernetes.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=7c03292954ff635a1994623a5c39971b

Kết nối Kubernetes

Kết nối các cluster Kubernetes