# Mulai Cepat

Canonical source: https://maguyva.ai/id/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).

Jalan tercepat dari nol ke jawaban terverifikasi: dapatkan kunci API, indeks satu repository yang sudah Anda kenal, hubungkan klien Anda, lalu ajukan satu pertanyaan yang jawabannya sudah Anda ketahui.

## 1. Dapatkan kunci API

[Mulai gratis](https://app.maguyva.ai) — tanpa kartu kredit. Kunci API Anda (diawali dengan `mgv_`) tersimpan di [app.maguyva.ai](https://app.maguyva.ai).

## 2. Indeks repository yang sudah Anda kenal

Hubungkan repository GitHub dari portal dan biarkan proses pengindeksan berjalan. Pilih repo kecil yang bisa Anda periksa cepat — dengan begitu jelas terlihat apakah Maguyva benar-benar melandasi model dengan kode nyata, alih-alih langsung mengindeks seluruh kode perusahaan Anda di hari pertama.

## 3. Hubungkan klien Anda

Untuk Claude Code, instal plugin Maguyva dari marketplace — jalankan setiap perintah ini di dalam Claude Code:

```text
/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva
```

Plugin ini melakukan autentikasi memakai kunci Anda dari variabel lingkungan `MAGUYVA_API_KEY`. Atur variabel ini di shell Anda (`direnv` per proyek disarankan, karena kunci bersifat khusus repository):

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

Bekerja dalam tim? Pilih cakupan project di panel yang dibuka `/plugin install maguyva@maguyva`. Itu mencatat plugin di `.claude/settings.json` milik repository, yang Anda commit; setiap rekan tim tetap menjalankan instalasi sekali. Perintah `/plugin` di dalam sesi tidak menerima flag `--scope`, jadi untuk membuat skripnya, jalankan bentuk shell dari root repository:

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

Sebagian besar klien lain (Cursor, VS Code, Devin Desktop, Zed, dan sejenisnya) terhubung langsung ke server remote — arahkan ke endpoint dengan header `Bearer`, tanpa perlu bridge. Contohnya, `.cursor/mcp.json` milik Cursor:

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

Bentuk konfigurasinya sedikit berbeda tiap klien (VS Code bersarang di bawah `servers` dengan `type: "http"`, Antigravity memakai `serverUrl`, Zed memakai `context_servers`). Contoh Cursor ini membaca kunci Anda dari environment variable `MAGUYVA_API_KEY` yang ditunjukkan di atas; kalau config sebuah klien justru menampilkan placeholder `mgv_xxxx`, ganti dengan kunci API Anda. Lalu mulai ulang klien Anda. Konfigurasi lengkap untuk semua 23 klien yang didokumentasikan ada di [Panduan Instalasi](https://maguyva.ai/id/docs/installation).

## 4. Ajukan satu pertanyaan yang jawabannya sudah Anda ketahui

Mulai dengan **"Repository apa saja yang sudah saya hubungkan?"** untuk memastikan koneksi berhasil, lalu ajukan satu pertanyaan nyata tentang repo Anda yang jawabannya sudah Anda ketahui — misalnya **"Bagaimana autentikasi ditangani di codebase ini?"**

Anda seharusnya mendapatkan jawaban lengkap dengan jalur file dan nomor baris. Buka file yang dikutip dan periksa apakah jawabannya benar-benar cocok dengan repo yang sesungguhnya. Satu jawaban teruji itu memberi tahu Anda lebih banyak daripada daftar fitur mana pun — biarkan alat ini membuktikan diri layak dipercaya sebelum masuk ke alur kerja utama Anda.

Tidak ada hasil atau terjadi kesalahan koneksi? Periksa kunci API, konfigurasi klien, dan status pengindeksan repository di [Pemecahan Masalah](https://maguyva.ai/id/docs/troubleshooting). Jika penyiapan Anda memakai bridge, pastikan `npx` juga tersedia.

## Langkah berikutnya

- Panduan Instalasi: konfigurasi per klien untuk semua 23 klien yang didokumentasikan
- Cara Kerja: apa yang terjadi antara pertanyaan Anda dan jawabannya
- Referensi API MCP: setiap tool, parameter demi parameter