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 和行動應用程式)
完整存取:
- 在 Claude 目錄中開啟 PocketSmith Complete Access
- 按一下 Connect
- 系統會將您重新導向至 PocketSmith,以授權存取
連接器會與您的 Claude 帳戶綁定,因此在 claude.ai 連線後,也能在 Claude Desktop 和 Claude 行動應用程式中使用 PocketSmith。
唯讀:
- 在 claude.ai 或 Claude Desktop 中,開啟 Settings > Connectors
- 按一下 Add custom connector
- 輸入名稱(例如「PocketSmith Read-only」)和 URL
https://mcp-readonly.pocketsmith.com/mcp - 按一下新連接器旁的 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 和桌面應用程式)
完整存取:
- 在 chatgpt.com 上開啟 ChatGPT 應用程式目錄中的 PocketSmith
- 按一下 Connect
- 系統會將您重新導向至 PocketSmith,以授權存取
應用程式會與您的 ChatGPT 帳戶綁定,因此在 chatgpt.com 連線後,也能在 ChatGPT 桌面應用程式中使用 PocketSmith。如果沒有顯示,請重新啟動桌面應用程式。
唯讀:
唯讀版必須在 chatgpt.com 設定,不能在桌面應用程式中設定:
- 開啟 Settings > Apps & Connectors,並啟用 Developer mode(位於 Advanced settings)
- 按一下 Create 以新增自訂連接器
- 輸入名稱(例如「PocketSmith Read-only」)和 URL
https://mcp-readonly.pocketsmith.com/mcp - 按一下 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 預測引擎的預算事件
- 分類採用階層式結構(父項/子項),並由所有帳戶共用
- 標籤是可新增至交易的標記,方便彈性分組
隱私權與安全性
- PocketSmith 隱私權政策:https://www.pocketsmith.com/legal/privacy-policy/
- 您的 PocketSmith 憑證絕不會與 AI 助理分享
- OAuth 權杖採用 AES-256-GCM 加密,且為無狀態(伺服器端不會儲存任何資料)
- 所有 API 通訊皆使用 TLS 加密
- 您隨時可以從 PocketSmith 已授權的應用程式 撤銷存取權
支援
- 說明與支援:https://learn.pocketsmith.com
- 聯絡支援團隊:help@pocketsmith.com