CircleCI MCP Server

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

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

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

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

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

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

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

{
  "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 ของคุณ (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 and CLI clients จากนั้นชี้ 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 ภายในเครื่อง

เพิ่มสิ่งต่อไปนี้ลงใน 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 >= 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 and CLI clients จากนั้นลงทะเบียนด้วย 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 and CLI clients จากนั้นเพิ่มผ่าน 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

ตัวอย่าง: "ค้นหาไปป์ไลน์ที่ล้มเหลวล่าสุดบนสาขาของฉันและรับบันทึก" — ดู wiki สำหรับตัวอย่างเพิ่มเติม

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

วิเคราะห์ git diff เทียบกับกฎ cursor เพื่อระบุการละเมิดกฎ

ระบุ:

• เนื้อหา Git diff (เช่น git diff --cached, git diff HEAD)
• กฎของที่เก็บ จาก .cursorrules หรือ .cursor/rules

ส่งคืนรายงานการละเมิดโดยละเอียดพร้อมคะแนนความเชื่อมั่นและคำอธิบาย

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

• การตรวจสอบคุณภาพโค้ดก่อนคอมมิต
• การรับประกันความสอดคล้องกับมาตรฐานการเขียนโค้ดของทีม
• การตรวจจับการละเมิดกฎก่อนการตรวจสอบโค้ด

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

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

สร้างเทมเพลตพรอมต์ที่มีโครงสร้างสำหรับแอปพลิเคชันที่เปิดใช้งาน AI ตามความต้องการคุณลักษณะ

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

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

ตัวเลือกที่ 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. การใช้ CircleCI Project URL:

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

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

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

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

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

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

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

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

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

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

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

2. การใช้ CircleCI URLs:

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

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

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

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

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

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

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

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

2. การใช้ CircleCI URL:

   • URL งาน: https://app.circleci.com/pipelines/github/org/repo/123/workflows/abc-def/jobs/789
   • URL เวิร์กโฟลว์: https://app.circleci.com/pipelines/github/org/repo/123/workflows/abc-def
   • URL ไปป์ไลน์: https://app.circleci.com/pipelines/github/org/repo/123

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

   • ทำงานจากพื้นที่ทำงานภายในเครื่องของคุณโดยระบุ root ของพื้นที่ทำงาน, URL ระยะไกลของ git และชื่อสาขา

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

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

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

ดึงข้อมูลสถานะของไปป์ไลน์ล่าสุดสำหรับสาขาที่กำหนด เครื่องมือนี้สามารถใช้ได้สามวิธี:

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

   • ตัวอย่าง: "รับสถานะของไปป์ไลน์ล่าสุดสำหรับ my-project บนสาขา main"

2. การใช้ CircleCI Project URL:

   • ตัวอย่าง: "รับสถานะของไปป์ไลน์ล่าสุดสำหรับ https://app.circleci.com/pipelines/github/org/repo"

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

   • ทำงานจากพื้นที่ทำงานภายในเครื่องของคุณโดยระบุ root ของพื้นที่ทำงาน, URL ระยะไกลของ git และชื่อสาขา

ตัวอย่างเอาต์พุต:

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

ดึงข้อมูลรายการอาร์ติแฟกต์ที่ผลิตโดยงาน CircleCI เครื่องมือนี้สามารถใช้ได้สามวิธี:

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

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

2. การใช้ CircleCI URL:

   • URL งาน: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def/jobs/789
   • URL เวิร์กโฟลว์: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def
   • URL ไปป์ไลน์: https://app.circleci.com/pipelines/gh/organization/project/123

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

   • ทำงานจากพื้นที่ทำงานภายในเครื่องของคุณโดยระบุ root ของพื้นที่ทำงาน, URL ระยะไกลของ git และชื่อสาขา

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

• การค้นหา URL ดาวน์โหลดสำหรับอาร์ติแฟกต์บิลด์ (ไบนารี, รายงาน, บันทึก)
• การตรวจสอบว่าอาร์ติแฟกต์ใดถูกผลิตโดยการรันไปป์ไลน์

แสดงรายการเวอร์ชันทั้งหมดสำหรับคอมโพเนนต์ CircleCI เฉพาะในสภาพแวดล้อม รวมถึงสถานะการปรับใช้ ข้อมูลคอมมิต และการประทับเวลา

เครื่องมือจะแจ้งให้คุณเลือกคอมโพเนนต์และสภาพแวดล้อมหากไม่ได้ระบุไว้

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

• การระบุว่าเวอร์ชันใดใช้งานจริงอยู่ในปัจจุบัน
• การเลือกเวอร์ชันเป้าหมายสำหรับการดำเนินการย้อนกลับ
• การรับรายละเอียดการปรับใช้ (ไปป์ไลน์, เวิร์กโฟลว์, งาน)

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

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

ตัวอย่างเอาต์พุต:

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

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

สร้างกรณีทดสอบสำหรับเทมเพลตพรอมต์เพื่อให้แน่ใจว่าให้ผลลัพธ์ตามที่คาดหวัง

• สร้างสถานการณ์การทดสอบที่หลากหลายตามเทมเพลตพรอมต์และ schema บริบทของคุณ
• ส่งคืนอาร์เรย์ของกรณีทดสอบที่แนะนำพร้อมชุดพารามิเตอร์ต่างๆ
• ตัวอย่าง: "สร้างการทดสอบสำหรับเทมเพลตพรอมต์นิทานก่อนนอนของฉัน"

เรียกใช้เวิร์กโฟลว์อีกครั้งตั้งแต่เริ่มต้นหรือจากงานที่ล้มเหลว

ส่งคืน ID ของเวิร์กโฟลว์ที่สร้างขึ้นใหม่และลิงก์เพื่อตรวจสอบ

เรียกใช้การทดสอบประเมินผล (หรือที่เรียกว่า "การทดสอบพรอมต์") บนไปป์ไลน์ CircleCI สร้างการกำหนดค่า CircleCI ที่เหมาะสมและทริกเกอร์ไปป์ไลน์โดยใช้การกำหนดค่านั้น

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

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

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

2. การใช้ CircleCI URL:

   • Project URL, Pipeline URL, Workflow URL หรือ Job URL
   • ตัวอย่าง: "เรียกใช้การทดสอบประเมินผลสำหรับ https://app.circleci.com/pipelines/gh/organization/project/123"

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

   • ทำงานจากพื้นที่ทำงานภายในเครื่องของคุณโดยระบุ root ของพื้นที่ทำงาน, URL ระยะไกลของ git และชื่อสาขา

เครื่องมือยอมรับไฟล์เทมเพลตพรอมต์และส่งคืน URL เพื่อตรวจสอบไปป์ไลน์ที่ถูกทริกเกอร์

[!NOTE] หากโปรเจกต์มีคำจำกัดความไปป์ไลน์หลายรายการ เครื่องมือจะส่งคืนรายการไปป์ไลน์ที่พร้อมใช้งานเพื่อให้คุณเลือก

ทริกเกอร์ให้ไปป์ไลน์ทำงาน เครื่องมือนี้สามารถใช้ได้สามวิธี:

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

   • ตัวอย่าง: "เรียกใช้ไปป์ไลน์สำหรับ my-project บนสาขา main"

2. การใช้ CircleCI URL:

   • Pipeline URL, Workflow URL, Job URL หรือ Project URL พร้อมสาขา
   • ตัวอย่าง: "เรียกใช้ไปป์ไลน์สำหรับ https://app.circleci.com/pipelines/github/org/repo/123"

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

   • ทำงานจากพื้นที่ทำงานภายในเครื่องของคุณโดยระบุ root ของพื้นที่ทำงาน, URL ระยะไกลของ git และชื่อสาขา

เครื่องมือส่งคืนลิงก์เพื่อตรวจสอบการดำเนินการของไปป์ไลน์

1. การเลือกโปรเจกต์ — แสดงรายการโปรเจกต์ที่ติดตามเพื่อให้คุณเลือก
2. การเลือกสภาพแวดล้อม — แสดงรายการสภาพแวดล้อมที่พร้อมใช้งาน (เลือกอัตโนมัติหากมีเพียงหนึ่ง)
3. การเลือกคอมโพเนนต์ — แสดงรายการคอมโพเนนต์ที่พร้อมใช้งาน (เลือกอัตโนมัติหากมีเพียงหนึ่ง)
4. การเลือกเวอร์ชัน — แสดงเวอร์ชันที่พร้อมใช้งาน คุณเลือกเป้าหมายสำหรับการย้อนกลับ
5. การตรวจจับโหมดการย้อนกลับ — ตรวจสอบว่ามีการกำหนดค่าไปป์ไลน์การย้อนกลับหรือไม่
6. ดำเนินการย้อนกลับ — สองตัวเลือก:
   • การย้อนกลับด้วยไปป์ไลน์: เรียกใช้ไปป์ไลน์การย้อนกลับ
   • การรันเวิร์กโฟลว์ใหม่: รันเวิร์กโฟลว์ก่อนหน้าใหม่โดยใช้รหัสเวิร์กโฟลว์
7. การยืนยัน — สรุปและยืนยันก่อนดำเนินการ

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

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

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

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

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

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

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

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

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

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

กระบวนการค้าง — ฆ่ากระบวนการ 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. รวมระบบปฏิบัติการ เวอร์ชัน Node และ IDE ของคุณเมื่อรายงานปัญหา
3. แชร์ข้อความข้อผิดพลาดที่เกี่ยวข้องจากคอนโซล IDE