Як підключити приватні репозиторії 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 може їх читати, працювати в них і допомагати команді випускати швидше, а вам не треба виходити з чату.