Untuk pengguna Warp

Ejen Warp tinggal dalam terminal. Beri ia peta repo.

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.

Mula percuma Baca persediaan Warp

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

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

Perkara yang perlu diketahui tentang Warp

Empat fakta khusus untuk Warp.

// fail konfigurasi

~/.warp/.mcp.json

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

// pengangkutan

Jauh, melalui URL

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

// kunci

Pengepala literal

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

// fail projek

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.

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

// workflow 01

Jejak skrip yang gagal hingga ke puncanya

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.

// workflow 02

Semak pemanggil sebelum mengubah langkah but

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.

// step 01

Indeks repo di maguyva.ai

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

// step 02

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

~/.warp/.mcp.json

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

// step 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.