CircleCI

Предварительные требования:

• Персональный API-токен CircleCI (подробнее)
• NPX: Node.js >= v18 и pnpm
• Docker: Docker

Использование NPX на локальном MCP-сервере

Добавьте следующее в конфигурацию 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-сервере

Добавьте следующее в конфигурацию 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"
      }
    }
  }
}

Использование самостоятельного удаленного MCP-сервера

См. Self-Managed Remote MCP Server. Используйте конфигурацию клиента для каждого пользователя и добавьте ее в конфигурацию Cursor MCP (Cursor Settings → MCP).

Предварительные требования:

• Персональный API-токен CircleCI (подробнее)
• NPX: Node.js >= v18 и pnpm
• Docker: Docker

Использование NPX на локальном MCP-сервере

Добавьте следующее в .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-сервере

Добавьте следующее в .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}"
      }
    }
  }
}

Использование самостоятельного удаленного MCP-сервера

См. Self-Managed Remote MCP Server. Используйте конфигурацию клиента для каждого пользователя в .vscode/mcp.json.

Предварительные требования:

• Персональный API-токен CircleCI (подробнее)
• NPX: Node.js >= v18 и pnpm
• Docker: Docker

Использование NPX на локальном MCP-сервере

Добавьте следующее в ваш 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-сервере

Добавьте следующее в ваш 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"
      }
    }
  }
}

Использование самостоятельного удаленного MCP-сервера

См. Self-Managed Remote MCP Server. Создайте скрипт-обертку, как показано в 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

Предварительные требования:

• Персональный API-токен CircleCI (подробнее)
• NPX: Node.js >= v18 и pnpm
• Docker: Docker

Использование NPX на локальном MCP-сервере

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

Использование Docker на локальном MCP-сервере

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

Использование самостоятельного удаленного MCP-сервера

См. Self-Managed Remote MCP Server и настройку клиента Claude Code там.

Предварительные требования:

• Персональный API-токен CircleCI (подробнее)
• NPX: Node.js >= v18 и pnpm
• Docker: Docker

Использование NPX на локальном MCP-сервере

Добавьте следующее в ваш 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-сервере

Добавьте следующее в ваш 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"
      }
    }
  }
}

Использование самостоятельного удаленного MCP-сервера

См. Self-Managed Remote MCP Server. Используйте конфигурацию клиента для каждого пользователя в вашем Windsurf mcp_config.json.

Для получения дополнительной информации: https://docs.windsurf.com/windsurf/mcp

Предварительные требования:

• Персональный API-токен CircleCI (подробнее)
• NPX: Node.js >= v18 и pnpm

Конфигурация MCP-клиента в Amazon Q Developer хранится в формате JSON в файле с именем mcp.json. Поддерживаются два уровня конфигурации:

• Глобальная: ~/.aws/amazonq/mcp.json — применяется ко всем рабочим пространствам
• Рабочего пространства: .amazonq/mcp.json — относится к текущему рабочему пространству

Если существуют оба файла, их содержимое объединяется. В случае конфликта приоритет имеет конфигурация рабочего пространства.

Использование NPX на локальном MCP-сервере

Отредактируйте ~/.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
    }
  }
}

Использование самостоятельного удаленного MCP-сервера

См. Self-Managed Remote MCP Server. Используйте скрипт-обертку, как показано в Claude Desktop and CLI clients, затем зарегистрируйте его с помощью q mcp add.

Предварительные требования:

• Персональный API-токен CircleCI (подробнее)
• NPX: Node.js >= v18 и pnpm

Использование NPX на локальном MCP-сервере

Отредактируйте ~/.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
    }
  }
}

Использование самостоятельного удаленного MCP-сервера

См. Self-Managed Remote MCP Server. Используйте скрипт-обертку, как показано в Claude Desktop and CLI clients, затем добавьте его через пользовательский интерфейс конфигурации MCP:

1. Откройте пользовательский интерфейс конфигурации MCP
2. Нажмите символ +
3. Выберите область действия: глобальная или локальная
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"

Генерирует структурированные шаблоны промптов для приложений с поддержкой ИИ на основе требований к функциям.

• Преобразует требования пользователя в оптимизированные шаблоны промптов
• Возвращает структурированный шаблон и схему контекста, определяющую необходимые входные параметры
• Пример: "Создай шаблон промпта для генерации сказок на ночь по возрасту и теме"

Загружает данные об использовании из 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. Использование контекста локального проекта:

   • Работает из вашего локального рабочего пространства, предоставляя корень рабочего пространства и URL удаленного git-репозитория
   • Пример: "Найти нестабильные тесты в моем текущем проекте"

Режимы вывода:

• Текст (по умолчанию): Возвращает детали нестабильных тестов в текстовом формате
• Файл (требуется переменная окружения FILE_OUTPUT_DIRECTORY): Создает директорию с деталями нестабильных тестов

Анализирует CSV-файл данных об использовании CircleCI для поиска заданий со средним или максимальным использованием CPU/RAM ниже заданного порога (по умолчанию: 40%).

Предоставьте CSV-файл, полученный из download_usage_api_data.

Возвращает список недозагруженных заданий в формате markdown, сгруппированных по проекту и рабочему процессу — полезно для выявления возможностей оптимизации затрат.

Извлекает подробные логи сбоев из сборок CircleCI. Этот инструмент можно использовать тремя способами:

1. Использование Project Slug и ветки (рекомендуется):

   • Сначала используйте list_followed_projects, чтобы получить ваши проекты, затем:
   • Пример: "Получить сбои сборки для my-project в ветке main"

2. Использование URL CircleCI:

   • Предоставьте URL упавшего задания или URL пайплайна напрямую
   • Пример: "Получить логи из https://app.circleci.com/pipelines/github/org/repo/123"

3. Использование контекста локального проекта:

   • Работает из вашего локального рабочего пространства, предоставляя корень рабочего пространства, URL удаленного git-репозитория и имя ветки
   • Пример: "Найти последний упавший пайплайн в моей текущей ветке"

Инструмент возвращает форматированные логи, включая:

• Имена заданий
• Пошаговые детали выполнения
• Сообщения о сбоях и контекст

Извлекает метаданные тестов для заданий CircleCI, позволяя анализировать результаты тестов, не покидая IDE. Этот инструмент можно использовать тремя способами:

1. Использование Project Slug и ветки (рекомендуется):

   • Пример: "Получить результаты тестов для my-project в ветке main"

2. Использование URL CircleCI:

   • 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. Использование контекста локального проекта:

   • Работает из вашего локального рабочего пространства, предоставляя корень рабочего пространства, URL удаленного git-репозитория и имя ветки

Инструмент возвращает:

• Сводку по всем тестам (всего, успешных, неудачных)
• Подробную информацию о неудачных тестах: имя, класс, файл, сообщение об ошибке, длительность
• Список успешных тестов с временем выполнения
• Фильтрацию по результату теста

[!NOTE] Метаданные тестов должны быть настроены в вашей конфигурации CircleCI. Смотрите Сбор данных тестов для инструкций по настройке.

Извлекает статус последнего пайплайна для указанной ветки. Этот инструмент можно использовать тремя способами:

1. Использование Project Slug и ветки (рекомендуется):

   • Пример: "Получить статус последнего пайплайна для my-project в ветке main"

2. Использование URL проекта CircleCI:

   • Пример: "Получить статус последнего пайплайна для https://app.circleci.com/pipelines/github/org/repo"

3. Использование контекста локального проекта:

   • Работает из вашего локального рабочего пространства, предоставляя корень рабочего пространства, 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 и ветки (рекомендуется):

   • Сначала используйте list_followed_projects, чтобы получить ваши проекты, затем:
   • Пример: "Список артефактов для my-project в ветке main"

2. Использование URL CircleCI:

   • 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. Использование контекста локального проекта:

   • Работает из вашего локального рабочего пространства, предоставляя корень рабочего пространства, 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.

Генерирует тестовые случаи для шаблонов промптов, чтобы гарантировать получение ожидаемых результатов.- Создает разнообразные тестовые сценарии на основе вашего шаблона промпта и схемы контекста

• Возвращает массив рекомендуемых тестовых случаев с различными комбинациями параметров
• Пример: "Сгенерируй тесты для моего шаблона промпта сказки на ночь"

Перезапускает рабочий процесс с начала или с упавшего задания.

Возвращает ID вновь созданного рабочего процесса и ссылку для его отслеживания.

Запускает оценочные тесты (также известные как "Промпт-тесты") в пайплайне CircleCI. Генерирует подходящую конфигурацию CircleCI и запускает пайплайн с её использованием.

Этот инструмент можно использовать тремя способами:

1. Используя Project Slug и ветку (Рекомендуется):

   • Сначала используйте list_followed_projects, чтобы получить свои проекты, затем:
   • Пример: "Запусти оценочные тесты для my-project на ветке main"

2. Используя URL CircleCI:

   • URL проекта, URL пайплайна, URL рабочего процесса или URL задания
   • Пример: "Запусти оценочные тесты для https://app.circleci.com/pipelines/gh/organization/project/123"

3. Используя контекст локального проекта:

   • Работает из вашего локального рабочего пространства, предоставляя корень рабочего пространства, URL удаленного git-репозитория и имя ветки

Инструмент принимает файлы шаблонов промптов и возвращает URL для отслеживания запущенного пайплайна.

[!NOTE] Если в проекте есть несколько определений пайплайнов, инструмент вернет список доступных пайплайнов для выбора.

Запускает пайплайн на выполнение. Этот инструмент можно использовать тремя способами:

1. Используя Project Slug и ветку (Рекомендуется):

   • Пример: "Запусти пайплайн для my-project на ветке main"

2. Используя URL CircleCI:

   • URL пайплайна, URL рабочего процесса, URL задания или URL проекта с веткой
   • Пример: "Запусти пайплайн для https://app.circleci.com/pipelines/github/org/repo/123"

3. Используя контекст локального проекта:

   • Работает из вашего локального рабочего пространства, предоставляя корень рабочего пространства, URL удаленного git-репозитория и имя ветки

Инструмент возвращает ссылку для отслеживания выполнения пайплайна.

Запускает откат для проекта CircleCI. Инструмент интерактивно проведет вас через:

1. Выбор проекта — показывает список отслеживаемых проектов для выбора
2. Выбор окружения — показывает список доступных окружений (автовыбор, если только одно)
3. Выбор компонента — показывает список доступных компонентов (автовыбор, если только один)
4. Выбор версии — отображает доступные версии; вы выбираете цель для отката
5. Определение режима отката — проверяет, настроен ли пайплайн отката
6. Выполнение отката — два варианта:
   • Откат пайплайна: запускает пайплайн отката
   • Перезапуск рабочего процесса: перезапускает предыдущий рабочий процесс, используя его ID
7. Подтверждение — суммирует и запрашивает подтверждение перед выполнением

Наиболее частые проблемы:

1. Очистите кэши пакетов:

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

2. Принудительно используйте последнюю версию: Добавьте @latest в ваш конфиг:

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

3. Полностью перезапустите IDE (а не просто перезагрузите окно)

• Ошибки недействительного токена: Проверьте ваш CIRCLECI_TOKEN в Personal API Tokens
• Ошибки доступа: Убедитесь, что у токена есть доступ на чтение к вашим проектам
• Переменные окружения не загружаются: Проверьте с помощью 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