CircleCI

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

• Mã thông báo API Cá nhân CircleCI (tìm hiểu thêm)
• NPX: Node.js >= v18 và pnpm
• Docker: Docker

Sử dụng NPX trong Máy chủ MCP cục bộ

Thêm phần sau vào cấu hình Cursor MCP của bạn:

{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "npx",
      "args": ["-y", "@circleci/mcp-server-circleci@latest"],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      }
    }
  }
}

CIRCLECI_BASE_URL là tùy chọn — chỉ bắt buộc đối với khách hàng tại chỗ. MAX_MCP_OUTPUT_LENGTH là tùy chọn — độ dài đầu ra tối đa cho các phản hồi MCP (mặc định: 50000).

Sử dụng Docker trong Máy chủ MCP cục bộ

Thêm phần sau vào cấu hình Cursor MCP của bạn:

{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "CIRCLECI_TOKEN",
        "-e",
        "CIRCLECI_BASE_URL",
        "-e",
        "MAX_MCP_OUTPUT_LENGTH",
        "circleci/mcp-server-circleci"
      ],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      }
    }
  }
}

Sử dụng Máy chủ MCP Từ xa Tự quản lý

Xem Máy chủ MCP Từ xa Tự quản lý. Sử dụng cấu hình ứng dụng khách cho từng người dùng và thêm nó vào cấu hình Cursor MCP của bạn (Cursor Settings → MCP).

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

• Mã thông báo API Cá nhân CircleCI (tìm hiểu thêm)
• NPX: Node.js >= v18 và pnpm
• Docker: Docker

Sử dụng NPX trong Máy chủ MCP cục bộ

Thêm phần sau vào .vscode/mcp.json trong dự án của bạn:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "circleci-token",
      "description": "CircleCI API Token",
      "password": true
    },
    {
      "type": "promptString",
      "id": "circleci-base-url",
      "description": "CircleCI Base URL",
      "default": "https://circleci.com"
    }
  ],
  "servers": {
    "circleci-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@circleci/mcp-server-circleci@latest"],
      "env": {
        "CIRCLECI_TOKEN": "${input:circleci-token}",
        "CIRCLECI_BASE_URL": "${input:circleci-base-url}"
      }
    }
  }
}

💡 Các đầu vào được nhắc khi khởi động máy chủ lần đầu, sau đó được VS Code lưu trữ an toàn.

Sử dụng Docker trong Máy chủ MCP cục bộ

Thêm phần sau vào .vscode/mcp.json trong dự án của bạn:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "circleci-token",
      "description": "CircleCI API Token",
      "password": true
    },
    {
      "type": "promptString",
      "id": "circleci-base-url",
      "description": "CircleCI Base URL",
      "default": "https://circleci.com"
    }
  ],
  "servers": {
    "circleci-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "CIRCLECI_TOKEN",
        "-e",
        "CIRCLECI_BASE_URL",
        "circleci/mcp-server-circleci"
      ],
      "env": {
        "CIRCLECI_TOKEN": "${input:circleci-token}",
        "CIRCLECI_BASE_URL": "${input:circleci-base-url}"
      }
    }
  }
}

Sử dụng Máy chủ MCP Từ xa Tự quản lý

Xem Máy chủ MCP Từ xa Tự quản lý. Sử dụng cấu hình ứng dụng khách cho từng người dùng trong .vscode/mcp.json.

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

• Mã thông báo API Cá nhân CircleCI (tìm hiểu thêm)
• NPX: Node.js >= v18 và pnpm
• Docker: Docker

Sử dụng NPX trong Máy chủ MCP cục bộ

Thêm phần sau vào claude_desktop_config.json của bạn:

{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "npx",
      "args": ["-y", "@circleci/mcp-server-circleci@latest"],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      }
    }
  }
}

Sử dụng Docker trong Máy chủ MCP cục bộ

Thêm phần sau vào claude_desktop_config.json của bạn:

{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "CIRCLECI_TOKEN",
        "-e",
        "CIRCLECI_BASE_URL",
        "-e",
        "MAX_MCP_OUTPUT_LENGTH",
        "circleci/mcp-server-circleci"
      ],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      }
    }
  }
}

Sử dụng Máy chủ MCP Từ xa Tự quản lý

Xem Máy chủ MCP Từ xa Tự quản lý. Tạo một tập lệnh bao bọc như được hiển thị trong Ứng dụng khách Claude Desktop và CLI, sau đó trỏ claude_desktop_config.json của bạn vào đó.

Để tìm hoặc tạo tệp cấu hình của bạn, hãy mở cài đặt Claude Desktop, nhấp vào Developer ở thanh bên trái, sau đó nhấp vào Edit Config. Tệp cấu hình nằm ở:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Để biết thêm thông tin: https://modelcontextprotocol.io/quickstart/user

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

• Mã thông báo API Cá nhân CircleCI (tìm hiểu thêm)
• NPX: Node.js >= v18 và pnpm
• Docker: Docker

Sử dụng NPX trong Máy chủ MCP cục bộ

claude mcp add circleci-mcp-server -e CIRCLECI_TOKEN=your-circleci-token -- npx -y @circleci/mcp-server-circleci@latest

Sử dụng Docker trong Máy chủ MCP cục bộ

claude mcp add circleci-mcp-server -e CIRCLECI_TOKEN=your-circleci-token -e CIRCLECI_BASE_URL=https://circleci.com -- docker run --rm -i -e CIRCLECI_TOKEN -e CIRCLECI_BASE_URL circleci/mcp-server-circleci

Sử dụng Máy chủ MCP Từ xa Tự quản lý

Xem Máy chủ MCP Từ xa Tự quản lý và thiết lập ứng dụng khách Claude Code ở đó.

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

• Mã thông báo API Cá nhân CircleCI (tìm hiểu thêm)
• NPX: Node.js >= v18 và pnpm
• Docker: Docker

Sử dụng NPX trong Máy chủ MCP cục bộ

Thêm phần sau vào mcp_config.json Windsurf của bạn:

{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "npx",
      "args": ["-y", "@circleci/mcp-server-circleci@latest"],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      }
    }
  }
}

Sử dụng Docker trong Máy chủ MCP cục bộ

Thêm phần sau vào mcp_config.json Windsurf của bạn:

{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "CIRCLECI_TOKEN",
        "-e",
        "CIRCLECI_BASE_URL",
        "-e",
        "MAX_MCP_OUTPUT_LENGTH",
        "circleci/mcp-server-circleci"
      ],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      }
    }
  }
}

Sử dụng Máy chủ MCP Từ xa Tự quản lý

Xem Máy chủ MCP Từ xa Tự quản lý. Sử dụng cấu hình ứng dụng khách cho từng người dùng trong mcp_config.json Windsurf của bạn.

Để biết thêm thông tin: https://docs.windsurf.com/windsurf/mcp

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

• Mã thông báo API Cá nhân CircleCI (tìm hiểu thêm)
• NPX: Node.js >= v18 và pnpm

Cấu hình ứng dụng khách MCP trong Amazon Q Developer được lưu trữ ở định dạng JSON trong một tệp có tên mcp.json. Hai cấp độ cấu hình được hỗ trợ:

• Toàn cục: ~/.aws/amazonq/mcp.json — áp dụng cho tất cả không gian làm việc
• Không gian làm việc: .amazonq/mcp.json — cụ thể cho không gian làm việc hiện tại

Nếu cả hai tệp tồn tại, nội dung của chúng được hợp nhất. Trong trường hợp xung đột, cấu hình không gian làm việc được ưu tiên.

Sử dụng NPX trong Máy chủ MCP cục bộ

Chỉnh sửa ~/.aws/amazonq/mcp.json hoặc tạo .amazonq/mcp.json với nội dung sau:

{
  "mcpServers": {
    "circleci-local": {
      "command": "npx",
      "args": [
        "-y",
        "@circleci/mcp-server-circleci@latest"
      ],
      "env": {
        "CIRCLECI_TOKEN": "YOUR_CIRCLECI_TOKEN",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      },
      "timeout": 60000
    }
  }
}

Sử dụng Máy chủ MCP Từ xa Tự quản lý

Xem Máy chủ MCP Từ xa Tự quản lý. Sử dụng tập lệnh bao bọc như được hiển thị trong Ứng dụng khách Claude Desktop và CLI, sau đó đăng ký nó với q mcp add.

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

• Mã thông báo API Cá nhân CircleCI (tìm hiểu thêm)
• NPX: Node.js >= v18 và pnpm

Sử dụng NPX trong Máy chủ MCP cục bộ

Chỉnh sửa ~/.aws/amazonq/mcp.json hoặc tạo .amazonq/mcp.json với nội dung sau:

{
  "mcpServers": {
    "circleci-local": {
      "command": "npx",
      "args": [
        "-y",
        "@circleci/mcp-server-circleci@latest"
      ],
      "env": {
        "CIRCLECI_TOKEN": "YOUR_CIRCLECI_TOKEN",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      },
      "timeout": 60000
    }
  }
}

Sử dụng Máy chủ MCP Từ xa Tự quản lý

Xem Máy chủ MCP Từ xa Tự quản lý. Sử dụng tập lệnh bao bọc như được hiển thị trong Ứng dụng khách Claude Desktop và CLI, sau đó thêm nó qua giao diện người dùng cấu hình MCP:

1. Truy cập giao diện người dùng cấu hình MCP
2. Chọn biểu tượng +
3. Chọn phạm vi: toàn cục hoặc cục bộ
4. Nhập tên (ví dụ: circleci-remote-mcp)
5. Chọn giao thức truyền tải: stdio
6. Nhập đường dẫn lệnh đến tập lệnh của bạn
7. Nhấp vào Save

Để cài đặt Máy chủ CircleCI MCP cho Claude Desktop tự động qua Smithery:

npx -y @smithery/cli install @CircleCI-Public/mcp-server-circleci --client claude

Ví dụ: "Tìm pipeline thất bại mới nhất trên nhánh của tôi và lấy nhật ký" — xem wiki để biết thêm ví dụ.

https://github.com/user-attachments/assets/3c765985-8827-442a-a8dc-5069e01edb74

Phân tích các khác biệt git dựa trên các quy tắc con trỏ để xác định vi phạm quy tắc.

Cung cấp:

• Nội dung khác biệt Git (ví dụ: git diff --cached, git diff HEAD)
• Quy tắc kho lưu trữ từ .cursorrules hoặc .cursor/rules

Trả về báo cáo vi phạm chi tiết với điểm tin cậy và giải thích.

Hữu ích cho:

• Kiểm tra chất lượng mã trước khi commit
• Đảm bảo tính nhất quán với tiêu chuẩn mã hóa của nhóm
• Phát hiện vi phạm quy tắc trước khi xem xét mã

Hỗ trợ các tác vụ cấu hình CircleCI bằng cách cung cấp hướng dẫn và xác thực.

• Xác thực .circleci/config.yml của bạn để tìm lỗi cú pháp và ngữ nghĩa
• Cung cấp kết quả xác thực chi tiết và đề xuất cấu hình
• Ví dụ: "Xác thực cấu hình CircleCI của tôi"

Tạo các mẫu lời nhắc có cấu trúc cho các ứng dụng hỗ trợ AI dựa trên yêu cầu tính năng.

• Chuyển đổi yêu cầu của người dùng thành các mẫu lời nhắc được tối ưu hóa
• Trả về một mẫu có cấu trúc và một lược đồ ngữ cảnh xác định các tham số đầu vào cần thiết
• Ví dụ: "Tạo một mẫu lời nhắc để tạo truyện trước khi đi ngủ theo độ tuổi và chủ đề"

Tải xuống dữ liệu sử dụng từ API Sử dụng CircleCI cho một tổ chức nhất định. Chấp nhận đầu vào ngày linh hoạt (ví dụ: "Tháng 3 năm 2025" hoặc "tháng trước"). Tính năng chỉ dành cho Cloud.

Tùy chọn 1: Bắt đầu một công việc xuất mới bằng cách cung cấp:

• orgId, startDate, endDate (tối đa 32 ngày), outputDir

Tùy chọn 2: Kiểm tra/tải xuống một công việc xuất hiện có bằng cách cung cấp:

• orgId, jobId, outputDir

Trả về một tệp CSV với dữ liệu sử dụng CircleCI cho khung thời gian đã chỉ định.

[!LƯU Ý] Dữ liệu sử dụng có thể được đưa vào công cụ find_underused_resource_classes để phân tích tối ưu hóa chi phí.

Xác định các bài kiểm tra không ổn định trong dự án CircleCI của bạn bằng cách phân tích lịch sử thực thi kiểm tra. Tận dụng tính năng phát hiện kiểm tra không ổn định trong CircleCI.

Công cụ này có thể được sử dụng theo ba cách:

1. Sử dụng Project Slug (Khuyến nghị):

   • Trước tiên, sử dụng list_followed_projects để lấy các dự án của bạn, sau đó:
   • Ví dụ: "Lấy các bài kiểm tra không ổn định cho my-project"

2. Sử dụng URL Dự án CircleCI:

   • Ví dụ: "Tìm các bài kiểm tra không ổn định trong https://app.circleci.com/pipelines/github/org/repo"

3. Sử dụng Ngữ cảnh Dự án Cục bộ:

   • Hoạt động từ không gian làm việc cục bộ của bạn bằng cách cung cấp thư mục gốc không gian làm việc và URL git remote
   • Ví dụ: "Tìm các bài kiểm tra không ổn định trong dự án hiện tại của tôi"

Chế độ đầu ra:

• Văn bản (mặc định): Trả về chi tiết kiểm tra không ổn định ở định dạng văn bản
• Tệp (yêu cầu biến môi trường FILE_OUTPUT_DIRECTORY): Tạo một thư mục với chi tiết kiểm tra không ổn định

Phân tích tệp CSV dữ liệu sử dụng CircleCI để tìm các công việc có mức sử dụng CPU/RAM trung bình hoặc tối đa dưới ngưỡng nhất định (mặc định: 40%).

Cung cấp tệp CSV thu được từ download_usage_api_data.

Trả về danh sách markdown các công việc ít được sử dụng được tổ chức theo dự án và quy trình làm việc — hữu ích cho việc xác định cơ hội tối ưu hóa chi phí.

Truy xuất nhật ký lỗi chi tiết từ các bản dựng CircleCI. Công cụ này có thể được sử dụng theo ba cách:

1. Sử dụng Project Slug và Nhánh (Khuyến nghị):

   • Trước tiên, sử dụng list_followed_projects để lấy các dự án của bạn, sau đó:
   • Ví dụ: "Lấy lỗi bản dựng cho my-project trên nhánh main"

2. Sử dụng URL CircleCI:

   • Cung cấp trực tiếp URL công việc thất bại hoặc URL pipeline
   • Ví dụ: "Lấy nhật ký từ https://app.circleci.com/pipelines/github/org/repo/123"

3. Sử dụng Ngữ cảnh Dự án Cục bộ:

   • Hoạt động từ không gian làm việc cục bộ của bạn bằng cách cung cấp thư mục gốc không gian làm việc, URL git remote và tên nhánh
   • Ví dụ: "Tìm pipeline thất bại mới nhất trên nhánh hiện tại của tôi"

Công cụ trả về nhật ký được định dạng bao gồm:

• Tên công việc
• Chi tiết thực thi từng bước
• Thông báo lỗi và ngữ cảnh

Truy xuất siêu dữ liệu kiểm tra cho các công việc CircleCI, cho phép bạn phân tích kết quả kiểm tra mà không cần rời khỏi IDE. Công cụ này có thể được sử dụng theo ba cách:

1. Sử dụng Project Slug và Nhánh (Khuyến nghị):

   • Ví dụ: "Lấy kết quả kiểm tra cho my-project trên nhánh main"

2. Sử dụng URL CircleCI:

   • URL Công việc: https://app.circleci.com/pipelines/github/org/repo/123/workflows/abc-def/jobs/789
   • URL Quy trình làm việc: https://app.circleci.com/pipelines/github/org/repo/123/workflows/abc-def
   • URL Pipeline: https://app.circleci.com/pipelines/github/org/repo/123

3. Sử dụng Ngữ cảnh Dự án Cục bộ:

   • Hoạt động từ không gian làm việc cục bộ của bạn bằng cách cung cấp thư mục gốc không gian làm việc, URL git remote và tên nhánh

Công cụ trả về:

• Tóm tắt tất cả các bài kiểm tra (tổng số, thành công, thất bại)
• Thông tin chi tiết về các bài kiểm tra thất bại: tên, lớp, tệp, thông báo lỗi, thời lượng
• Danh sách các bài kiểm tra thành công với thời gian
• Lọc theo kết quả kiểm tra

[!LƯU Ý] Siêu dữ liệu kiểm tra phải được cấu hình trong cấu hình CircleCI của bạn. Xem Thu thập Dữ liệu Kiểm tra để biết hướng dẫn thiết lập.

Truy xuất trạng thái của pipeline mới nhất cho một nhánh nhất định. Công cụ này có thể được sử dụng theo ba cách:

1. Sử dụng Project Slug và Nhánh (Khuyến nghị):

   • Ví dụ: "Lấy trạng thái của pipeline mới nhất cho my-project trên nhánh main"

2. Sử dụng URL Dự án CircleCI:

   • Ví dụ: "Lấy trạng thái của pipeline mới nhất cho https://app.circleci.com/pipelines/github/org/repo"

3. Sử dụng Ngữ cảnh Dự án Cục bộ:

   • Hoạt động từ không gian làm việc cục bộ của bạn bằng cách cung cấp thư mục gốc không gian làm việc, URL git remote và tên nhánh

Ví dụ đầu ra:

---
Workflow: build
Status: success
Duration: 5 minutes
Created: 4/20/2025, 10:15:30 AM
Stopped: 4/20/2025, 10:20:45 AM
---
Workflow: test
Status: running
Duration: unknown
Created: 4/20/2025, 10:21:00 AM
Stopped: in progress

Truy xuất danh sách các tạo phẩm được tạo ra bởi một công việc CircleCI. Công cụ này có thể được sử dụng theo ba cách:

1. Sử dụng Project Slug và Nhánh (Khuyến nghị):

   • Trước tiên, sử dụng list_followed_projects để lấy các dự án của bạn, sau đó:
   • Ví dụ: "Liệt kê các tạo phẩm cho my-project trên nhánh main"

2. Sử dụng URL CircleCI:

   • URL Công việc: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def/jobs/789
   • URL Quy trình làm việc: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def
   • URL Pipeline: https://app.circleci.com/pipelines/gh/organization/project/123

3. Sử dụng Ngữ cảnh Dự án Cục bộ:

   • Hoạt động từ không gian làm việc cục bộ của bạn bằng cách cung cấp thư mục gốc không gian làm việc, URL git remote và tên nhánh

Hữu ích cho:

• Tìm URL tải xuống cho các tạo phẩm bản dựng (tệp nhị phân, báo cáo, nhật ký)
• Kiểm tra những tạo phẩm nào đã được tạo ra bởi một lần chạy pipeline

Liệt kê tất cả các phiên bản cho một thành phần CircleCI cụ thể trong một môi trường. Bao gồm trạng thái triển khai, thông tin commit và dấu thời gian.

Công cụ sẽ nhắc bạn chọn thành phần và môi trường nếu không được cung cấp.

Hữu ích cho:

• Xác định phiên bản nào hiện đang hoạt động
• Chọn phiên bản mục tiêu cho các hoạt động khôi phục
• Lấy chi tiết triển khai (pipeline, quy trình làm việc, công việc)

Liệt kê tất cả các dự án mà người dùng đang theo dõi trên CircleCI.

• Hiển thị tất cả các dự án bạn có quyền truy cập với projectSlug của chúng
• Ví dụ: "Liệt kê các dự án CircleCI của tôi"

Ví dụ đầu ra:

Projects followed:
1. my-project (projectSlug: gh/organization/my-project)
2. another-project (projectSlug: gh/organization/another-project)

[!LƯU Ý] projectSlug (không phải tên dự án) là bắt buộc đối với nhiều công cụ CircleCI khác.

Tạo các trường hợp kiểm thử cho các mẫu lời nhắc để đảm bảo chúng tạo ra kết quả mong đợi.

• Tạo các kịch bản kiểm thử đa dạng dựa trên mẫu prompt và lược đồ ngữ cảnh của bạn
• Trả về một mảng các ca kiểm thử được đề xuất với nhiều tổ hợp tham số khác nhau
• Ví dụ: "Tạo các bài kiểm thử cho mẫu prompt truyện kể trước khi đi ngủ của tôi"

Chạy lại một workflow từ đầu hoặc từ job bị lỗi.

Trả về ID của workflow mới được tạo và một liên kết để theo dõi nó.

Chạy các bài kiểm thử đánh giá (còn được gọi là "Prompt Tests") trên một pipeline CircleCI. Tạo một cấu hình CircleCI phù hợp và kích hoạt một pipeline sử dụng cấu hình đó.

Công cụ này có thể được sử dụng theo ba cách:

1. Sử dụng Project Slug và Branch (Khuyến nghị):

   • Trước tiên, sử dụng list_followed_projects để lấy danh sách dự án của bạn, sau đó:
   • Ví dụ: "Chạy các bài kiểm thử đánh giá cho my-project trên nhánh main"

2. Sử dụng URL CircleCI:

   • URL Dự án, URL Pipeline, URL Workflow hoặc URL Job
   • Ví dụ: "Chạy các bài kiểm thử đánh giá cho https://app.circleci.com/pipelines/gh/organization/project/123"

3. Sử dụng Ngữ cảnh Dự án Cục bộ:

   • Hoạt động từ không gian làm việc cục bộ của bạn bằng cách cung cấp thư mục gốc của không gian làm việc, URL git remote và tên nhánh

Công cụ chấp nhận các tệp mẫu prompt và trả về một URL để theo dõi pipeline đã được kích hoạt.

[!LƯU Ý] Nếu dự án có nhiều định nghĩa pipeline, công cụ sẽ trả về danh sách các pipeline khả dụng để bạn lựa chọn.

Kích hoạt một pipeline để chạy. Công cụ này có thể được sử dụng theo ba cách:

1. Sử dụng Project Slug và Branch (Khuyến nghị):

   • Ví dụ: "Chạy pipeline cho my-project trên nhánh main"

2. Sử dụng URL CircleCI:

   • URL Pipeline, URL Workflow, URL Job hoặc URL Dự án kèm nhánh
   • Ví dụ: "Chạy pipeline cho https://app.circleci.com/pipelines/github/org/repo/123"

3. Sử dụng Ngữ cảnh Dự án Cục bộ:

   • Hoạt động từ không gian làm việc cục bộ của bạn bằng cách cung cấp thư mục gốc của không gian làm việc, URL git remote và tên nhánh

Công cụ trả về một liên kết để theo dõi quá trình thực thi pipeline.

Kích hoạt rollback cho một dự án CircleCI. Công cụ sẽ tương tác hướng dẫn bạn qua các bước:

1. Chọn Dự án — liệt kê các dự án đã theo dõi để bạn chọn
2. Chọn Môi trường — liệt kê các môi trường khả dụng (tự động chọn nếu chỉ có một)
3. Chọn Thành phần — liệt kê các thành phần khả dụng (tự động chọn nếu chỉ có một)
4. Chọn Phiên bản — hiển thị các phiên bản khả dụng; bạn chọn mục tiêu để rollback
5. Phát hiện Chế độ Rollback — kiểm tra xem pipeline rollback đã được cấu hình chưa
6. Thực thi Rollback — hai tùy chọn:
   • Pipeline Rollback: kích hoạt pipeline rollback
   • Chạy lại Workflow: chạy lại một workflow trước đó bằng ID workflow của nó
7. Xác nhận — tóm tắt và xác nhận trước khi thực thi

Các vấn đề phổ biến nhất:

1. Xóa bộ nhớ đệm gói:

   npx clear-npx-cache
   npm cache clean --force
   

2. Ép buộc phiên bản mới nhất: Thêm @latest vào cấu hình của bạn:

   "args": ["-y", "@circleci/mcp-server-circleci@latest"]
   

3. Khởi động lại hoàn toàn IDE của bạn (không chỉ tải lại cửa sổ)

• Lỗi token không hợp lệ: Xác minh CIRCLECI_TOKEN của bạn trong Personal API Tokens
• Lỗi quyền: Đảm bảo token có quyền đọc đối với các dự án của bạn
• Biến môi trường không tải: Kiểm tra với echo $CIRCLECI_TOKEN (Mac/Linux) hoặc echo %CIRCLECI_TOKEN% (Windows)

• URL Cơ sở: Xác nhận CIRCLECI_BASE_URL là https://circleci.com
• Mạng công ty: Cấu hình cài đặt proxy npm nếu đứng sau tường lửa
• Tường lửa chặn: Kiểm tra xem phần mềm bảo mật có chặn tải xuống gói không

• Phiên bản Node.js: Đảm bảo >= 18.0.0 với node --version
• Cập nhật Node.js: Cân nhắc LTS mới nhất nếu gặp vấn đề tương thích
• Trình quản lý gói: Xác minh npm/pnpm đang hoạt động: npm --version

• Vị trí tệp cấu hình: Kiểm tra kỹ đường dẫn cho hệ điều hành của bạn
• Lỗi cú pháp: Xác thực cú pháp JSON trong tệp cấu hình của bạn
• Nhật ký console: Kiểm tra console nhà phát triển của IDE để tìm lỗi cụ thể
• Thử một IDE khác: Kiểm tra trong một trình soạn thảo được hỗ trợ khác để cô lập vấn đề

Tiến trình treo — hủy các tiến trình MCP hiện có:

# Mac/Linux:
pkill -f "mcp-server-circleci"

# Windows:
taskkill /f /im node.exe

Xung đột cổng: Khởi động lại IDE của bạn nếu kết nối dường như bị chặn.

• Kiểm tra gói trực tiếp: npx @circleci/mcp-server-circleci@latest --help
• Ghi nhật ký chi tiết: DEBUG=* npx @circleci/mcp-server-circleci@latest
• Phương án thay thế Docker: Thử cài đặt Docker nếu npx liên tục thất bại

Vẫn cần trợ giúp?

1. Kiểm tra GitHub Issues để tìm các vấn đề tương tự
2. Bao gồm hệ điều hành, phiên bản Node và IDE của bạn khi báo cáo sự cố
3. Chia sẻ các thông báo lỗi liên quan từ console IDE