PocketSmith Read-only
resmiSalt 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:
| Mod | Açıklama | Bağlanma yöntemi |
|---|---|---|
| Tam erişim | 66 aracın tümü - okuma, oluşturma, güncelleme ve silme | Claude veya ChatGPT dizininden tek tıklamayla |
| Salt okunur | 40 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:
- Claude dizininde PocketSmith Complete Access sayfasını açın
- Connect'e tıklayın
- 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:
- claude.ai üzerinde veya Claude Desktop'ta Settings > Connectors bölümünü açın
- Add custom connector'a tıklayın
- Bir ad girin (ör. "PocketSmith Read-only") ve URL'yi
https://mcp-readonly.pocketsmith.com/mcpgirin - 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:
- chatgpt.com üzerinde ChatGPT uygulamaları dizinindeki PocketSmith'i açın
- Connect'e tıklayın
- 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:
- Settings > Apps & Connectors bölümünü açın ve Developer mode'u etkinleştirin (Advanced settings altında)
- Özel bağlayıcı eklemek için Create'e tıklayın
- Bir ad girin (ör. "PocketSmith Read-only") ve URL'yi
https://mcp-readonly.pocketsmith.com/mcpgirin - 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
| Mod | URL |
|---|---|
| Tam erişim | https://mcp.pocketsmith.com/mcp |
| Salt okunur | https://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_snapshot | Net varlık, harcama hızı, bütçe durum göstergeleri, yapılacaklar |
month_end_review | Gelir/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_expenses | Abonelikleri ve yinelenen faturaları yıllık toplam maliyetleriyle belirleme |
cash_flow_forecast | Risk bölgesi uyarılarıyla ileriye dönük hesap bakiyesi tahminleri |
net_worth_forecast | Geçmiş eğilim, tahmin ve kilometre taşı öngörüleriyle net varlık gidişatı |
forecast_accuracy | Bü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_budget | Tahmin dönemi için kategori bazında bütçe analizi |
get_budget_summary | Tarih aralığı için gerçekleşen gider/gelir ile bütçelenen tutarları karşılaştırma |
get_trend_analysis | Kategoriye göre zaman içindeki harcama eğilimleri |
delete_forecast_cache | Toplu 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_transaction | Tek bir işlemin tüm ayrıntılarını alma |
create_transaction | Yeni 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_accounts | Kullanıcıya veya finans kuruluşuna göre tüm hesapları listeleme |
get_account | Bakiye ve alt hesaplar dahil hesap ayrıntılarını alma |
create_account / update_account / delete_account | Hesapları yönetme |
update_account_display_order | Hesapları yeniden sıralama |
list_institutions / get_institution | Finans kuruluşlarını görüntüleme |
create_institution / update_institution / delete_institution | Finans 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_category | Kategori hiyerarşinizi görüntüler |
create_category / update_category / delete_category | Kategorileri yönetir |
list_category_rules / create_category_rule | Otomatik kategorilendirme kurallarını görüntüler ve oluşturur |
Bütçe Etkinlikleri
| Araç | Ne işe yarar |
|---|---|
list_events / get_event | Bütçe tahmini etkinliklerini görüntüler |
create_event / update_event / delete_event | Yinelenen ve tek seferlik bütçe etkinliklerini yönetir |
Ekler
| Araç | Ne işe yarar |
|---|---|
list_attachments / get_attachment | Makbuz ve belge eklerini görüntüler |
create_attachment / update_attachment / delete_attachment | Ekleri yönetir |
assign_transaction_attachment / unassign_transaction_attachment | Ekleri işlemlere bağlar/bağlantılarını kaldırır |
Veri Akışları
| Araç | Ne işe yarar |
|---|---|
get_data_feeds_connection_status | Banka veri akışı eşitleme durumunu ve sağlayıcı ayrıntılarını kontrol eder |
refresh_data_feeds_connection | Bir 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_transactions | Hesap, kategori, anahtar kelime veya tarihe göre önceden filtrelenmiş işlem araması |
navigate_to_budget | Tarih ayarları ve diğer seçenekleri bağlantı üzerinden kontrol edilebilen bütçe sayfasına gider |
navigate_to_trends | Bir kategorinin zaman içindeki harcama veya gelir eğilimleri raporu; tüm seçenekler bağlantı üzerinden kullanılabilir |
navigate_to_income_expense | Filtreleme, 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_cashflows | Nakit Akışları tablosu (aylık tablo) |
navigate_to_net_worth | Tüm filtreleme ve diğer seçeneklerin bağlantı üzerinden kullanılabildiği Net Değer sayfası |
navigate_to_calendar | Bağlantı üzerinden tarih aralıklarıyla birlikte görüntülenebilen planlanmış ve tahmini bütçe etkinlikleri ile bakiyelerin takvimi |
navigate_to_account_summary | Belirli bir hesap ve aya ait Hesap Özeti |
Diğer
| Araç | Ne işe yarar |
|---|---|
get_current_user / update_user | Kullanıcı profilini ve ayarlarını görüntüler ve günceller |
list_labels | Tüm işlem etiketlerini görüntüler |
list_saved_searches | Kaydedilmiş işlem arama filtrelerini görüntüler |
list_currencies / get_currency | Para birimi referans verileri |
list_time_zones | Saat 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
- PocketSmith'in gizlilik politikası: https://www.pocketsmith.com/legal/privacy-policy/
- PocketSmith kimlik bilgileriniz AI asistanıyla asla paylaşılmaz
- OAuth belirteçleri AES-256-GCM ile şifrelenir ve durumsuzdur (sunucu tarafında hiçbir şey saklanmaz)
- Tüm API iletişiminde TLS şifrelemesi kullanılır
- Erişimi istediğiniz zaman PocketSmith yetkilendirilmiş uygulamalar sayfasından iptal edebilirsiniz
Destek
- Yardım ve destek: https://learn.pocketsmith.com
- Destek ekibiyle iletişime geçin: help@pocketsmith.com