Lompat ke konten

Buku Resep

Resep praktis untuk pekerjaan sehari-hari Maguyva MCP. Setiap resep memberi nama alat dan urutannya — bukan referensi parameter lengkap. Untuk parameter alat, gunakan Referensi MCP API. Untuk pengaturan pertama kali, gunakan Mulai cepat.

Pilih alat yang tepat#

Kebanyakan pertanyaan dimulai dengan satu panggilan. Tingkatkan hanya jika jawaban pertama terlalu luas atau terlalu tipis.

  • intelligent_search — mulai di sini untuk pertanyaan natural-language tentang codebase; alat ini mengarahkan pencarian semantic, symbol, struktural, dan dependency.
  • find_symbol — gunakan saat Anda sudah mengetahui nama fungsi, kelas, atau variabel.
  • dependency_search — petakan dampak: pemanggil, dependensi, dan efek sebelum maupun sesudah perubahan.
  • get_task_context — untuk area yang belum dikenal; satu paket terbatas berisi file, symbol, dan dependensi berdasarkan deskripsi tugas.
  • repository_context — tampilkan repositori yang dapat diakses atau periksa bagaimana nama repositori di-resolve.
  • ask_maguyva dengan operation="guidance" — bantuan lokal untuk memilih dan menggunakan alat Maguyva, tanpa mengubah repo.

Instal dan verifikasi klien#

Tambahkan Maguyva ke klien MCP Anda, lalu verifikasi koneksinya dengan daftar repositori yang nyata.

  1. Buat kunci API di app.maguyva.ai (kunci diawali mgv_).
  2. Hubungkan dan indeks setidaknya satu repositori GitHub yang sudah Anda pahami.
  3. Konfigurasikan klien melalui Panduan Instalasi (plugin Claude Code, atau konfigurasi remote native untuk Cursor, VS Code, Windsurf, Zed, dan lainnya).
  4. Tanyakan "Repositori apa yang telah saya sambungkan?" kepada agen Anda; ini menguji autentikasi dan repository_context dari awal hingga akhir.
  5. Ajukan satu pertanyaan nyata tentang repo itu yang jawabannya bisa Anda nilai. Anda seharusnya melihat path file dan nomor baris dari tree yang telah diindeks.

Terjebak pada kunci, jembatan, atau repo yang hilang? Pemecahan masalah.

Tanyakan sebelum Anda mengedit#

Petakan symbol dan dampak perubahan sebelum mengubah kode bersama. Alat Maguyva tidak memodifikasi repositori Anda; alat ini menyediakan bukti untuk perubahan yang diterapkan klien secara lokal.

  1. Jika Anda mengetahui nama symbol, panggil find_symbol untuk menemukan definisi dan penggunaannya.
  2. Jika Anda hanya memiliki deskripsi tugas ("tambahkan SSO", "perbaiki webhook penagihan"), mulai dengan get_task_context atau intelligent_search.
  3. Sebelum mengedit symbol bersama, panggil dependency_search untuk menganalisis dependensi dan dampak (atau kirim path yang berubah untuk analisis ala PR) agar Anda melihat seluruh blast radius.
  4. Buka file yang dirujuk (baca secara lokal untuk file di disk; gunakan get_file untuk path remote atau lintas repo), lalu cocokkan rencana dengan kode yang sebenarnya.
  5. Setelah mengedit, periksa kembali symbol yang sama dengan dependency_search, termasuk verifikasi pascaedit jika klien mendukung flag tersebut, agar para pemanggil tetap di-resolve sesuai harapan.

Parameter lengkap: Referensi MCP API.

Cari, lalu ubah#

Loop agen bawaan: jelajahi → tetapkan symbol → edit berdasarkan bukti.

  1. Mulai dengan intelligent_search dan kueri natural-language ("bagaimana sesi kedaluwarsa", "di mana logika retry berada").
  2. Persempit dengan filter bahasa atau path ketika hasil pertama terlalu bising.
  3. Lanjutkan hasil yang menjanjikan ke find_symbol atau dependency_search, alih-alih mengulang pertanyaan samar yang sama.
  4. Gunakan get_file hanya saat Anda membutuhkan path terindeks tertentu yang tidak tersedia di disk.
  5. Edit dengan alat klien biasa. Maguyva untuk penemuan dan verifikasi, bukan untuk menulis.

Mengapa loop ini berfungsi: Cara Kerjanya.

Hasil kosong atau tipis#

Jika alat tidak menghasilkan apa pun yang berguna, perbaiki resolusi dan pengindeksan sebelum menulis ulang kueri selamanya.

  1. Konfirmasikan repositori terhubung dan selesai mengindeks di app.maguyva.ai.
  2. Periksa string repositori: "owner/repo" menggunakan cabang default; "owner/repo:branch" menyematkan cabang. Pencocokan tidak membedakan huruf besar-kecil, tidak kabur — kesalahan ketik tidak dikoreksi secara otomatis.
  3. Panggil repository_context dengan action="info" dan periksa metadata resolusi (misalnya metadata.resolution_reason).
  4. Hilangkan repository hanya ketika klien MCP Anda menyediakan permintaan default atau kunci dapat mengakses tepat satu repositori; jika tidak, sampaikan secara eksplisit.
  5. Coba lagi dengan kueri yang lebih spesifik, nama symbol yang dikenal melalui find_symbol, atau filter bahasa/jalur. Jika koneksinya sendiri terputus, gunakan Pemecahan masalah.

Kegagalan pengaturan: Pemecahan masalah.

Bekerja di banyak repositori#

Targetkan repo terindeks yang tepat ketika sebuah kunci dapat melihat lebih dari satu.

  1. Panggil repository_context dengan action="list" satu kali untuk mengetahui slug persis yang dapat dicari oleh kunci Anda.
  2. Kirim repository secara eksplisit ke alat pencarian dan symbol saat Anda membutuhkan repo non-default (misalnya "owner/other-repo" atau "owner/other-repo:develop").
  3. Pertahankan satu pertanyaan = satu repositori, kecuali Anda memang membandingkan repo melalui panggilan terpisah.
  4. Gunakan get_file saat file berada di repo terindeks yang bukan working tree saat ini.
  5. Ingat: alat tidak pernah menulis kembali ke GitHub; konteks lintas repo hanya untuk membaca dan merencanakan.

Detail format repositori: Referensi MCP API.

Baru menggunakan Maguyva? Ikuti Mulai cepat terlebih dahulu, lalu kembali ke sini untuk alur kerja hari berikutnya.

Langkah selanjutnya#