# Panduan Instalasi

Canonical source: https://maguyva.ai/id/docs/installation

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).

Siap pakai dalam waktu kurang dari 5 menit. Panduan ini mencakup setup untuk 23 klien MCP, termasuk Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex CLI, GitHub Copilot CLI, Gemini CLI, Cline, Goose, Continue, LM Studio, Kiro CLI, JetBrains, Zed, Trae, OpenCode, BoltAI, LibreChat, Antigravity, Claude Cowork, ChatGPT, dan Warp, dan lainnya.

**Prasyarat**: Anda memerlukan kunci API dari [app.maguyva.ai](https://app.maguyva.ai) dan repository GitHub yang sudah terhubung.

## Setup Environment

Pertama, setel kunci API Anda dalam variabel lingkungan. Jangan sertakan `repository` ketika klien MCP Anda menyediakan default untuk permintaan tersebut atau kunci dapat mengakses tepat satu repository; jika tidak, berikan secara eksplisit.

### macOS/Linux (Bash/Zsh)

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

### Windows (PowerShell)

```powershell
'$Env:MAGUYVA_API_KEY="mgv_xxxx"' | Out-File -Append $PROFILE
. $PROFILE
```

Ganti `mgv_xxxx` dengan kunci API asli Anda dari [app.maguyva.ai](https://app.maguyva.ai).

## Konfigurasi Klien

Pilih klien MCP Anda di bawah untuk instruksi setup yang spesifik.

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

Maguyva memakai MCP standar. Klien apa pun yang mendukung protokol ini dapat terhubung — bahkan jika tidak ada panduan resmi di atas. 23 klien telah didokumentasikan, dan terus bertambah secara berkala.

## Validasi Setup Anda

Setelah terhubung, coba ajukan beberapa pertanyaan ke agen Anda:

- "Repository apa saja yang sudah saya hubungkan?" — memverifikasi koneksi berfungsi
- "Bagaimana autentikasi ditangani di codebase ini?" — menguji pencarian semantik
- "Temukan semua fungsi yang memanggil database" — menguji dependency search
- "Apa saja yang menjadi dependency class UserService?" — menguji pencarian simbol

Anda seharusnya melihat hasil dengan jalur file dan nomor baris dari repository yang terhubung. Jika tidak, periksa [troubleshooting](https://maguyva.ai/id/docs/troubleshooting) di bawah.

## Format Repository

Saat menentukan repository:

- Dengan branch: `"owner/repo:branch"` (e.g. `"owner/repository:develop"`)
- Branch default: `"owner/repo"`

**Tip**: gunakan `repository_context(action="info", repository="...")` untuk memeriksa resolusi repositori. Penggantian repositori secara eksplisit hanya berlaku pada panggilan saat ini.

## Pemecahan Masalah

### Masalah Kunci API

- Pastikan kunci Anda diawali dengan prefix mgv_
- Periksa apakah kunci sudah diatur dengan benar di environment Anda
- Pastikan kunci belum kedaluwarsa

### Repository Tidak Ditemukan

- Pastikan repository sudah terhubung di app.maguyva.ai
- Periksa apakah format owner/repo sudah benar
- Pastikan Anda memiliki akses ke repository tersebut

### Masalah Koneksi MCP

- Jika klien memakai penghubung @maguyva/mcp, pastikan npx tersedia di PATH
- Periksa apakah token API Anda valid dan belum kedaluwarsa
- Uji konektivitas ke https://maguyva.tools/mcp
- Periksa sintaks konfigurasi MCP klien Anda

## Langkah Berikutnya

- Referensi API MCP: Dokumentasi API lengkap
- Cara Kerja: Pahami optimisasi konteks
- Pemecahan Masalah: Perbaiki masalah setup dan koneksi