PocketSmith Read-only

resmi

Salt okunur: PocketSmith kişisel finans aracındaki işlemler, bütçeler, tahminler ve içgörüler.

PocketSmith Read Only MCP ile neler yapabilirsiniz?

  • Finansal sağlık kontrolü — Net varlıkların, bütçeye kıyasla harcama hızının ve kategori bütçelerinin durumunun özetini isteyin.
  • Harcama karşılaştırmaları — Nelerin değiştiğini görmek için iki dönemin harcamalarını kategoriye ve alacaklıya göre karşılaştırın.
  • Düzenli gider tespiti — Sıklıklarını ve yıllık toplam maliyetlerini de içerecek şekilde abonelikleri ve düzenli faturaları bulun.
  • Nakit akışı ve net varlık tahminleri — PocketSmith'in tahmin motorunu kullanarak hesap bakiyelerini ve net varlıkları ileriye dönük tahmin edin.
  • İşlem arama — Tarihe, kategoriye, anahtar kelimeye veya duruma göre filtrelenmiş işlemleri bulun.
  • Derin bağlantılar — Görüşülen PocketSmith sayfasına, raporuna veya filtrelenmiş arama sonucuna doğrudan bağlantı alın.

Barındırılan MCP Sunucusu

npx add-mcp 'https://mcp-readonly.pocketsmith.com/mcp'

Claude Code, Codex, Cursor ve daha fazlasına kurulur

Dokümantasyon

MCP Sunucusu

PocketSmith hesabınızı Model Context Protocol'ü destekleyen herhangi bir yapay zekâ asistanına bağlayın.

Yapay zekâ asistanınızı Model Context Protocol (MCP) aracılığıyla PocketSmith'e bağlamak, finansal verilerinize, bütçelerinize ve tahminlerinize doğrudan erişmesini sağlar. Asistanınız size içgörüler ve bilgiler sunabilir, ayrıca sizin için çeşitli işlemler gerçekleştirebilir.

Ne işe yarar?

PocketSmith MCP sunucusu, yapay zekâ asistanlarının sizin adınıza PocketSmith verilerinizi okumasını ve yönetmesini sağlar. Yapay zekâ asistanınız ile PocketSmith arasında geçiş yapmak yerine, doğal dille sorular sorabilir ve işlemler gerçekleştirebilirsiniz:

  • Harcamalarınızı, bütçelerinizi ve net varlığınızı inceleyin
  • İşlemleri arayın ve kategorilere ayırın
  • Bütçe etkinlikleri oluşturun ve güncelleyin
  • Eğilimleri analiz edin ve dönemler arasındaki harcamaları karşılaştırın
  • Banka akışı eşitleme durumunu kontrol edin ve yenileme işlemlerini başlatın
  • Doğrudan PocketSmith'teki doğru sayfaya veya rapora giden derin bağlantılar alın

İki erişim modu kullanılabilir:

ModAçıklamaBağlanma yöntemi
Tam erişim66 aracın tümü - okuma, oluşturma, güncelleme ve silmeClaude veya ChatGPT dizininden tek tıklamayla
Salt okunur40 salt okunur araç - görüntüleme ve analiz, değişiklik yapma yokÖzel bağlayıcı olarak manuel kurulum (birkaç ek adım)

Çoğu kişi tam erişimi seçmelidir. Herhangi bir şeyi silmek için önce açık onayınız gerekir; ayrıca başka değişiklikler yapmadan önce asistandan size danışmasını isteyebilirsiniz. Asistanın verilerinizi hiçbir zaman değiştiremeyeceğinden emin olmak istiyorsanız salt okunur modu seçin.

Bağlanma

Tam erişim, Claude ve ChatGPT dizinlerinde listelenen bir uygulama olarak sunulur; bu nedenle bağlanmak tek tıklamayla tamamlanır. Salt okunur modu henüz bu dizinlerin hiçbirinde listelenmiyor, bu yüzden aşağıdaki Diğer MCP istemcileri bölümündeki URL'yi kullanarak özel bağlayıcı olarak manuel eklemeniz gerekir.


Claude (claude.ai, Claude Desktop ve mobil uygulamalar)

Tam erişim:

  1. Claude dizininde PocketSmith Complete Access sayfasını açın
  2. Connect'e tıklayın
  3. Erişimi yetkilendirmek için PocketSmith'e yönlendirilirsiniz

Bağlayıcılar Claude hesabınıza bağlıdır; dolayısıyla claude.ai'de bağlandıktan sonra PocketSmith, Claude Desktop'ta ve Claude mobil uygulamalarında da kullanılabilir.

Salt okunur:

  1. claude.ai üzerinde veya Claude Desktop'ta Settings > Connectors bölümünü açın
  2. Add custom connector'a tıklayın
  3. Bir ad girin (ör. "PocketSmith Read-only") ve URL'yi https://mcp-readonly.pocketsmith.com/mcp girin
  4. Yeni bağlayıcının yanındaki Connect'e tıklayın ve PocketSmith'te erişimi yetkilendirin

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, ilk kullanımda OAuth aracılığıyla yetkilendirme yapmanızı ister.

ChatGPT (chatgpt.com ve masaüstü uygulaması)

Tam erişim:

  1. chatgpt.com üzerinde ChatGPT uygulamaları dizinindeki PocketSmith'i açın
  2. Connect'e tıklayın
  3. Erişimi yetkilendirmek için PocketSmith'e yönlendirilirsiniz

Uygulamalar ChatGPT hesabınıza bağlıdır; dolayısıyla chatgpt.com'da bağlandıktan sonra PocketSmith, ChatGPT masaüstü uygulamasında da kullanılabilir. Görünmüyorsa masaüstü uygulamasını yeniden başlatın.

Salt okunur:

Salt okunur mod, masaüstü uygulamasında değil, chatgpt.com üzerinde kurulmalıdır:

  1. Settings > Apps & Connectors bölümünü açın ve Developer mode'u etkinleştirin (Advanced settings altında)
  2. Özel bağlayıcı eklemek için Create'e tıklayın
  3. Bir ad girin (ör. "PocketSmith Read-only") ve URL'yi https://mcp-readonly.pocketsmith.com/mcp girin
  4. Connect'e tıklayın - erişimi yetkilendirmek için PocketSmith'e yönlendirilirsiniz

Masaüstü uygulamasındaki Settings > Plugins > Add MCP server seçeneğini kullanmayın - oraya eklenen sunucular yalnızca Codex'te kullanılabilir, ChatGPT'de kullanılamaz.

Business/Enterprise/Edu çalışma alanları: çalışma alanı yöneticisi önce uygulamayı etkinleştirir veya bağlayıcıyı Workspace settings bölümünden ekler; ardından her kullanıcı kendi PocketSmith hesabını ayrı ayrı bağlayıp yetkilendirir.

Codex

Tam erişim: PocketSmith'i ChatGPT uygulamaları dizininden zaten bağladıysanız, bir sonraki sohbetinizden itibaren Codex'te otomatik olarak kullanılabilir. Aksi takdirde komut satırından ekleyin:

codex mcp add pocketsmith --transport http https://mcp.pocketsmith.com/mcp

Salt okunur:

codex mcp add pocketsmith-readonly --transport http https://mcp-readonly.pocketsmith.com/mcp

Codex, ilk kullanımda OAuth aracılığıyla yetkilendirme yapmanızı ister.

Diğer MCP istemcileri

ModURL
Tam erişimhttps://mcp.pocketsmith.com/mcp
Salt okunurhttps://mcp-readonly.pocketsmith.com/mcp

HTTP aktarımını ve OAuth'u destekleyen tüm MCP istemcileri bu URL'leri kullanarak bağlanabilir. Sunucu OAuth 2.0 with PKCE desteği sunar ve keşif meta verilerini /.well-known/oauth-authorization-server ile /.well-known/oauth-protected-resource adreslerinde yayımlar.

Kimlik doğrulama

Kimlik doğrulama OAuth aracılığıyla otomatik olarak gerçekleştirilir. İlk kez bağlandığınızda oturum açıp erişim izni vermeniz için PocketSmith'e yönlendirilirsiniz. Yapay zekâ asistanı, seçtiğiniz erişim moduyla (tam veya salt okunur) sınırlı bir belirteç alır ve PocketSmith parolanızı hiçbir zaman görmez.

Belirteçler şifrelenir ve durumsuzdur - MCP sunucusunda hiçbir şey saklanmaz. Erişimi istediğiniz zaman PocketSmith yetkilendirilmiş uygulamalar sayfanızdan iptal edebilirsiniz.

Kullanım örnekleri

"Bu ay nasıl gidiyorum?"

Genel bir bakış özeti almak için finansal durum değerlendirmesi isteyin:

Siz: Bu ay finansal durumum nasıl? Bütçeme uygun ilerliyor muyum?

Net varlığınızı, içinde bulunulan ayın harcama hızını bütçeyle karşılaştırmalı olarak, kategori bazında bütçe durum göstergelerini ve kategorilere ayrılmamış işlemler gibi yapılacakları döndürmek için financial_health_snapshot aracını kullanır.


"Hangi abonelikler için ödeme yapıyorum?"

Unutmuş olabileceğiniz yinelenen ödemeleri bulun:

Siz: Yinelenen tüm giderlerimi ve aboneliklerimi bulabilir misin? Her ay ne kadar ödediğimi ve yıllık toplam maliyeti görmek istiyorum.

İşlem geçmişinizi taramak, alacaklıya göre düzenli ödemeleri belirlemek, sıklıklarını sınıflandırmak ve yıllık maliyeti toplamak için find_recurring_expenses aracını kullanır.


"Harcamalarımı geçen ayla karşılaştır"

Paranızın nereye gittiğindeki farklılıkları görün:

Siz: Bu ayki harcamalarımı geçen ayla karşılaştır. Hangi kategorilerde artış veya düşüş oldu?

Her iki dönemi kategoriye ve alacaklıya göre ayrıştırmak, değişiklikleri ve yeni ya da artık görünmeyen alacaklıları vurgulamak için spending_comparison aracını kullanır.


"Mart ayı mali durumumu incele"

Ay sonu için kapsamlı bir değerlendirme alın:

Siz: Mart 2025 için gelir, gider, tasarruf oranı ve bütçeme göre durumumu içeren kapsamlı bir değerlendirme yap.

Gelir/gider özeti, tasarruf oranı, kategori bazında bütçe farkı, en çok ödeme yapılan alacaklılar, dikkat çeken işlemler ve net varlık anlık görüntüsünü içeren ayrıntılı bir rapor oluşturmak için month_end_review aracını kullanır.


"Son işlemlerimi kategorilere ayır"

Kategorilere ayrılmamış işlemleri düzenleyin:

Siz: Geçen haftadan kategorilere ayrılmamış bir sürü işlemim var. Bunları inceleyip benim için kategorilere ayırabilir misin?

Yakın tarihli kategorilere ayrılmamış işlemleri bulmak için list_transactions, kategori ağacınızı görmek için list_categories ve alacaklı adlarına göre uygun kategorileri atamak için update_transaction araçlarını kullanır. (Tam erişim modu gerektirir.)


"Tasarruf hesabım 6 ay sonra ne durumda olur?"

Hesap bakiyelerinizi ileriye dönük tahmin edin:

Siz: Bütçeme göre tasarruf hesabımın bakiyesi önümüzdeki 6 ay boyunca nasıl görünür?

PocketSmith'in tahmin motorunu kullanarak bakiyeleri ileriye dönük tahmin etmek, her hesabın gidişatını göstermek ve bakiyelerin güvenli bir eşiğin altına düşebileceği noktaları işaretlemek için cash_flow_forecast aracını kullanır.


"Beni oraya götür"

PocketSmith web uygulamasındaki doğru sayfaya veya rapora doğrudan bağlantı alın:

Siz: Geçen yıl boyunca market harcamalarım nasıl değişti? Kendim inceleyebilmem için bir bağlantı ver.

Eğilimi özetlemek için get_trend_analysis, ardından PocketSmith'te incelemeye devam edebilmeniz için Eğilimler raporuna - Market kategorinize ve tarih aralığınıza göre önceden filtrelenmiş - derin bağlantı oluşturmak için navigate_to_trends aracını kullanır. Tüm gezinme araçları bu şekilde çalışır: asistan yanıt verir, ardından sözünü ettiği tam sayfaya, rapora veya işlem aramasına bağlantı verir.

Kullanılabilir araçlar

İçgörüler (bileşik analiz araçları)

Bu araçlar, zengin ve kullanıma hazır analizler üretmek için birden fazla API çağrısını birleştirir:

AraçNe işe yarar
financial_health_snapshotNet varlık, harcama hızı, bütçe durum göstergeleri, yapılacaklar
month_end_reviewGelir/gider, tasarruf oranı, bütçe farkı ve en çok ödeme yapılan alacaklıları içeren tam dönem değerlendirmesi
spending_comparisonİki tarih dönemini kategoriye ve alacaklıya göre yan yana karşılaştırma
find_recurring_expensesAbonelikleri ve yinelenen faturaları yıllık toplam maliyetleriyle belirleme
cash_flow_forecastRisk bölgesi uyarılarıyla ileriye dönük hesap bakiyesi tahminleri
net_worth_forecastGeçmiş eğilim, tahmin ve kilometre taşı öngörüleriyle net varlık gidişatı
forecast_accuracyBütçe güvenilirliğini değerlendirmek için gerçekleşen ve tahmin edilen bakiyeleri karşılaştırma

Bütçeleme

AraçNe işe yarar
get_budgetTahmin dönemi için kategori bazında bütçe analizi
get_budget_summaryTarih aralığı için gerçekleşen gider/gelir ile bütçelenen tutarları karşılaştırma
get_trend_analysisKategoriye göre zaman içindeki harcama eğilimleri
delete_forecast_cacheToplu düzenlemelerden sonra bütçenin yeniden hesaplanmasını zorlama

İşlemler

AraçNe işe yarar
list_transactionsİşlemleri tarihe, kategoriye, anahtar kelimeye ve duruma göre arama ve filtreleme
get_transactionTek bir işlemin tüm ayrıntılarını alma
create_transactionYeni işlem ekleme
update_transactionİşlemi düzenleme (alacaklı, kategori, etiketler, notlar, bölmeler)
delete_transactionİşlemi kaldırma

Hesaplar ve finans kuruluşları

AraçNe işe yarar
list_accountsKullanıcıya veya finans kuruluşuna göre tüm hesapları listeleme
get_accountBakiye ve alt hesaplar dahil hesap ayrıntılarını alma
create_account / update_account / delete_accountHesapları yönetme
update_account_display_orderHesapları yeniden sıralama
list_institutions / get_institutionFinans kuruluşlarını görüntüleme
create_institution / update_institution / delete_institutionFinans kuruluşlarını yönetme
list_transaction_accounts / get_transaction_account / update_transaction_accountİşlem hesaplarını görüntüleme ve güncelleme

Kategoriler ve kurallar

AraçNe işe yarar
list_categories / get_categoryKategori hiyerarşinizi görüntüler
create_category / update_category / delete_categoryKategorileri yönetir
list_category_rules / create_category_ruleOtomatik kategorilendirme kurallarını görüntüler ve oluşturur

Bütçe Etkinlikleri

AraçNe işe yarar
list_events / get_eventBütçe tahmini etkinliklerini görüntüler
create_event / update_event / delete_eventYinelenen ve tek seferlik bütçe etkinliklerini yönetir

Ekler

AraçNe işe yarar
list_attachments / get_attachmentMakbuz ve belge eklerini görüntüler
create_attachment / update_attachment / delete_attachmentEkleri yönetir
assign_transaction_attachment / unassign_transaction_attachmentEkleri işlemlere bağlar/bağlantılarını kaldırır

Veri Akışları

AraçNe işe yarar
get_data_feeds_connection_statusBanka veri akışı eşitleme durumunu ve sağlayıcı ayrıntılarını kontrol eder
refresh_data_feeds_connectionBir veya tüm banka veri akışı bağlantıları için eşitleme başlatır

Gezinme

Bu araçlar, asistanın konuşma için sizi PocketSmith'in tam olarak ilgili sayfasına yönlendirebilmesi amacıyla derin bağlantılar oluşturur. Bağlantılar; doğru hesaplar, kategoriler ve tarihler ile rapor için gereken diğer sayfa içi kontroller önceden filtrelenmiş şekilde açılır.

AraçNe işe yarar
navigate_to_transactionsHesap, kategori, anahtar kelime veya tarihe göre önceden filtrelenmiş işlem araması
navigate_to_budgetTarih ayarları ve diğer seçenekleri bağlantı üzerinden kontrol edilebilen bütçe sayfasına gider
navigate_to_trendsBir kategorinin zaman içindeki harcama veya gelir eğilimleri raporu; tüm seçenekler bağlantı üzerinden kullanılabilir
navigate_to_income_expenseFiltreleme, tarih aralıkları ve diğer seçeneklerin bağlantı üzerinden kullanılabildiği Gelir ve Gider raporu (kâr ve zarar tablosu)
navigate_to_cashflowsNakit Akışları tablosu (aylık tablo)
navigate_to_net_worthTüm filtreleme ve diğer seçeneklerin bağlantı üzerinden kullanılabildiği Net Değer sayfası
navigate_to_calendarBağlantı üzerinden tarih aralıklarıyla birlikte görüntülenebilen planlanmış ve tahmini bütçe etkinlikleri ile bakiyelerin takvimi
navigate_to_account_summaryBelirli bir hesap ve aya ait Hesap Özeti

Diğer

AraçNe işe yarar
get_current_user / update_userKullanıcı profilini ve ayarlarını görüntüler ve günceller
list_labelsTüm işlem etiketlerini görüntüler
list_saved_searchesKaydedilmiş işlem arama filtrelerini görüntüler
list_currencies / get_currencyPara birimi referans verileri
list_time_zonesSaat dilimi referans verileri

PocketSmith veri modeli

PocketSmith hiyerarşisini anlamak, soru sorarken yardımcı olur:

Institution (e.g. "Sample Bank")
  → Account (container/group, e.g. "Everyday Credit Card")
      → Transaction Account (where transactions live)
      → Scenario (where budget forecast events live)
  • Kurumlar, bankaları veya finansal hizmet sağlayıcılarını temsil eder
  • Hesaplar, bir veya daha fazla işlem hesabını ve senaryoyu gruplandırır
  • İşlem hesapları, gerçek işlem kayıtlarını içerir
  • Senaryolar, PocketSmith'in tahmin motorunu çalıştıran bütçe etkinliklerini içerir
  • Kategoriler, hiyerarşik yapıdadır (üst/alt) ve tüm hesaplarda ortaktır
  • Etiketler, esnek gruplandırma için işlemlere ekleyebileceğiniz etiketlerdir

Gizlilik ve güvenlik

Destek