Membangun Sistem Memori AI Persisten di Cloudflare

Pentingnya Memori AI Persisten untuk Agen

Seiring dengan semakin terintegrasinya asisten AI ke dalam kehidupan kita sehari-hari, kita sering kali menghadapi masalah konteks kosong (blank context). Keputusan yang dibuat minggu lalu terlupakan, sehingga kita harus memasukkan detail tech stack yang sama dan mengatur preferensi pengguna berulang kali di setiap sesi baru.

Alih-alih memulai dari awal setiap kali, kita perlu membangun sistem memori yang terus berkembang, secara konsisten memahami keputusan pengguna, dan menghilangkan kebutuhan untuk mengulang konteks secara terus-menerus.

Sistem Memori AI Mandiri vs. Bawaan

Banyak agen AI dilengkapi dengan memori bawaan, tetapi kita jarang menggunakan satu agen saja untuk semua kebutuhan. Kita menggunakan Claude untuk merancang dan menyusun arsitektur proyek, Kimi untuk menulis kode, dan ChatGPT untuk riset mendalam. Konteks tidak dibagikan di antara agen-agen ini; semuanya tetap terisolasi di setiap alat secara terpisah.

Dari sudut pandang rekayasa perangkat lunak, kita tidak mempercayai kotak hitam (black box). Kita membutuhkan sistem memori AI yang dapat diobservasi, diaudit, dan berada di bawah kendali kita sepenuhnya. Proyek sumber terbuka Second Brain, yang merupakan fork dari https://github.com/rahilp/second-brain-cloudflare, menyediakan sistem memori persisten dan mandiri (self-hosted) dengan dukungan Model Context Protocol (MCP). Agen AI apa pun yang kompatibel seperti Claude, ChatGPT, atau Kimi Code dapat berbagi konteks memori terpadu yang sama.

Cara Membangun Memori AI Second Brain di Cloudflare

Sistem memori Second Brain diterapkan di atas Cloudflare Workers, yang menyediakan infrastruktur serverless berlatensi sangat rendah yang terdistribusi secara global. Hal ini memungkinkan operasi pencarian memori (recall) dan penyimpanan berjalan hampir instan dalam logika berpikir AI.

Model embedding dari Workers AI digunakan untuk menghasilkan vektor. Embedding ini disimpan di Cloudflare Vectorize, yang merupakan database vektor terdistribusi global yang sangat optimal. Cloudflare Vectorize melakukan pencarian kemiripan kosinus (cosine similarity) untuk mengidentifikasi memori dengan relevansi semantik.

Second Brain juga dilengkapi dengan mekanisme deduplikasi dan penggabungan cerdas. Konten dengan kemiripan kurang dari 85% akan disimpan langsung; jika tidak, konten tersebut akan diblokir atau ditandai sebagai kandidat duplikat. Teks panjang yang melebihi 1.600 karakter akan dipotong berdasarkan batas kalimat atau baris baru, dengan tetap mempertahankan tumpang tindih (overlap) sebanyak 200 karakter untuk menjaga kontinuitas konteks. Setiap potongan kemudian divektorisasi untuk pencocokan presisi tinggi.

Alat-alat berikut diekspos sebagai antarmuka MCP untuk digunakan langsung oleh agen AI:

• remember: Menyimpan ide, keputusan, preferensi, dan konteks proyek secara umum.
• append: Menambahkan pembaruan ke memori yang sudah ada.
• update: Mengganti memori yang ada secara keseluruhan.
• recall: Menemukan memori berdasarkan makna semantiknya, bukan kata kunci yang tepat.
• list_recent: Menampilkan memori yang baru disimpan.
• forget: Menghapus memori secara permanen.
• link/connections: Menghubungkan memori yang saling berkaitan (fitur graf v2).

Menyiapkan Second Brain di Cloudflare

1. Klik Deploy to Cloudflare pada halaman Github repo. [[]]
2. Isi formulir Cloudflare Worker yang ditampilkan.
3. Masukkan '384' untuk Dimensions; pilih 'cosine' untuk Metric; lalu klik tombol Deploy.
4. Gambar berikut menunjukkan ringkasan dari Second Brain Anda di Cloudflare Worker:
5. Buka tab 'Settings', lalu klik ikon edit pada variabel 'AUTH_TOKEN' untuk membuat token keamanan:
6. Klik tautan 'Rotate' untuk memasukkan nilai baru:
7. Jalankan perintah openssl rand -base64 32 di terminal macOS untuk menghasilkan nilai acak yang aman dan tempelkan di bidang input 'Value'.
8. Klik tombol 'Deploy' untuk menyimpan nilai baru dari variabel 'AUTH_TOKEN'.
9. Buka URL worker Second Brain Anda di peramban web.
10. Masukkan 'AUTH_TOKEN' yang telah dibuat pada kolom input Bearer token dan klik tombol 'Connect' untuk masuk ke dashboard Web UI.

Mengintegrasikan Claude Desktop via MCP

1. Klik 'Customize' pada pengaturan Claude Desktop.
2. Klik 'Developer' untuk membuka dan mengedit file konfigurasi server MCP secara manual:
3. Tambahkan blok kode berikut ke bagian mcpServers di file claude_desktop_config.json:

    "second-brain": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://<your-worker-url>/mcp",
        "--header",
        "Authorization: Bearer <your-token>"
      ]
    }

4. Mulai ulang Claude Desktop dan periksa daftar 'Local MCP servers'. Statusnya harus menunjukkan 'running' (sedang berjalan).

Mengintegrasikan Claude Code via MCP

• Jalankan perintah berikut untuk menambahkan server MCP baru:

claude mcp add --transport http second-brain https://<your-worker-url>/mcp

• Claude Code akan mendeteksi bahwa endpoint memerlukan OAuth dan akan membuka halaman masuk di peramban web untuk memasukkan AUTH_TOKEN.
• Buat file CLAUDE.md di folder ~/.claude dengan instruksi yang dijelaskan di CLAUDE_INSTRUCTIONS.md.

Mengintegrasikan Gemini CLI via MCP

1. Tambahkan pengaturan server MCP berikut ke file './.gemini/settings.json' Anda:

    "second-brain": {
      "httpUrl": "https://<your-worker-url>/mcp",
      "oauth": {
        "enabled": true
      }
    }

2. Jalankan Gemini CLI.

Menguji Second Brain di Agen AI

1. Saat mendefinisikan palet warna merek sederhana di Claude Desktop, Second Brain tidak langsung dipanggil secara default.
2. Saat menggunakan kata kunci sederhana seperti 'remember', hanya alat bawaan lokal memory_user-edits di Claude Desktop yang digunakan, bukan lapisan penyimpanan jarak jauh Second Brain.
3. Saat mengirim perintah berikut di Claude Code, integrasi dengan Second Brain berhasil dipanggil:

Remember Our brand palette uses `#1a1a2e` as primary, `#16213e` as secondary, and `#e94560` as accent. Never use pure black."

4. Verifikasi pengaturan warna baru yang disimpan di Second Brain di Cloudflare: - Claude Code dapat berfungsi secara otomatis karena file instruksi CLAUDE_INSTRUCTIONS.md berisi aturan yang mengarah pada kata kunci 'Second Brain'. 5. Untuk menggunakan integrasi ini di Claude Desktop, kata kunci 'Second Brain' harus disebutkan secara eksplisit dalam prompt Anda untuk memaksa penyimpanan atau pembacaan di lapisan memori persisten ini. 6. Hal yang sama berlaku untuk Gemini CLI, Anda harus menyebutkan kata kunci 'Second Brain' untuk mengaktifkan alat MCP Second Brain. - Menambahkan instruksi serupa ke file GEMINI.md, seperti yang telah dilakukan pada CLAUDE_INSTRUCTIONS.md, akan mengaktifkan Second Brain di latar belakang tanpa harus menulis kata kunci secara manual.

Ekstensi Peramban Web

• Ekstensi tersedia untuk peramban web Chrome, Firefox, dan Microsoft Edge.
• Fitur ekstensi meliputi:
  • Mengambil halaman saat ini — menyimpan judul dan URL halaman ke Second Brain.
  • Mengambil teks terpilih — pilih teks apa pun pada halaman sebelum mengklik ikon ekstensi; cuplikan tersebut akan disimpan bersama judul dan URL.
  • Menambahkan catatan cepat — ketik catatan atau gunakan #hashtags langsung di popup ekstensi sebelum menyimpan; hashtag akan diekstrak secara otomatis sebagai tag.

Sinkronisasi Pengetahuan Pribadi dengan Plugin Obsidian

• Tersedia plugin Obsidian untuk menyinkronkan catatan dari Obsidian Vault Anda langsung ke Second Brain di Cloudflare.
• Catatan dapat ditandai dengan tag khusus untuk disinkronkan ke penyimpanan persisten.

Menginstal Plugin Obsidian

1. Buka Obsidian → Settings → Community Plugins
2. Klik tombol 'Browse'.
3. Cari 'Second Brain Sync'.
4. Klik tombol 'Install' lalu 'Enable'.

Mengonfigurasi Plugin Obsidian

1. Buka Obsidian → Settings → Second Brain Sync
2. Masukkan 'URL' dan 'Auth token' Anda.
3. Klik tombol 'Test' untuk memverifikasi koneksi.
4. Konfigurasikan perilaku sinkronisasi. Atur tag sinkronisasi di 'Sync tag' dan aktifkan 'Auto-sync on save'.
5. Buat catatan di Obsidian dengan tag 'second-brain', sesuai dengan yang dikonfigurasi di 'Sync tag'.
6. Catatan tersebut kini telah disimpan dan disinkronkan ke Second Brain yang diterapkan di Cloudflare.

Kesimpulan

Second Brain menawarkan solusi sumber terbuka yang cerdas untuk mengatasi salah satu masalah paling membuat frustrasi dalam AI: ketiadaan memori persisten. Dengan memadukan proyek ini dengan infrastruktur Cloudflare yang skalabel, kita mendapatkan lapisan memori semantik mandiri yang terdistribusi secara global dengan latensi sangat rendah. Dukungan MCP yang tertanam di Second Brain membuat memori ini sepenuhnya portabel di berbagai agen AI.

Plugin Obsidian memperluas arsitektur ini dengan menghubungkan catatan pribadi di dalam vault dengan logika berpikir AI. Catatan mentah Anda diubah menjadi konteks terstruktur yang dapat dipahami dan dipanggil secara semantik oleh agen AI kapan saja.

Dengan menyatukan self-hosting, pencarian semantik vektor, dan standar integrasi berbasis MCP; Second Brain membuktikan dirinya bukan sekadar tempat penyimpanan memori, melainkan fondasi praktis untuk membangun ekosistem AI yang andal.

Referensi:

• https://www.thesecondbrain.dev/
• https://github.com/rahilp/second-brain-cloudflare/wiki/How-It-Works
• Connect to AI Clients
• Second Brain Obsidian Plugin
• https://github.com/rahilp/second-brain-obsidian-plugin