Cara Instal dan Gunakan Augment Context Engine MCP
Cara Instal dan Gunakan Augment Context Engine MCP
Augment's Context Engine MCP menghubungkan pencarian kode tingkat enterprise ke agen AI modern. Setelah server Model Context Protocol (MCP) berjalan secara lokal, alat seperti Cursor, Claude Code, Zed, atau GitHub Copilot dapat meminta Augment untuk pengambilan kode yang tepat, menjaga asisten Anda tetap terkoneksi dengan proyek nyata. Panduan ini menjelaskan instalasi, konfigurasi, dan penggunaan sehari-hari agar Anda dapat mulai mengirim fitur dengan lebih cepat.
Mengapa Memilih Augment Context Engine MCP?
- Kesadaran proyek yang mendalam – Augment membangun indeks pencarian multi-repo, sehingga kueri seperti "Di mana kita menginisialisasi Stripe?" langsung mengembalikan file yang tepat.
- Kompatibilitas MCP – Klien yang mendukung MCP (Cursor, Claude Desktop, Gemini CLI, dll.) dapat memanggil server yang sama tanpa perlu plugin baru.
- Alur autentikasi yang aman – Anda dapat mengandalkan sesi login Auggie CLI atau menyisipkan token akses terbatas melalui
AUGMENT_SESSION_AUTH. - Alat lintas platform – Bekerja di macOS, Windows, dan Linux. Server berkomunikasi melalui stdio, sehingga editor-agnostik.
Prasyarat
- Node.js 18+ agar bisa menginstal Auggie CLI (
npmataunpx). - Akun Augment dengan akses ke Context Engine. Daftar di Augment dan verifikasi workspace Anda.
- Klien MCP yang didukung seperti Cursor, Claude Code/Desktop, Zed, atau GitHub Copilot.
Langkah 1: Instal Auggie CLI
Augment menyediakan server MCP sebagai bagian dari Auggie CLI. Instal paket pre-release secara global:
npm install -g @augmentcode/auggie@prereleaseVerifikasi instalasi:
auggie --versionMemperbarui CLI memastikan Anda menerima peningkatan protokol dan alat pengambilan baru.
Langkah 2: Autentikasi dengan Augment
Login menggunakan browser agar CLI dapat mengeluarkan permintaan yang telah ditandatangani:
auggie loginPerintah ini membuka jendela OAuth Augment. Setelah autentikasi, CLI menyimpan sesi lokal yang akan digunakan kembali oleh server MCP. Jika Anda butuh setup yang ramah CI, ekspor token sebagai gantinya:
auggie token print
export AUGMENT_SESSION_AUTH='{"accessToken":"...","tenantURL":"https://tenant.augmentcode.com","scopes":["read","write"]}'Tips: Jangan pernah menyimpan token di git. Gunakan ekspor terminal, file
.envdalam.gitignore, atau pengelola rahasia.
Langkah 3: Jalankan Server MCP
Auggie CLI menyediakan mode context engine:
auggie --mcp -m default -w "${WORKSPACE_FOLDER_PATHS%%,*}"-m defaultmemilih profil model Augment Anda.-wmenunjuk ke folder workspace pertama supaya server dapat mencerminkan struktur proyek Anda.
Ketika klien terhubung melalui MCP, Auggie mengindeks file secara bertahap dan menawarkan alat seperti codebase-retrieval atau query_codebase.
Langkah 4: Konfigurasikan Klien MCP Anda
Cursor IDE
- Buka Settings › Tools & MCP → New MCP Server.
- Tempelkan snippet JSON sesuai OS Anda:
macOS / Linux (bash):
{
"mcpServers": {
"augment-context-engine": {
"type": "local",
"command": "bash",
"args": ["-c", "auggie --mcp -m default -w \"${WORKSPACE_FOLDER_PATHS%%,*}\""] ,
"enabled": true
}
}
}Windows (PowerShell):
{
"mcpServers": {
"augment-context-engine": {
"type": "local",
"command": "powershell",
"args": ["-Command", "auggie --mcp -m default -w \"($env:WORKSPACE_FOLDER_PATHS -split ',')[0]\""],
"enabled": true
}
}
}- Restart Cursor. Anda sekarang harus melihat
codebase-retrievaldi palet alat MCP.
Claude Code / Claude Desktop
- Edit konfigurasi Claude (macOS:
~/Library/Application Support/Claude/claude_desktop_config.json, Windows:%APPDATA%/Claude/claude_desktop_config.json). - Tambahkan entri server Augment:
{
"mcpServers": {
"augment-context-engine": {
"command": "npx",
"args": ["-y", "auggie-context-mcp@latest"],
"env": {
"AUGMENT_SESSION_AUTH": "{\"accessToken\":\"your-token\",\"tenantURL\":\"https://...\"}"
}
}
}
}- Restart Claude Desktop untuk memuat set alat MCP baru.
Root workspace: Claude Code membutuhkan path root repo agar server mengindeks file yang benar. Konfigurasikan di Claude Code Settings › Workspace Root dalam IDE.
Langkah 5: Uji Integrasi
Di IDE yang mendukung MCP, jalankan prompt pengambilan sederhana:
"Apa yang dilakukan proyek ini? Mohon gunakan alat codebase retrieval."Anda harus melihat agen memanggil codebase-retrieval, menampilkan snippet kaya konteks secara streaming, dan menjawab dengan sitasi. Jika alat tidak muncul, periksa output CLI untuk kesalahan seperti:
Auggie CLI not found→ pastikan binary ada di PATH.Authentication required→ jalankan ulangauggie loginatau perbarui token Anda.Query timed out→ indeks pertama dapat memakan waktu lebih lama di monorepo besar; coba lagi setelah indeks selesai.
Tips Penggunaan Sehari-hari
- Ajukan pertanyaan yang tepat. Alih-alih "Di mana auth?", tanyakan "Tunjukkan middleware yang memvalidasi JWT" untuk mengurangi gangguan.
- Gabungkan alat. Cursor dan Claude dapat memanggil
codebase-retrieval,codebase-search, dan alat MCP lain secara berurutan untuk jawaban bertahap. - Proyek multi-repo. Gunakan beberapa flag
-watau folder workspace saat mengembangkan microservices agar Augment memetakan referensi antar-service. - Cadangan offline. Jika koneksi hilang, CLI tetap melayani indeks cache, tapi respons mungkin tidak mencakup perubahan jarak jauh terbaru. Jalankan
git pulldan restart server saat online kembali.
Seberapa Baik Augment Context Engine MCP?
- Presisi: Augment fokus pada alur kerja developer, sehingga peringkat memprioritaskan graph panggilan, tes, dan dokumentasi yang relevan dengan kueri Anda.
- Kecepatan: Server MCP mengalirkan token ke klien hampir secara instan, dan kueri berikutnya menggunakan cache yang sudah dipanaskan.
- Keamanan: Token autentikasi tetap lokal, dan transport stdio berarti Anda mengontrol lingkungan runtime. Untuk tim, Augment Enterprise mendukung kebijakan organisasi dan log audit.
- Kelemahan: Mesin bergantung pada backend Augment yang dikelola, jadi Anda perlu langganan aktif dan akses jaringan. Karena mengindeks lokal, proses pertama pada monorepo besar bisa memakan waktu beberapa menit.
Dibandingkan embedding DIY atau retriever open-source, Augment menghemat waktu setup dan terintegrasi dengan agen IDE utama secara langsung. Jika Anda sudah menggunakan Cursor atau Claude, jalur MCP terasa sangat alami.
Daftar Periksa Troubleshooting
| Gejala | Penyebab Kemungkinan | Solusi |
|---|---|---|
| Server MCP tidak muncul | JSON salah konfigurasi | Periksa koma/quotes, restart klien |
Auggie CLI not found | Masalah PATH | Instal ulang CLI atau tambahkan direktori npm global ke PATH |
| Error autentikasi | Sesi kedaluwarsa | auggie login atau perbarui AUGMENT_SESSION_AUTH |
| Alat hilang di IDE | Workspace tidak cocok | Pastikan -w menunjuk ke repo aktif |
| Kueri lambat | Indeks pertama | Biarkan CLI berjalan sampai indeks selesai |
Kesimpulan
Augment's Context Engine MCP memberikan agen coding AI akses terpercaya ke kode nyata Anda. Dengan beberapa perintah terminal — instal Auggie, login, dan tempel konfigurasi MCP — Anda mendapatkan pengambilan yang tepat, review lebih cepat, dan kode yang minim halusinasi. Biarkan server berjalan berdampingan dengan IDE dan perlakukan seperti layanan pengembangan lain: perbarui secara rutin, awasi log, dan amankan token Anda.
Butuh infrastruktur andal untuk hosting eksperimen MCP, layanan tambahan, atau lingkungan demo? Jelajahi node global terjangkau dari LightNode di tautan ini dan buat VPS hanya dalam hitungan menit.