Server MCP Snipset: Pakai Snippet-mu dari Claude Code

Snippet, catatan, dan tugasmu sudah ada di Snipset. Dengan server MCP Snipset, Claude Code dan agent AI lain bisa langsung bekerja dengannya: mencari di pustaka snippet-mu sambil menulis kode, mengubah percakapan jadi tugas, atau menanyakan bagaimana minggumu berjalan. Server ini bagian dari alat baris perintah snipset, dan kamu menyalakannya dengan satu perintah, snipset mcp.

Tulisan ini membahas apa saja yang dibuka server itu, cara menambahkannya ke Claude Code atau klien MCP lain, apa yang tetap di komputermu, dan alat mana yang bisa mengubah atau menghapus data.

Apa Itu MCP dan Dari Mana CLI Snipset Berasal

MCP (Model Context Protocol) adalah standar terbuka untuk menghubungkan alat AI ke data dan aksi di luar dirinya. Klien AI, misalnya Claude Code, menjalankan server MCP, menanyakan alat apa saja yang tersedia, lalu memanggil alat itu sambil bekerja. Snipset adalah salah satu server seperti itu.

Server ini ada di dalam CLI snipset, yang membaca dan mengubah data yang sama dengan aplikasi desktop. Ini tempat kamu bisa mendapatkannya:

Dari mana	Yang kamu dapat
CLI mandiri v0.2.0	Unduhan Linux x64 dan Windows x64 dari rilis publik snipset-cli, tanpa perlu aplikasi desktop
Installer desktop Windows	snipset.exe di folder aplikasi, ditambahkan ke PATH sistem (sejak Windows 0.6.849)
Aplikasi desktop Linux	CLI di dalam resource aplikasi, tidak di PATH (sejak Linux 0.6.869); pakai installer mandiri
Aplikasi desktop macOS (beta)	CLI di dalam bundle aplikasi, tidak di PATH

Di Linux, installer mandiri menaruh snipset di ~/.local/bin. Di Windows, installer PowerShell-nya memakai %LOCALAPPDATA%\Snipset\bin. Kalau kamu memasang aplikasi desktop Windows lewat installer-nya, snipset ada di PATH setelah kamu keluar lalu masuk lagi ke Windows.

Apa yang Dibuka Server MCP Snipset

Server ini mendaftarkan 87 alat, masing-masing bernama snipset_<aksi>. Alat-alat itu terbagi ke beberapa kelompok:

Kelompok	Alat	Contoh
Snippet dan grup	10	snipset_search_snippets, snipset_expand_snippet, snipset_create_snippet, snipset_bulk_import
Riwayat clipboard	10	snipset_list_clipboard, snipset_search_clipboard, snipset_set_clipboard_tag
Tugas	16	snipset_create_task, snipset_complete_task, snipset_parse_task
Catatan	12	snipset_search_notes, snipset_create_note, snipset_generate_note_title
Audio	11	riwayat suara ke teks dan teks ke suara, kamus suara, snipset_audio_stats
Jurnal	5	snipset_get_journal, snipset_generate_journal
Statistik	9	snipset_stats_overview, snipset_stats_tasks, snipset_stats_all
Pengaturan	5	snipset_list_settings, snipset_set_setting
Pomodoro	4	snipset_pomodoro_status, snipset_pomodoro_control
Lainnya	5	snipset_doctor, snipset_init, katalog referensi, kategori dan tiket dukungan

Setiap alat menjawab dengan objek JSON kecil: {"ok": true, "data": ...} kalau berhasil, atau {"ok": false, "error": "..."} kalau ada masalah, jadi agent bisa membaca error-nya lalu bereaksi.

Beberapa alat layak disebut khusus. snipset_expand_snippet mengisi variabel template sebuah snippet, seperti #{date} atau #{clipboard}, berdasarkan uuid atau keyword, jadi agent mendapat teks yang sudah terisi. #{clipboard} memakai teks clipboard yang dikirim agent, dan #{selection} menjadi kosong. snipset_doctor memeriksa akses database, mode WAL, dan skema sebelum agent mulai menulis. snipset_init membuat database mandiri baru untuk pemakaian tanpa aplikasi dan menolak menyentuh file yang sudah ada kecuali kamu meminta force; dalam hal itu, file lama dicadangkan dulu.

Cara Menambahkannya ke Claude Code dan Klien MCP Lain

Server ini berbicara MCP lewat stdio: klien menjalankan snipset mcp sebagai subproses dan berkomunikasi lewat input dan output standar. Kamu tidak perlu menjalankannya sendiri.

Di Claude Code, tambahkan dengan:

claude mcp add --transport stdio snipset -- snipset mcp

Semua yang ada setelah -- adalah perintah yang dijalankan Claude Code. Tanpa flag --scope, server ditambahkan ke scope local, hanya tersedia untukmu di proyek saat ini; tambahkan --scope user supaya tersedia di semua proyek. Periksa dengan claude mcp list, atau dengan /mcp di dalam sesi.

Kalau kamu lebih suka file konfigurasi, Claude Code membaca server yang sama dari entri mcpServers di file .mcp.json di root proyek:

{
  "mcpServers": {
    "snipset": {
      "command": "snipset",
      "args": ["mcp"]
    }
  }
}

Klien lain punya format file sendiri, tapi idenya sama: server lokal dengan perintah snipset dan argumen mcp. Untuk opencode, installer Linux bisa menuliskan konfigurasinya lewat --with-mcp. Installer hanya menulis ~/.config/opencode/opencode.json kalau file itu belum ada, dan tidak pernah menimpa file yang sudah ada.

Secara bawaan, server membuka database yang sama dengan aplikasi desktop, yaitu Snipset/snipset.db di folder data lokal platformmu. Untuk mengarahkannya ke tempat lain, tambahkan --db <PATH> setelah mcp (misalnya snipset mcp --db /path/to/snipset.db). CLI tidak pernah membuat database sendiri; hanya snipset init (atau alat snipset_init) yang melakukannya.

Apa yang Berjalan Lokal dan Apa yang Butuh Jaringan

Server MCP-nya sendiri tidak membuka port jaringan apa pun. Server berbicara dengan klien AI-mu lewat stdio dan membaca database SQLite di disk-mu, dengan membukanya ulang untuk setiap pemanggilan alat.

Beberapa alat butuh aplikasi desktop yang sedang berjalan dengan control API lokalnya menyala. Control API mati secara bawaan dan hanya menjawab kalau pengaturan control_api_enabled bernilai true dan control_api_token berisi token. CLI menghubunginya di 127.0.0.1 (port 8317 kecuali kamu mengaturnya lain) dengan token itu. Alat-alat ini membutuhkannya:

• keempat alat pomodoro
• snipset_generate_journal, snipset_generate_note_title, snipset_generate_note_labels, dan snipset_parse_task
• snipset_clear_clipboard (penghapusan yang dikonfirmasi; pratinjaunya jalan tanpa aplikasi)

Saat control API menyala, perubahan pengaturan dan suntingan jurnal juga lewat aplikasi, jadi aplikasi sendiri yang menjalankan efek sampingnya. Semua penulisan lain langsung ke file database.

Ada satu alat yang menghubungi internet: snipset_submit_support_ticket. Tanpa confirm: true, alat ini hanya menampilkan tiket yang akan dikirim. Dengan confirm: true, tiket dikirim ke endpoint dukungan Snipset lewat HTTPS, melalui aplikasi yang sedang berjalan.

Ingat satu hal lagi. Apa pun yang dikembalikan sebuah alat menjadi bagian percakapanmu dengan klien AI. Kalau klien itu memakai model cloud, entri clipboard atau catatanmu ikut terkirim ke penyedia model itu bersama isi chat lainnya. Snipset tidak bisa mengatur langkah itu, jadi buka server ini hanya untuk klien yang kamu percaya memegang data ini.

Apa yang Bisa Diubah atau Dihapus oleh Alat-alatnya

Banyak alat hanya membaca. Alat yang menulis dirancang dengan beberapa pengaman:

• Pengaturan: server menolak key apa pun yang diawali vault_, mfa_, atau secret_, jadi agent tidak bisa membaca atau mengubah pengaturan vault atau MFA-mu. Nilai yang terlihat seperti rahasia dikembalikan dalam bentuk tersamar di setiap pembacaan dan ekspor, dan kredensial khusus aplikasi tidak bisa disimpan lewat server ini sebagai teks biasa.
• Perubahan massal dipratinjau dulu: snipset_bulk_import punya mode dry_run yang menampilkan jumlah dan duplikat. snipset_clear_clipboard dan snipset_clear_audio_history hanya melaporkan apa yang akan dihapus sampai dipanggil dengan confirm: true.
• Penghapusan butuh konfirmasi: menghapus catatan atau tugas butuh confirm: true dan berupa hapus lunak. Menghapus jurnal juga butuh confirm: true dan permanen.

Beberapa alat langsung bertindak tanpa langkah konfirmasi: snipset_delete_snippet menghapus baris snippet dari database, sedangkan snipset_delete_clipboard, snipset_delete_audio_history, dan snipset_delete_audio_dictionary masing-masing menghapus satu entri. snipset_set_setting bisa mengubah pengaturan apa pun di luar namespace yang dilindungi. snipset_init dengan force memindahkan database aktifmu ke cadangan, dan snipset_set_setting juga bisa menyalakan control API lokal (control_api_enabled, control_api_token). Kalau klien AI-mu bisa meminta persetujuan untuk setiap pemanggilan alat, biarkan itu menyala untuk alat-alat ini.

Ringkasan

Server MCP Snipset mengubah CLI snipset menjadi 87 alat yang bisa dipanggil Claude Code dan klien MCP lain: snippet, riwayat clipboard, catatan, tugas, riwayat audio, jurnal, statistik, pengaturan, dan timer pomodoro. Server berjalan lewat stdio di komputermu, membaca database lokalmu, dan secara bawaan hanya menghubungi aplikasi yang sedang berjalan di 127.0.0.1, yang kemudian mengirim tiket dukungan ke server Snipset kalau kamu mengonfirmasinya. Pengaturan vault dan MFA tetap tidak terjangkau, penghapusan massal dipratinjau dulu, dan beberapa penghapusan satu entri langsung dijalankan.

Mau agent AI-mu bekerja dari snippet yang sudah kamu punya? Lihat paket Snipset.