Для користувачів Claude Desktop

Claude Desktop не бачить ваш репозиторій. Покажіть йому.

У Claude Desktop багато хто питає про код, який зараз не редагує: рев’ю, онбординг, дзвінки щодо інцидентів. Maguyva індексує репозиторій і віддає його через MCP, тож відповіді посилаються на файли й рядки, а не на пам’ять.

Почати безкоштовно Читати про налаштування Claude Desktop

Тариф Free: 3 репозиторії, До 50 тис. проіндексованих рядків репозиторію, без кредитної картки.

Локальна копія не потрібна. Спитайте індекс.

Що треба знати про Claude Desktop

Чотири факти саме про Claude Desktop.

// файл конфігурації

claude_desktop_config.json

Його відкриває Settings → Developer → Edit Config. У macOS він лежить у ~/Library/Application Support/Claude/, у Windows — у %APPDATA%\Claude\.

// транспорт

Локальний міст

Цей файл запускає локальні процеси, тож посібник запускає @maguyva/mcp через npx. Потрібен встановлений Node.js.

// ключ

Запис у env

Міст читає MAGUYVA_API_KEY із блоку env сервера в тому самому файлі.

// перезапуск

Закрийте і відкрийте знову

Claude Desktop читає файл під час запуску. Після правки повністю закрийте застосунок; сервер стартує під час наступного запуску.

Інструкції проєкту задають рамку. Користуйтеся ними.

У проєктах Claude зберігаються інструкції та файли, з яких починається кожен чат у проєкті. Вони підходять для:

Того, для кого відповіді: рев’юер, новачок, черговий інженер.
Прийнятого стилю пояснень і підсумків.
Кількох документів, які варто цитувати, наприклад огляду архітектури.

Завантажені файли — це знімок. Наступного дня після завантаження репозиторій уже пішов уперед.

Де вставленого коду вже замало

Три способи, якими розмова про код іде не так без самого коду.

// вставлені фрагменти застарівають

Файл, вставлений у чат минулого тижня, описує код минулого тижня. Claude впевнено відповідає за тією версією, яку йому дали.

// фрагмент — це не система

Один файл рідко відповідає на питання “що станеться, якщо це впаде?” Обробник, повтор і алерт зазвичай живуть у трьох різних пакетах.

// немає локальної копії — немає grep

У Claude Desktop немає робочої копії вашого репозиторію. Без інструмента будь-яка відповідь про структуру залежить від того, що ви не забули вставити.

Maguyva як MCP-сервер у Claude Desktop

Один запис у mcpServers дає Claude:

11 інструментів для вашого проіндексованого репозиторію семантичний, структурний (AST), графовий і текстовий пошук, а також пошук символів, залежні та отримання файлів.
Відповіді зі шляхами до файлів і номерами рядків у понад 285 мовах, щоб ви могли перевірити кожне твердження.
Результати з урахуванням гілки щоб Claude відповідав про гілку, яку ви назвали, а не про файл, що його хтось завантажив минулого місяця.

Інструкції проєкту кажуть Claude, як відповідати.
Maguyva дає Claude код, на який можна спертися.

Два робочі процеси

Запитання, заради яких інакше довелося б відкрити IDE.

// workflow 01

Пояснити шлях виконання на рев’ю

claude> що відбувається, якщо вебхук платежу не проходить перевірку підпису?

semantic_search("webhook signature verification failure")
  src/payments/webhooks.ts:64   verifySignature()
  src/payments/webhooks.ts:91   rejectAndAlert()

→ Claude відповідає, посилаючись на обидва рядки.
[exit 0]

Кожен крок відповіді вказує на файл і рядок, які можна відкрити.

// workflow 02

Оцінити обсяг зміни до планування

claude> скільки місць читають застаріле поле plan_code?

text_pattern_search("plan_code")
  14 збігів у 9 файлах
dependency_search("getPlanCode", dependents)
  6 викликачів

→ Оцінка починається з числа, а не з припущення.
[exit 0]

Корисно на плануванні, коли репозиторій ні в кого не відкритий.

Налаштування в Claude Desktop

Три кроки. Тариф Free: 3 репозиторії, До 50 тис. проіндексованих рядків репозиторію, без кредитної картки.

// step 01

Проіндексуйте репозиторій на maguyva.ai

Оберіть той, який ви вже знаєте, щоб оцінити відповіді.

// step 02

Додайте Maguyva до claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

// step 03

Замініть заглушку, перезапустіть і поставте запитання

Замініть mgv_xxxx своїм API-ключем, повністю закрийте Claude Desktop і відкрийте знову. Якщо сервер не з’явився, перегляньте mcp-server-maguyva.log у теці журналів Claude (~/Library/Logs/Claude у macOS).

Самостійна реєстрація відкрита.

Проіндексуйте один репозиторій, який ви вже добре знаєте.

Підключіть Claude Desktop через MCP і поставте запитання, яке можна перевірити.

Проіндексуйте свій перший репозиторій Переглянути документацію про сумісність

тариф Free: 3 репозиторії, До 50 тис. проіндексованих рядків репозиторію, без кредитної картки.