CircleCI

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

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

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

เพิ่มเนื้อหาต่อไปนี้ลงในการกำหนดค่า MCP ของ Cursor:

{
  "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 ในเครื่อง

เพิ่มเนื้อหาต่อไปนี้ลงในการกำหนดค่า MCP ของ Cursor:

{
  "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 ใช้ การกำหนดค่าไคลเอนต์แบบต่อผู้ใช้ และเพิ่มลงในการกำหนดค่า MCP ของ Cursor (Cursor Settings → MCP)

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

• CircleCI Personal API token (เรียนรู้เพิ่มเติม)
• NPX: Node.js >= v18 และ 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 >= v18 และ 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 ของคุณไปที่สคริปต์นั้น

หากต้องการค้นหาหรือสร้างไฟล์กำหนดค่าของคุณ ให้เปิดการตั้งค่า Claude Desktop คลิก Developer ในแถบด้านข้างซ้าย จากนั้นคลิก Edit 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 >= v18 และ 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 >= v18 และ pnpm
• Docker: Docker

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

เพิ่มเนื้อหาต่อไปนี้ลงใน mcp_config.json ของ Windsurf:

{
  "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 ในเครื่อง

เพิ่มเนื้อหาต่อไปนี้ลงใน mcp_config.json ของ Windsurf:

{
  "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 ใช้ การกำหนดค่าไคลเอนต์แบบต่อผู้ใช้ ใน mcp_config.json ของ Windsurf

สำหรับข้อมูลเพิ่มเติม: https://docs.windsurf.com/windsurf/mcp

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

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

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

• Global: ~/.aws/amazonq/mcp.json — ใช้กับทุกเวิร์กสเปซ
• Workspace: .amazonq/mcp.json — เฉพาะเวิร์กสเปซปัจจุบัน

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

การใช้ 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 >= v18 และ 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. คลิก บันทึก

หากต้องการติดตั้ง 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 ของคุณสำหรับข้อผิดพลาดทางไวยากรณ์และความหมาย
• ให้ผลการตรวจสอบโดยละเอียดและคำแนะนำการกำหนดค่า
• ตัวอย่าง: "ตรวจสอบ CircleCI config ของฉัน"

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

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

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

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

• orgId, jobId, outputDir

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

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

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

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

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

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

2. ใช้ CircleCI Project URL:

   • ตัวอย่าง: "ค้นหา flaky tests ใน https://app.circleci.com/pipelines/github/org/repo"

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

   • ทำงานจาก workspace ในเครื่องโดยระบุ workspace root และ git remote URL
   • ตัวอย่าง: "ค้นหา flaky tests ในโปรเจกต์ปัจจุบันของฉัน"

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

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

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

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

ส่งคืนรายการ markdown ของงานที่ใช้งานน้อยจัดกลุ่มตามโปรเจกต์และ workflow — มีประโยชน์สำหรับการระบุโอกาสในการปรับต้นทุน

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

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

   • ใช้ list_followed_projects ก่อนเพื่อรับโปรเจกต์ของคุณ จากนั้น:
   • ตัวอย่าง: "รับ build failures สำหรับ my-project บน main branch"

2. ใช้ CircleCI URLs:

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

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

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

เครื่องมือส่งคืน logs ที่จัดรูปแบบรวมถึง:

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

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

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

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

2. ใช้ CircleCI URL:

   • Job URL: https://app.circleci.com/pipelines/github/org/repo/123/workflows/abc-def/jobs/789
   • Workflow URL: https://app.circleci.com/pipelines/github/org/repo/123/workflows/abc-def
   • Pipeline URL: https://app.circleci.com/pipelines/github/org/repo/123

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

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

เครื่องมือส่งคืน:

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

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

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. การใช้ Local Project Context:

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

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

---
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 เครื่องมือนี้ใช้งานได้สามวิธี:

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. การใช้ Local Project Context:

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

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

• ค้นหา URL สำหรับดาวน์โหลด build artifacts (binaries, reports, logs)
• ตรวจสอบว่า artifacts ใดถูกผลิตจาก pipeline run

แสดงรายการเวอร์ชันทั้งหมดสำหรับ component ของ CircleCI เฉพาะใน environment รวมถึงสถานะ deployment, ข้อมูล commit, และ timestamp

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

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

• ระบุว่าเวอร์ชันใดที่กำลังใช้งานอยู่
• เลือกเวอร์ชันเป้าหมายสำหรับการดำเนินการ rollback
• ดูรายละเอียด deployment (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 ทำงาน เครื่องมือนี้ใช้งานได้สามวิธี:

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 พร้อมแบรนช์
   • ตัวอย่าง: "Run the pipeline for https://app.circleci.com/pipelines/github/org/repo/123"

3. การใช้ Local Project Context:

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

เครื่องมือคืนลิงก์สำหรับติดตามการทำงานของ 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 ใน config ของคุณ:

   "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 หากอยู่หลัง firewall
• Firewall บล็อก: ตรวจสอบว่าซอฟต์แวร์ความปลอดภัยบล็อกการดาวน์โหลดแพ็กเกจหรือไม่

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

• ตำแหน่งไฟล์ config: ตรวจสอบเส้นทางสำหรับระบบปฏิบัติการของคุณอีกครั้ง
• ข้อผิดพลาด syntax: ตรวจสอบ JSON syntax ในไฟล์ config ของคุณ
• Console logs: ตรวจสอบ developer console ของ IDE สำหรับข้อผิดพลาดเฉพาะ
• ลองใช้ IDE อื่น: ทดสอบใน editor ที่รองรับอื่นเพื่อแยกปัญหา

กระบวนการค้าง — ฆ่า MCP processes ที่มีอยู่:

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

# Windows:
taskkill /f /im node.exe

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

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

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

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