Langkau ke kandungan

Mula Pantas

Laluan terpantas dari sifar kepada jawapan yang disahkan: dapatkan kunci API, indeks satu repositori yang anda sudah kenali, sambungkan klien anda, dan tanya satu soalan yang anda sudah tahu jawapannya.

1. Dapatkan kunci API#

Mula percuma — tiada kad kredit diperlukan. Kunci API anda (bermula dengan mgv_) disimpan di app.maguyva.ai.

2. Indeks repositori yang anda sudah kenali#

Sambungkan repositori GitHub dari portal dan biarkan ia diindeks. Pilih repo kecil yang boleh anda semak dengan pantas — ini memudahkan anda nampak sama ada Maguyva benar-benar menjadikan jawapan berasaskan kod sebenar, bukannya terus cuba mengindeks seluruh kod syarikat anda pada hari pertama.

3. Sambungkan klien anda#

Untuk Claude Code, pasang plugin Maguyva dari marketplace — jalankan setiap arahan ini di dalam Claude Code:

/plugin marketplace add maguyva/claude-code-plugin
/plugin install maguyva@maguyva

Plugin ini mengesahkan diri menggunakan kunci anda daripada pemboleh ubah persekitaran MAGUYVA_API_KEY. Tetapkannya dalam shell anda (direnv per-projek disyorkan, kerana kunci bersifat khusus repositori):

export MAGUYVA_API_KEY=mgv_xxxx

Bekerja dalam pasukan? Tambah --scope project pada kedua-dua arahan /plugin untuk komit plugin ini ke .claude/settings.json repositori, supaya rakan sepasukan mendapatnya secara automatik.

Kebanyakan klien lain (Cursor, VS Code, Windsurf, Zed, dan seangkatan) menyambung terus ke pelayan jarak jauh — arahkan mereka ke endpoint dengan header Bearer, tanpa memerlukan bridge. Contohnya, .cursor/mcp.json milik Cursor:

.cursor/mcp.json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

Bentuk konfigurasi berbeza sedikit mengikut klien (VS Code bersarang di bawah servers dengan type: "http", Windsurf menggunakan serverUrl, Zed menggunakan context_servers). Gantikan mgv_xxxx dengan kunci API anda, kemudian mulakan semula klien anda. Konfigurasi tepat untuk semua 24 klien yang didokumentasikan ada dalam Panduan Pemasangan.

4. Tanya satu soalan yang anda sudah tahu jawapannya#

Mulakan dengan "Repositori apa yang saya ada sambungkan?" untuk sahkan sambungan, kemudian tanya satu soalan sebenar tentang repo anda yang jawapannya anda sudah tahu — seperti "Bagaimana pengesahan (authentication) dikendalikan dalam codebase ini?"

Anda sepatutnya mendapat jawapan lengkap dengan laluan fail dan nombor baris. Buka fail yang disebut dan semak sama ada jawapan itu benar-benar tepat apabila dibandingkan dengan repo sebenar. Satu jawapan teruji itu memberitahu anda lebih banyak daripada mana-mana senarai ciri — biarkan tool ini buktikan kebolehpercayaannya dahulu sebelum ia menyertai aliran kerja lalai anda.

Tiada hasil, atau ralat sambungan? Pergi ke Penyelesaian Masalah — kebanyakan kegagalan berpunca daripada kunci API yang belum ditetapkan, npx yang tiada, atau repositori yang belum selesai diindeks.

Langkah seterusnya#