GitHub

Три способа подключения. Начинайте с первого — он самый быстрый и не требует токенов.

1. Через gh CLI (проверить первым делом)

Если на машине уже установлен и авторизован официальный клиент GitHub, отдельный источник чаще всего не нужен — агент вызывает gh напрямую.

gh auth status     # авторизован? под каким аккаунтом? какие права?

Если команда отвечает Logged in to github.com — используйте её:

gh repo list --limit 50
gh issue list --repo <owner>/<repo> --state open
gh pr view 123 --repo <owner>/<repo> --json title,body,files
gh api /repos/<owner>/<repo>/commits --paginate

gh api покрывает весь REST API, поэтому отдельный API-источник почти никогда не нужен.

Если gh не авторизован: gh auth login → выбрать GitHub.com → HTTPS → авторизация через браузер.

2. MCP-сервер GitHub

Подходит, когда нужен структурированный доступ инструментами, а не через командную строку. Требует personal access token.

Создание токена: Settings → Developer settings → Personal access tokens → Fine-grained tokens (предпочтительно) или Tokens (classic).

Минимальные права для fine-grained токена:

Выбирайте конкретные репозитории, а не «All repositories» — токен с доступом ко всему аккаунту это лишний риск.

3. REST API как обычный источник

Крайний случай — когда нужен нестандартный запрос, которого нет ни в gh, ни в MCP.

• Базовый адрес: https://api.github.com
• Авторизация: заголовок Authorization: Bearer <токен>
• Обязательно указывать заголовок Accept: application/vnd.github+json

Частые ошибки

Проверка после настройки

gh api /user --jq .login          # чей аккаунт
gh api /rate_limit --jq .rate     # лимиты и что авторизация работает

Для MCP или API-источника — запросить список репозиториев и убедиться, что виден именно нужный.