Как подключить приватные репозитории GitHub к Claude Desktop через токен и Docker

Если настроить правильное подключение, Claude сможет работать с вашими репозиториями GitHub напрямую: перечислять ветки, проверять pull request, читать историю коммитов. Вставлять код в чат больше не придётся. Ниже — как подключить приватные репозитории и несколько способов сразу пустить это подключение в дело.

Что делает коннектор GitHub

Представьте коннектор как мост между вашим аккаунтом GitHub и Claude. Когда он работает, Claude может запускать настоящие операции GitHub: перечислять репозитории, читать файлы, проверять ветки, открывать pull request и оставлять комментарии к ревью. Ваш пароль от GitHub до Claude никогда не доходит. Используется только токен, который вы создаёте сами, и вы решаете, что этот токен может видеть.

Создаём токен

Настройка опирается на Personal Access Token (Classic). Были опробованы оба вида токенов: детализированные (fine-grained) блокируют GitHub Search API, а классические нет, так что классический — надёжный выбор, если нужен полный доступ.

1. Откройте github.com и войдите.
2. Нажмите на фото профиля вверху справа, выберите Settings, прокрутите левое меню до конца и нажмите Developer settings. Есть короткий путь, который пропускает этот и следующий шаг: перейдите сразу на https://github.com/settings/tokens, откроется страница классических токенов.
3. В левом меню нажмите Personal access tokens, затем Tokens (classic). Не выбирайте здесь «Fine-grained tokens». Если вы воспользовались коротким путём, вы уже на этой странице.
4. Нажмите Generate new token и выберите классический вариант. GitHub может запросить пароль или код двухфакторной аутентификации.
5. В поле «Note» напишите что-то узнаваемое, например claude-mcp-access, чтобы потом помнить, зачем существует этот токен.
6. Выберите срок действия 30, 60 или 90 дней. Избегайте «No expiration» без веской причины: короткий срок жизни ограничивает ущерб, если токен утечёт.
7. Тщательно выберите области доступа (scopes): это самый важный шаг.
8. Прокрутите вниз, нажмите Generate token и скопируйте его.

Об областях доступа: они определяют, что Claude может делать с вашими репозиториями. Не ставьте все галочки подряд, только то, что нужно для задачи, и прочитайте список, прежде чем что-то нажимать. Никогда не включайте delete_repo. Это право позволяет удалить репозиторий, одна неудачная команда может стереть целый проект, а у ИИ-ассистента почти никогда нет веской причины его иметь. Общее правило: начинайте с самой узкой области, которой хватает для работы. Если позже какой-то задаче понадобится больше, всегда можно создать новый токен с более широким доступом.

На последнем шаге GitHub показывает токен один-единственный раз на следующем экране. Сразу скопируйте его и сохраните в менеджере паролей: покинув страницу, вы больше не сможете его увидеть.

Подключаем токен к Claude Desktop

Эта часть связывает GitHub с Claude Desktop через Docker. Проходите шаги по порядку и ничего не пропускайте.

1. Установите Docker Desktop с docker.com, если его ещё нет, так же, как любое обычное приложение.
2. Запустите Docker Desktop и дождитесь статуса «Docker is running», обычно это зелёный значок в строке меню. Это обязательно: без запущенного Docker Claude не достучится до GitHub. Забыть об этом — самая частая ошибка, так что, если позже подключение не заработает, проверьте это первым делом.
3. Полностью закройте Claude Desktop, прежде чем трогать конфигурацию. На Mac сделайте это через значок Claude в доке: щёлкните правой кнопкой и выберите Quit. Если просто закрыть окно, приложение продолжит работать.
4. Найдите файл конфигурации. Claude Desktop читает настройки из claude_desktop_config.json, который в macOS лежит по пути ~/Library/Application Support/Claude/claude_desktop_config.json. Чтобы открыть эту скрытую папку, зайдите в Finder, затем Go, затем Go to Folder, и вставьте путь.
5. Откройте файл в простом текстовом редакторе, например TextEdit или VS Code, через правый клик и Open With. Не используйте Word или что-либо, что добавляет форматирование. Если файла нет, создайте пустой ровно с таким именем ровно в этой папке.
6. Добавьте блок MCP-сервера GitHub на корневой уровень JSON. Если файл пустой, вставьте блок целиком. Если в нём уже что-то есть, аккуратно объедините ключ mcpServers: два ключа mcpServers в одном файле его сломают.

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN=your_pat_here",
        "ghcr.io/github/github-mcp-server"
      ]
    }
  }
}

1. Найдите в этом блоке your_pat_here и замените классическим токеном из шага 8. Кавычки оставьте на месте и не добавляйте пробелов.
2. Сохраните файл под тем же именем, в том же месте и с тем же расширением.
3. Ещё раз проверьте значок Docker. Docker должен работать до того, как откроется Claude.
4. Запустите Claude Desktop. Он читает новую конфигурацию при запуске, и первый старт может занять на несколько секунд дольше, пока Docker скачивает образ MCP-сервера GitHub.
5. Проверьте. Если ничего не происходит, пройдите три проверки в таком порядке: Docker Desktop запущен, в JSON нет опечаток (чаще всего виновата пропущенная запятая), токен вставлен без лишних пробелов.

Что попробовать

• Ревью pull request. Попросите Claude посмотреть открытый PR. Он прочитает diff, отметит баги, неясные имена и недостающие тесты и может оставить комментарии прямо в GitHub, чтобы команда видела замечания в одном месте.
• Аудит веток. В больших командах копятся старые ветки. Попросите Claude перечислить все ветки во всех репозиториях и указать заброшенные, которые можно безопасно удалить.
• Автоматизация процессов. Claude может создать ветку, запушить небольшое исправление и открыть pull request, и рутина из пяти ручных шагов превращается в одно предложение.
• Сортировка задач. Он может прочитать открытые issues, расставить их по приоритету и предложить метки, что помогает в репозиториях с большим бэклогом.
• Заметки к релизу. Укажите ему на последние коммиты и слитые PR, и он составит аккуратный список изменений для следующего релиза.
• Поиск по всем репозиториям. В архитектуре с множеством микросервисов Claude может искать по всем репозиториям сразу и находить каждое место, где встречается функция или значение конфигурации, в каком бы проекте оно ни находилось.

Чек-лист безопасности

• Подбирайте области доступа под задачу и никогда не включайте delete_repo.
• Давайте токену только нужные области доступа.
• Задавайте срок действия и регулярно меняйте токены.
• Не размещайте токены в публичных чатах, файлах публичных репозиториев и общих документах.
• Не добавляйте claude_desktop_config.json в систему контроля версий: токен лежит в нём открытым текстом.
• Если возможна утечка, немедленно отзовите токен.
• Обновляйте Docker Desktop: в старых версиях могут быть уязвимости.

После этого ваши приватные репозитории подключены, и Claude может их читать, работать в них и помогать команде выпускать быстрее, а вам не нужно выходить из чата.