Chuyển đến nội dung chính
Kết nối SonarQube để các agent CloudThinker cho bạn biết vì sao quality gate thất bại, liệt kê các issue mức blocker và high đứng sau, xem lại các security hotspot đang mở, và tìm những file có độ phủ test thấp nhất. Kết nối đăng nhập bằng một user token của SonarQube và chạy MCP server chính thức của SonarSource, nên hoạt động với cả SonarQube Cloud lẫn SonarQube Server tự host.

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

  • Một organization SonarQube Cloud, hoặc một instance SonarQube Server hay Community Build mà CloudThinker truy cập được qua HTTPS. Với instance nội bộ, xem Truy cập dịch vụ nội bộ.
  • Một tài khoản SonarQube dành cho CloudThinker, có quyền Browse trên các project agent cần đọc (xem Quyền yêu cầu).
  • Vai trò Admin trong workspace CloudThinker, vai trò cần có để thêm kết nối. Xem Vai trò.

Thiết lập

1

Tạo user token

Đăng nhập SonarQube Cloud bằng tài khoản CloudThinker sẽ dùng. Vào My Account → Security, nhập tên như cloudthinker, đặt ngày hết hạn, rồi nhấn Generate Token.Sao chép token. SonarQube chỉ hiển thị token một lần.
2

Tìm organization key

Mở organization của bạn. Key là phần cuối của URL: https://sonarcloud.io/organizations/<org-key>.
3

Cấp quyền Browse trên các project

Với mỗi project agent cần đọc, mở project, vào Administration → Permissions, và cấp quyền Browse cho tài khoản CloudThinker. Thiếu quyền này, prompt xác minh sẽ trả về kết quả rỗng.
4

Thêm kết nối trong CloudThinker

Trên thanh bên, nhấn More → Workspace settings → Connections, giữ nguyên tab Builtin Connections, rồi chọn SonarQube. Điền:
  • SONARQUBE_TOKEN: token bạn vừa sao chép
  • SONARQUBE_DEPLOYMENT_TYPE: SonarQube Cloud
  • SONARQUBE_ORG: organization key của bạn
Nhấn Connect.Trạng thái thành công: hộp thoại Connect SonarQube đóng lại mà không báo lỗi. Chạy prompt xác minh bên dưới.

Chi tiết kết nối

Form hiển thị SONARQUBE_ORG hoặc SONARQUBE_URL tùy theo loại triển khai bạn chọn. Tùy chọn SonarQube Cloud kết nối tới sonarcloud.io. Không có trường region.

Quyền yêu cầu

User token hoạt động với quyền của tài khoản đã tạo ra nó. Cấp quyền project cho tài khoản đó trong SonarQube, theo từng project hoặc qua permission template.
Hãy bắt đầu chỉ với Browse. Với quyền này, agent đã giải thích được mọi gate và issue. Chỉ thêm hai quyền Administer trên những project mà bạn muốn agent đề xuất thay đổi trạng thái.

Khả năng của agent

Tên mức độ nghiêm trọng tuân theo chế độ của instance. Chế độ Multi-Quality Rule báo BLOCKER, HIGH, MEDIUM, LOW và INFO. Chế độ Standard Experience báo BLOCKER, CRITICAL, MAJOR, MINOR và INFO. 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. Yêu cầu bị từ chối sẽ không được thử lại. Để tự quyết định từng thay đổi trạng thái, chẳng hạn đánh dấu một issue là false positive, hãy chọn Manual để người duyệt phê duyệt mọi thay đổi. Khi CloudThinker bật Rule enforcement cho workspace của bạn, một Rule Ask first có thể thu hẹp việc này về riêng kết nối SonarQube. Một số tool phụ thuộc vào phiên bản SonarQube: dependency risk cần giấy phép Advanced Security, còn các tool kiểm tra tình trạng hệ thống chỉ hoạt động trên SonarQube Server. Agent báo cáo số liệu của từng project như hiện tại. SonarQube trả về measure hiện hành, nên agent sẽ không khẳng định xu hướng nào trừ khi bạn yêu cầu so sánh các branch hoặc pull request.

Xác minh kết nối

Kết quả mong đợi là một bảng gồm key và tên project, trạng thái gate OK hoặc ERROR cho từng project, và số issue theo mức độ nghiêm trọng, chẳng hạn BLOCKER.

Ví dụ prompt

Hãy dùng đúng project key thật. Agent tra key từ danh sách project và không đoán key.

Khắc phục sự cố

Token sai, đã hết hạn hoặc bị thu hồi. Tạo user token mới, sửa kết nối và dán token vào SONARQUBE_TOKEN.
CloudThinker không truy cập được SONARQUBE_URL. Kiểm tra địa chỉ dùng HTTPS và truy cập được từ internet, không phải localhost hay hostname nội bộ, và service SonarQube đang chạy.
SONARQUBE_ORG sai, hoặc tài khoản của token không phải thành viên của organization đó. Sao chép key từ URL của organization và xác nhận tư cách thành viên.
Tài khoản của token thiếu quyền Browse trên các project đó. Cấp quyền Browse trên các project này trong SonarQube. Không cần kết nối lại; quyền có hiệu lực từ request tiếp theo.
Tài khoản thiếu quyền Administer Issues hoặc Administer Security Hotspots trên project đó. Cấp quyền trong SonarQube, rồi yêu cầu lại.
Phiên bản của bạn không có các tool đó. Dependency risk cần giấy phép Advanced Security, còn các tool kiểm tra tình trạng hệ thống chỉ có trên SonarQube Server.

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.
  • Dùng user token: trên SonarQube Server, chọn loại User Token, không chọn Global Analysis Token, để quyền truy cập tuân theo quyền project của một tài khoản.
  • Đặt ngày hết hạn: đặt ngày hết hạn cho token và xoay vòng trước khi token hết hạn.

Liên quan

Review

Nhận bình luận AI review trên mọi merge request và pull request.

Kết nối Semgrep

Cho agent phân loại các phát hiện phân tích tĩnh từ Semgrep.