Як підключити GitHub Issues до Claude Code

Термінал із командою gh auth login та адресою MCP-сервера GitHub, з'єднаний із репозиторієм на GitHub, issues якого Claude Code може читати й оновлювати.

Команда CRUX · · Команди перевірено · 5 хв читання

Одному розробникові найшвидше підключитися через GitHub CLI: виконайте gh auth login один раз, і Claude Code читатиме та змінюватиме GitHub issues командами gh у вашому терміналі. Якщо потрібні інструменти MCP, додайте офіційний MCP-сервер GitHub за адресою https://api.githubcopilot.com/mcp однією командою claude mcp add-json з personal access token. GitHub називає одиницю роботи issue, а далі в статті це задача.

Як підключити GitHub Issues до Claude Code?

Спосіб 1. GitHub CLI. Потрібен встановлений gh і обліковий запис GitHub з доступом до репозиторію. Увійдіть через браузер:

gh auth login

Якщо статуси задач беруться з дошки GitHub Projects, додайте scope project:

gh auth refresh -s project

Документація Claude Code каже, що з установленим і авторизованим gh Claude сам відкриває pull requests і читає коментарі рев'ю без додаткових пояснень, а CLI інструмента зазвичай і є найпростішим входом.

Спосіб 2. Віддалений MCP-сервер GitHub. Його хостить сам GitHub. Потрібен personal access token. Інструкція GitHub для Claude радить перевірити, що токен має scope repo (це scope класичних токенів), а документація Claude Code радить fine-grained токен з доступом до потрібних репозиторіїв. Команду виконуйте в терміналі, а не всередині Claude Code:

claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}'

Цю форму GitHub дає для Claude Code 2.1.1 і новіших. Для старіших версій, або якщо add-json на Windows повертає Invalid input, GitHub дає таку:

claude mcp add --transport http github https://api.githubcopilot.com/mcp -H "Authorization: Bearer YOUR_GITHUB_PAT"

Обидві команди записують у конфігурацію Claude Code приблизно такий запис. Не кладіть токен у файл .mcp.json, який комітите.

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_GITHUB_PAT"
      }
    }
  }
}

Перезапустіть Claude Code. Вхід тут відбувається через токен у заголовку: ні GitHub, ні Anthropic не описують входу через OAuth у /mcp для віддаленого сервера.

Спосіб 3. Той самий сервер локально, у Docker. На github.com токен не потрібен: під час першого виклику Claude Code пропонує відкрити сторінку входу GitHub у браузері, а токен лишається лише в пам'яті.

claude mcp add github -e GITHUB_OAUTH_CALLBACK_PORT=8085 -- docker run -i --rm -p 127.0.0.1:8085:8085 -e GITHUB_OAUTH_CALLBACK_PORT ghcr.io/github/github-mcp-server

Як перевірити, що підключення працює?

Для CLI:

gh auth status
gh issue list

Для MCP-сервера:

claude mcp list
claude mcp get github

У самому Claude Code команда /mcp показує стан сервера. Після цього попросіть Claude Code прочитати одну задачу за номером.

Що Claude Code після цього вміє в GitHub Issues і чого не вміє?

Без додаткових налаштувань MCP-сервер вмикає п'ять наборів інструментів: context, repos, issues, pull_requests і users. Через набір issues Claude Code може:

  • прочитати задачу з коментарями, мітками, sub-issues і батьківською задачею;
  • вивести список задач і шукати серед них;
  • створити задачу та змінити її заголовок, опис, мітки, виконавців і стан;
  • додавати й редагувати коментарі, змінювати sub-issues.

Обмеження:

  • Набір projects типово вимкнений. Його вмикає заголовок X-MCP-Toolsets, наприклад зі значенням issues,projects; адреса https://api.githubcopilot.com/mcp/x/projects дає лише інструменти Projects. Ці інструменти просять scope read:project для читання і project для запису. З ними Claude Code може змінити поле на кшталт Status в елемента дошки.
  • У наборі issues немає інструмента, який видаляє задачу. У CLI є gh issue delete.
  • Щоб дати доступ лише на читання, додайте /readonly до адреси або надішліть заголовок X-MCP-Readonly.
  • Віддалений сервер не працює з GitHub Enterprise Server. Локальний працює, з GITHUB_HOST і токеном.
  • З класичним токеном сервер ховає інструменти, для яких токенові бракує scope.
  • Claude Code діє від вашого імені, з правами вашого токена.

А як щодо @claude у GitHub Actions?

Це окремий продукт. Claude Code GitHub Actions запускає Claude Code у воркфлоу вашого репозиторію, а не на вашій машині. Потрібні права адміна в репозиторії на github.com і авторизований gh. Виконайте в Claude Code:

/install-github-app

Команда встановлює Claude GitHub App, зберігає секрет репозиторію ANTHROPIC_API_KEY або CLAUDE_CODE_OAUTH_TOKEN і відкриває pull request із файлом воркфлоу. Після злиття згадайте @claude у коментарі до issue чи pull request, і Claude відповість коментарем там само. Запускати його можуть лише люди з правом запису в репозиторій. Подробиці є в Claude Code GitHub Actions.

Що змінюється, коли так працюють троє і більше людей?

Сервер і gh з'єднують агента однієї людини з GitHub. Хто що робить у команді, вони не визначають. Коли вас троє чи більше, виникають такі ситуації:

  • Задача стоїть у статусі "In review", а жодна роль за цей статус не відповідає. Ніхто не знає, хто запускає наступний крок і хто його погоджує.
  • Андрій просить агента спершу показати план. Інший розробник має власні промпти і план пропускає. Результат залежить від того, хто взяв задачу.
  • Олена, PM, відповідає на питання агента в чаті Андрія. Марія тестує задачу за тиждень і цієї відповіді не бачить.
  • Сесія Андрія чекає на відповідь Олени. Олена не знає, що на неї чекає сесія.

Як командну частину вирішує CRUX?

CRUX робимо ми, тож тут ідеться про наш власний продукт. Він у беті.

Те, що агентові треба знати про проєкт, уже є в GitHub: задача, її батьківська задача і рішення, які вже в ній записано. CRUX дає агентові це прочитати, а кожен статус у вашому воркфлоу має власні інструкції, тож промпт ніхто не пише. CRUX це шар воркфлоу між трекером команди та агентами для коду, якими команда вже користується.

  • CRUX підключається через CRUX GitHub App. Задачами є GitHub issues.
  • Окрема дошка GitHub Projects не обов'язкова. Статуси беруться з поля Status дошки, якщо вона є, і з міток з назвами S:<NAME>, якщо її немає.
  • Проєкт у CRUX відповідає одному репозиторію і щонайбільше одній дошці.
  • Кожен статус має роль-власника. Кожен крок запускає людина, і вона ж погоджує результат у контрольних точках погодження.
  • Кожен крок лишає артефакт коментарем у задачі.
  • CRUX не прикріплює файли й не видаляє задачі в GitHub і не підтримує GitHub Enterprise Server.

Коли досить самого MCP-сервера?

  • Ви працюєте самі.
  • Усю роботу агента запускає й перевіряє одна людина.
  • Агентові треба лише читати задачі й писати коментарі, а статуси люди переводять вручну.
  • Робота разова, наприклад розставити мітки на нових задачах.
  • У вас GitHub Enterprise Server.

Часті запитання

Чи є офіційний MCP-сервер GitHub?

Так, це github/github-mcp-server. GitHub хостить віддалену версію і публікує локальну як образ Docker та бінарний файл.

Чи потрібен personal access token?

Для віддаленого сервера в Claude Code інструкція GitHub використовує токен. Локальний сервер у Docker на github.com і gh входять через браузер.

Чи може Claude Code змінювати статуси дошки GitHub Projects?

Так, з набором projects і scope project або командою gh project item-edit.

Що вибрати, MCP-сервер чи gh?

Беріть gh, якщо він уже є на вашій машині. MCP-сервер потрібен, коли ви хочете режим лише для читання або сталий набір інструментів.

Спробуйте на своєму проєкті. CRUX безкоштовний для однієї людини, картка не потрібна.

Почати безкоштовно

Далі: Досить писати промпти: навіщо AI-агентам воркфлоу

Усі статті