# Agen Warp tinggal di terminal. Beri ia peta repo.

Canonical source: https://maguyva.ai/id/for-warp

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

Agen Warp menjalankan perintah dan membaca keluarannya. Maguyva mengindeks seluruh repo dan menyajikannya lewat MCP, jadi agen bertanya di mana kode berada alih-alih menjalankan grep dan cat sampai ada yang cocok.

> Satu entri mcpServers di ~/.warp/.mcp.json: sebuah URL dan header Authorization.

## Yang perlu diketahui Warp

Empat fakta khusus Warp.

### ~/.warp/.mcp.json

Warp memulai sendiri server di berkas global ini. Anda juga bisa menempelkan JSON yang sama di Settings → Agents → MCP servers → + Add.

### Jarak jauh, lewat URL

Entri `url` terhubung lewat Streamable HTTP atau SSE. Tidak ada yang berjalan secara lokal dan Node.js tidak diperlukan.

### Header apa adanya

Kunci langsung masuk ke header `Authorization`. Simpan di berkas global, bukan di `.warp/.mcp.json` proyek yang Anda commit.

### Tidak pernah dimulai otomatis

Warp mendeteksi `.warp/.mcp.json` di repo hasil clone, tetapi menunggu Anda memulai setiap server. Warp juga bisa membaca server dari konfigurasi Claude Code dan Codex setelah Anda menyalakannya.

## Rules proyek adalah kesepakatan kerja. Gunakan.

```text
# AGENTS.md
- Jalankan make test sebelum menyatakan perubahan selesai.
- Gunakan skrip di bin/, bukan perintah dadakan.
```

Warp membaca rules proyek dari `AGENTS.md` (atau `WARP.md`, yang diutamakan bila keduanya ada) dan menerapkan Global Rules di mana saja. Gunakan untuk:

- Perintah build, test, dan deploy.
- Konvensi yang terus-terusan salah dikerjakan agen.
- Perintah yang tidak boleh dijalankan agen.

Rules memberi tahu agen cara bekerja. Rules tidak bisa memberi tahu layanan mana yang masih membaca variabel lingkungan yang akan Anda hapus.

## Di mana grep di terminal berhenti

Tiga hal yang tidak murah dipelajari sesi shell.

### // keluaran lewat begitu saja

Setiap grep dan cat yang dijalankan agen masuk ke percakapan. Pencarian yang mencetak dua ratus baris menghabiskan konteks sebelum pekerjaan sebenarnya dimulai.

### // kecocokan bukan pemanggil

grep tidak bisa membedakan panggilan sungguhan dari komentar, fixture, atau metode bernama sama di kelas lain.

### // shell mulai dari nol

Sesi baru tidak tahu apa pun tentang repo. Indeks Maguyva sudah dibangun, jadi pertanyaan pertama langsung mendapat jawaban berperingkat.

## Maguyva sebagai server MCP di Warp

Satu entri mcpServers memberi agen Warp:

- **11 alat di atas repo yang terindeks**: pencarian semantik, struktural (AST), graf, dan teks, ditambah pencarian simbol, dependen, dan pengambilan berkas.
- **Jawaban dengan jalur berkas dan nomor baris**: di 285+ bahasa, cukup pendek untuk dibaca di panel terminal.
- **Alat yang hanya membaca**: Alat Maguyva hanya mengkueri indeks. Tidak ada yang mengedit berkas atau menjalankan perintah.

> Warp memberi agen *sebuah terminal*.
> Maguyva memberi agen *peta kode*.

## Dua alur kerja

Tanya peta dulu, baru jalankan perintah.

### 01. Lacak skrip yang gagal sampai ke sumbernya

```text
warp agent> deploy.sh gagal: BUILD_ID belum diatur. di mana diaturnya?

text_pattern_search("BUILD_ID=")
  ci/env.sh:9   export BUILD_ID=...
  docs/deploy.md:31   ← prosa

→ Agen memuat ci/env.sh lalu menjalankan ulang deploy.
[exit 0]
```

Satu pencarian terindeks menggantikan grep rekursif di seluruh repo beserta keluarannya.

### 02. Periksa pemanggil sebelum mengubah langkah boot

```text
warp agent> bisakah kita berhenti menjalankan migrasi saat startup?

dependency_search("runMigrations", dependents)
  3 pemanggil: server.ts, worker.ts, scripts/seed.ts

→ Agen memindahkan ketiganya ke langkah rilis.
[exit 0]
```

Pemanggil datang sebelum perubahan, jadi worker tidak boot dengan skema lama.

## Setup di Warp

Tiga langkah. Paket Free: 3 repository, Hingga 50K baris repo terindeks, tanpa kartu kredit.

### 01. Indeks repo di maguyva.ai

Pilih yang sudah Anda kenal, agar Anda dapat menilai jawabannya.

### 02. Tambahkan Maguyva ke ~/.warp/.mcp.json

`~/.warp/.mcp.json`

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

### 03. Ganti placeholder dan ajukan satu pertanyaan

Ganti `mgv_xxxx` dengan kunci API Anda lalu simpan. Pastikan server berjalan di Settings → Agents → MCP servers, lalu ajukan satu pertanyaan yang jawabannya sudah Anda ketahui.

[Dokumentasi MCP](https://docs.warp.dev/agents/capabilities/mcp/) Warp membahas server berbasis berkas, berbagi, dan autentikasi.

## Indeks satu repo yang sudah Anda kenal.

Hubungkan Warp lewat MCP, lalu ajukan satu pertanyaan yang bisa Anda periksa.