CircleCI MCP Server

Что умеет сервер

CircleCI предлагает два MCP-сервера, и для записи важен первый: облачный сервер, который CircleCI запускает сама, так что ставить на компьютер ничего не нужно. Он подключает AI-ассистента к вашим запускам в CircleCI и закрывает диагностику сборок. Ассистент может получить список запусков проекта с фильтром по ветке и статусу, открыть запуск, его воркфлоу и задания, прочитать логи шагов (если шаг не назван, сервер сам берёт упавшие), посмотреть артефакты и результаты тестов, а также перезапустить или отменить воркфлоу. Есть и выгрузка данных об использовании организации в CSV за период до 31 дня.

Второй сервер встроен в CircleCI CLI и работает локально. Он открывает ассистенту весь CLI: проверку и генерацию конфигурации, управление контекстами и переменными окружения, орбы (orbs), политики и раннеры.

Когда использовать

Облачный сервер подходит для ежедневного разбора проблем: спросить, что упало в последнем запуске на ветке, показать лог упавшего задания, перезапустить только упавшие задания воркфлоу или выяснить, какие тесты не прошли. CLI-сервер выбирайте, когда ассистенту нужно писать и проверять конфигурацию или управлять орбами (orbs), а также если организация хочет держать учётные данные на машине разработчика, а не отправлять их на удалённый сервер.

Ограничения и безопасность

Прежний локальный сервер из пакета @circleci/mcp-server-circleci объявлен устаревшим: в его репозитории написано, что он больше не получает новых функций и репозиторий будет архивирован. Хранить в таком сервере персональный API-токен CircleCI не рекомендуется. Если он у вас настроен, документация советует удалить его перед подключением нового, например командой claude mcp remove circleci-mcp-server.

Облачному серверу нужен клиент с поддержкой удалённых MCP-серверов по streamable HTTP. Основной способ входа OAuth2 под вашей учётной записью CircleCI; персональный API-токен нужен только тем клиентам, которые не умеют OAuth2, и для автоматизации, причём хранить его следует в переменной окружения или хранилище секретов. Перезапуск и отмена воркфлоу меняют реальное состояние CI, поэтому на общих и боевых проектах проверяйте действие ассистента, прежде чем подтверждать.

Claude Code

Облачный сервер CircleCI находится по адресу https://mcp.circleci.com/v1/mcp. Добавьте его командой:

claude mcp add --transport http circleci-mcp-server https://mcp.circleci.com/v1/mcp

Затем выполните в Claude Code команду /mcp, выберите circleci-mcp-server и нажмите Authenticate, чтобы войти через OAuth2 в браузере.

Если клиент не умеет OAuth2, передайте персональный API-токен заголовком:

claude mcp add --transport http circleci-mcp-server https://mcp.circleci.com/v1/mcp \
  --header "Authorization: Bearer <your-circleci-token>"

Claude Desktop и claude.ai

Сервер есть в каталоге Claude Connectors Directory: откройте Settings, Customize, Connectors, найдите CircleCI и добавьте, затем пройдите вход OAuth2 в браузере. Можно добавить и как собственный коннектор: выберите Add custom connector, введите https://mcp.circleci.com/v1/mcp как адрес сервера и нажмите Add.

Cursor

Сервер есть в Cursor MCP Marketplace под именем circleci: Customize, MCP, найдите circleci, нажмите Add to Cursor и пройдите вход OAuth2. Можно добавить вручную в файл mcp.json:

{
  "mcpServers": {
    "circleci-mcp-server": {
      "url": "https://mcp.circleci.com/v1/mcp"
    }
  }
}

VS Code

Файл .vscode/mcp.json:

{
  "servers": {
    "circleci-mcp-server": {
      "type": "http",
      "url": "https://mcp.circleci.com/v1/mcp"
    }
  }
}

Windsurf

Файл mcp_config.json:

{
  "mcpServers": {
    "circleci-mcp-server": {
      "serverUrl": "https://mcp.circleci.com/v1/mcp"
    }
  }
}

Вход по персональному API-токену

Используйте этот способ, только если клиент не поддерживает OAuth2, или для автоматизации. Токен передают как bearer-токен в заголовке Authorization:

{
  "mcpServers": {
    "circleci-mcp-server": {
      "url": "https://mcp.circleci.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer <your-circleci-token>"
      }
    }
  }
}