Untuk pengguna Warp

Agen Warp tinggal di terminal. Beri ia peta repo.

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.

Mulai gratis Baca penyiapan Warp

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

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

Yang perlu diketahui Warp

Empat fakta khusus Warp.

// berkas konfigurasi

~/.warp/.mcp.json

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

// transport

Jarak jauh, lewat URL

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

// kunci

Header apa adanya

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

// berkas proyek

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.

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

// workflow 01

Lacak skrip yang gagal sampai ke sumbernya

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.

// workflow 02

Periksa pemanggil sebelum mengubah langkah boot

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.

// step 01

Indeks repo di maguyva.ai

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

// step 02

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

~/.warp/.mcp.json

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

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