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

Canonical source: https://maguyva.ai/ru/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 и задайте вопрос, который можно проверить.