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 服务器
将您的 PocketSmith 账户连接到任何支持 Model Context Protocol 的 AI 助手。
通过 Model Context Protocol (MCP) 将 AI 助手连接到 PocketSmith 后，它便可直接访问您的财务数据、预算和预测。它可以提供见解和信息，也可以为您执行多种操作。
功能
PocketSmith MCP 服务器可代表您读取和管理 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 根据收款方名称分配合适的类别。（需要完全访问模式。）
“我的储蓄账户 6 个月后会是什么情况？”
预测账户余额的未来变化：
您： 根据我的预算，未来 6 个月我的储蓄账户余额会是什么情况？
使用 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