# Ejen Warp tinggal dalam terminal. Beri ia peta repo.

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

Ejen Warp menjalankan arahan dan membaca output yang dicetaknya. Maguyva mengindeks seluruh repo dan menyajikannya melalui MCP, jadi ejen bertanya di mana kod berada dan bukannya menjalankan grep dan cat sehingga ada yang sepadan.

> Satu entri mcpServers dalam ~/.warp/.mcp.json: satu URL dan satu pengepala Authorization.

## Perkara yang perlu diketahui tentang Warp

Empat fakta khusus untuk Warp.

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

Warp memulakan sendiri pelayan dalam fail global ini. Anda juga boleh menampal JSON yang sama dalam Settings → Agents → MCP servers → + Add.

### Jauh, melalui URL

Entri `url` bersambung melalui Streamable HTTP atau SSE. Tiada apa yang berjalan secara setempat dan Node.js tidak diperlukan.

### Pengepala literal

Kunci terus masuk ke pengepala `Authorization`. Simpan dalam fail global, bukan dalam `.warp/.mcp.json` projek yang anda commit.

### Tidak pernah dimulakan automatik

Warp mengesan `.warp/.mcp.json` dalam repo yang diklon tetapi menunggu anda memulakan setiap pelayan. Warp juga boleh membaca pelayan daripada konfigurasi Claude Code dan Codex sebaik sahaja anda menghidupkannya.

## Peraturan projek ialah persetujuan kerja. Gunakannya.

```text
# AGENTS.md
- Jalankan make test sebelum menganggap sesuatu perubahan selesai.
- Guna skrip dalam bin/, bukan arahan sesuka hati.
```

Warp membaca peraturan projek daripada `AGENTS.md` (atau `WARP.md`, yang diutamakan jika kedua-duanya wujud) dan menggunakan Global Rules di mana-mana. Gunakannya untuk:

- Arahan build, ujian dan deploy.
- Konvensyen yang asyik tersilap oleh ejen.
- Arahan yang tidak boleh sekali-kali dijalankan ejen.

Peraturan memberitahu ejen cara bekerja. Ia tidak dapat memberitahu perkhidmatan mana yang masih membaca pemboleh ubah persekitaran yang akan anda buang.

## Di mana grep dalam terminal berakhir

Tiga perkara yang tidak murah untuk dipelajari sesi shell.

### // output berlalu pergi

Setiap grep dan cat yang dijalankan ejen masuk ke dalam perbualan. Carian yang mencetak dua ratus baris menghabiskan konteks sebelum kerja sebenar bermula.

### // padanan bukan pemanggil

grep tidak dapat membezakan panggilan sebenar daripada komen, fixture atau kaedah sama nama dalam kelas lain.

### // shell bermula sejuk

Sesi baharu tidak tahu apa-apa tentang repo. Indeks Maguyva sudah dibina, jadi soalan pertama terus mendapat jawapan berperingkat.

## Maguyva sebagai pelayan MCP dalam Warp

Satu entri mcpServers memberi ejen Warp:

- **11 alat merentasi repo anda yang diindeks**: carian semantik, struktur (AST), graf dan teks, ditambah carian simbol, dependen dan pengambilan fail.
- **Jawapan dengan laluan fail dan nombor baris**: dalam 285+ bahasa, cukup pendek untuk dibaca dalam panel terminal.
- **Alat yang hanya membaca**: Alat Maguyva menyoal indeks. Tiada satu pun yang menyunting fail atau menjalankan arahan.

> Warp memberi ejen *sebuah terminal*.
> Maguyva memberi ejen *peta kod*.

## Dua aliran kerja

Tanya peta dahulu, kemudian jalankan arahan.

### 01. Jejak skrip yang gagal hingga ke puncanya

```text
warp agent> deploy.sh gagal: BUILD_ID tidak ditetapkan. di mana ia ditetapkan?

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

→ Ejen memuatkan ci/env.sh dan menjalankan semula deploy.
[exit 0]
```

Satu carian berindeks menggantikan grep rekursif merentas repo berserta outputnya.

### 02. Semak pemanggil sebelum mengubah langkah but

```text
warp agent> bolehkah kita berhenti menjalankan migrasi semasa permulaan?

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

→ Ejen memindahkan ketiga-tiganya ke langkah keluaran.
[exit 0]
```

Pemanggil tiba sebelum perubahan, jadi worker tidak but dengan skema lama.

## Sediakan Warp

Tiga langkah. Peringkat Free: 3 repositori, Sehingga 50K baris repo terindeks, tanpa kad.

### 01. Indeks repo di maguyva.ai

Pilih satu yang anda sudah kenali, supaya anda boleh menilai jawapannya.

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

`~/.warp/.mcp.json`

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

### 03. Ganti pemegang tempat dan tanya satu soalan

Tukar `mgv_xxxx` kepada kunci API anda dan simpan. Pastikan pelayan sedang berjalan dalam Settings → Agents → MCP servers, kemudian tanya satu soalan yang anda sudah tahu jawapannya.

[Dokumentasi MCP](https://docs.warp.dev/agents/capabilities/mcp/) Warp merangkumi pelayan berasaskan fail, perkongsian dan pengesahan.

## Indeks satu repo yang anda dah kenal.

Sambungkan Warp melalui MCP, kemudian tanya satu soalan yang boleh anda semak.