CircleCI MCP-сервер

Подключите вашего ИИ-ассистента к данным CircleCI для отладки сбоев, анализа тестов и улучшения конвейеров с помощью естественного языка.

Обзор MCP
Что может сделать MCP
Recommended setup
Начало работы
Доступные инструменты
Узнать больше

Контекст CI/CD для инструментов ИИ

Сервер CircleCI MCP делает вашу систему сборки понятной с помощью ИИ-инструментов, таких как Cursor, Claude Code, Windsurf и других. Он построен на Model Context Protocol (MCP) — лёгком стандарте, который позволяет агентам на базе LLM получать структурированные данные из внешних систем.

Подключаясь к серверу CircleCI MCP, агенты получают видимость в режиме реального времени:

Журналы сборки и тестовые результаты
Статусы конвейера
Недавние изменения конфигурации
Метрики производительности рабочих процессов

Это значит, что вместо того чтобы копаться в журналах заданий или интерфейсах панелей, вы можете спросить:

why did my last build fail?

и получить весь необходимый контекст, чтобы решить проблему и двигаться дальше, не сбавляя темп.

Превратите данные по сборке в действие

После установки сервер MCP делает ваши данные CI/CD доступными на естественном языке. Инструменты на базе LLM могут:

Диагностировать неудачные сборки
Получите структурированные сводки ошибок и логи.

Отследить сбой до последних изменений
Связать регрессии с коммитами, диффами или воркфлоу.

Точечные тесты на шелушащие
Модели поверхностной нестабильности из истории тестов.

рекомендую улучшения
Рекомендую оптимизации конфигураций или тайминга в контексте.

Внесите данные CI в ваш редактор< strong>
Используйте инструменты LLM, чтобы рассуждать по сборкам без переключения вкладок.</li> </ul> Имея доступ как к коду, так и к контексту сборки эти инструменты помогут быстрее исправлять ошибки, уверенно внедрять изменения и оставаться сосредоточенным на важной работе.

Recommended setup

For local editors — use the CircleCI CLI. The MCP server is built directly into the CLI, which is the recommended way to connect Cursor, VS Code, Claude Desktop, and similar tools to CircleCI.

For web-hosted agents like Claude.ai, or if company policy prefers — use the hosted MCP server, which connects via OAuth2 and requires no local install.

Both can be active at the same time.

Note for original local MCP users: Our original local MCP server is in maintenance mode and is no longer recommended. If you need to stay on the original server for now, use version 0.19.0 or later. Installs that use the @latest tag pick this up automatically; if you pin a specific version, point your configuration at @circleci/mcp-server-circleci@0.19.0.

Начните с MCP

CircleCI MCP Server работает локально и интегрируется с различными редакторами и инструментами разработки на основе LLM.

Ниже представлены готовые к использованию примеры конфигураций для установки MCP Server в предпочитаемой среде разработки.

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

Перед настройкой IDE убедитесь, что у вас есть следующее:

Персональный токен API CircleCI (PAT):
- Перейдите в раздел Настройки пользователя > Персональные токены API
- Нажмите Создать новый токен
- Скопируйте его и сохраните в надёжном месте — он будет использоваться как CIRCLECI_TOKEN при настройке
Для установки через NPX:
- Менеджер пакетов pnpm
- Node.js версии ≥ 18.0.0
Для установки через Docker:
- Docker

Инструкции по настройке

Cursor

С использованием NPX:


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

С использованием Docker:


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

Документация по настройке Cursor

VS Code

С использованием NPX:


{
  "inputs": [
    {
      "type": "promptString",
      "id": "circleci-token",
      "description": "Токен CircleCI API",
      "password": true
    },
    {
      "type": "promptString",
      "id": "circleci-base-url",
      "description": "Базовый URL CircleCI",
      "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}"
      }
    }
  }
}

С использованием Docker:


{
  "inputs": [
    {
      "type": "promptString",
      "id": "circleci-token",
      "description": "Токен CircleCI API",
      "password": true
    },
    {
      "type": "promptString",
      "id": "circleci-base-url",
      "description": "Базовый URL CircleCI",
      "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}"
      }
    }
  }
}

Документация по настройке VS Code

Claude Desktop

С использованием NPX:


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

С использованием Docker:


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

Расположение файла конфигурации:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Документация по настройке Claude Desktop

Claude Code

С использованием NPX:


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

С использованием Docker:


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

Документация по настройке Claude Code

Windsurf

С использованием NPX:


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

С использованием Docker:


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

Документация по настройке Windsurf

Amazon Q Developer / Kiro

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

Персональный токен API CircleCI
NPX: Node.js >= v18 и pnpm

Файлы конфигурации:
Amazon Q Developer и Kiro CLI хранят конфигурацию MCP-клиента в формате JSON. Пути к конфигурации различаются в зависимости от используемого инструмента:

Amazon Q Developer:
- Локальный: .amazonq/agents/default.json
- Глобальный: ~/.aws/amazonq/agents/default.json

Kiro CLI:
- Рабочее пространство: .kiro/settings/mcp.json
- Глобальный: ~/.kiro/settings/mcp.json

Пути Amazon Q Developer выше предназначены для агента по умолчанию. Если вы используете пользовательские агенты, добавьте конфигурацию MCP Server в файл конфигурации соответствующего агента.

Оба варианта являются необязательными. Если оба существуют, конфигурация считывается из обоих. Если один и тот же сервер определён в обоих, используется локальная конфигурация / конфигурация рабочего пространства.

С использованием NPX (локальный MCP Server):

Добавьте следующее в файл конфигурации:

{
  "mcpServers": {
    "circleci-local": {
      "command": "npx",
      "args": ["-y", "@circleci/mcp-server-circleci@latest"],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com" // необязательно, требуется только для on-premises
      },
      "timeout": 60000
    }
  }
}

С использованием самоуправляемого удалённого MCP Server:

Создайте скрипт-обёртку (например, circleci-remote-mcp.sh):

#!/bin/bash
export CIRCLECI_TOKEN="your-circleci-token"
npx mcp-remote http://your-circleci-remote-mcp-server-endpoint:8000/mcp --allow-http

Сделайте его исполняемым:

chmod +x circleci-remote-mcp.sh

Добавление удалённого сервера:

Через Kiro CLI:

kiro-cli mcp add --name circleci --command "/full/path/to/circleci-remote-mcp.sh"

Через интерфейс настройки Amazon Q MCP:

Выберите глобальную или локальную область
Введите имя сервера (например, circleci-remote-mcp)
Укажите транспортный протокол: stdio
Укажите команду: путь к скрипту-обёртке (например, /full/path/to/circleci-remote-mcp.sh)
Сохраните конфигурацию

Установка через Smithery


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

Доступные инструменты

От ускорения разработки на основе ИИ до оркестрации агентных рабочих процессов — каждый инструмент, предоставляемый MCP Server, обеспечивает разработчиков ИИ структурированным CI/CD-контекстом для более быстрых и надёжных циклов выпуска.

Инструмент	Назначение
`config_helper`	Исправить проблемы конфигурации до того, как они нарушат работу пайплайна
`create_prompt_template`	Создавать промпт-шаблоны для обеспечения согласованного поведения ИИ
`find_flaky_tests`	Выявлять и устранять нестабильные тесты
`get_build_failure_logs`	Быстрее отлаживать и устранять сбои сборки
`get_job_test_results`	Анализировать и исправлять ошибки тестов и проблемы с производительностью
`get_latest_pipeline_status`	Отслеживать состояние пайплайна и реагировать на изменения
`list_followed_projects`	Найти отслеживаемые проекты и их `projectSlug`
`recommend_prompt_template_tests`	Тестировать и повышать надёжность промптов
`rerun_workflow`	Перезапустить рабочий процесс с начала или с упавшего задания
`run_pipeline`	Запускать сборки, не покидая редактор
`run_rollback_pipeline`	Откатывать проблемные деплои одной командой

Узнать больше

Начните работу с CircleCI MCP Server, изучите примеры или следите за обновлениями платформы:

Репозиторий проекта – Исходный код, задачи и руководство по участию в разработке.
MCP Cookbook – Примеры промптов и паттерны использования инструментов.
Статья в блоге: Представляем CircleCI MCP Server – Предпосылки создания и варианты использования.
Журнал изменений CircleCI – Последние обновления платформы и выпуски новых функций.

Обзор

Функции

Интеграции

Роль

Варианты использования

Размер компании

Разработчикам

Исследуйте

Список изменений

Преимущества

Сравнение

Компания

Обзор

Функции

Интеграции

Роль

Варианты использования

Размер компании

Разработчикам

Исследуйте

Список изменений

Преимущества

Сравнение

Компания

CircleCI MCP-сервер

Контекст CI/CD для инструментов ИИ

Превратите данные по сборке в действие

Recommended setup

Начните с MCP

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

Инструкции по настройке

Доступные инструменты

Узнать больше