Beyond Payday

npx add-mcp 'https://beyondpayday.com/api/mcp'

它是什么

一个已经了解你财务数字的聊天助手

Beyond Payday 发布了一个连接器——一组小型工具，助手可以在与你交谈时调用。问题需要具体数字时，助手会从你的账户中获取数据，而不是猜测，然后在你原本就在进行的对话中作答。你无需粘贴电子表格，也无需重新输入余额。

人们实际会问的问题

• “我这个月的情况怎么样——有哪些收入，又有哪些支出？”
• “哪些账单是必要支出，付完之后还剩多少？”
• “按利率给我的债务排序，并告诉我每笔债务让我付出了多少成本。”
• “我的目标进展如何？哪个目标落后了？”
• “把我现在的净资产与我在一月份保存的快照进行比较。”
• “添加一笔新的 18 美元流媒体账单，4 号到期。”

最后一个问题只有在你授予了写入权限时才能处理。其他示例都只读取数据。

设置

连接大约只需一分钟

服务器地址

这是你需要粘贴到任何助手中的唯一内容。有两个地址：一个是主地址，你可以自行选择访问级别；另一个是只读地址，完全不提供写入权限。

读写

批准时，你仍然可以选择只读或读写。

https://beyondpayday.com/api/mcp

只读

仅提供 21 个读取工具，不提供其他工具。访问级别已为你选定。

https://beyondpayday.com/api/mcp/readonly

通用方法——适用于大多数 AI 聊天应用

Beyond Payday 使用开放的 MCP 标准（基于可流式传输 HTTP 的 OAuth 2.1），因此在各处的设置方式都相同。找到助手的连接器或 MCP 设置：

1. 添加自定义或远程 MCP 连接器 将其指向上方的服务器地址。只读设置请改用只读地址。
2. 在打开的页面中登录 Beyond Payday 浏览器会打开 Beyond Payday 页面。如果你启用了双重身份验证，系统会先要求你输入验证码。
3. 选择访问级别并批准 只读允许助手查看你的数据。读写还允许添加、编辑和删除账单、收入和工资扣款、资产（包括投资持仓、股票授予和保险保单详情）、债务（包括学生贷款详情）和目标；记录目标缴款；更改家庭税务信息；添加和编辑企业；更改你的 SHTF 计划；以及创建、更改和删除假设情景。你也可以选择拒绝。

下面列出的客户端展示了各自的设置入口——随着更多助手采用此协议，列表也会不断扩充。

Claude

在网页、桌面或移动端：依次选择 Settings → Connectors → Add custom connector，粘贴地址，选择 Connect，登录 Beyond Payday，然后选择 Read-only 或 Read & write 并点击 Approve。在终端中，请使用 Claude Code（见下文）。你可以添加的内容以及可使用的额度取决于你的 Claude 套餐。

ChatGPT

启用 Developer mode（Settings → Apps → Advanced）——此功能适用于 Plus、Pro、Business、Enterprise 和 Edu 套餐的网页版应用——然后添加自定义连接器、粘贴地址并完成 OAuth 登录。需要坦诚说明一点：ChatGPT 的 Deep Research 需要连接器提供自己的 search 和 fetch 工具，因此 Beyond Payday 的财务工具可能不会出现在所有 ChatGPT 功能中。

Cursor

打开 Settings → Tools & MCP → Add custom MCP（或者在 .cursor/mcp.json 中的 mcpServers 下添加服务器，并使用 url），然后完成 Cursor 打开的浏览器登录流程。

VS Code（GitHub Copilot）

将 HTTP 服务器添加到 { "type": "http", "url": "…" } — mcp.json — 然后点击条目上方的 Auth 操作以完成登录。

Claude Code

只需两条命令。第一条注册服务器，第二条会打开浏览器，供你像在其他客户端中一样批准连接。

claude mcp add --transport http beyond-payday https://beyondpayday.com/api/mcp

如需只读设置，请将地址替换为 https://beyondpayday.com/api/mcp/readonly。

其他 AI 聊天应用

Windsurf，以及任何其他支持通过可流式传输 HTTP 使用 Model Context Protocol 并通过 OAuth 登录的应用，都可以用相同方式连接——在其 MCP 设置中添加服务器地址，然后完成浏览器登录。服务器没有任何客户端专属设置。

也已列入官方 MCP Registry（名称为 com.beyondpayday/mcp）、Smithery、MCP.so、mcpservers.org 和 Glama。

访问级别

由你决定访问范围

批准页面只提供两个选项，并会显示发起请求的应用。连接绝不会在之后悄悄升级——从一个级别切换到另一个级别需要重新批准。

只读

查看你的个人资料、收入和实得工资、工资扣款、账单、资产和账户、投资持仓、股票授予、保险保单详情、债务（包括学生贷款详情）、目标、企业和企业支出、家庭税务信息、假设情景、现金流、净资产及其历史记录、SHTF 计划、省钱建议和社会保障金申领对比。无法更改任何内容。共 21 个工具，全部用于查询。

读写

除上述所有内容外，还可以添加、编辑和删除账单、收入和工资扣款、资产（包括投资持仓、股票授予和保险保单详情）、债务（包括学生贷款详情）和目标；记录目标缴款；更改家庭税务信息；添加和编辑企业；更改 SHTF 计划；以及创建、更改和删除假设情景。仅限记录——请参阅下方说明。

“写入”仅指在 Beyond Payday 中添加或更改一条记录，不涉及其他操作。

在此删除账单，只会删除你保存的记录；不会向账单提供方取消任何服务。删除资产不会关闭账户，删除债务也不会结清债务。Beyond Payday 不连接任何银行或银行卡——其中的所有信息都是由某人手动输入的——因此，即使连接器收到要求，也没有途径可以转移资金。

工具

连接器的全部功能一览

共 54 个工具——21 个读取工具和 33 个写入工具。没有隐藏功能：以下就是全部功能范围，只读连接仅提供 21 个读取工具。

读取——所有连接均可使用

工具	功能
财务概览 beyondpayday_get_overview	净资产、资产总额和负债总额，以及每月税前总收入、必要账单、非必要账单和可支配收入，并按类别显示记录数量。
每月现金流 beyondpayday_get_cash_flow	每月实得收入、必要和非必要账单，以及结余金额——还包括未来 1–90 天内到期的账单。需要“收入和支出”访问权限；只有所有者授予后，子女才能拥有此权限。
列出账单 beyondpayday_list_bills	定期账单及其金额、到期频率、类别和是否标记为必要支出。仅读取记录——不会支付任何费用。
列出收入来源 beyondpayday_list_income	收入来源及其薪酬标准、发薪频率、税率，以及所属家庭成员或企业。
列出资产 beyondpayday_list_assets	账户、房产和投资及其当前价值、类别、金融机构和所有者。不包含账号。
列出债务 beyondpayday_list_debts	债务和负债及其未偿余额、利率、到期日和所有者。不包含账号。
列出储蓄和还款目标 beyondpayday_list_goals	目标及其目标金额和日期、目前已储蓄金额、进度，以及是否按计划推进的评估。
列出企业 beyondpayday_list_businesses	企业及其实体类型、行业、预估税率和估值设置。绝不会返回雇主识别号码。需要包含企业功能的套餐。
列出企业支出 beyondpayday_list_business_expenses	某家企业的支出——分配给该企业的账单——包括账单全额、分配比例和企业应承担的金额。需要包含企业功能的套餐。
企业财务摘要 beyondpayday_get_business_summary	某家企业的年度收入、支出和利润、企业账面上的资产和债务，以及按你选择的方法计算的估值。需要包含企业功能的套餐。
列出假设情景 beyondpayday_list_scenarios	已保存的假设情景——命名的收入和账单变更组合——以及每个情景包含的新增和移除项目数量。仅限所有者或配偶/伴侣使用，并需要“假设规划器”访问权限。
获取假设情景 beyondpayday_get_scenario	按照“假设规划器”中的显示方式返回某个假设情景：每项生活变化及其关联项目的选项、“还要添加？”附加项和任何购买项目、你的手动编辑，以及变更前后的结余、账单和净资产。仅限所有者或配偶/伴侣使用，并需要“假设规划器”访问权限。
净资产历史记录 beyondpayday_get_net_worth_history	你保存的仪表板快照，按时间从新到旧排列：包含净资产、资产、负债和当时每月财务数据的日期记录。不会重建你从未保存过的历史记录。
SHTF 计划 beyondpayday_get_shtf_plan	你的困难时期计划——收入中断时将进行的变更，按严重程度显示已检查或未检查的项目。保存计划前，显示 SHTF 页面上的初始计划。仅限所有者或配偶/伴侣使用，并需要 SHTF 计划、收入、账单和资产访问权限。
列出省钱建议 beyondpayday_list_savings_matches	“省钱”页面提供建议的账单，以及每笔账单匹配的建议集和建议标题。仅为一般建议，不是针对你的服务提供方的建议。
账户个人资料 beyondpayday_get_profile	当前连接所代表的用户信息——显示名称、家庭角色、家庭名称、时区，以及按姓名和关系列出的家庭成员。不包含电子邮件地址和生日。
列出账户中的持仓 beyondpayday_list_holdings	某个账户中的投资（代码、名称、类型、份额、价格、价值、成本基础），以及总额、按类型划分的明细、未实现收益（如有），还有持仓总额是否与账户价值不同。持仓仅供参考：不会改变账户价值或净资产。
列出资产上的股票授予 beyondpayday_list_equity_grants	某项股票薪酬资产对应的股票期权、RSU、PSU 和 ESPP 授予项目，以及每项的归属计划、已归属且仍持有的数量、未归属数量和下一次归属时间，数据截至今天。仅供参考：不会改变净资产。
家庭税务信息 beyondpayday_get_tax_profile	你保存的税务信息（申报身份、州、仅以数量表示的受抚养人、扣除额选择）；如果没有保存任何信息，则返回空内容。为你启用税额估算后，也会返回估算结果。需要“收入和支出”访问权限。非税务建议。
将保险保障与经验法则进行比较 beyondpayday_get_coverage_check	将你保存的保险保单（包括洪水险、长期护理险和公寓保险）与常见经验法则进行比较，结果包括：低于规则、达到或超过规则、仅供参考、未录入、需要更多详情，或需要检查，例如“是否续保了？”。这是对你自身数据的比较，不是保险建议。仅在 Beyond Payday 为你启用后可用。
比较社会保障金申领年龄 beyondpayday_compare_ss_claiming	某人如果在其尚未达到的各个年龄申领（最高至 70 岁），其本人可获得的社会保障金金额，以及截至之后各年龄累计领取的总额；或者显示其已开始领取。仅供比较，不构成建议。仅在 Beyond Payday 为你启用后可用。

写入——仅在你批准读写权限后可用

工具	功能说明
添加账单 beyondpayday_create_bill	记录一笔新的定期账单，使其计入预算。这只会创建一条记录——Beyond Payday 不会转移资金，也无法支付账单。
更新账单 beyondpayday_update_bill	修改现有账单记录中的字段。只会更改提供的字段；其他内容保持不变。
删除账单 beyondpayday_delete_bill	永久删除账单记录及其与资产和企业的关联。这不会取消你与账单收款方之间的任何服务。
添加收入来源 beyondpayday_create_income	记录新的收入来源，使其计入预算和实得收入数据。补充收入——奖金、小费、每日津贴、401(k) 雇主配比缴款——仍须在应用中添加。
更新收入来源 beyondpayday_update_income	修改现有收入记录中的字段。无法通过连接器编辑补充收入；工资扣款可使用下方的专用工具。
删除收入来源 beyondpayday_delete_income	永久删除收入记录及其工资扣款。
添加工资扣款 beyondpayday_create_income_deduction	为每次发薪添加一项扣款，例如 401(k)、HSA 或医疗保险费；金额可按每次发薪的美元数填写，也可按基本工资的百分比填写（不含奖金）。工作保险保费或 ESPP 缴款会关联到相应的保单或股票资产。ESPP、529 缴款和工会会费始终在税后扣除。返回扣款后的实得工资。
更新工资扣款 beyondpayday_update_income_deduction	修改一项工资扣款中的字段。只会更改你提供的字段。
删除工资扣款 beyondpayday_delete_income_deduction	永久删除一项工资扣款。工资记录及任何关联账户都会保留。
添加资产 beyondpayday_create_asset	记录新的账户、房产、车辆或投资，使其计入净资产。这不会开设或注资任何账户。
更新资产 beyondpayday_update_asset	修改现有资产记录中的字段，例如当前价值。这只会编辑记录，不会转移资金。
删除资产 beyondpayday_delete_asset	永久删除资产记录。这不会关闭任何真实账户。
添加持仓 beyondpayday_create_holding	记录投资账户中的一项投资。此操作绝不会更改账户价值或净资产，也不会买入任何东西。
更新持仓 beyondpayday_update_holding	修改一项持仓中的字段。只会更改你提供的字段。
删除持仓 beyondpayday_delete_holding	永久删除一项持仓记录。此操作不会卖出任何东西，也不会更改账户价值。
添加股票授予 beyondpayday_create_equity_grant	在股票薪酬资产中记录一项股票期权、RSU 或 ESPP 授予。此操作不会授予、行权或卖出任何东西。
更新股票授予 beyondpayday_update_equity_grant	修改一项股票授予中的字段。只会更改你提供的字段。
删除股票授予 beyondpayday_delete_equity_grant	永久删除一项股票授予记录。此操作不会行权或卖出任何东西。
更新家庭税务信息 beyondpayday_update_tax_profile	修改已保存的税务信息。只会更改你提供的字段；如果尚未保存任何信息，则会创建一条记录，并且需要提供报税身份。此操作只会编辑记录，不会提交任何申报。
添加债务 beyondpayday_create_debt	记录新的债务或负债，使其计入净资产。这不会借款、偿还债务或转移任何东西。
更新债务 beyondpayday_update_debt	修改现有债务记录中的字段，例如未偿余额。这只会编辑记录，不会转移资金。
删除债务 beyondpayday_delete_debt	永久删除债务记录。这不会结清或关闭实际债务。
添加目标 beyondpayday_create_goal	记录新的储蓄或还债目标；也可选择关联真实账户或债务，以便自动跟踪其余额进度。
更新目标 beyondpayday_update_goal	修改现有目标记录中的字段，例如目标金额、目标日期或跟踪的账户。只会更改提供的字段。
删除目标 beyondpayday_delete_goal	永久删除目标记录及其已记录的缴款。该目标跟踪的账户或债务不会被删除，余额也不会改变。
记录目标缴款 beyondpayday_log_goal_contribution	记录一笔目标缴款，并返回重新计算后的进度。缴款记录只能追加——如需更正错误，请记录一笔负数。
添加企业 beyondpayday_create_business	记录一家新企业，同时添加一条记录，将企业价值计入你的净资产，并将所有者的转付收入计入收入。无法通过连接器设置 EIN。需要包含企业功能的套餐。
更新企业 beyondpayday_update_business	修改现有企业记录中的字段。重命名企业，或更改其实体类型或估值设置，会重算衍生收入和股权数据。无法通过连接器设置 EIN。
更改 SHTF 计划 beyondpayday_update_shtf_plan	按照 SHTF 页面中的方式更改你的假设性困难时期计划——包括起始数字、各级别的假设，以及添加、勾选或编辑账单削减、福利、搬迁、资产出售或提款等变更。你的家庭实际情况不会发生任何变化；数据按照该页面自身的规则计算。仅限所有者或配偶/伴侣使用，并且需要拥有 SHTF 计划更新权限。
创建假设情景 beyondpayday_create_scenario	创建一个假设情景；也可选择从“买车”或“换新工作”等人生变化开始，并按照 What-if 规划器针对你的数据填充内容。你的家庭实际情况不会发生任何变化。仅限所有者或配偶/伴侣使用，并且需要拥有 What-if 规划器更新权限。
更改假设情景 beyondpayday_update_scenario	按照 What-if 规划器中的方式更改假设情景——重命名、叠加、编辑、暂停或移除人生变化，也可以手动移除或添加项目。数据按照该页面自身的计算方式得出；你的家庭实际情况不会发生任何变化。仅限所有者或配偶/伴侣使用，并且需要拥有 What-if 规划器更新权限。
删除假设情景 beyondpayday_delete_scenario	删除已保存的假设情景。你的实际账单、收入和账户不会受到影响。仅限所有者或配偶/伴侣使用，并且需要拥有 What-if 规划器更新权限。
恢复已删除的记录 beyondpayday_restore_deleted	列出过去 30 天内通过连接器删除的记录，并将其中一条按原样恢复，包括一并删除的内容。需要拥有相应记录类型的添加权限。

安全与隐私

将财务信息交给助手，需要了解一些细节

添加连接器

在你的助手中粘贴一次 Beyond Payday 服务器地址。它会将你带到我们的网站登录。

在此授权

登录后，在 Beyond Payday 页面上选择只读或读写权限——你也可以拒绝授权。

助手会获得受限密钥

密钥仅涵盖你授权的内容。它每天过期一次，并会自动续期，直到你撤销授权。

每次请求都会重新检查

每次调用都会应用你的家庭权限，因此连接器的访问范围绝不会超出你的权限。

我们绝不保留答案副本

我们的日志会记录某个工具是否运行、运行的是哪个工具、是否成功以及耗时多久。不记录返回内容、不记录你的提问，也不记录其中的任何数字。

你可以查看并终止连接

“设置” → “AI 连接”会列出每个连接、它可以执行的操作以及上次使用时间。撤销后会在下一次请求时立即生效。

助手与 Beyond Payday 的连接如何设置，以及之后允许执行哪些操作。

沿用你已有的权限

每次工具调用都会根据应用本身使用的家庭权限系统进行检查。儿童账户无法连接，Beyond Payday 支持人员身份也不会为连接器带来任何额外权限。

有些信息绝不会离开

账户号码、雇主识别号码、电子邮件地址和生日不会出现在任何工具结果中。工具只会返回固定字段列表中的内容，因此不在列表中的值绝不会泄露。

如果你愿意，可以使用只读连接

你可以在授权页面选择访问级别；此外，我们还提供单独的只读服务器地址，供不应提供其他选择的连接使用。

账户每小时限额

每个连接每小时最多可进行 300 次读取调用和 60 次写入调用。限额按 Beyond Payday 账户计算，因此添加更多连接不会提高限额。

撤销立即生效

“设置” → “AI 连接”会列出每个连接、它可以执行的操作以及上次运行时间。点击“撤销”后会在下一次请求时立即生效，而不是等到令牌过期才生效。

我们只记录工具运行情况，不记录它说了什么

我们记录的工具调用信息包括工具名称、是否成功、错误代码和耗时。不记录问题、不记录答案，也不记录其中的任何数字。

出现问题时，可以关闭连接器

你可以在“设置” → “AI 连接”中撤销任何连接。我们这边的管理员可以为单个账户关闭连接器，也可以为所有人关闭整个连接器——连接器设有紧急关闭开关，且默认处于关闭状态。

常见问题

为什么不直接把我的数字粘贴到聊天中提问？

有三个原因。首先，它不会靠猜：助手读取的是你实际保存的数字，而不是你记得粘贴的内容，也不是它从之前的聊天中模糊记住的内容。其次，它有真正的计算器，因此计算结果更有可能准确：实得工资计算会考虑 FICA、税前和税后扣款，以及 1099 收入的预估税；退休计划会运行数千次市场回报蒙特卡洛模拟，涵盖 Social Security（包括配偶和遗属福利）、养老金和年金、强制最低分配、税款、通货膨胀、提款顺序和缩小住房规模，并提供成功率和结果范围，而不是只给出一个猜测。债务偿还、假设情景和你的应急计划也会以同样方式计算，因此每次提问都会得到相同答案。最后，它的记忆不会随着某个助手的结束而消失：你的数据保存在 Beyond Payday，而不是聊天记录中，因此对话结束时不会丢失任何内容；切换 AI 助手时，只需连接新的助手，就能从上次中断处继续，净资产历史记录也会保留。

与单独使用聊天相比，我还能获得什么？

你的家庭共用一份计划。配偶或伴侣可以将自己的 AI 助手连接到同一组数据。你可以核对任何答案：助手引用的每个数字也会显示在 Beyond Payday 仪表板和图表中。即使你没有聊天，它也会继续工作，通过电子邮件或推送通知提醒你账单到期、发薪日和预估税款，并记录你的净资产随时间的变化。你始终掌握控制权：Beyond Payday 不连接任何银行或银行卡，因此任何助手都无法转移资金；你可以将连接设为只读；也可以随时在“设置” → “AI 连接”中撤销连接；我们只记录工具是否运行，绝不记录你的提问或它的回答。

哪些助手可以使用此功能？

任何支持 MCP 的助手都可以使用，因为 Beyond Payday 是标准 MCP 服务器，没有客户端允许列表。Claude 和 Claude Code 可通过各自的连接器设置进行连接。ChatGPT 也可以使用——你需要先开启 Developer mode；其 Deep Research 功能需要使用自己的搜索和抓取工具，因此 Beyond Payday 的财务工具可能不会在那里显示。Cursor、带有 GitHub Copilot 的 VS Code、Windsurf 等也可以用同样的方式连接。随着更多助手采用该协议，支持列表也会不断扩大。

我的助手实际上能看到什么？ 只有工具调用时才会返回工具返回的内容。这是一份简短的个人资料，以及你的收入和实得工资、工资扣款、账单、资产和账户、投资持仓、股票授予、保险单详情、债务（包括学生贷款详情）、目标、企业及企业支出、家庭税务信息、假设情景、现金流、净资产及其历史记录、你的 SHTF 计划、省钱技巧和社会保障金申领方案比较——并按照你在应用中的相同家庭权限进行筛选。结果中绝不会包含账号、雇主识别号码、电子邮件地址或生日。

它能更改我的记录吗？

只有在你于授权页面授予读写权限后才可以。若只有只读权限，所有写入工具都会拒绝操作，并告知助手请你重新连接。即使拥有写入权限，这些工具也只会在 Beyond Payday 中添加、编辑和删除记录——任何地方的任何工具都无法转移、发送或支付资金，因为 Beyond Payday 未连接任何银行或银行卡。

我可以撤销授权吗？

可以，随时都能在 Beyond Payday 的 Settings → AI Connections 中撤销。撤销会在连接器发出下一次请求时生效。你也可以在助手端断开连接；访问密钥在签发一天后会停止工作，除非续期。

Beyond Payday 会存储我的对话吗？

不会。你的对话保存在你的助手那里，而不是我们这里——我们永远不会收到对话内容。我们只会为每次工具调用保留一条记录：运行了哪个工具、对应哪个账户、是否成功、失败时的错误代码，以及耗时。绝不记录参数，也绝不记录返回值。

孩子的账户怎么办？

儿童账户无法连接 AI 助手。只有账户所有者及其配偶或伴侣可以连接；儿童尝试连接时会看到“儿童账户不可用”页面，不会共享任何信息。

哪些 Beyond Payday 套餐可以使用？

连接器处于预览期间，所有套餐均可使用，包括 Free。唯一的例外是 businesses 工具，它需要包含企业跟踪功能的套餐——应用本身也采用相同的限制。你在助手端可以执行的操作可能取决于助手自身的套餐（例如，某些应用中的自定义连接器需要付费套餐）。

无法连接——我该检查什么？

请确认地址准确无误，为 https://beyondpayday.com/api/mcp，且末尾没有斜杠；并确认你已完成 Beyond Payday 登录并点击 Approve，而不是直接关闭标签页。如果你启用了双重身份验证，创建连接前系统会要求你输入验证码。如果连接成功，但现在所有工具都失败，请检查 Settings → AI Connections——连接可能已被撤销，或者已达到每小时限额。

你的助手会根据账户中的数据进行处理，也可能误解这些数据的含义。它提供的内容仅供参考，不构成财务、税务或投资建议——Beyond Payday 是一款跟踪和规划工具，它本身以及读取其中信息的助手都不能替代合格的专业人士。

让你的助手有真实数据可用

在 Beyond Payday 中跟踪账单、收入、资产和债务，然后连接一次，随心提问。连接器在预览期间适用于所有套餐。

开始使用无需信用卡。已有账户？请从 Settings → Connections 连接。