PocketSmith Read-only
resmiHanya-baca: transaksi, anggaran, prakiraan, dan wawasan dari alat keuangan pribadi PocketSmith.
Apa yang bisa Anda lakukan dengan PocketSmith Read Only MCP?
- Pemeriksaan kesehatan keuangan — Minta ringkasan kekayaan bersih, laju pengeluaran dibandingkan anggaran, dan status anggaran per kategori.
- Perbandingan pengeluaran — Bandingkan pengeluaran antara dua periode berdasarkan kategori dan penerima pembayaran untuk melihat perubahan.
- Deteksi pengeluaran berulang — Temukan langganan dan tagihan berulang, beserta frekuensi dan total biaya tahunan.
- Proyeksi arus kas dan kekayaan bersih — Proyeksikan saldo akun dan kekayaan bersih ke masa depan menggunakan mesin proyeksi PocketSmith.
- Pencarian transaksi — Cari transaksi dengan filter tanggal, kategori, kata kunci, atau status.
- Tautan langsung — Dapatkan tautan ke halaman, laporan, atau pencarian terfilter PocketSmith yang sedang dibahas.
Server MCP Terhosting
npx add-mcp 'https://mcp-readonly.pocketsmith.com/mcp'Terpasang ke Claude Code, Codex, Cursor, dan lainnya
Dokumentasi
Server MCP
Hubungkan akun PocketSmith Anda ke asisten AI apa pun yang mendukung Model Context Protocol.
Menghubungkan asisten AI Anda ke PocketSmith melalui Model Context Protocol (MCP) akan memberinya akses langsung ke data keuangan, anggaran, dan proyeksi Anda. Asisten dapat memberikan wawasan dan informasi, serta melakukan sejumlah tindakan untuk Anda.
Fungsinya
Server MCP PocketSmith memungkinkan asisten AI membaca dan mengelola data PocketSmith Anda atas nama Anda. Daripada berpindah-pindah antara asisten AI dan PocketSmith, Anda dapat mengajukan pertanyaan dan melakukan tindakan menggunakan bahasa sehari-hari:
- Meninjau pengeluaran, anggaran, dan kekayaan bersih Anda
- Mencari dan mengategorikan transaksi
- Membuat dan memperbarui peristiwa anggaran
- Menganalisis tren dan membandingkan pengeluaran antarperiode
- Memeriksa status sinkronisasi feed bank dan memicu penyegaran
- Mendapatkan tautan langsung ke halaman atau laporan PocketSmith yang tepat
Tersedia dua mode akses:
| Mode | Deskripsi | Cara menghubungkan |
|---|---|---|
| Akses penuh | Semua 66 alat — membaca, membuat, memperbarui, dan menghapus | Satu klik dari direktori Claude atau ChatGPT |
| Hanya baca | 40 alat hanya-baca — melihat dan menganalisis, tanpa perubahan | Penyiapan manual sebagai konektor khusus (beberapa langkah tambahan) |
Kebanyakan orang sebaiknya memilih akses penuh. Penghapusan apa pun selalu memerlukan persetujuan eksplisit Anda terlebih dahulu, dan Anda dapat meminta asisten untuk meminta konfirmasi sebelum melakukan perubahan lain. Pilih hanya-baca jika Anda ingin memastikan bahwa asisten tidak akan pernah dapat mengubah data Anda.
Menghubungkan
Akses penuh tersedia sebagai aplikasi terdaftar di direktori Claude dan ChatGPT, sehingga hanya perlu satu klik untuk menghubungkannya. Mode hanya-baca belum terdaftar di kedua direktori tersebut, jadi Anda perlu menambahkannya secara manual sebagai konektor khusus menggunakan URL di bagian Klien MCP lainnya di bawah.
Claude (claude.ai, Claude Desktop, dan aplikasi seluler)
Akses penuh:
- Buka PocketSmith Complete Access di direktori Claude
- Klik Connect
- Anda akan dialihkan ke PocketSmith untuk mengizinkan akses
Konektor terhubung ke akun Claude Anda, jadi setelah terhubung di claude.ai, PocketSmith juga tersedia di Claude Desktop dan aplikasi seluler Claude.
Hanya baca:
- Di claude.ai atau Claude Desktop, buka Settings > Connectors
- Klik Add custom connector
- Masukkan nama (misalnya, "PocketSmith Read-only") dan URL
https://mcp-readonly.pocketsmith.com/mcp - Klik Connect di samping konektor baru, lalu izinkan akses di PocketSmith
Claude Code
# Full access
claude mcp add pocketsmith --transport http https://mcp.pocketsmith.com/mcp
# Read-only
claude mcp add pocketsmith-readonly --transport http https://mcp-readonly.pocketsmith.com/mcp
Claude Code akan meminta Anda melakukan otorisasi melalui OAuth saat pertama kali digunakan.
ChatGPT (chatgpt.com dan aplikasi desktop)
Akses penuh:
- Buka PocketSmith di direktori aplikasi ChatGPT di chatgpt.com
- Klik Connect
- Anda akan dialihkan ke PocketSmith untuk mengizinkan akses
Aplikasi terhubung ke akun ChatGPT Anda, jadi setelah terhubung di chatgpt.com, PocketSmith juga tersedia di aplikasi desktop ChatGPT. Jika tidak muncul, mulai ulang aplikasi desktop.
Hanya baca:
Mode hanya-baca harus disiapkan di chatgpt.com, bukan di aplikasi desktop:
- Buka Settings > Apps & Connectors dan aktifkan Developer mode (di bagian Advanced settings)
- Klik Create untuk menambahkan konektor khusus
- Masukkan nama (misalnya, "PocketSmith Read-only") dan URL
https://mcp-readonly.pocketsmith.com/mcp - Klik Connect — Anda akan dialihkan ke PocketSmith untuk mengizinkan akses
Jangan gunakan opsi Settings > Plugins > Add MCP server di aplikasi desktop — server yang ditambahkan di sana hanya tersedia di Codex, bukan di ChatGPT.
Ruang kerja Business/Enterprise/Edu: admin ruang kerja harus terlebih dahulu mengaktifkan aplikasi atau menambahkan konektor dari Workspace settings, lalu setiap pengguna menghubungkan dan mengizinkan akses ke akun PocketSmith masing-masing.
Codex
Akses penuh: jika Anda sudah menghubungkan PocketSmith dari direktori aplikasi ChatGPT, PocketSmith akan tersedia secara otomatis di Codex mulai dari obrolan berikutnya. Jika belum, tambahkan melalui baris perintah:
codex mcp add pocketsmith --transport http https://mcp.pocketsmith.com/mcp
Hanya baca:
codex mcp add pocketsmith-readonly --transport http https://mcp-readonly.pocketsmith.com/mcp
Codex akan meminta Anda melakukan otorisasi melalui OAuth saat pertama kali digunakan.
Klien MCP lainnya
| Mode | URL |
|---|---|
| Akses penuh | https://mcp.pocketsmith.com/mcp |
| Hanya baca | https://mcp-readonly.pocketsmith.com/mcp |
Klien MCP apa pun yang mendukung transport HTTP dan OAuth dapat terhubung menggunakan URL ini. Server mendukung OAuth 2.0 dengan PKCE dan menyediakan metadata penemuan di /.well-known/oauth-authorization-server dan /.well-known/oauth-protected-resource.
Autentikasi
Autentikasi ditangani secara otomatis melalui OAuth. Saat pertama kali terhubung, Anda akan dialihkan ke PocketSmith untuk masuk dan memberikan akses. Asisten AI menerima token yang cakupannya sesuai dengan mode akses pilihan Anda (akses penuh atau hanya-baca) dan tidak pernah melihat kata sandi PocketSmith Anda.
Token dienkripsi dan bersifat stateless — tidak ada yang disimpan di server MCP. Anda dapat mencabut akses kapan saja dari halaman aplikasi yang diotorisasi di PocketSmith.
Contoh penggunaan
"Bagaimana perkembangan saya bulan ini?"
Minta pemeriksaan kesehatan keuangan untuk mendapatkan ringkasan sekilas:
Anda: Bagaimana kondisi keuangan saya bulan ini? Apakah anggaran saya masih sesuai rencana?
Menggunakan alat financial_health_snapshot untuk menampilkan kekayaan bersih, laju pengeluaran bulan ini dibandingkan anggaran, indikator status anggaran per kategori, dan hal-hal yang perlu ditindaklanjuti seperti transaksi yang belum dikategorikan.
"Langganan apa saja yang saya bayar?"
Temukan tagihan berulang yang mungkin terlupakan:
Anda: Bisakah Anda menemukan semua pengeluaran berulang dan langganan saya? Saya ingin tahu berapa yang saya bayar setiap bulan dan total biaya tahunannya.
Menggunakan alat find_recurring_expenses untuk memindai riwayat transaksi, mengidentifikasi tagihan rutin berdasarkan penerima pembayaran, mengklasifikasikan frekuensinya, dan menghitung total biaya tahunan.
"Bandingkan pengeluaran saya dengan bulan lalu"
Lihat perbedaan penggunaan uang Anda:
Anda: Bandingkan pengeluaran saya bulan ini dengan bulan lalu. Kategori mana yang naik atau turun?
Menggunakan alat spending_comparison untuk menguraikan kedua periode berdasarkan kategori dan penerima pembayaran, serta menyoroti perubahan dan penerima pembayaran baru atau yang tidak lagi muncul.
"Tinjau keuangan saya pada bulan Maret"
Dapatkan tinjauan akhir bulan yang menyeluruh:
Anda: Berikan tinjauan lengkap untuk Maret 2025 — pendapatan, pengeluaran, tingkat tabungan, dan pencapaian saya dibandingkan anggaran.
Menggunakan alat month_end_review untuk membuat laporan terperinci yang mencakup ringkasan pendapatan/pengeluaran, tingkat tabungan, selisih anggaran per kategori, penerima pembayaran teratas, transaksi penting, dan gambaran kekayaan bersih.
"Kategorikan transaksi terbaru saya"
Rapikan transaksi yang belum dikategorikan:
Anda: Ada banyak transaksi yang belum dikategorikan dari minggu lalu. Bisakah Anda memeriksanya dan mengategorikannya untuk saya?
Menggunakan list_transactions untuk menemukan transaksi terbaru yang belum dikategorikan, lalu list_categories untuk melihat hierarki kategori Anda, dan update_transaction untuk menetapkan kategori yang sesuai berdasarkan nama penerima pembayaran. (Memerlukan mode akses penuh.)
"Berapa saldo rekening tabungan saya dalam 6 bulan?"
Proyeksikan saldo rekening Anda ke depan:
Anda: Seperti apa saldo rekening tabungan saya selama 6 bulan ke depan berdasarkan anggaran saya?
Menggunakan cash_flow_forecast untuk memproyeksikan saldo ke depan dengan mesin peramalan PocketSmith, menunjukkan arah saldo setiap rekening dan menandai titik saat saldo mungkin turun di bawah ambang batas aman.
"Arahkan saya ke sana"
Dapatkan tautan langsung ke halaman atau laporan yang tepat di aplikasi web PocketSmith:
Anda: Bagaimana perubahan pengeluaran belanja bahan makanan saya selama setahun terakhir? Berikan tautan agar saya bisa menelusurinya sendiri.
Menggunakan get_trend_analysis untuk merangkum tren, lalu navigate_to_trends untuk membuat tautan langsung ke laporan Tren — dengan filter awal untuk kategori Groceries dan rentang tanggal Anda — agar Anda dapat melanjutkan penelusuran di PocketSmith. Semua alat navigasi bekerja dengan cara ini: asisten menjawab, lalu memberikan tautan ke halaman, laporan, atau pencarian transaksi yang tepat yang sedang dibahas.
Alat yang tersedia
Wawasan (alat analisis gabungan)
Alat-alat ini menggabungkan beberapa panggilan API untuk menghasilkan analisis lengkap yang siap digunakan:
| Alat | Fungsinya |
|---|---|
financial_health_snapshot | Kekayaan bersih, laju pengeluaran, indikator status anggaran, hal-hal yang perlu ditindaklanjuti |
month_end_review | Tinjauan periode lengkap dengan pendapatan/pengeluaran, tingkat tabungan, selisih anggaran, penerima pembayaran teratas |
spending_comparison | Perbandingan berdampingan dua periode tanggal berdasarkan kategori dan penerima pembayaran |
find_recurring_expenses | Mendeteksi langganan dan tagihan berulang beserta total biaya tahunan |
cash_flow_forecast | Proyeksi saldo rekening ke depan dengan peringatan zona bahaya |
net_worth_forecast | Tren kekayaan bersih historis, proyeksi, dan perkiraan pencapaian |
forecast_accuracy | Membandingkan saldo aktual dengan proyeksi untuk mengevaluasi keandalan anggaran |
Penganggaran
| Alat | Fungsinya |
|---|---|
get_budget | Analisis anggaran per kategori untuk periode proyeksi |
get_budget_summary | Realisasi pengeluaran/pendapatan dibandingkan anggaran untuk rentang tanggal |
get_trend_analysis | Tren pengeluaran dari waktu ke waktu berdasarkan kategori |
delete_forecast_cache | Memaksa penghitungan ulang anggaran setelah pengeditan massal |
Transaksi
| Alat | Fungsinya |
|---|---|
list_transactions | Mencari dan memfilter transaksi berdasarkan tanggal, kategori, kata kunci, status |
get_transaction | Mendapatkan detail lengkap satu transaksi |
create_transaction | Menambahkan transaksi baru |
update_transaction | Mengedit transaksi (penerima pembayaran, kategori, label, catatan, pembagian) |
delete_transaction | Menghapus transaksi |
Rekening & Institusi
| Alat | Fungsinya |
|---|---|
list_accounts | Mencantumkan semua rekening berdasarkan pengguna atau institusi |
get_account | Mendapatkan detail rekening, termasuk saldo dan rekening anak |
create_account / update_account / delete_account | Mengelola rekening |
update_account_display_order | Mengurutkan ulang rekening |
list_institutions / get_institution | Melihat institusi keuangan |
create_institution / update_institution / delete_institution | Mengelola institusi |
list_transaction_accounts / get_transaction_account / update_transaction_account | Melihat dan memperbarui rekening transaksi |
Kategori & Aturan
| Alat | Fungsinya |
|---|---|
list_categories / get_category | Melihat hierarki kategori Anda |
create_category / update_category / delete_category | Mengelola kategori |
list_category_rules / create_category_rule | Melihat dan membuat aturan kategorisasi otomatis |
Peristiwa Anggaran
| Alat | Fungsinya |
|---|---|
list_events / get_event | Melihat peristiwa prakiraan anggaran |
create_event / update_event / delete_event | Mengelola peristiwa anggaran berulang dan sekali saja |
Lampiran
| Alat | Fungsinya |
|---|---|
list_attachments / get_attachment | Melihat lampiran tanda terima dan dokumen |
create_attachment / update_attachment / delete_attachment | Mengelola lampiran |
assign_transaction_attachment / unassign_transaction_attachment | Menautkan/melepaskan tautan lampiran ke transaksi |
Umpan Data
| Alat | Fungsinya |
|---|---|
get_data_feeds_connection_status | Memeriksa status sinkronisasi umpan bank dan detail penyedia |
refresh_data_feeds_connection | Memulai sinkronisasi untuk satu atau semua koneksi umpan bank |
Navigasi
Alat-alat ini membuat tautan langsung agar asisten dapat mengarahkan Anda ke halaman PocketSmith yang tepat untuk percakapan tersebut—dengan akun, kategori, dan tanggal yang sudah difilter, serta kontrol halaman lainnya yang diperlukan untuk laporan.
| Alat | Fungsinya |
|---|---|
navigate_to_transactions | Pencarian transaksi, dengan filter awal berdasarkan akun, kategori, kata kunci, atau tanggal |
navigate_to_budget | Membuka halaman anggaran, dengan pengaturan tanggal dan opsi lainnya yang dapat dikontrol melalui tautan |
navigate_to_trends | Laporan tren pengeluaran atau pendapatan kategori dari waktu ke waktu, dengan semua opsi tersedia melalui tautan |
navigate_to_income_expense | Laporan Pendapatan & Pengeluaran (laporan laba rugi) dengan filter, rentang tanggal, dan opsi lainnya yang tersedia melalui tautan |
navigate_to_cashflows | Laporan arus kas (tabel bulan demi bulan) |
navigate_to_net_worth | Halaman Kekayaan Bersih, dengan semua filter dan opsi lainnya tersedia melalui tautan |
navigate_to_calendar | Kalender peristiwa dan saldo anggaran terjadwal dan prakiraan, beserta rentang tanggal yang tersedia melalui tautan |
navigate_to_account_summary | Ringkasan Akun untuk akun dan bulan tertentu |
Lainnya
| Alat | Fungsinya |
|---|---|
get_current_user / update_user | Melihat dan memperbarui profil serta pengaturan pengguna |
list_labels | Melihat semua label transaksi |
list_saved_searches | Melihat filter pencarian transaksi tersimpan |
list_currencies / get_currency | Data referensi mata uang |
list_time_zones | Data referensi zona waktu |
Model data PocketSmith
Memahami hierarki PocketSmith membantu saat mengajukan pertanyaan:
Institution (e.g. "Sample Bank")
→ Account (container/group, e.g. "Everyday Credit Card")
→ Transaction Account (where transactions live)
→ Scenario (where budget forecast events live)
- Institusi mewakili bank atau penyedia layanan keuangan
- Akun mengelompokkan satu atau beberapa akun transaksi dan skenario
- Akun transaksi menyimpan catatan transaksi yang sebenarnya
- Skenario menyimpan peristiwa anggaran yang menggerakkan mesin prakiraan PocketSmith
- Kategori memiliki hierarki (induk/anak) dan digunakan bersama oleh semua akun
- Label adalah tag yang dapat Anda tambahkan ke transaksi untuk pengelompokan yang fleksibel
Privasi & keamanan
- Kebijakan privasi PocketSmith: https://www.pocketsmith.com/legal/privacy-policy/
- Kredensial PocketSmith Anda tidak pernah dibagikan kepada asisten AI
- Token OAuth dienkripsi dengan AES-256-GCM dan bersifat stateless (tidak ada yang disimpan di sisi server)
- Semua komunikasi API menggunakan enkripsi TLS
- Anda dapat mencabut akses kapan saja dari aplikasi resmi PocketSmith
Dukungan
- Bantuan & dukungan: https://learn.pocketsmith.com
- Hubungi dukungan: help@pocketsmith.com