Konfigurasi Server MCP PandaNpc untuk Claude Code dan Codex

Diperbarui 2026-08-18

Server MCP PandaNpc menghubungkan agen pengkodean yang kompatibel dengan MCP ke basis pengetahuan PandaNote, catatan kerja, tugas terjadwal, konfigurasi model, dan Pusat Layanan Agen Anda. Ini berguna ketika agen membutuhkan konteks proyek yang tahan lama alih-alih memulai dari percakapan kosong setiap saat.

Server berjalan secara lokal melalui transport input/output standar MCP. Klien MCP Anda memulai proses pandanpc-mcp saat sesi dibuka; Anda tidak perlu membuka port atau menjalankan server web terpisah.

Sebelum Anda menginstal

Anda membutuhkan:

Node.js dan npm tersedia di lingkungan yang sama tempat klien MCP berjalan.
Akun PandaNpc dengan akses ke alamat email yang digunakan untuk verifikasi.
Claude Code, OpenAI Codex, Cursor, atau klien lain yang mendukung server MCP stdio lokal.

Jika Anda ingin agen menjadwalkan pekerjaan di salah satu komputer Anda, instal dan hubungkan PandaPaw terlebih dahulu. Alat catatan dan ruang kerja tidak memerlukan perangkat PandaPaw yang online.

Menginstal atau memperbarui server MCP

Instal paket secara global di macOS, Linux, atau Windows:

bash

npm install -g @pandanpc/mcp-server

Konfirmasi bahwa file eksekutif terlihat oleh shell Anda:

bash

pandanpc-mcp --help

Jalankan perintah npm yang sama setiap kali Anda ingin memperbarui. Mulai ulang klien MCP setelah pembaruan karena klien yang sudah berjalan tetap menggunakan versi proses yang awalnya diluncurkan.

Periksa riwayat versi server MCP ketika suatu alat atau perilakunya berbeda dari tangkapan layar atau tutorial lama.

Menambahkan PandaNpc ke Claude Code

Metode yang paling andal adalah perintah konfigurasi milik Claude Code. Gunakan lingkup pengguna jika Anda ingin PandaNpc tersedia di setiap proyek:

bash

claude mcp add --scope user pandanpc -- pandanpc-mcp

Gunakan --scope project sebagai gantinya ketika konfigurasi akan dibagikan melalui repositori saat ini, atau --scope local ketika hanya berlaku untuk Anda di proyek saat ini.

Periksa server yang terdaftar:

bash

claude mcp get pandanpc
claude mcp list

Anda juga dapat mengonfigurasi server stdio secara manual dalam konfigurasi MCP yang digunakan oleh instalasi Claude Code Anda:

json

{
  "mcpServers": {
    "pandanpc": {
      "command": "pandanpc-mcp"
    }
  }
}

Menambahkan PandaNpc ke OpenAI Codex

Codex dapat mendaftarkan proses lokal yang sama dari baris perintah:

bash

codex mcp add pandanpc -- pandanpc-mcp

Verifikasi konfigurasi yang disimpan:

bash

codex mcp get pandanpc
codex mcp list

Entri yang setara di ~/.codex/config.toml adalah:

toml

[mcp_servers.pandanpc]
command = "pandanpc-mcp"

Mulai ulang Codex atau buka sesi baru setelah menambahkan server. Jika Anda memelihara file konfigurasi Codex khusus, letakkan tabel MCP di file tersebut daripada menggandakannya di seluruh file.

Mengonfigurasi Cursor dan klien MCP lainnya

Untuk Cursor, tambahkan server lokal ke ~/.cursor/mcp.json menggunakan bentuk JSON yang sama seperti yang ditunjukkan untuk Claude Code. Untuk Windsurf dan klien lainnya, buat server MCP stdio perintahnya pandanpc-mcp dan daftar argumennya kosong.

File eksekutif harus berada di PATH yang diwarisi oleh aplikasi grafis. Jika berfungsi di terminal tetapi klien desktop melaporkan “perintah tidak ditemukan,” gunakan jalur eksekusi absolut yang dikembalikan oleh perintah berikut:

bash

command -v pandanpc-mcp

Di Windows PowerShell, gunakan:

powershell

Get-Command pandanpc-mcp

Masuk dari agen

PandaNpc menggunakan alur verifikasi email dua langkah. Minta agen untuk melakukan tindakan berikut secara berurutan:

Panggil note_login dengan alamat email Anda. PandaNpc mengirimkan kode verifikasi.
Panggil note_login lagi dengan alamat email yang sama dan kode tersebut.

Kredensial lokal disimpan dalam cache, jadi Anda tidak perlu masuk setiap sesi. Jangan pernah menempelkan kode verifikasi ke transkrip publik atau prompt yang dibagikan.

Memverifikasi koneksi MCP

Jalankan tes baca-saja kecil sebelum mengizinkan agen membuat atau mengedit data:

Minta agen untuk memanggil list_workspaces.
Minta agen untuk memanggil list_notes untuk satu ruang kerja.
Minta agen untuk mencari kata kunci yang tidak berbahaya dengan search_notes.

Respons yang berhasil membuktikan bahwa klien MCP memulai proses, autentikasi selesai, dan API akun dapat dijangkau. Untuk tes tulis, buat catatan sekali pakai lalu hapus lunak (soft-delete).

Daftar alat yang tepat yang ditampilkan oleh klien MCP Anda adalah sumber kebenaran untuk versi yang terinstal. Alat-alat dikelompokkan berdasarkan alur kerja berikut:

Alur Kerja	Alat Umum	Perilaku Penting
Catatan	`list_notes`, `create_note`, `read_note`, `update_note`, `search_notes`	`update_note` mengganti seluruh isi; baca sebelum mengedit
Log kerja	`save_done`	Menyimpan pekerjaan yang selesai di folder proyek hari ini secara otomatis
Ruang kerja	`list_workspaces`, `create_workspace`, `update_workspace`	Jalur proyek terikat memungkinkan server menemukan ruang kerja yang benar
Pekerjaan terjadwal	`list_scheduled_bridges`, `create_scheduled_task`, `list_scheduled_task_runs`	Mesin PandaPaw harus online; ekspresi cron menggunakan enam bidang
Penyedia dan model	`list_providers`, `list_models`, create/update/delete tools	Buat daftar terlebih dahulu agar Anda menggunakan ID saat ini dan tipe model yang valid
Aturan dan keterampilan	`sync_rules`	Menyinkronkan instruksi proyek yang didukung sambil melewati file yang tidak berubah

Untuk definisi bidang penyedia dan model, lihat Penyedia AI khusus dan API keys. Untuk batasan akun dan penagihan, lihat Akun, paket, dan biaya API PandaNpc.

Praktik pengoperasian yang aman

Mulailah dengan alat daftar, baca, atau cari sebelum tindakan buat, perbarui, hapus, atau jadwalkan.
Baca catatan sebelum memperbaruinya karena pembaruan catatan mengganti seluruh dokumen Markdown, bukan menerapkan tambalan.
Perlakukan prompt terjadwal sebagai permintaan eksekusi kode: konfirmasi mesin target, direktori kerja, zona waktu, dan ekspresi cron enam bidang.
Jauhkan API keys penyedia dari prompt dan catatan. Masukkan rahasia hanya melalui alur konfigurasi penyedia yang dimaksud.
Tinjau kartu persetujuan alat MCP sebelum mengizinkan tindakan destruktif atau eksternal.
Gunakan save_done untuk log kerja alih-alih menebak secara manual ruang kerja dan folder tanggal yang benar.

Pemecahan masalah

Klien mengatakan `pandanpc-mcp` tidak ditemukan

Buka terminal baru setelah instalasi dan periksa jalur eksekusi. Aplikasi desktop terkadang mewarisi PATH yang lebih lama; konfigurasikan jalur absolut atau mulai ulang aplikasi. Jika npm diinstal melalui manajer versi, pastikan klien MCP dimulai dengan pengguna dan lingkungan yang sama.

Server terdaftar tetapi tidak ada alat yang muncul

Mulai ulang klien, lalu periksa claude mcp get pandanpc atau codex mcp get pandanpc. Hapus dan tambahkan entri lagi jika perintahnya salah. Periksa juga bahwa Anda tidak mengonfigurasi proses stdio lokal sebagai URL HTTP.

Alat mengatakan Anda tidak terautentikasi

Ulangi dua panggilan note_login. Gunakan kode verifikasi terbaru, periksa folder spam, dan pastikan kedua panggilan menggunakan alamat email yang sama.

Tugas terjadwal tidak dapat menemukan mesin

Panggil list_scheduled_bridges terlebih dahulu. Jika tidak mengembalikan perangkat yang tersedia, verifikasi status PandaPaw dan konektivitas perangkat di mesin target. Mesin yang dimatikan, tidur, keluar, atau terputus tidak dapat memulai eksekusi terjadwal.

Pembaruan catatan menghapus teks yang ada

update_note menerima isi pengganti lengkap. Pulihkan catatan dari riwayat atau tempat sampah jika tersedia, lalu baca konten saat ini dan kirim dokumen gabungan.

Butuh bantuan khusus akun? Hubungi support@pandanpc.com dan sertakan nama klien MCP, sistem operasi, versi paket, dan pesan kesalahan yang tepat tanpa rahasia.