Перейти до вмісту

Збірник рецептів

Практичні рецепти для щоденної роботи 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? Спочатку пройдіть Швидкий старт, а потім поверніться сюди на день-два петлі.

Наступні кроки#