PocketSmith Read-only

官方

唯讀:PocketSmith 個人理財工具中的交易、預算、預測和洞察。

你可以用 PocketSmith Read Only MCP 做什麼?

  • 財務健康檢查 — 詢問淨資產、支出速度與預算的比較,以及各類別的預算狀況。
  • 支出比較 — 依類別和收款對象比較兩個期間的支出,了解有哪些變化。
  • 定期支出偵測 — 找出訂閱和定期帳單,並列出頻率與年度總費用。
  • 現金流與淨資產預測 — 使用 PocketSmith 的預測引擎推估未來的帳戶餘額與淨資產。
  • 交易搜尋 — 依日期、類別、關鍵字或狀態篩選並查詢交易。
  • 深層連結 — 取得所討論的 PocketSmith 頁面、報表或篩選搜尋的精確連結。

託管 MCP 伺服器

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

可安裝到 Claude Code、Codex、Cursor 等客戶端

文件

MCP Server

將您的 PocketSmith 帳戶連接至任何支援 Model Context Protocol 的 AI 助理。

透過 Model Context Protocol(MCP)將 AI 助理連接至 PocketSmith,即可讓助理直接存取您的財務資料、預算和預測。助理可以提供洞察和資訊,也能為您執行多種操作。

功能

PocketSmith MCP 伺服器可代表您讓 AI 助理讀取及管理 PocketSmith 資料。您不必在 AI 助理和 PocketSmith 之間切換,只要用自然語言提問並執行操作即可:

  • 檢視支出、預算和淨資產
  • 搜尋交易並為交易分類
  • 建立及更新預算事件
  • 分析趨勢並比較不同期間的支出
  • 查看銀行資料同步狀態並觸發重新整理
  • 取得直接連至正確 PocketSmith 頁面或報表的深層連結

提供兩種存取模式:

模式說明連線方式
完整存取全部 66 項工具——讀取、建立、更新和刪除從 Claude 或 ChatGPT 目錄一鍵連線
唯讀40 項唯讀工具——檢視和分析,不會變更資料手動設定為自訂連接器(需多幾個步驟)

大多數人應選擇完整存取。刪除任何內容前,一律需要您明確核准;您也可以要求助理在進行其他變更前先向您確認。如果您希望確保助理絕不會變更資料,請選擇唯讀。

連線

Claude 和 ChatGPT 目錄中都有完整存取版應用程式,只需按一下即可連線。唯讀版目前尚未列在這兩個目錄中,因此需要使用下方其他 MCP 用戶端中的 URL,手動新增為自訂連接器。


Claude(claude.ai、Claude Desktop 和行動應用程式)

完整存取:

  1. 在 Claude 目錄中開啟 PocketSmith Complete Access
  2. 按一下 Connect
  3. 系統會將您重新導向至 PocketSmith,以授權存取

連接器會與您的 Claude 帳戶綁定,因此在 claude.ai 連線後,也能在 Claude Desktop 和 Claude 行動應用程式中使用 PocketSmith。

唯讀:

  1. 在 claude.ai 或 Claude Desktop 中,開啟 Settings > Connectors
  2. 按一下 Add custom connector
  3. 輸入名稱(例如「PocketSmith Read-only」)和 URL https://mcp-readonly.pocketsmith.com/mcp
  4. 按一下新連接器旁的 Connect,並在 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 會在首次使用時提示您透過 OAuth 授權。

ChatGPT(chatgpt.com 和桌面應用程式)

完整存取:

  1. 在 chatgpt.com 上開啟 ChatGPT 應用程式目錄中的 PocketSmith
  2. 按一下 Connect
  3. 系統會將您重新導向至 PocketSmith,以授權存取

應用程式會與您的 ChatGPT 帳戶綁定,因此在 chatgpt.com 連線後,也能在 ChatGPT 桌面應用程式中使用 PocketSmith。如果沒有顯示,請重新啟動桌面應用程式。

唯讀:

唯讀版必須在 chatgpt.com 設定,不能在桌面應用程式中設定:

  1. 開啟 Settings > Apps & Connectors,並啟用 Developer mode(位於 Advanced settings)
  2. 按一下 Create 以新增自訂連接器
  3. 輸入名稱(例如「PocketSmith Read-only」)和 URL https://mcp-readonly.pocketsmith.com/mcp
  4. 按一下 Connect——系統會將您重新導向至 PocketSmith,以授權存取

請勿使用桌面應用程式中的 Settings > Plugins > Add MCP server 選項——在此新增的伺服器只能在 Codex 中使用,無法在 ChatGPT 中使用。

Business/Enterprise/Edu 工作區:工作區管理員必須先從 Workspace settings 啟用應用程式或新增連接器,之後每位使用者再個別連線並授權自己的 PocketSmith 帳戶。

Codex

**完整存取:**如果您已從 ChatGPT 應用程式目錄連線 PocketSmith,從下一次聊天開始即可在 Codex 中自動使用。否則,請從命令列新增:

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

唯讀:

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

Codex 會在首次使用時提示您透過 OAuth 授權。

其他 MCP 用戶端

模式URL
完整存取https://mcp.pocketsmith.com/mcp
唯讀https://mcp-readonly.pocketsmith.com/mcp

任何支援 HTTP 傳輸和 OAuth 的 MCP 用戶端,都可以使用這些 URL 連線。伺服器支援 OAuth 2.0 with PKCE,並在 /.well-known/oauth-authorization-server 和 /.well-known/oauth-protected-resource 發布探索中繼資料。

驗證

驗證會透過 OAuth 自動處理。首次連線時,系統會將您重新導向至 PocketSmith,讓您登入並授予存取權。AI 助理會取得依您所選存取模式(完整或唯讀)設定範圍的權杖,且永遠不會看到您的 PocketSmith 密碼。

權杖會經過加密,且採無狀態設計——MCP 伺服器不會儲存任何資料。您可以隨時從 PocketSmith 已授權的應用程式頁面撤銷存取權。

使用範例

「我這個月的狀況如何?」

要求進行財務健康檢查,即可快速掌握摘要:

您: 我這個月的財務狀況如何?預算進度有跟上嗎?

使用 financial_health_snapshot 工具,回傳您的淨資產、本月支出速度與預算的比較、各類別預算的紅黃綠燈狀態,以及未分類交易等待處理事項。


「我有哪些訂閱費用?」

找出您可能已忘記的定期扣款:

您: 可以找出我所有的定期支出和訂閱嗎?我想知道每月支付哪些費用,以及每年的總成本。

使用 find_recurring_expenses 工具掃描您的交易記錄,依收款方識別定期扣款、判斷扣款頻率,並計算年度總成本。


「比較我這個月和上個月的支出」

查看支出項目有哪些變化:

您: 比較我這個月和上個月的支出。哪些類別增加或減少了?

使用 spending_comparison 工具,依類別和收款方拆解兩個期間的支出,並指出變化以及新增或消失的收款方。


「檢視我三月份的財務狀況」

取得完整的月底檢視:

您: 請完整檢視我 2025 年 3 月的財務狀況——收入、支出、儲蓄率,以及預算執行情況。

使用 month_end_review 工具產生詳細報告,內容包括收入/支出摘要、儲蓄率、各類別預算差異、主要收款方、值得注意的交易,以及淨資產概況。


「為我最近的交易分類」

整理尚未分類的交易:

您: 我上週有不少尚未分類的交易。可以幫我查看並分類嗎?

使用 list_transactions 尋找近期尚未分類的交易,再使用 list_categories 查看您的類別樹,並使用 update_transaction 根據收款方名稱指派適當類別。(需要完整存取模式。)


「六個月後我的儲蓄帳戶會有多少錢?」

預測未來的帳戶餘額:

您: 根據我的預算,未來六個月的儲蓄帳戶餘額會如何變化?

使用 cash_flow_forecast,透過 PocketSmith 的預測引擎推估未來餘額,顯示各帳戶的餘額走勢,並標示餘額可能低於安全門檻的時間點。


「帶我前往那裡」

取得直接連至 PocketSmith 網頁應用程式中正確頁面或報表的連結:

您:過去一年我的雜貨支出有什麼變化?給我一個連結,讓我可以自行深入查看。

使用 get_trend_analysis 摘要說明趨勢,再使用 navigate_to_trends 建立指向趨勢報表的深層連結,並預先篩選您的雜貨類別和日期範圍,讓您可以在 PocketSmith 中繼續探索。所有導覽工具都以相同方式運作:助理先回答問題,再提供連至所述確切頁面、報表或交易搜尋結果的連結。

可用工具

洞察(複合分析工具)

這些工具會結合多個 API 呼叫,產生豐富且可直接使用的分析結果:

工具功能
financial_health_snapshot淨資產、支出速度、預算紅黃綠燈狀態、待處理事項
month_end_review完整期間檢視,包含收入/支出、儲蓄率、預算差異和主要收款方
spending_comparison依類別和收款方並列比較兩個日期期間
find_recurring_expenses偵測訂閱和定期帳單,並計算年度總成本
cash_flow_forecast預測未來帳戶餘額,並在進入危險區間時發出警示
net_worth_forecast淨資產走勢,包含歷史趨勢、預測和里程碑推估
forecast_accuracy比較實際餘額與預測餘額,以評估預算可靠性

預算

工具功能
get_budget分析預測期間內各類別的預算
get_budget_summary比較日期範圍內的實際支出/收入與預算金額
get_trend_analysis依類別查看支出趨勢
delete_forecast_cache大量編輯後強制重新計算預算

交易

工具功能
list_transactions依日期、類別、關鍵字和狀態搜尋及篩選交易
get_transaction取得單筆交易的完整詳細資料
create_transaction新增交易
update_transaction編輯交易(收款方、類別、標籤、備註、拆分)
delete_transaction移除交易

帳戶與金融機構

工具功能
list_accounts依使用者或金融機構列出所有帳戶
get_account取得帳戶詳細資料,包括餘額和子帳戶
create_account / update_account / delete_account管理帳戶
update_account_display_order重新排序帳戶
list_institutions / get_institution檢視金融機構
create_institution / update_institution / delete_institution管理金融機構
list_transaction_accounts / get_transaction_account / update_transaction_account檢視及更新交易帳戶

類別與規則

工具功能說明
list_categories / get_category查看您的分類階層
create_category / update_category / delete_category管理分類
list_category_rules / create_category_rule查看及建立自動分類規則

預算事件

工具功能說明
list_events / get_event查看預算預測事件
create_event / update_event / delete_event管理定期及單次預算事件

附件

工具功能說明
list_attachments / get_attachment查看收據及文件附件
create_attachment / update_attachment / delete_attachment管理附件
assign_transaction_attachment / unassign_transaction_attachment將附件連結至交易或取消連結

資料來源

工具功能說明
get_data_feeds_connection_status檢查銀行資料來源同步狀態及提供者詳細資訊
refresh_data_feeds_connection觸發一個或所有銀行資料來源連線的同步作業

導覽

這些工具會產生深層連結,讓助理能在對話中將您帶到 PocketSmith 的確切頁面,並預先篩選正確的帳戶、分類和日期,以及報告所需的其他頁面控制項。

工具功能說明
navigate_to_transactions交易搜尋,可依帳戶、分類、關鍵字或日期預先篩選
navigate_to_budget前往預算頁面,可透過連結控制日期設定及其他切換選項
navigate_to_trends分類支出或收入的趨勢報告,可透過連結使用所有切換選項
navigate_to_income_expense收入與支出報告(損益表),可透過連結使用篩選條件、日期範圍及其他選項
navigate_to_cashflows現金流量表(逐月表格)
navigate_to_net_worth淨值頁面,可透過連結使用所有篩選條件及其他選項
navigate_to_calendar已排程及預測預算事件與餘額的行事曆,可透過連結設定日期範圍
navigate_to_account_summary特定帳戶及月份的帳戶摘要

其他

工具功能說明
get_current_user / update_user查看及更新使用者個人資料與設定
list_labels查看所有交易標籤
list_saved_searches查看已儲存的交易搜尋篩選條件
list_currencies / get_currency貨幣參考資料
list_time_zones時區參考資料

PocketSmith 資料模型

了解 PocketSmith 的階層有助於提出問題:

Institution (e.g. "Sample Bank")
  → Account (container/group, e.g. "Everyday Credit Card")
      → Transaction Account (where transactions live)
      → Scenario (where budget forecast events live)
  • 金融機構代表銀行或金融服務提供者
  • 帳戶包含一個或多個交易帳戶及情境
  • 交易帳戶存放實際交易記錄
  • 情境包含驅動 PocketSmith 預測引擎的預算事件
  • 分類採用階層式結構(父項/子項),並由所有帳戶共用
  • 標籤是可新增至交易的標記,方便彈性分組

隱私權與安全性

支援