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

Canonical source: https://maguyva.ai/uk/for-claude-desktop

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

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

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

## Що треба знати про 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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

`claude_desktop_config.json`

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

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

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

У [посібнику MCP про локальні сервери](https://modelcontextprotocol.io/docs/develop/connect-local-servers) докладніше описано файл конфігурації та його журнали.

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

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