# Panduan Pemasangan

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

Mula beroperasi dalam masa kurang 5 minit. Panduan ini merangkumi persediaan 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 banyak lagi.

**Prasyarat**: Anda perlukan kunci API daripada [app.maguyva.ai](https://app.maguyva.ai) dan satu repositori GitHub yang disambungkan.

## Persediaan Persekitaran

Mula-mula, tetapkan kunci API anda dalam pemboleh ubah persekitaran. Abaikan `repository` apabila klien MCP anda memberikan lalai untuk permintaan tersebut atau apabila kunci boleh mengakses tepat satu repositori; jika tidak, berikannya 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
```

Gantikan `mgv_xxxx` dengan kunci API sebenar anda daripada [app.maguyva.ai](https://app.maguyva.ai).

## Konfigurasi Klien

Pilih klien MCP anda di bawah untuk arahan persediaan khusus.

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

Maguyva menggunakan MCP standard. Sebarang klien yang menyokong protokol ini boleh menyambung — walaupun tiada panduan rasmi di atas. 23 klien didokumenkan, lebih banyak ditambah secara berkala.

## Sahkan Persediaan Anda

Selepas menyambung, cuba tanya ejen anda beberapa soalan:

- "Repositori manakah yang telah saya sambungkan?" — mengesahkan sambungan berfungsi
- "Bagaimana pengesahan (authentication) dikendalikan dalam kod ini?" — menguji carian semantik
- "Cari semua fungsi yang memanggil pangkalan data" — menguji carian kebergantungan
- "Kelas UserService bergantung kepada apa?" — menguji carian simbol

Anda sepatutnya nampak hasil lengkap dengan laluan fail dan nombor baris daripada repositori yang disambungkan. Jika tidak, semak [troubleshooting](https://maguyva.ai/ms/docs/troubleshooting) di bawah.

## Format Repositori

Apabila menyatakan repositori:

- Dengan cabang: `"owner/repo:branch"` (e.g. `"owner/repository:develop"`)
- Cabang lalai: `"owner/repo"`

**Petua**: gunakan `repository_context(action="info", repository="...")` untuk menyemak penentuan repositori. Penggantian repositori lalai hanya terpakai pada panggilan semasa.

## Penyelesaian Masalah

### Isu Kunci API

- Sahkan kunci anda bermula dengan awalan mgv_
- Semak kunci itu ditetapkan dengan betul dalam persekitaran anda
- Pastikan kunci itu belum luput tempoh

### Repositori Tidak Ditemui

- Sahkan repositori itu disambungkan dalam app.maguyva.ai
- Semak format owner/repo adalah betul
- Pastikan anda mempunyai akses kepada repositori itu

### Isu Sambungan MCP

- Jika klien anda menggunakan jambatan @maguyva/mcp, pastikan npx tersedia dalam PATH anda
- Semak token API anda sah dan belum luput tempoh
- Uji ketersambungan ke https://maguyva.tools/mcp
- Semak sintaks konfigurasi MCP klien anda

## Langkah Seterusnya

- Rujukan API MCP: Dokumentasi API lengkap
- Cara Ia Berfungsi: Fahami pengoptimuman konteks
- Penyelesaian Masalah: Betulkan isu persediaan dan sambungan