# Mula Pantas

Canonical source: https://maguyva.ai/ms/docs/quickstart

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

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](https://app.maguyva.ai) — tiada kad kredit diperlukan. Kunci API anda (bermula dengan `mgv_`) disimpan di [app.maguyva.ai](https://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:

```text
/plugin marketplace add maguyva/agent-plugins
/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):

```bash
export MAGUYVA_API_KEY="mgv_xxxx"
```

Bekerja dalam pasukan? Pilih skop project dalam panel yang dibuka oleh `/plugin install maguyva@maguyva`. Ini merekodkan plugin dalam `.claude/settings.json` repositori, yang anda commit; setiap rakan sepasukan masih menjalankan pemasangan sekali. Arahan `/plugin` dalam sesi tiada bendera `--scope`, jadi untuk menskripkannya, jalankan bentuk shell dari akar repositori:

```bash
claude plugin marketplace add maguyva/agent-plugins --scope project
claude plugin install maguyva@maguyva --scope project
```

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

```json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}
```

Bentuk konfigurasi berbeza sedikit mengikut klien (VS Code bersarang di bawah `servers` dengan `type: "http"`, Antigravity menggunakan `serverUrl`, Zed menggunakan `context_servers`). Contoh Cursor ini membaca kunci anda daripada pemboleh ubah persekitaran `MAGUYVA_API_KEY` yang ditunjukkan di atas; jika konfigurasi sesuatu klien memaparkan pemegang tempat `mgv_xxxx` sebaliknya, gantikan dengan kunci API anda. Kemudian mulakan semula klien anda. Konfigurasi tepat untuk semua 23 klien yang didokumentasikan ada dalam [Panduan Pemasangan](https://maguyva.ai/ms/docs/installation).

## 4. Tanya satu soalan yang anda sudah tahu jawapannya

Mulakan dengan **"Repositori manakah yang telah saya sambungkan?"** untuk sahkan sambungan, kemudian tanya satu soalan sebenar tentang repo anda yang jawapannya anda sudah tahu — seperti **"Bagaimana pengesahan (authentication) dikendalikan dalam pangkalan kod 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 alat ini buktikan kebolehpercayaannya dahulu sebelum ia menyertai aliran kerja lalai anda.

Tiada hasil carian atau sambungan bermasalah? Semak kunci API, konfigurasi klien dan status pengindeksan repositori dalam [Penyelesaian Masalah](https://maguyva.ai/ms/docs/troubleshooting). Jika persediaan anda menggunakan jambatan, semak juga bahawa `npx` tersedia.

## Langkah seterusnya

- Panduan Pemasangan: konfigurasi setiap klien untuk semua 23 klien yang didokumentasikan
- Cara Ia Berfungsi: apa yang berlaku antara soalan anda dan jawapannya
- Rujukan API MCP: setiap alat, parameter demi parameter