Як підключити 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. Ці інструменти просять scoperead: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-агентам воркфлоу
Усі статті