Головна / Статті / Під'єднуємо Claude Desktop до локальних проєктів і GitHub через MCP

mcpclaude-desktopgithubautomationjava

Під'єднуємо Claude Desktop до локальних проєктів і GitHub через MCP

Налаштовуємо в Claude Desktop MCP-сервер файлової системи й конектор GitHub, щоб він сам правив локальні Java-тести, робив коміти, пушив і відкривав pull request'и.

1181 слів

Ганяти код туди-сюди між IDE і вікном чату швидко набридає. Значно зручніше мати асистента, який може відкрити теку проєкту на вашому комп'ютері, просто там виправити чи додати тестові класи на Java, а потім закомітити, запушити й відкрити pull request. Це нічого не коштує, а працює все завдяки MCP, Model Context Protocol. Якщо натрапити на типові граблі, запуск забере кілька спроб, тому помилки перелічено нижче поруч із кроками.

Цикл копіювання, якого ви хочете позбутися

Візьмімо QA-інженера, який цілий день пише скрипти на Selenium. Рутина виглядає так: скопіювати клас із VS Code, Eclipse чи IntelliJ, вставити в чат, прочитати пропозицію, знову скопіювати, вставити назад в IDE. Потім перемкнутися на GitHub і завантажити чи запушити результат вручну. Кожен крок ручний, і жоден із них не потребує людини.

А хочеться написати "запуш цей файл на GitHub" — і щоб це просто сталося.

Що робить MCP

MCP — відкритий стандарт від Anthropic. Він визначає, як асистент на кшталт Claude контрольовано спілкується із зовнішніми інструментами, застосунками й джерелами даних. Без нього Claude бачить лише те, що ви набираєте в чаті, наче людина, замкнена в кімнаті зі щілиною в дверях. MCP прорізає в цій кімнаті справжні двері, і для нашого налаштування важливі два види дверей:

  • MCP-сервер файлової системи, який дає Claude змогу читати файли на вашому комп'ютері.
  • Конектор, який дає Claude змогу користуватися зовнішніми сервісами, як-от GitHub, Gmail чи Jira.

Коли є і те, і те, чат перестає бути просто полем для тексту й починає діяти. Ланцюжок іде від вашої IDE через сервер файлової системи:

VSCode / Eclipse / IntelliJ
        │
        ▼
Filesystem MCP Server
        │
        ▼
Claude Desktop
        │
        ▼
GitHub MCP Server
        │
        ▼
GitHub Repository

Що знадобиться

  • Claude Desktop, окремий застосунок. claude.ai у вкладці браузера для цього не підійде, усе працює лише в десктопному застосунку.
  • Обліковий запис GitHub (безплатний).
  • Node.js, безплатне середовище виконання, без якого деякі інструменти не запустяться.
  • Абсолютний шлях до кореневої теки вашого проєкту, хоч яку IDE ви використовуєте.

Усе це безплатно, і безплатного тарифу Claude досить.

Крок 1: дайте Claude доступ до теки проєкту

Ця частина дає Claude змогу напряму читати й записувати файли, скажімо, робочого простору Eclipse.

  1. Встановіть Node.js з nodejs.org. Просто проклацайте інсталятор, налаштовувати нічого не треба.
  2. У Claude Desktop відкрийте Settings, потім Developer, потім Edit Config. Відкриється невеликий файл налаштувань.
  3. Вставте фрагмент нижче й замініть теку з прикладу на шлях до свого проєкту. У Windows подвойте кожну зворотну скісну риску в шляху.
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\Users\\YourName\\eclipse-workspace\\YourProjectName"
      ]
    }
  }
}
  1. Збережіть, потім повністю закрийте Claude Desktop і запустіть знову. Згортання вікна нічого не перезавантажує, застосунок справді має завершитися.
  2. Знайдіть поруч із полем введення маленький значок молотка чи інструментів. Якщо він є, сервер файлової системи завантажився.

Крок 2: під'єднайте GitHub

Саме тут майже все й ламається, тож не поспішайте.

Зареєструйте власний застосунок на GitHub

GitHub не пускає довільну програму. Спершу ви створюєте власний невеликий запис застосунку, і GitHub видає два секрети, потрібні Claude.

  1. Перейдіть на github.com/settings/applications/new.
  2. Введіть Claude як назву застосунку, https://claude.ai як URL домашньої сторінки й той самий https://claude.ai як callback URL для авторизації. Цей callback поки що просто заглушка.
  3. Натисніть Register application.
  4. Скопіюйте Client ID, що з'явився.
  5. Натисніть Generate a new client secret і одразу скопіюйте його. GitHub показує його рівно один раз.

Додайте конектор у Claude

  1. У Claude Desktop перейдіть у Settings, потім Connectors, натисніть плюс і оберіть Add custom connector.
  2. Назвіть його GitHub і вкажіть URL https://api.githubcopilot.com/mcp/.
  3. Відкрийте Advanced settings і вставте Client ID та Client Secret.
  4. Натисніть Add, потім Connect біля запису GitHub, що з'явився.
  5. GitHub спитає, чи дозволити доступ. Натисніть Authorize.

Обидва сервери в одному чаті

Коли і сервер файлової системи, і GitHub відображаються як під'єднані, в одній розмові можна користуватися ними разом. Сервер файлової системи відкриває доступ до локального робочого простору, а сервер GitHub — до ваших репозиторіїв. Claude бере файл із вашого диска й пушить його на GitHub, без вставок і без термінала.

На практиці це закриває весь цикл:

  • Перегляд вмісту проєкту
  • Зміна наявних Java-файлів
  • Написання нових тестових скриптів
  • Коміт із повідомленням
  • Пуш у віддалений репозиторій
  • Відкриття pull request'ів

Помилки, яких можна уникнути

  • Порожній callback URL. GitHub вимагає його заповнити, тож реєстрація зриватиметься, доки ви цього не зробите.
  • Натискання Add до того, як з'явився client secret. Якщо облікових даних бракує, Claude лише повідомляє, що не зміг зареєструватися в сервісі входу, а це ні про що не каже.
  • Вхід у два різні облікові записи Claude: один у браузері, інший у десктопному застосунку. Це була найгірша з трьох проблем, бо помилка "Account mismatch", яку вона спричиняє, не має жодного стосунку до GitHub. Рішення — вийти в браузері й знову увійти під обліковим записом із десктопного застосунку.

Промпти для копіювання

Вони працюють у Claude Desktop, коли активні і сервер файлової системи, і сервер GitHub. Спершу повний запит від індексації до пушу:

End-to-End Example
Stage all test classes under the com.myAutomation package, commit the changes with the commit message "updated", and push the latest commit to the master branch of the Autonation Project GitHub repository.

І git-процес із гілкою:

Git Workflow
Create a new branch named feature/login-automation, commit all modified files with the message "Added Login Automation Tests", and push the branch to the GitHub repository.

Швидка перевірка

Відкрийте Claude Desktop і пройдіть ці кроки по черзі, кожен спирається на попередній.

  1. Локальний доступ: попросіть відкрити ваш проєкт автотестів і показати структуру.
  2. Зміна файлів: попросіть тестовий клас для сторінки входу в src/test/java.
  3. Git: попросіть ініціалізувати репозиторій, створити гілку feature/login-test і зробити коміт.
  4. Пуш: попросіть запушити цю гілку в репозиторій Automation Testing Project.
  5. Pull request: попросіть відкрити pull request у гілку develop.
Усі статтіНадіслати бриф