Перейти к содержимому

Сборник рецептов

Практические рецепты повседневной работы Maguyva MCP. В каждом рецепте указаны инструменты и последовательность, а не полная ссылка на параметры. Для параметров инструмента используйте MCP API Ссылка. Для первоначальной настройки используйте Быстрый старт.

Выберите правильный инструмент#

Большинство вопросов начинаются с одного звонка. Обостряйте ситуацию только в том случае, если первый ответ слишком широк или слишком скуден.

  • intelligent_search — начните здесь для любого вопроса по кодовой базе естественного языка; он маршрутизируется по semantic, symbol, структурному поиску и dependency.
  • find_symbol — вы уже знаете имя функции, класса или переменной.
  • dependency_search — радиус взрыва: звонящие, иждивенцы или воздействие до (и после) редактирования.
  • get_task_context — незнакомая местность; один ограниченный пакет файлов symbol и зависимостей для описания задачи.
  • repository_context — список доступных репозиториев или проверка разрешения имени репозитория.
  • ask_maguyva с operation="guidance" — локальная справка по выбору инструмента и использованию Maguyva (без мутации репо).

Установите и проверьте клиент#

Загрузите Maguyva в свой клиент MCP и подтвердите соединение с реальным списком репозиториев.

  1. Создайте ключ API в app.maguyva.ai (ключи начинаются с mgv_).
  2. Подключите и проиндексируйте хотя бы один уже знакомый вам репозиторий GitHub.
  3. Подключите свой клиент с помощью Руководство по установке (плагин Claude Code или встроенная удаленная конфигурация для Cursor, VS Code, Windsurf, Zed и других).
  4. Спросите своего агента "Какие репозитории у меня подключены?" — он осуществляет аутентификацию и сквозную аутентификацию repository_context.
  5. Задайте один реальный вопрос об этом репозитории, ответ на который вы можете оценить. Вы должны увидеть пути к файлам и номера строк из индексированного дерева.

Застряли на ключах, мостах или отсутствующих репозиториях? Поиск неисправностей.

Спросите, прежде чем редактировать#

Прежде чем менять общий код, сопоставьте symbol и радиус взрыва. Инструменты Maguyva не изменяют ваши репозитории — они сообщают, что изменения, которые ваш клиент применяет локально, не вносятся в них.

  1. Если вы знаете имя symbol, позвоните в find_symbol, чтобы узнать об определениях и использовании.
  2. Если у вас есть только описание задачи («добавить SSO», «исправить вебхук для выставления счетов»), начните с get_task_context или intelligent_search.
  3. Прежде чем редактировать общий symbol, вызовите dependency_search с анализом зависимостей/воздействия (или передайте измененные пути для воздействия стиля PR-), чтобы увидеть радиус взрыва.
  4. Откройте указанные файлы (локальное чтение для файлов на диске; get_file для удаленных путей/путей между репозиториями) и сверьте план с реальным кодом.
  5. После редактирования повторно проверьте те же symbol с dependency_search (включая проверку после редактирования, если ваш клиент поддерживает флаги проверки), чтобы вызывающие объекты по-прежнему разрешались должным образом.

Полные параметры: MCP API Ссылка.

Искать, затем менять#

Цикл агента по умолчанию: исследовать → закрепить symbol → редактировать с доказательствами.

  1. Начните с intelligent_search и запроса на простом языке («как работает истечение срока сеанса», «где логика повтора»).
  2. Ограничьте фильтрами языка или пути, если первое окно зашумлено.
  3. Продвигайте многообещающие хиты на find_symbol или dependency_search вместо того, чтобы повторно задавать тот же расплывчатый вопрос.
  4. Используйте get_file только в том случае, если вам нужен определенный индексированный путь, которого нет на диске.
  5. Редактируйте в своих обычных клиентских инструментах. Maguyva предназначен для обнаружения и проверки — не пишет.

Почему этот цикл работает: Как это работает.

Пустые или тонкие результаты#

Если инструменты не возвращают ничего полезного, исправьте разрешение и индексацию, прежде чем навсегда переписывать запрос.

  1. Убедитесь, что репозиторий подключен и индексация в app.maguyva.ai завершена.
  2. Проверьте строку репозитория: "owner/repo" использует ветку по умолчанию; "owner/repo:branch" закрепляет ветку. Сопоставление не учитывает регистр и не является нечетким — опечатки не исправляются автоматически.
  3. Вызовите repository_context с помощью action="info" и проверьте метаданные разрешения (например, metadata.resolution_reason).
  4. Опустите repository только в том случае, если ваш клиент MCP предоставляет запрос по умолчанию или ключ может получить доступ только к одному репозиторию; в противном случае передайте его явно.
  5. Повторите попытку с более конкретным запросом, известным именем symbol через find_symbol или фильтром языка/пути. Если само соединение нарушено, используйте Поиск неисправностей.

Сбои установки: Поиск неисправностей.

Работа с несколькими репозиториями#

Нацельтесь на правильное индексированное репо, если ключ может видеть более одного.

  1. Позвоните repository_context с помощью action="list" один раз, чтобы узнать, какие именно пули может искать ваш ключ.
  2. Явно передайте repository в инструменты поиска и symbol, если вам нужен репозиторий не по умолчанию (например, "owner/other-repo" или "owner/other-repo:develop").
  3. Сохраняйте один вопрос = один репозиторий, если только вы намеренно не сравниваете репозитории в отдельных вызовах.
  4. Используйте get_file, если файл находится в индексированном репозитории, который не является вашим текущим рабочим деревом.
  5. Помните: инструменты никогда не пишут обратно в GitHub — контекст нескольких репозиториев предназначен только для чтения и планирования.

Подробности формата репозитория: MCP API Ссылка.

Впервые в Maguyva? Сначала пройдите Быстрый старт, а затем вернитесь сюда на циклы второго дня.

Следующие шаги#