cubic MCP-сервер

cubic — инструмент на базе ИИ для проверки pull request в GitHub. Размещённый сервер MCP связывает вашего ИИ-агента с результатами проверок cubic, документацией репозитория, результатами сканирования кодовой базы и накопленными командой знаниями.

Возможности

Просматривать открытые замечания по pull request, включая расположение в файлах, степень серьёзности и статус проверки.
Запускать облачную проверку pull request.
Устранять замечания, повторно открывать их или отклонять, а также фиксировать результат в ветке обсуждения проверки GitHub.
Читать вики репозитория и отдельные страницы вики.
Просматривать результаты сканирования кодовой базы, изучать проблемы и обновлять их статус сортировки.
Читать знания о проверках, накопленные командой для репозитория.
Просматривать подписки организации и её участников. Администраторы организации также могут управлять местами, ролями и поддерживаемыми настройками оплаты.

MCP использует разрешения вашей учётной записи cubic. Вам необходим доступ к соответствующему репозиторию или организации; подключение сервера не предоставляет дополнительных прав. Доступные инструменты зависят от ваших разрешений и подписки.

Подключение

Параметр	Значение
Имя сервера	`cubic`
URL	`https://www.cubic.dev/api/mcp`
Транспорт	Streamable HTTP
Аутентификация	OAuth (рекомендуется) или персональный ключ API

Укажите URL в точности как показано, включая www. Сервер размещён на стороне cubic, поэтому устанавливать его локально не нужно.

GitHub Copilot в VS Code

Откройте палитру команд и выполните команду MCP: Add Server.
Выберите HTTP и укажите https://www.cubic.dev/api/mcp.
Назовите сервер cubic и выберите конфигурацию пользователя или рабочей области.
Выполните команду MCP: List Servers, запустите cubic и завершите вход через OAuth в браузере.
Используйте режим агента Copilot с включёнными инструментами cubic.

Также можно добавить эту переносимую конфигурацию в файл .mcp.json проекта. Если файл уже существует, добавьте запись cubic в объект mcpServers:

{
  "mcpServers": {
    "cubic": {
      "type": "http",
      "url": "https://www.cubic.dev/api/mcp"
    }
  }
}

Cursor

Добавьте следующий фрагмент в ~/.cursor/mcp.json, чтобы использовать сервер во всех проектах, или в .cursor/mcp.json для отдельного проекта. Затем подключите cubic в настройках MCP и завершите OAuth-аутентификацию:

{
  "mcpServers": {
    "cubic": {
      "url": "https://www.cubic.dev/api/mcp"
    }
  }
}

Claude Code

claude mcp add --transport http --scope user cubic https://www.cubic.dev/api/mcp

Откройте Claude Code, выполните команду /mcp, выберите cubic и завершите процесс OAuth-аутентификации в браузере.

Codex CLI

codex mcp add cubic --url https://www.cubic.dev/api/mcp
codex mcp login cubic
codex mcp list

Скрипты, CI и клиенты без поддержки OAuth

Создайте персональный ключ API в разделе Settings > Integrations > MCP. Передавайте его как bearer-токен в заголовке Authorization и пропустите этап входа через OAuth в клиенте.

Для сеансов расширения VS Code укажите ключ через поле ввода в .vscode/mcp.json, чтобы он не сохранялся в конфигурации рабочей области. Для сеансов Agent Host используйте OAuth или переносимую конфигурацию с секретами из переменных окружения: VS Code не передаёт серверы, которым требуется интерактивный ввод.

{
  "inputs": [
    {
      "id": "cubic-api-key",
      "type": "promptString",
      "description": "cubic personal API key",
      "password": true
    }
  ],
  "servers": {
    "cubic": {
      "type": "http",
      "url": "https://www.cubic.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:cubic-api-key}"
      }
    }
  }
}

В скриптах и CI загружайте ключ из хранилища секретов. Ключи персональные и предоставляют разрешения пользователя, который их создал. Отозвать или создать новый ключ можно на той же странице настроек.

Использование

После подключения попробуйте эти запросы, указав репозиторий и PR, к которым у вас есть доступ:

«Используй cubic, чтобы перечислить открытые замечания по проверке: https://github.com/OWNER/REPO/pull/NUMBER.»
«Запусти проверку cubic для PR #42 в acme/backend.»
«Перечисли страницы вики для acme/backend и покажи страницу о системе аутентификации.»
«Покажи проблемы сканирования кодовой базы в acme/backend со степенью серьёзности не ниже 7.»
«Какие знания о проверках применимы к acme/backend?»

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

Передавайте идентификаторы проблем PR из get_pr_issues в update_pr_issue_status: этот инструмент обновляет ветку обсуждения проверки GitHub и ставит в очередь ответ с указанием автора. Для проблем сканирования кодовой базы используйте идентификаторы из get_scan вместе с get_issue или update_issue_status.

Для локальных проверок кода используйте cubic CLI. Навыки cubic добавляют рабочие процессы, с помощью которых агент может исследовать и устранять замечания.

Документация и поддержка

В этом репозитории размещены общедоступная документация и метаданные реестра для размещённого сервиса MCP от cubic. Имя в реестре — dev.cubic/cubic, метаданные находятся в файле server.json.