Panduan MCP
MCP menghubungkan Codex atau Claude Code ke tugas Rememo Anda. Baca konteks, tambahkan pembaruan, dan lakukan tindakan atas izin Anda.
Publikasi di npm masih tertunda. Perintah di bawah digunakan setelah publikasi.
Sebelum memulai
- Gunakan Node.js 24.18.1–24.x. Instal CLI Codex atau Claude Code yang ingin dihubungkan dan pastikan tersedia di PATH.
- Di Rememo, buka Pengaturan → Pribadi → Agent access. Buat token akses pribadi, pilih cakupan izin yang diperlukan, lalu salin saat ditampilkan sekali.
- Gunakan tasks:read untuk membaca tugas, tasks:write untuk mengambil atau menyelesaikannya, comments:write untuk pembaruan, dan context:read untuk konteks tugas. Cabut token di Agent access saat tidak diperlukan lagi.
Hubungkan klien Anda
npx @rememo/cli mcp setup- Pilih codex, claude, atau both. CLI klien yang dipilih harus sudah terinstal sebelum penyiapan dapat mendaftarkan Rememo.
- Gunakan https://app.rememo.io atau URL Rememo yang Anda hosting sendiri, termasuk awalan jalurnya. URL dengan /api/ secara eksplisit juga dapat digunakan.
- Tempel token pada prompt terminal yang menyamarkan input. Penyiapan menyimpannya dalam berkas lokal pribadi dan hanya mendaftarkan jalur berkas ke klien. Mulai ulang klien setelah penyiapan.
Berkas pribadi bawaan adalah ~/.rememo/mcp/config.json (direktori 0700, berkas 0600 pada sistem yang mendukungnya). Jaga kerahasiaannya. Jangan masukkan token ke argumen perintah atau pengaturan klien bersama.
Alat yang tersedia
rememo_list_tasks- Tampilkan tugas yang dapat diakses token Anda.
rememo_get_task- Baca tugas, alur kerja, dan konteks yang diizinkan.
rememo_claim_task- Ambil tugas ke kolom tujuan yang jelas saat Anda meminta.
rememo_add_task_update- Tambahkan komentar ke tugas.
rememo_complete_task- Selesaikan tugas saat Anda memintanya secara eksplisit.
Klien hanya mengambil atau menyelesaikan tugas saat Anda memintanya secara eksplisit. Pengambilan memerlukan kolom tujuan yang jelas. Server tidak mengambil tugas secara mandiri.
Penyiapan lanjutan dan pemecahan masalah
Penyiapan noninteraktif
Atur REMEMO_PERSONAL_ACCESS_TOKEN di lingkungan, lalu berikan --client dan --url. Tidak ada argumen --token. Jangan simpan nilai lingkungan dalam riwayat shell atau log bersama.
npx @rememo/cli mcp setup --client both --url https://app.rememo.ioInstalasi terpisah
Gunakan --config dengan jalur absolut berkas pribadi terpisah untuk instalasi Rememo lain. Jalankan penyiapan lagi untuk memperbarui hanya pendaftaran Rememo; pengaturan klien lainnya tetap tersimpan.
npx @rememo/cli mcp setup --client codex --url https://tasks.example.com/team --config /ABSOLUTE/PRIVATE/team.jsonServer mandiri
Untuk klien yang dikonfigurasi sendiri, jalankan server stdio dengan berkas konfigurasi pribadi. Daftarkan perintah dan jalur berkas, jangan tokennya.
npx -y @rememo/mcp@0.1.0 --config /ABSOLUTE/PRIVATE/config.jsonUrutan konfigurasi: berkas --config yang diberikan, lalu pasangan lingkungan REMEMO_API_URL dan REMEMO_PERSONAL_ACCESS_TOKEN yang lengkap, lalu berkas pribadi bawaan. Pasangan lingkungan yang tidak lengkap ditolak. REMEMO_API_URL adalah URL dasar API, termasuk /api/.
Jika koneksi gagal
Periksa versi Node.js, perintah klien yang dipilih di PATH, URL Rememo, dan cakupan token. Mulai ulang klien setelah pendaftaran. Jika pendaftaran hanya berhasil sebagian, perbaiki klien tersebut lalu ulangi penyiapan. Cabut dan ganti token yang terekspos atau kedaluwarsa.