Server MCP

Perch dapat terhubung ke sistem eksternal melalui Model Context Protocol, atau MCP. Dengan begitu, Perch dapat menjangkau data dan tool yang bukan berupa file di disk Anda: basis data hukum, otomatisasi browser, API internal, apa pun yang mendukung MCP. Tool dari server yang terhubung muncul berdampingan dengan tool bawaan Perch, dan model dapat memanggilnya secara langsung.

Yang disertakan secara default

Saat Anda pertama kali menjalankan Perch Terminal Desktop, aplikasi ini membuat file konfigurasi di ~/.perch/mcp.json dengan dua server yang sudah dikonfigurasi:

• CourtListener. Server riset hukum yang dapat mencari yurisprudensi, mencari sitasi, mengambil teks putusan, menemukan perkara terkait, dan menarik entri daftar perkara. Server ini terhubung ke basis data CourtListener, yang mencakup pengadilan federal dan negara bagian. Token API bawaan sudah disertakan, sehingga server ini langsung berfungsi saat pertama kali dijalankan tanpa konfigurasi.
• Playwright. Server otomatisasi browser yang dikunci ke versi @playwright/mcp yang sudah diuji. Server inilah yang menjalankan fitur browser Perch: membuka halaman, mengeklik elemen, mengetik di kolom isian, dan membaca apa yang ada di layar.

Anda tidak perlu menginstal atau mengonfigurasi keduanya. Keduanya terhubung otomatis saat Perch dijalankan.

Cara tool ditampilkan ke model

Saat server MCP terhubung, Perch membaca daftar tool-nya dan mengubah setiap tool menjadi definisi yang dapat dipakai model. Konvensi penamaannya adalah mcp__<serverName>__<toolName>. Misalnya, pencarian perkara CourtListener menjadi mcp__courtlistener__search_cases, dan muncul berdampingan dengan tool bawaan seperti readLocalFile atau webSearch.

Model memperlakukan tool ini setara dengan tool bawaan. Model dapat memanggilnya dalam alur yang sama dengan tool lain, dan hasilnya kembali sebagai konten terstruktur yang dapat dikutip dan ditindaklanjuti oleh Perch.

Konfigurasi global dan per folder

Server MCP dapat dikonfigurasi di dua tingkat:

• Global. File di ~/.perch/mcp.json berlaku untuk setiap sesi Perch di komputer Anda. Di sinilah server default dikonfigurasi.
• Per folder. File .perch/mcp.json di dalam folder ruang kerja Anda hanya berlaku saat Anda bekerja di folder itu. Konfigurasi folder mengesampingkan konfigurasi global berdasarkan nama server, sehingga Anda dapat mengganti server global dengan server lain untuk proyek tertentu.

Ekspansi variabel lingkungan didukung. Jika sebuah server memerlukan kunci API, Anda dapat merujuknya sebagai ${YOUR_API_KEY} di konfigurasi, dan Perch akan mengisinya dari environment Anda.

Menambahkan server Anda sendiri

Untuk menambahkan server MCP, edit ~/.perch/mcp.json (untuk global) atau .perch/mcp.json di folder ruang kerja Anda (untuk proyek tertentu). Strukturnya:

{
  "servers": {
    "my-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@some-org/some-mcp-server"],
      "env": {
        "API_KEY": "${MY_API_KEY}"
      }
    }
  }
}

Tiga jenis transport didukung:

• stdio. Menjalankan proses lokal. Memerlukan command serta args dan env yang opsional.
• http. Terhubung ke endpoint HTTP jarak jauh. Memerlukan url serta headers yang opsional.
• sse. Terhubung ke endpoint SSE jarak jauh. Memerlukan url serta headers yang opsional.

Setelah mengedit konfigurasi, mulai ulang Perch atau jalankan perintah reconnect. Server baru akan terhubung saat aplikasi dijalankan berikutnya.

Posisi MCP

MCP ditujukan untuk sistem live yang tidak dapat direpresentasikan sebagai file di folder. Jika datanya sudah ada di disk Anda sebagai spreadsheet, PDF, atau CSV, Perch membacanya langsung melalui jembatan folder. MCP ditujukan untuk semua hal lainnya: basis data eksternal, API, dan layanan yang memerlukan proses yang berjalan atau autentikasi.

Operator dan agen→

Cara Perch melampaui chat untuk membaca file, menjalankan analisis, dan mengoordinasikan worker.

Keamanan dan data→

Cara Perch menangani file Anda, data Anda, dan apa yang diproses di luar perangkat Anda.