Как подключить CircleCI к Cursor через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → CircleCI, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

CircleCI + Cursor

Дайте ИИ проверять CircleCI: пайплайны, воркфлоу и джобы, упавшие тесты и артефакты, метрики Insights и нестабильные тесты, контексты и имена переменных, а после вашего подтверждения запускать пайплайны, перезапускать и отменять воркфлоу.

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

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

CIRCLECI_TOKEN

Шаг 1 — Получите учётные данные

1. Войдите в CircleCI по адресу https://app.circleci.com и откройте User Settings → Personal API Tokens (https://app.circleci.com/settings/user/tokens).
2. Нажмите Create New Token, дайте токену имя и скопируйте его. Новые токены начинаются с CCIPAT_. Проектные API-токены из настроек проекта с API v2 не работают.
3. Вставьте токен в CIRCLECI_TOKEN как есть, без префикса, и установите коннектор. Он передаётся в заголовке Circle-Token только на circleci.com.
4. Проверьте настройку с помощью circleci_get_current_user, а затем circleci_list_collaborations, который показывает организации, в которых вы состоите.

Кто что видит: у токена те же права, что и у вашего пользователя CircleCI, во всех организациях, в которых вы состоите. Делитесь MCP-сервером только с теми, кому можно видеть эти сборки.

Слаги проектов: большинству инструментов нужен слаг проекта, который показан в Project Settings → Overview. Проекты через GitHub OAuth и Bitbucket Cloud используют gh/<org>/<repo> или bb/<workspace>/<repo> (например, gh/ivanov-tech/web-app); проекты через GitHub App и GitLab используют circleci/<organization id>/<project id>. Передавайте слаг как есть, вместе с косыми чертами.

Запускает сборки и останавливает текущую работу, поэтому ИИ сначала спрашивает: circleci_trigger_pipeline запускает новый пайплайн на ветке или теге. Ему нужен id определения из circleci_list_pipeline_definitions, а тому, в свою очередь, нужен id проекта из circleci_get_project; для проектов GitLab он недоступен. circleci_rerun_workflow перезапускает воркфлоу как новый воркфлоу: все джобы, только начиная с упавшей джобы или выбранные вами джобы. circleci_cancel_workflow останавливает выполняющийся воркфлоу, и ещё не начатые джобы уже не запустятся. Запуск и перезапуск расходуют кредиты и выполняют всё, что предусмотрено конфигурацией, включая джобы деплоя; отмена может оставить деплой незавершённым. Перед каждым таким вызовом ИИ называет проект, ветку, воркфлоу или джобы и ждёт вашего «да». При установке ни один инструмент не отключён, и ничто здесь не удаляет проекты, контексты или переменные.

Как выяснить, почему упала сборка: circleci_list_pipelines (сначала новые, при желании только по одной ветке), circleci_get_pipeline по id или circleci_get_pipeline_by_number по #номеру из приложения; затем circleci_list_pipeline_workflows и circleci_list_workflow_jobs, чтобы найти упавшую джобу и её номер. circleci_get_job даёт статус, длительность, executor, использованные контексты и веб-ссылку. circleci_list_job_tests считает пройденные, пропущенные и упавшие тесты и показывает каждый упавший тест с его сообщением (только для джоб, которые сохраняют результаты тестов). circleci_list_job_artifacts выводит сохранённые артефакты со ссылками на скачивание, для которых нужен тот же токен. Полные логи шагов есть только в приложении CircleCI, по web_url джобы.

Тренды и нестабильные тесты: circleci_get_workflow_metrics сводит все воркфлоу проекта за период от последних 24 часов до последних 90 дней (запуски, доля успешных, длительность, израсходованные кредиты, время восстановления), по одной ветке или по всем. circleci_get_workflow_summary показывает один воркфлоу за последние 90 дней и его тренд по сравнению с предыдущим периодом. circleci_list_flaky_tests выводит тесты, которые на одном и том же коммите и прошли, и упали, с числом таких случаев и потерянным временем. Данные Insights обновляются раз в сутки, а не в реальном времени.

Контексты и переменные: circleci_list_contexts нужен id организации из circleci_list_collaborations (или слаг организации, например gh/ivanov-tech, для организаций GitHub OAuth и Bitbucket). circleci_list_context_env_var_names и circleci_list_project_env_var_names возвращают только имена переменных окружения, но никогда их значения.

Пагинация: списки возвращают next_page_token; ИИ передаёт его обратно как page_token, пока он не станет пустым.

Частые ошибки: 401: токен неверный или отозван, либо это проектный API-токен; создайте персональный API-токен в User Settings. 404: слаг проекта неверный или ваш пользователь не видит проект; для проектов вне вашего доступа CircleCI отвечает 404, а не 403. 429: достигнут лимит запросов; подождите минуту и повторите.

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

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Cursor

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты CircleCI.

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

Примеры запросов

• «Почему упал последний пайплайн на main в gh/ivanov-tech/web-app? Покажи упавшую джобу, упавшие тесты с их сообщениями и ссылку на джобу.»
• «Какие тесты в gh/ivanov-tech/web-app нестабильны, сколько раз они падали случайно и сколько времени мы на них потеряли?»
• «Сравни все воркфлоу gh/ivanov-tech/web-app за последние 30 дней по всем веткам: доля успешных запусков, средняя длительность и израсходованные кредиты.»
• «Перезапусти воркфлоу деплоя из пайплайна #1482, начиная с упавшей джобы. Скажи, какие джобы запустятся снова, и спроси меня перед запуском.»
• «Запусти пайплайн на ветке release/2.4 с параметром deploy, равным true. Сначала покажи проект, ветку и параметры.»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT