Для пользователей 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 тыс. проиндексированных строк, без банковской карты.