CircleCI

ข้อกำหนดเบื้องต้น:

• CircleCI Personal API token (เรียนรู้เพิ่มเติม)
• NPX: Node.js ^22.23.4 || ^24.22.1 || >=26.12.1 และ pnpm
• Docker: Docker

ใช้ NPX ใน MCP Server ภายในเครื่อง

เพิ่มรายการต่อไปนี้ใน Cursor MCP config ของคุณ:

{
  "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 เป็นตัวเลือก — จำเป็นสำหรับลูกค้า on-prem เท่านั้น MAX_MCP_OUTPUT_LENGTH เป็นตัวเลือก — ความยาวเอาต์พุตสูงสุดสำหรับการตอบกลับของ MCP (ค่าเริ่มต้น: 50000)

ใช้ Docker ใน MCP Server ภายในเครื่อง

เพิ่มรายการต่อไปนี้ใน Cursor MCP config ของคุณ:

{
  "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"
      }
    }
  }
}

ใช้ Self-Managed Remote MCP Server

ดู Self-Managed Remote MCP Server ใช้ การกำหนดค่าไคลเอ็นต์รายผู้ใช้ แล้วเพิ่มลงใน Cursor MCP config ของคุณ (Cursor Settings → MCP)

ข้อกำหนดเบื้องต้น:

• CircleCI Personal API token (เรียนรู้เพิ่มเติม)
• NPX: Node.js ^22.23.4 || ^24.22.1 || >=26.12.1 และ pnpm
• Docker: Docker

ใช้ NPX ใน MCP Server ภายในเครื่อง

เพิ่มรายการต่อไปนี้ใน .vscode/mcp.json ในโปรเจกต์ของคุณ:

{
  "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}"
      }
    }
  }
}

💡 ระบบจะแจ้งให้ป้อนข้อมูลเมื่อเริ่มเซิร์ฟเวอร์ครั้งแรก จากนั้น VS Code จะจัดเก็บข้อมูลดังกล่าวอย่างปลอดภัย

ใช้ Docker ใน MCP Server ภายในเครื่อง

เพิ่มรายการต่อไปนี้ใน .vscode/mcp.json ในโปรเจกต์ของคุณ:

{
  "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}"
      }
    }
  }
}

ใช้ Self-Managed Remote MCP Server

ดู Self-Managed Remote MCP Server ใช้ การกำหนดค่าไคลเอ็นต์รายผู้ใช้ ใน .vscode/mcp.json

ข้อกำหนดเบื้องต้น:

• CircleCI Personal API token (เรียนรู้เพิ่มเติม)
• NPX: Node.js ^22.23.4 || ^24.22.1 || >=26.12.1 และ pnpm
• Docker: Docker

ใช้ NPX ใน MCP Server ภายในเครื่อง

เพิ่มรายการต่อไปนี้ใน claude_desktop_config.json ของคุณ:

{
  "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"
      }
    }
  }
}

ใช้ Docker ใน MCP Server ภายในเครื่อง

เพิ่มรายการต่อไปนี้ใน claude_desktop_config.json ของคุณ:

{
  "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"
      }
    }
  }
}

ใช้ Self-Managed Remote MCP Server

ดู Self-Managed Remote MCP Server สร้างสคริปต์ wrapper ตามที่แสดงใน ไคลเอ็นต์ Claude Desktop และ CLI จากนั้นกำหนด claude_desktop_config.json ให้ชี้ไปยังสคริปต์ดังกล่าว

หากต้องการค้นหาหรือสร้างไฟล์ config ให้เปิดการตั้งค่า Claude Desktop คลิก Developer ในแถบด้านข้างซ้าย แล้วคลิก Edit Config ไฟล์ config อยู่ที่:

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

ดูข้อมูลเพิ่มเติม: https://modelcontextprotocol.io/quickstart/user

ข้อกำหนดเบื้องต้น:

• CircleCI Personal API token (เรียนรู้เพิ่มเติม)
• NPX: Node.js ^22.23.4 || ^24.22.1 || >=26.12.1 และ pnpm
• Docker: Docker

ใช้ NPX ใน MCP Server ภายในเครื่อง

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

ใช้ Docker ใน MCP Server ภายในเครื่อง

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

ใช้ Self-Managed Remote MCP Server

ดู Self-Managed Remote MCP Server และการตั้งค่าไคลเอ็นต์ Claude Code ที่นั่น

ข้อกำหนดเบื้องต้น:

• CircleCI Personal API token (เรียนรู้เพิ่มเติม)
• NPX: Node.js ^22.23.4 || ^24.22.1 || >=26.12.1 และ pnpm
• Docker: Docker

ใช้ NPX ใน MCP Server ภายในเครื่อง

เพิ่มรายการต่อไปนี้ใน Windsurf mcp_config.json ของคุณ:

{
  "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"
      }
    }
  }
}

ใช้ Docker ใน MCP Server ภายในเครื่อง

เพิ่มรายการต่อไปนี้ใน Windsurf mcp_config.json ของคุณ:

{
  "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"
      }
    }
  }
}

ใช้ Self-Managed Remote MCP Server

ดู Self-Managed Remote MCP Server ใช้ การกำหนดค่าไคลเอ็นต์รายผู้ใช้ ใน Windsurf mcp_config.json ของคุณ

ดูข้อมูลเพิ่มเติม: https://docs.windsurf.com/windsurf/mcp

ข้อกำหนดเบื้องต้น:

• CircleCI Personal API token (เรียนรู้เพิ่มเติม)
• NPX: Node.js ^22.23.4 || ^24.22.1 || >=26.12.1 และ pnpm

การกำหนดค่าไคลเอ็นต์ MCP ใน Amazon Q Developer จัดเก็บในรูปแบบ JSON ในไฟล์ชื่อ mcp.json รองรับการกำหนดค่าสองระดับ:

• ส่วนกลาง: ~/.aws/amazonq/mcp.json — ใช้กับทุก workspace
• Workspace: .amazonq/mcp.json — ใช้เฉพาะกับ workspace ปัจจุบัน

หากมีไฟล์ทั้งสอง ไฟล์จะถูกรวมเนื้อหาเข้าด้วยกัน ในกรณีที่ขัดแย้งกัน config ของ workspace จะมีลำดับความสำคัญสูงกว่า

ใช้ NPX ใน MCP Server ภายในเครื่อง

แก้ไข ~/.aws/amazonq/mcp.json หรือสร้าง .amazonq/mcp.json โดยใช้เนื้อหาต่อไปนี้:

{
  "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
    }
  }
}

ใช้ Self-Managed Remote MCP Server

ดู Self-Managed Remote MCP Server ใช้สคริปต์ wrapper ตามที่แสดงใน ไคลเอ็นต์ Claude Desktop และ CLI จากนั้นลงทะเบียนสคริปต์ด้วย q mcp add

ข้อกำหนดเบื้องต้น:

• CircleCI Personal API token (เรียนรู้เพิ่มเติม)
• NPX: Node.js ^22.23.4 || ^24.22.1 || >=26.12.1 และ pnpm

ใช้ NPX ใน MCP Server ภายในเครื่อง

แก้ไข ~/.aws/amazonq/mcp.json หรือสร้าง .amazonq/mcp.json โดยใช้เนื้อหาต่อไปนี้:

{
  "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
    }
  }
}

ใช้ Self-Managed Remote MCP Server

ดู Self-Managed Remote MCP Server ใช้สคริปต์ wrapper ตามที่แสดงใน ไคลเอ็นต์ Claude Desktop และ CLI จากนั้นเพิ่มผ่าน UI การกำหนดค่า MCP:

1. เปิด UI การกำหนดค่า MCP
2. เลือกสัญลักษณ์ +
3. เลือกขอบเขต: global หรือ local
4. ป้อนชื่อ (เช่น circleci-remote-mcp)
5. เลือกโปรโตคอลการขนส่ง: stdio
6. ป้อนพาธคำสั่งไปยังสคริปต์ของคุณ
7. คลิก Save

หากต้องการติดตั้ง CircleCI MCP Server สำหรับ Claude Desktop โดยอัตโนมัติผ่าน Smithery:

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

ตัวอย่าง: "ค้นหา pipeline ล่าสุดที่ล้มเหลวบน branch ของฉัน แล้วดึง logs" — ดูตัวอย่างเพิ่มเติมได้ที่ wiki

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

ช่วยทำงานเกี่ยวกับการกำหนดค่า CircleCI โดยให้คำแนะนำและตรวจสอบความถูกต้อง

• ตรวจสอบ .circleci/config.yml ของคุณเพื่อหาข้อผิดพลาดด้านไวยากรณ์และความหมาย
• แสดงผลการตรวจสอบโดยละเอียดและคำแนะนำในการกำหนดค่า
• ตัวอย่าง: "ตรวจสอบ config ของ CircleCI ของฉัน"

ดาวน์โหลดข้อมูลการใช้งานจาก CircleCI Usage API สำหรับองค์กรที่ระบุ รองรับการป้อนวันที่ได้หลายรูปแบบ (เช่น "มีนาคม 2025" หรือ "เดือนที่แล้ว") ฟีเจอร์นี้ใช้ได้เฉพาะ Cloud

ตัวเลือกที่ 1: เริ่มงานส่งออกใหม่โดยระบุ:

• orgId, startDate, endDate (สูงสุด 32 วัน), outputDir

ตัวเลือกที่ 2: ตรวจสอบ/ดาวน์โหลดงานส่งออกที่มีอยู่โดยระบุ:

• orgId, jobId, outputDir

ส่งคืนไฟล์ CSV ที่มีข้อมูลการใช้งาน CircleCI สำหรับช่วงเวลาที่ระบุ

[!NOTE] สามารถป้อนข้อมูลการใช้งานให้เครื่องมือ find_underused_resource_classes เพื่อวิเคราะห์การปรับลดต้นทุนได้

ระบุการทดสอบที่ไม่เสถียรในโปรเจกต์ CircleCI ของคุณโดยวิเคราะห์ประวัติการทำงานของการทดสอบ ใช้ ฟีเจอร์ตรวจจับการทดสอบที่ไม่เสถียร ใน CircleCI

ใช้เครื่องมือนี้ได้สามวิธี:

1. ใช้ Project Slug (แนะนำ):

   • ใช้ list_followed_projects เพื่อดูโปรเจกต์ของคุณก่อน จากนั้น:
   • ตัวอย่าง: "ค้นหาการทดสอบที่ไม่เสถียรสำหรับ my-project"

2. ใช้ URL โปรเจกต์ CircleCI:

   • ตัวอย่าง: "ค้นหาการทดสอบที่ไม่เสถียรใน https://app.circleci.com/pipelines/github/org/repo"

3. ใช้บริบทโปรเจกต์ในเครื่อง:

   • ใช้งานจาก workspace ในเครื่องได้โดยระบุรากของ workspace และ URL git remote
   • ตัวอย่าง: "ค้นหาการทดสอบที่ไม่เสถียรในโปรเจกต์ปัจจุบันของฉัน"

โหมดเอาต์พุต:

• ข้อความ (ค่าเริ่มต้น): ส่งคืนรายละเอียดการทดสอบที่ไม่เสถียรในรูปแบบข้อความ
• ไฟล์ (ต้องใช้ตัวแปรสภาพแวดล้อม FILE_OUTPUT_DIRECTORY): สร้างไดเรกทอรีที่มีรายละเอียดการทดสอบที่ไม่เสถียร

วิเคราะห์ไฟล์ CSV ข้อมูลการใช้งาน CircleCI เพื่อค้นหา job ที่มีการใช้งาน CPU/RAM เฉลี่ยหรือสูงสุดต่ำกว่าเกณฑ์ที่กำหนด (ค่าเริ่มต้น: 40%)

ระบุไฟล์ CSV ที่ได้จาก download_usage_api_data

ส่งคืนรายการ Markdown ของ job ที่ใช้งานทรัพยากรต่ำกว่าที่ควร โดยจัดกลุ่มตามโปรเจกต์และ workflow ซึ่งมีประโยชน์ในการค้นหาโอกาสลดต้นทุน

ดึง logs รายละเอียดของความล้มเหลวจาก build ของ CircleCI ใช้เครื่องมือนี้ได้สามวิธี:

1. ใช้ Project Slug และ Branch (แนะนำ):

   • ใช้ list_followed_projects เพื่อดูโปรเจกต์ของคุณก่อน จากนั้น:
   • ตัวอย่าง: "ดึง build ที่ล้มเหลวของ my-project บน branch main"

2. ใช้ URL ของ CircleCI:

   • ระบุ URL ของ job หรือ pipeline ที่ล้มเหลวได้โดยตรง
   • ตัวอย่าง: "ดึง logs จาก https://app.circleci.com/pipelines/github/org/repo/123"

3. ใช้บริบทโปรเจกต์ในเครื่อง:

   • ใช้งานจาก workspace ในเครื่องได้โดยระบุรากของ workspace, URL git remote และชื่อ branch
   • ตัวอย่าง: "ค้นหา pipeline ล่าสุดที่ล้มเหลวบน branch ปัจจุบันของฉัน"

เครื่องมือจะแสดง logs ในรูปแบบที่จัดไว้ ซึ่งประกอบด้วย:

• ชื่อ job
• รายละเอียดการทำงานทีละขั้นตอน
• ข้อความแสดงความล้มเหลวและบริบท

ดึงข้อมูลเมตาของการทดสอบสำหรับ job ของ CircleCI ช่วยให้คุณวิเคราะห์ผลการทดสอบได้โดยไม่ต้องออกจาก IDE ใช้เครื่องมือนี้ได้สามวิธี:

1. ใช้ Project Slug และ Branch (แนะนำ):

   • ตัวอย่าง: "ดูผลการทดสอบของ my-project บน branch main"

2. ใช้ URL ของ CircleCI:

   • URL ของ job: https://app.circleci.com/pipelines/github/org/repo/123/workflows/abc-def/jobs/789
   • URL ของ workflow: https://app.circleci.com/pipelines/github/org/repo/123/workflows/abc-def
   • URL ของ pipeline: https://app.circleci.com/pipelines/github/org/repo/123

3. ใช้บริบทโปรเจกต์ในเครื่อง:

   • ใช้งานจาก workspace ในเครื่องได้โดยระบุรากของ workspace, URL git remote และชื่อ branch

เครื่องมือจะแสดงข้อมูลต่อไปนี้:

• สรุปการทดสอบทั้งหมด (จำนวนทั้งหมด สำเร็จ และล้มเหลว)
• ข้อมูลโดยละเอียดของการทดสอบที่ล้มเหลว: ชื่อ คลาส ไฟล์ ข้อความแสดงข้อผิดพลาด และระยะเวลา
• รายการการทดสอบที่สำเร็จพร้อมเวลา
• กรองตามผลการทดสอบ

[!NOTE] ต้องกำหนดค่าเมตาของการทดสอบใน config ของ CircleCI ดู รวบรวมข้อมูลการทดสอบ สำหรับคำแนะนำในการตั้งค่า

1. ใช้ Project Slug และ Branch (แนะนำ):

   • ตัวอย่าง: "Get the status of the latest pipeline for my-project on the main branch"

2. ใช้ CircleCI Project URL:

   • ตัวอย่าง: "Get the status of the latest pipeline for https://app.circleci.com/pipelines/github/org/repo"

3. ใช้บริบทโปรเจกต์ในเครื่อง:

   • ใช้งานจาก workspace ในเครื่องของคุณ โดยระบุ workspace root, git remote URL และชื่อ branch

ตัวอย่างผลลัพธ์:

---
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

ดึงรายการ artifacts ที่สร้างโดย CircleCI job เครื่องมือนี้ใช้ได้ 3 วิธี:

1. ใช้ Project Slug และ Branch (แนะนำ):

   • ใช้ list_followed_projects ก่อนเพื่อดูโปรเจกต์ของคุณ จากนั้น:
   • ตัวอย่าง: "List artifacts for my-project on the main branch"

2. ใช้ CircleCI URL:

   • Job URL: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def/jobs/789
   • Workflow URL: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def
   • Pipeline URL: https://app.circleci.com/pipelines/gh/organization/project/123

3. ใช้บริบทโปรเจกต์ในเครื่อง:

   • ใช้งานจาก workspace ในเครื่องของคุณ โดยระบุ workspace root, git remote URL และชื่อ branch

มีประโยชน์สำหรับ:

• ค้นหา URL สำหรับดาวน์โหลด build artifacts (ไบนารี รายงาน บันทึก)
• ตรวจสอบว่า pipeline run สร้าง artifacts ใดบ้าง

แสดงรายการเวอร์ชันทั้งหมดของ CircleCI component ที่ระบุใน environment โดยมีสถานะการ deploy ข้อมูล commit และ timestamp

เครื่องมือจะแจ้งให้คุณเลือก component และ environment หากไม่ได้ระบุไว้

มีประโยชน์สำหรับ:

• ระบุว่าเวอร์ชันใดกำลังใช้งานอยู่
• เลือกเวอร์ชันเป้าหมายสำหรับการ rollback
• ดูรายละเอียดการ deploy (pipeline, workflow, job)

แสดงรายการโปรเจกต์ทั้งหมดที่ผู้ใช้ติดตามบน CircleCI

• แสดงโปรเจกต์ทั้งหมดที่คุณมีสิทธิ์เข้าถึง พร้อม projectSlug
• ตัวอย่าง: "List my CircleCI projects"

ตัวอย่างผลลัพธ์:

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

[!NOTE] ต้องใช้ projectSlug (ไม่ใช่ชื่อโปรเจกต์) สำหรับเครื่องมือ CircleCI อื่นๆ อีกหลายรายการ

รัน workflow ซ้ำตั้งแต่เริ่มต้นหรือจาก job ที่ล้มเหลว

ส่งคืน ID ของ workflow ที่สร้างขึ้นใหม่และลิงก์สำหรับติดตาม

สั่งให้ pipeline ทำงาน เครื่องมือนี้ใช้ได้ 3 วิธี:

1. ใช้ Project Slug และ Branch (แนะนำ):

   • ตัวอย่าง: "Run the pipeline for my-project on the main branch"

2. ใช้ CircleCI URL:

   • Pipeline URL, Workflow URL, Job URL หรือ Project URL พร้อม branch
   • ตัวอย่าง: "Run the pipeline for https://app.circleci.com/pipelines/github/org/repo/123"

3. ใช้บริบทโปรเจกต์ในเครื่อง:

   • ใช้งานจาก workspace ในเครื่องของคุณ โดยระบุ workspace root, git remote URL และชื่อ branch

เครื่องมือจะแสดงลิงก์สำหรับติดตามการทำงานของ pipeline

สั่ง rollback สำหรับโปรเจกต์ CircleCI เครื่องมือจะแนะนำขั้นตอนแบบโต้ตอบดังนี้:

1. เลือกโปรเจกต์ — แสดงรายการโปรเจกต์ที่ติดตามเพื่อให้คุณเลือก
2. เลือก Environment — แสดงรายการ environment ที่พร้อมใช้งาน (เลือกให้อัตโนมัติหากมีเพียงรายการเดียว)
3. เลือก Component — แสดงรายการ component ที่พร้อมใช้งาน (เลือกให้อัตโนมัติหากมีเพียงรายการเดียว)
4. เลือกเวอร์ชัน — แสดงเวอร์ชันที่พร้อมใช้งานให้เลือกเป็นเป้าหมายสำหรับ rollback
5. ตรวจหาโหมด Rollback — ตรวจสอบว่ามีการกำหนดค่า rollback pipeline ไว้หรือไม่
6. ดำเนินการ Rollback — มีสองตัวเลือก:
   • Pipeline Rollback: สั่งให้ rollback pipeline ทำงาน
   • Workflow Rerun: รัน workflow ก่อนหน้าซ้ำโดยใช้ workflow ID
7. ยืนยัน — สรุปรายการและขอการยืนยันก่อนดำเนินการ

ปัญหาที่พบบ่อยที่สุด:

1. ล้างแคชของแพ็กเกจ:

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

2. บังคับใช้เวอร์ชันล่าสุด: เพิ่ม @latest ลงในการกำหนดค่าของคุณ:

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

3. รีสตาร์ท IDE ทั้งหมด (ไม่ใช่แค่โหลดหน้าต่างใหม่)

• ข้อผิดพลาด token ไม่ถูกต้อง: ตรวจสอบ CIRCLECI_TOKEN ของคุณใน Personal API Tokens
• ข้อผิดพลาดด้านสิทธิ์: ตรวจสอบว่า token มีสิทธิ์อ่านโปรเจกต์ของคุณ
• โหลด environment variables ไม่ได้: ทดสอบด้วย echo $CIRCLECI_TOKEN (Mac/Linux) หรือ echo %CIRCLECI_TOKEN% (Windows)

• Base URL: ยืนยันว่า CIRCLECI_BASE_URL คือ https://circleci.com
• เครือข่ายองค์กร: กำหนดค่า npm proxy หากอยู่หลังไฟร์วอลล์
• ไฟร์วอลล์บล็อก: ตรวจสอบว่าซอฟต์แวร์รักษาความปลอดภัยบล็อกการดาวน์โหลดแพ็กเกจหรือไม่

• เวอร์ชัน Node.js: ตรวจสอบว่าเป็นไปตาม ^22.23.4 || ^24.22.1 || >=26.12.1 โดยใช้ node --version
• อัปเดต Node.js: หากพบปัญหาความเข้ากันได้ ให้พิจารณาใช้ LTS รุ่นล่าสุด
• ตัวจัดการแพ็กเกจ: ตรวจสอบว่า npm/pnpm ทำงานได้: npm --version

• ตำแหน่งไฟล์กำหนดค่า: ตรวจสอบเส้นทางให้ตรงกับ OS ของคุณ
• ข้อผิดพลาดทางไวยากรณ์: ตรวจสอบไวยากรณ์ JSON ในไฟล์กำหนดค่า
• บันทึกคอนโซล: ตรวจสอบคอนโซลสำหรับนักพัฒนาของ IDE เพื่อดูข้อผิดพลาดเฉพาะ
• ลองใช้ IDE อื่น: ทดสอบใน editor อื่นที่รองรับเพื่อแยกหาสาเหตุของปัญหา

โปรเซสค้าง — ปิดโปรเซส MCP ที่มีอยู่:

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

# Windows:
taskkill /f /im node.exe

พอร์ตขัดแย้งกัน: รีสตาร์ท IDE หากดูเหมือนว่าการเชื่อมต่อถูกบล็อก

• ทดสอบแพ็กเกจโดยตรง: npx @circleci/mcp-server-circleci@latest --help
• บันทึกแบบละเอียด: DEBUG=* npx @circleci/mcp-server-circleci@latest
• ทางเลือก Docker: ลองติดตั้งด้วย Docker หาก npx ล้มเหลวอย่างต่อเนื่อง

ยังต้องการความช่วยเหลือหรือไม่?

1. ตรวจสอบ GitHub Issues ว่ามีปัญหาคล้ายกันหรือไม่
2. ระบุ OS, เวอร์ชัน Node และ IDE เมื่อรายงานปัญหา
3. แชร์ข้อความแสดงข้อผิดพลาดที่เกี่ยวข้องจากคอนโซล IDE