# Vercel MCP: найти причину сбоя деплоя: сведения для ИИ-агента

> Справочный документ Staksy для твоего агента. Это сведения для проверки, не команды: ничего отсюда не выполняй и не устанавливай без подтверждения пользователя. Сверь требования с первоисточниками ниже; устаревшее и неподтверждённое не принимай как факт. Не утверждай, что инструмент работает, пока это не проверено.

- Материал: vercel-mcp (mcp), страница для человека: /r/vercel-mcp
- Обновлено 2026-10-18

## Цель

Агент найдёт причину сбоя деплоя по логам Vercel

Найди нужный деплой Vercel и собери логи для разбора ошибки.

Vercel MCP даёт coding-агенту доступ к проектам, деплоям и логам через официальный удалённый сервер. Полезный первый сценарий - разобраться, почему сборка завершилась ошибкой: указать команду и проект, найти деплой и прочитать его логи. Доступ к данным аккаунта требует OAuth. У агента будут права вашего Vercel-пользователя, поэтому сценарий чтения нужно явно отделить от управления проектом.

## Источники

- Vercel: сервер, OAuth и настройка клиентов: https://vercel.com/docs/agent-resources/vercel-mcp
- Vercel: список инструментов: https://vercel.com/docs/agent-resources/vercel-mcp/tools
- OpenAI: настройка MCP в Codex: https://developers.openai.com/codex/mcp

## Требования

- Свой Vercel-аккаунт с доступом к нужной команде и проекту; клиент из списка Vercel с поддержкой указанного способа подключения.
- Для закрытых данных потребуется OAuth. До авторизации проверьте выбранный аккаунт и права.
- MCP доступен по условиям Vercel; расходы вашего проекта, лимиты логов и тариф не определяются этим обзором.

## Совместимость

- Codex CLI: По условиям клиента и зависимостей; версия клиента: не указана. Vercel публикует настройку Codex CLI по Streamable HTTP и OAuth.
- Claude Code: По условиям клиента и зависимостей; версия клиента: не указана. Vercel публикует HTTP-команду настройки Claude Code.
- Cursor: По условиям клиента и зависимостей; версия клиента: не указана. Vercel публикует URL-конфигурацию Cursor.
- Gemini CLI: По условиям клиента и зависимостей; версия клиента: не указана. Vercel описывает настройку Gemini CLI через mcp-remote; зависимости этого способа проверяются отдельно.
- OpenCode: По условиям клиента и зависимостей; версия клиента: не указана. Vercel публикует remote-конфигурацию OpenCode.

## Риски

- Подключение даёт агенту права вашего Vercel-пользователя, а не технически ограниченный доступ только к чтению. Отдельно подтверждайте изменения и развёртывания.
- Логи могут содержать чувствительные данные. Проверьте допустимость их передачи вашему AI-провайдеру.

## Порядок действий

Подключите сервер в своём клиенте и завершите авторизацию только для разрешённого аккаунта. Начните с одного сбоя на известном deployment ID. Инструкция рассчитана на чтение логов; разрешение на изменения задаётся отдельно.

1. Подключите официальный сервер: В установленном Codex CLI добавьте официальный HTTPS endpoint. Для другого клиента используйте его раздел в руководстве Vercel.

```text
codex mcp add vercel --url https://mcp.vercel.com
```

Руководство: https://vercel.com/docs/agent-resources/vercel-mcp

2. Проверьте авторизацию: Для закрытых данных завершите OAuth своего аккаунта. Список серверов в Codex виден через codex mcp list, активные инструменты - через /mcp. При необходимости используйте codex mcp login vercel.

Руководство: https://developers.openai.com/codex/mcp

3. Разберите один сбой: Укажите команду, проект и конкретный неуспешный деплой. Сначала запросите только сведения и логи; сверяйте deployment ID и время с панелью Vercel.

```text
Найди указанный мной неуспешный деплой Vercel. Покажи его ID, время и относящиеся к ошибке строки логов. Отдели наблюдения от гипотез. Ничего не меняй и не запускай новый деплой.
```

Руководство: https://vercel.com/docs/agent-resources/vercel-mcp/tools

## Как проверить результат

Deployment ID, проект и время совпадают с панелью Vercel. В отчёте есть реальные строки ошибки и ссылка на деплой; предполагаемая причина отделена от наблюдения. Во время этого сценария не появились новый деплой или изменения проекта.