Автоматический деплой из Claude Code / Cursor в Vercel — три рабочих процесса с MCP, Plugin и GitHub Actions

«Claude Code уже сделал правку — теперь я вручную делаю push и открываю дашборд Vercel в браузере…» Чтобы сократить эти переключения, Vercel официально предлагает три инструмента: Vercel MCP (сервер, через который AI-инструменты работают с вашими проектами, деплоями и логами Vercel), Vercel Plugin (расширение, добавляющее знания о Vercel и slash-команды в Claude Code, Cursor и другие) и Agent Skills (наборы инструкций, которые ставятся командой npx skills add). Названия похожи, а роли вроде бы пересекаются, поэтому в ходу путаные объяснения вроде «подключить Agent Skills через MCP».

Сначала вывод: деплой из AI-агента в Vercel удобно рассматривать как три подхода. ① Git-интеграции (git push → автодеплой) хватает для большей части сольной работы. ② Прямо из редактора (Vercel MCP, Vercel Plugin) — для тех, кто хочет отдать AI и всё, что вокруг деплоя: чтение логов, работу с переменными окружения. ③ GitHub Actions + Claude Code Action — для команд, которые хотят, чтобы @claude правил код по комментариям в PR, а публикация шла только после тестов или одобрения. «Лучшего» варианта нет: всё решает, сколько вы отдаёте AI и где его останавливает человек.

Статья написана после повторного чтения оригинальной документации Vercel и Anthropic 30 сентября 2026 года. Примеры конфигурации, команды и условия тарифов приведены по состоянию на эту дату (и то и другое быстро меняется — проверьте страницы по ссылкам, прежде чем полагаться). Полезно прочитать вместе с этим: AI рекомендует Vercel, Что такое Cursor и Может ли AI взять на себя инфраструктуру?.

1. «Agent Skills», «MCP» и «Plugin» — разные вещи

Даже когда код пишет AI, проверка деплоя живёт на другом экране: вернуться в терминал ради git add . && git commit -m "fix" && git push, открыть дашборд Vercel в браузере, скопировать preview URL и вставить в Slack. Vercel постепенно добавлял входы, рассчитанные на AI, чтобы сократить эти переключения.

Если выстроить их по времени, путаница исчезает. 4 августа 2025 года Vercel MCP вышел в публичную бету (анонс Vercel) — это удалённый MCP-сервер с аутентификацией через OAuth по адресу https://mcp.vercel.com. В том же месяце, в августе 2025 года, Claude Code GitHub Action от Anthropic достиг версии 1.0 (тег v1.0.0 датирован 2025-08-25). 17 марта 2026 года вышел Vercel Plugin (анонс), а 23 июля 2026 года Vercel MCP научился деплоить код напрямую (анонс).

И Agent Skills — это не MCP. Страница Agent Skills у Vercel описывает их как упакованные возможности, которые ставятся через npx skills add <owner/repo> и учат агента определённому способу работы; они работают более чем в 18 агентах, включая Claude Code, GitHub Copilot и Cursor. Если MCP — средство действовать в вашем аккаунте, то Skills — это знание, как именно. См. также Что такое MCP и Claude Agent SDK.

2. Пять входов в Vercel: что умеет каждый и как он аутентифицируется

Вот пути, которыми AI-агент может добраться до Vercel, так, как их описывает официальная документация (по состоянию на 30 сентября 2026 года). Столбец «аутентификация» — то, что вы отдаёте AI, — определяет, насколько тяжёлой может оказаться авария.

Источники: Vercel MCP, справочник инструментов MCP, Vercel Plugin, Agent Skills, почему коммиты не запускают деплой (KB Vercel).

Как читать таблицу: если нужно только «чтобы деплоилось», Git-интеграции достаточно. MCP и Plugin окупаются, когда разговор должен охватывать и то, что вокруг деплоя: дать AI прочитать логи и понять, почему упала сборка, показать различия в переменных окружения, откатить продакшн на шаг назад.

3. Три подхода с первого взгляда

Вот три подхода по осям что получает AI × глубина автоматизации × где его останавливает человек.

Ориентиры: если после деплоя вы часто открываете дашборд только ради логов — берите ②. Если ревью PR — рутина и выпускать хочется только проверенные изменения — берите ③. Для личного блога или небольшого приложения хватит ①: лишнее усложнение стоит больше в поддержке, чем экономит. Подходы не исключают друг друга; обычно ① служит основой, а сверху добавляется ② или ③.

4. Подход 1: Git-интеграция (автодеплой по git push)

Самая простая схема. Свяжите Vercel с GitHub — и Vercel будет собирать проект при каждом git push и публиковать по окончании сборки. Задача AI сводится к тому, чтобы написать код, написать сообщение коммита и сделать push. Собственное руководство Vercel по GitHub Actions говорит: поскольку Git-интеграция уже даёт preview URL, неизменяемые деплои и мгновенный откат, большинству команд пайплайн вообще не нужен.

# Настройка (один раз)
1. Дашборд Vercel → Add New → Project
2. Выбрать репозиторий GitHub → Import
3. Framework Preset: определяется автоматически (Next.js и др.)
4. Environment Variables: добавить при необходимости
5. Deploy

# Ежедневный процесс (внутри Cursor / Claude Code)
> Сделай эту кнопку красной. Когда закончишь, запушь в ветку feature/red-button.

# Команды, которые выполняет AI
git switch -c feature/red-button
git add app/components/Button.tsx
git commit -m "feat: change primary button to red"
git push -u origin feature/red-button

# Vercel собирает preview → в PR появляется preview URL

Настоящая ценность здесь в том, что каждая ветка автоматически получает свой preview URL. Preview URL у Vercel бывают двух видов: URL ветки, который всегда указывает на её последнее состояние, и URL коммита, который указывает ровно на этот деплой (Environments). Если в продакшн попадают только merge в main, AI может пушить сколько угодно — всё останавливается на preview.

Внимание: тариф Hobby ограничен личным некоммерческим использованием (тариф Hobby). В сутки можно создать 100 деплоев на Hobby и 6000 на Pro, а Hobby выполняет одну сборку за раз (Limits). Если AI пушит мелкими шагами, вы упрётесь в эти лимиты раньше всего. О ценовых ловушках см. §5 в статье AI рекомендует Vercel.

5. Подход 2: прямо из редактора (Vercel MCP и Vercel Plugin)

Чтобы отдать AI всё, что вокруг деплоя, используйте Vercel MCP или Vercel Plugin. Ни тот ни другой не требует записывать токен в файл.

Настройка Vercel MCP (Cursor): по официальной инструкции достаточно одной строки URL в .cursor/mcp.json (на уровне проекта или глобально).

{
  "mcpServers": {
    "vercel": {
      "url": "https://mcp.vercel.com"
    }
  }
}

После добавления Cursor пытается подключиться и показывает Needs login. Нажмите — в браузере откроется вход в Vercel, где вы выберете команды, которыми Cursor может пользоваться. В Claude Code это две строки:

claude mcp add --transport http vercel https://mcp.vercel.com
# затем запустите claude и пройдите аутентификацию через /mcp

В документации есть и npx add-mcp https://mcp.vercel.com, который прописывает сервер сразу в нескольких клиентах. Учтите: добавление сервера не завершает авторизацию. Пока вы не войдёте и не дадите доступ к команде, AI не видит её деплоев и логов (справочник инструментов).

MCP даёт инструменты, а не slash-команды. Вы просите, например, «посмотри ошибки последнего деплоя», и AI сам выбирает и вызывает инструменты вроде этих (выдержка из списка на 30 сентября 2026 года):

Vercel Plugin (npx plugins add vercel/vercel-plugin) добавляет знания о Vercel и пять slash-команд с пространством имён: /vercel-plugin:deploy (с prod — в продакшн), /vercel-plugin:env (list, pull, add, remove, diff), /vercel-plugin:status, /vercel-plugin:bootstrap и /vercel-plugin:marketplace (Vercel Plugin). Если прочитать определение команды deploy, видно, что она управляет вашим локальным Vercel CLI (vercel, vercel --prod), по умолчанию делает preview, а перед продакшном ждёт явного «да». Команд /logs и /rollback нет: логи и откат — через инструменты MCP или CLI (vercel rollback).

Главный выигрыш — всё остаётся внутри разговора. Попросите «добавь этот API, задеплой в preview, а если будет ошибка — прочитай логи и исправь», и AI пройдёт цепочку правка кода → деплой → проверка лога сборки → исправление → повторный деплой. В терминах статьи Может ли AI взять на себя инфраструктуру? это зона «способен, но опасен». Vercel прямо пишет, что подключение MCP даёт AI те же права, что и вашему пользовательскому аккаунту Vercel, и рекомендует всегда включать подтверждение человеком. Не ставьте вызовы инструментов на автоодобрение.

6. Подход 3: GitHub Actions (@claude и контрольные шлюзы)

Схема для команд. С Claude Code GitHub Actions вы упоминаете @claude в комментарии к issue или PR, и Claude коммитит исправление и отвечает в той же ветке обсуждения. Preview-деплой по-прежнему делает Git-интеграция из подхода 1: когда Claude пушит в ветку PR, Vercel пересобирает preview.

# Настройка
1. Запустить /install-github-app в Claude Code (только репозитории на github.com)
2. Установить Claude GitHub App; сохранить ANTHROPIC_API_KEY (или CLAUDE_CODE_OAUTH_TOKEN) в Secrets
3. .github/workflows/claude.yml приходит в виде pull request

# .github/workflows/claude.yml (пример из официальной документации)
name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    timeout-minutes: 30          # останавливать зависшие задачи (рекомендует документация)
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write            # нужен для аутентификации через GitHub App по умолчанию
      actions: read              # читать результаты CI в PR
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          claude_args: "--max-turns 10"   # ограничить число ходов за запуск

timeout-minutes и --max-turns добавлены для примера — это две меры, которые рекомендует раздел документации «Manage costs» (значения подберите под свой проект). По умолчанию никакого ограничения ходов нет, поэтому задайте его сами.

Если вы хотите, чтобы деплоил и GitHub Actions — только когда перед деплоем нужны тесты, сканирование безопасности, бюджеты производительности или одобрение человека, — следуйте официальному руководству Vercel. Нужны три секрета: VERCEL_TOKEN, VERCEL_ORG_ID и VERCEL_PROJECT_ID (два последних лежат в .vercel/project.json, который создаёт vercel link).

# .github/workflows/vercel-preview.yml (форма из KB Vercel)
name: Vercel Preview Deployment
env:
  VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
  VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}
on:
  push:
    branches-ignore:
      - main
jobs:
  Deploy-Preview:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm install --global vercel@latest
      - run: vercel pull --yes --environment=preview --token=${{ secrets.VERCEL_TOKEN }}
      # сюда — тесты и сканирование
      - run: vercel build --token=${{ secrets.VERCEL_TOKEN }}
      - run: vercel deploy --prebuilt --token=${{ secrets.VERCEL_TOKEN }}

# vercel.json — отключить деплои от Git, чтобы не было двойного деплоя
{ "git": { "deploymentEnabled": false } }

То же руководство перечисляет ловушки: если Git-интеграция остаётся включённой, а Actions тоже деплоит, оба срабатывают на один и тот же коммит; без --prebuilt Vercel собирает то же самое второй раз. И наоборот: если нужно только прогонять тесты, проще оставить Git-интеграцию, запускать тесты против preview по событию deployment_status и через Deployment Checks придерживать продвижение в продакшн.

# Как это выглядит на практике
# Разработчик открывает PR → Git-интеграция собирает preview
[Bot] Vercel Preview: https://<preview-url>

# Ревьюер комментирует PR
@claude сделай так, чтобы кнопка меняла цвет и при наведении

# Claude добавляет коммит и отвечает → Vercel пересобирает preview
# Ревьюер проверяет → approve → merge → деплой в продакшн

Внимание: в приватных репозиториях автор коммита должен быть участником команды в Vercel (на Hobby — владельцем), иначе ничего не задеплоится (KB Vercel). Если коммиты, созданные внутри Actions, не дают preview, сначала проверьте комментарий Vercel Bot и автора коммита.

Такая схема делает реалистичным сценарий «человек не трогает код, пока PR не готов». Как говорилось в статьях Ветераны против джуниоров и Уничтожит ли AI офисные профессии?, команда сосредоточивается на ревью, а реализацию берёт на себя AI.

7. Как использовать preview-окружения: ветка → URL → показ

Во всех трёх подходах окупается одно — использовать preview-окружения на полную. Vercel автоматически создаёт preview-деплои для непродакшн-веток и PR, поэтому можно поставить рядом несколько вариантов одного изменения без дополнительной настройки.

Источники: Environments (варианты staging и тарифы), Password Protection (цены), Sharable Links (одна на Hobby) — всё по состоянию на 30 сентября 2026 года. Защита по умолчанию без пароля — Vercel Authentication (смотреть могут только участники команды); Vercel называет её рекомендуемым способом.

8. Четыре ловушки: утечка env, лимиты и расходы, конфликты, откат

Если отдать деплои AI-агенту, легко наткнуться на эти четыре ловушки. Каждую можно сдержать настройками, сделанными заранее.

Источники: инструменты MCP для переменных окружения (get_project_env возвращает расшифрованное значение), Spend Management (без доплаты на Pro и на части тарифов Enterprise; расход проверяется раз в несколько минут, поэтому пауза наступает с небольшой задержкой), Instant Rollback, настройка Git.

Часто повторяемый совет «поставить перед Vercel прокси Cloudflare» мы как защиту не рекомендуем. В официальной статье KB Vercel пишет, что не рекомендует ставить внешний прокси впереди: Vercel Firewall теряет полную видимость трафика, а производительность падает.

И ещё одно предупреждение: мы не рекомендуем полностью автоматизировать деплой в продакшн силами AI. Даже в подходах ② и ③ оставляйте финальное одобрение продакшна за человеком. Как говорилось в статье Что нельзя передавать AI, AI может сломать продакшн совершенно ненамеренной ошибкой. Автоматизируйте до preview и staging, а для продакшна требуйте одобрения человека — это двухступенчатый шлюз.

Итоги

Думая о деплое в Vercel из Claude Code или Cursor, сначала различите Git-интеграцию, CLI, Vercel MCP, Vercel Plugin и Agent Skills. MCP — средство действовать, подключаемое через OAuth; Plugin приносит команды /vercel-plugin:* и знания; Skills — это инструкции. Сам деплой в большинстве случаев прекрасно обеспечивает Git-интеграция.

Выбор зависит от того, сколько вы отдаёте AI и где его останавливает человек: ① сольная работа → Git-интеграция; ② хотите, чтобы AI разбирал логи и управлял env → Vercel MCP / Plugin (никаких токенов в файлах — вход через OAuth); ③ команды с регулярным ревью PR → GitHub Actions (@claude правит; деплой идёт от Git-интеграции или, если нужны контрольные шлюзы, от Actions + CLI). Используйте preview для A/B-сравнения, staging и показа клиенту, а четырём ловушкам противопоставьте подтверждение вызовов инструментов, настройки лимитов и расходов, порядок отката и одобрение продакшна человеком.

Связанные материалы: AI рекомендует Vercel, Vercel AI SDK, v0 vs Bolt vs Lovable, Что такое Cursor и Может ли AI взять на себя инфраструктуру?.

FAQ

В. Можно ли сделать то же самое на других хостингах (Cloudflare, Netlify)?
О. Можно. Оба публикуют официальные MCP-серверы. У Cloudflare есть каталог удалённых MCP-серверов с подключением через OAuth, в том числе сервер для сборок Workers (MCP-серверы Cloudflare). У Netlify есть Netlify MCP Server. Выбирайте по совместимости с фреймворком и цене, а не по наличию интеграции с агентами. См. также критерии в статье AI рекомендует Vercel.

В. Что лучше для деплоя в Vercel — Claude Code или Cursor?
О. Оба поддерживаются и Vercel MCP, и Vercel Plugin, так что возможности на стороне Vercel почти одинаковые. Разница в стиле работы: Claude Code ориентирован на терминал и имеет официальную интеграцию с GitHub Actions; Cursor ориентирован на редактор и подключает MCP в один клик. Если вы живёте в VS Code, естественнее Cursor; если в терминале — Claude Code.

В. Можно ли дать AI полностью автоматизировать деплой в продакшн?
О. Не рекомендуется. Автоматизируйте до preview и staging, но финальное одобрение продакшна всегда оставляйте за человеком. Причины: AI может сломать продакшн без всякого злого умысла, а при инциденте ответственность размывается. Запретите через GitHub Branch Protection прямой push в main и требуйте одобренных PR.

В. Можно ли коммитить .cursor/mcp.json в git?
О. С официальной конфигурацией Vercel MCP в нём нет секретов. Там только URL https://mcp.vercel.com; аутентификация идёт через OAuth и остаётся на стороне браузера, поэтому коммитить файл, чтобы поделиться с командой, можно. Другое дело, если вы вписали в заголовок API-ключ другого MCP-сервера — такой файл в git не кладите. VERCEL_TOKEN для CI храните в GitHub Secrets, а не в файле workflow.

В. Меня беспокоит стоимость GitHub Actions.
О. Согласно официальной документации, расходы складываются из двух частей: минут GitHub Actions и токенов Claude API (если аутентифицироваться OAuth-токеном подписки, запуски расходуют подписку Claude, а не оплату API). Сумма за запуск зависит от длины промпта, сложности задачи и размера кодовой базы. Способы снизить её, которые называет документация: ограничить число ходов через --max-turns в claude_args, задать таймауты для workflow, писать конкретные запросы к @claude и держать CLAUDE.md кратким. По умолчанию ограничения ходов нет — задайте его сами.