Cursor и GitHub: как выбрать и настроить подключение — это выбор одного из трёх маршрутов. GitHub App даёт Cloud Agents и Bugbot на удалённом репозитории. GitHub MCP-сервер даёт агенту инструменты чтения репозиториев, issues и PR. Локальный Git держит рабочий клон на вашем компьютере. Ниже — шаги, конфигурации и проверка.
Три маршрута и что каждый даёт
Способ подключения определяет результат. GitHub App — это установка приложения Cursor в вашу организацию GitHub: она открывает Cloud Agents и Bugbot на выбранных репозиториях. GitHub MCP-сервер — это отдельная запись в файле конфигурации Cursor, через которую агент получает инструменты GitHub. Локальный Git — обычный клон на вашем компьютере с собственной аутентификацией.
По документации Cursor, приложение GitHub подключает репозитории для функций Cloud Agents и Bugbot. В документации GitHub по установке MCP-сервера описаны два варианта: удалённый сервер на api.githubcopilot.com и локальный через Docker-образ. Это разные вещи с разными файлами настройки, и путать их не стоит.
Таблица ниже связывает задачу читателя с нужным маршрутом.
| Маршрут | Когда нужен | Где настраивается | Что проверить |
|---|---|---|---|
| Локальный Git | Код проекта открыт на вашем компьютере | Клон и Git-аутентификация | Доступ к репозиторию |
| GitHub App | Нужен Cloud Agent или Bugbot на удалённом репозитории | Dashboard → Integrations → Connect → Selected repositories | Нужный репозиторий, права PR, владелец установки |
| GitHub MCP | Агент читает репозитории, issues, PR через инструменты | ~/.cursor/mcp.json или .cursor/mcp.json, ключ mcpServers |
Удалённый endpoint и PAT, либо локальный Docker с OAuth |
GitHub App и MCP решают разные задачи, и один маршрут не заменяет другой.
Права для подключения GitHub App
Подключение GitHub App требует прав администратора Cursor и администратора организации GitHub. Это указано в документации Cursor по интеграции с GitHub. Без этих прав шаг Connect в дашборде не пройдёт.
Права администратора нужны на двух сторонах: в аккаунте Cursor и в организации GitHub. Если вы не администратор организации, попросите коллегу с нужными правами выполнить подключение или выдать вам доступ. Документация Cursor перечисляет разрешения, которые запрашивает приложение: доступ к репозиториям для клонирования кода и создания рабочих веток, работа с pull requests и комментариями ревью, issues, checks и statuses, Actions и workflows, администрирование для чтения правил защиты веток, а также пользовательские роли репозитория.
Разрешения выдаются по принципу наименьших привилегий. Перед подключением решите, какие репозитории открыть: все или выбранные. Это влияет на то, где приложение сможет создавать ветки и открывать PR.
Шаги подключения GitHub App
Порядок действий из документации Cursor такой. Откройте Integrations в дашборде. Нажмите Connect рядом с GitHub, а если подключение уже есть — Manage Connections. Выберите All repositories или Selected repositories. Вернитесь в дашборд, чтобы настроить функции на своих репозиториях.
При первом подключении аккаунта Cursor к GitHub выполняется вход через GitHub для привязки аккаунта без установки приложения. Второй аккаунт Cursor можно подключить к аккаунту GitHub, где приложение Cursor уже установлено: первый Connect не перемещает и не меняет существующую установку.
После подключения откройте настройки функций, которые используют интеграцию. Bugbot и Cloud Agents настраиваются отдельно. На GitHub подключение включает Bugbot для репозиториев, к которым вы дали доступ. Для команд доступна функция Share with another team: команда в организации может поделиться своей установкой с другими командами той же организации, и те используют репозитории установки без повторной установки приложения. Поделиться можно для GitHub.com и GitHub Enterprise Server.
Ограничение одной установки
Каждая установка GitHub App принадлежит одному аккаунту или команде Cursor. Если установкой уже владеет другой аккаунт или команда, подключение из вашего аккаунта завершится ошибкой «GitHub installation is already connected to another Cursor target», и установка останется у владельца.
Есть исключение: когда администратор команды подключает установку организации, которую участник той же команды подключил лично, Cursor переносит установку в команду. Для установок GitHub Enterprise Server эта ошибка не показывается.
При такой ошибке сверьте владельца установки, прежде чем повторять установку вслепую. Возможно, нужная установка уже существует в другой команде, и её достаточно поделить через Share with another team. Отозвать доступ можно там же: откройте Share with another team и выберите Revoke рядом с командой в разделе Already shared with. Отзыв также удаляет настройки Bugbot той команды для репозиториев установки.
GitHub App и GitHub MCP: в чём разница
GitHub App и GitHub MCP-сервер — разные подключения. App устанавливается в организацию GitHub через дашборд Cursor и работает на стороне сервиса. MCP-сервер описывается в файле конфигурации Cursor и даёт агенту инструменты для обращения к GitHub.
Файлы конфигурации тоже разные. У App настройка живёт в дашборде интеграций. У MCP — в ~/.cursor/mcp.json глобально или в .cursor/mcp.json в корне проекта, под ключом mcpServers. Документация GitHub по установке MCP-сервера в Cursor подтверждает оба пути и ключ mcpServers.
Подключение App может включить Bugbot на разрешённых репозиториях. Проверка без записи относится только к описанному сценарию чтения через MCP. У App есть отдельные возможности и разрешения. Если вам нужен только доступ агента к данным GitHub, начните с MCP. Если нужны Cloud Agents или Bugbot, нужен App.
Конфигурация GitHub MCP для Cursor
Удалённый сервер использует хостинг GitHub по адресу https://api.githubcopilot.com/mcp/ с заголовком Authorization: Bearer. Для поддержки Streamable HTTP требуется Cursor v0.48.0+. У официального удалённого сервера описан персональный токен доступа GitHub.
{
"mcpServers": {
"github": {
"url": "https://api.githubcopilot.com/mcp/",
"headers": {
"Authorization": "Bearer YOUR_GITHUB_PAT"
}
}
}
}
Замените YOUR_GITHUB_PAT на свой токен. Сохраните файл и перезапустите Cursor.
Локальный вариант запускается через Docker-образ ghcr.io/github/github-mcp-server и требует установленного и запущенного Docker Desktop. Для локального сервера документация GitHub описывает отдельный вход через OAuth: на github.com официальный образ уже содержит учётные данные приложения, сервер открывает вход в браузере при первом использовании и держит токен только в памяти. В Docker публикуется фиксированный порт обратного вызова на loopback.
{
"mcpServers": {
"github": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-p",
"127.0.0.1:8085:8085",
"-e",
"GITHUB_OAUTH_CALLBACK_PORT",
"ghcr.io/github/github-mcp-server"
],
"env": {
"GITHUB_OAUTH_CALLBACK_PORT": "8085"
}
}
}
}
Для входа по персональному токену вместо OAuth документация GitHub приводит отдельную конфигурацию с переменной GITHUB_PERSONAL_ACCESS_TOKEN. Токен имеет приоритет над OAuth. Не печатайте токен в терминал и логи.
Где лежит конфигурация MCP
Глобальный файл — ~/.cursor/mcp.json, он применяется ко всем проектам. Проектный файл — .cursor/mcp.json в корне проекта, он действует только в этом проекте. Оба используют ключ mcpServers.
Внутри ключа mcpServers размещается объект с именем сервера, в примерах это github. Для удалённого сервера указываются url и headers. Для локального — command, args и env.
Проверьте JSON перед сохранением: некорректный формат приводит к тому, что сервер не загружается. Документация GitHub по установке перечисляет эту причину среди общих проблем наряду с необходимостью полностью перезапустить Cursor после правки конфигурации.
Проверка подключения MCP
Проверка состоит из четырёх шагов. Полностью перезапустите Cursor. Откройте Settings → Tools & Integrations → MCP Tools и проверьте зелёный статус рядом с сервером. В чате или composer посмотрите список Available Tools. Отправьте запрос «List my GitHub repositories».
Ожидаемое наблюдение — список доступных репозиториев. Это проверяет соединение и права чтения, а commit, push и PR при этом не выполняются. Если список не появился, проверьте выбранный аккаунт и репозиторий, scope токена, точность JSON и MCP-логи. Токен в диагностике не печатайте.
Для удалённого сервера отдельно проверьте версию Cursor: Streamable HTTP требует v0.48.0 или новее. При ошибках аутентификации сверьте scope персонального токена. При ошибках соединения проверьте настройки firewall и proxy. Для локального сервера убедитесь, что Docker Desktop запущен; при сбоях загрузки образа документация GitHub предлагает выполнить docker logout ghcr.io и повторить попытку.
Как отключить подключение
Для GitHub App вернитесь в дашборд интеграций и нажмите Disconnect Account. Это разрывает связь аккаунта с GitHub.
Для MCP-сервера удалите соответствующую запись из mcp.json — глобального или проектного, в зависимости от того, где она добавлена. После правки перезапустите Cursor и убедитесь, что инструменты сервера больше не отображаются в MCP Tools.
Если установка приложения повреждена или не отображается в настройках GitHub, документация Cursor предлагает переустановить приложение со страницы github.com/apps/cursor и проверить, установлено ли оно на уровне организации. При конфликте владельца установки сначала разберитесь, какой аккаунт или команда ей владеет.
Частые вопросы
Чем GitHub App отличается от GitHub MCP в Cursor?
GitHub App устанавливается в организацию GitHub через дашборд Cursor и открывает Cloud Agents и Bugbot на выбранных репозиториях. GitHub MCP-сервер описывается в файле конфигурации Cursor и даёт агенту инструменты для обращения к GitHub. Это разные подключения с разными местами настройки.
Почему появляется ошибка «GitHub installation is already connected to another Cursor target»?
Каждая установка GitHub App принадлежит одному аккаунту или команде Cursor. Если установкой уже владеет другой аккаунт или команда, подключение из вашего завершится этой ошибкой, и установка останется у владельца. Сверьте владельца установки и при необходимости поделите её через Share with another team.
Какой npm-пакет для GitHub MCP использовать?
Пакет @modelcontextprotocol/server-github устарел с апреля 2025 года и больше не используется. Вместо него документация GitHub предлагает официальный Docker-образ ghcr.io/github/github-mcp-server либо удалённый сервер на https://api.githubcopilot.com/mcp/.
Где хранится конфигурация MCP для Cursor?
Глобальный файл — ~/.cursor/mcp.json, он применяется ко всем проектам. Проектный файл — .cursor/mcp.json в корне проекта. В обоих используется ключ mcpServers.
Как проверить, что MCP-подключение работает?
Перезапустите Cursor, откройте Settings → Tools & Integrations → MCP Tools и проверьте зелёный статус. Затем отправьте в чате запрос «List my GitHub repositories». Список доступных репозиториев подтверждает соединение и права чтения.