Beyond Payday

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

这是什么

一个已经知道你的数字的聊天

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

人们实际会问的事情

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

最后一项只有在您授予写入权限时才有效。其他所有示例都是读取操作。

设置

连接大约需要一分钟

服务器地址

这是你唯一需要粘贴到任何助手里的内容。有两个：主地址（你可以自己选择访问级别）和一个只读地址（完全无法提供写入权限）。

读写

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

https://beyondpayday.com/api/mcp

只读

仅提供15个读取工具，没有其他内容。选择已经为你做好了。

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

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

Beyond Payday 使用开放的 MCP 标准（基于流式 HTTP 的 OAuth 2.1），因此设置方式在所有地方都一样。无论你的助手在哪里保存其连接器或 MCP 设置：

1. 添加自定义或远程 MCP 连接器 将其指向上述服务器地址。只读设置则使用只读地址。
2. 在打开的页面中登录 Beyond Payday 浏览器中会打开一个 Beyond Payday 页面。如果你开启了双重身份验证，会先要求你输入验证码。
3. 选择访问级别并批准 只读允许助手查看你的数据。读写还允许它添加、编辑和删除账单、收入、资产和债务。拒绝选项也就在那里。

以下客户端是每个客户端隐藏该流程的示例——随着更多助手采用该协议，列表会不断增长。

Claude

在网页、桌面或移动端：设置 → 连接器 → 添加自定义连接器，粘贴地址，选择连接，登录 Beyond Payday，然后选择只读或读写并批准。在终端中，使用 Claude Code（见下文）。你可以添加的内容以及使用程度取决于你的 Claude 套餐。

ChatGPT

开启开发者模式（设置 → 应用 → 高级）——适用于 Plus、Pro、Business、Enterprise 和 Edu 套餐的网页应用——然后添加自定义连接器，粘贴地址并完成 OAuth 登录。一个坦诚的提醒：ChatGPT 的深度研究功能期望连接器自带 search 和 fetch 工具，因此 Beyond Payday 的财务工具可能不会出现在 ChatGPT 的每个功能中。

Cursor

打开设置 → 工具与 MCP → 添加自定义 MCP（或在 .cursor/mcp.json 的 mcpServers 下添加服务器，使用 url），然后完成 Cursor 打开的浏览器登录。

VS Code（GitHub Copilot）

在 mcp.json（{ "type": "http", "url": "…" }）中添加一个 HTTP 服务器，然后点击条目上方的 Auth 操作以完成登录。

Claude Code

两个命令。第一个注册服务器，第二个打开与所有其他地方相同的浏览器批准流程。

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

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

任何其他 AI 聊天应用

Windsurf 以及任何其他支持通过流式 HTTP 使用模型上下文协议并通过 OAuth 登录的应用，都以相同方式连接——在其 MCP 设置中添加服务器地址并完成浏览器登录。服务器本身没有任何客户端特定的内容。

也列在官方 MCP 注册表（作为 com.beyondpayday/mcp）、Smithery、MCP.so、mcpservers.org 和 Glama 上。

访问级别

你决定它的权限范围

批准屏幕只提供两个选项，并说明是哪个应用在请求。连接永远不能事后悄悄升级——从一个级别切换到另一个级别意味着需要重新批准。

只读

查看你的个人资料和财务数据。它不能更改任何内容。15个工具，全部是查询。

读写

上述所有内容，外加添加、编辑和删除账单、收入、资产、债务和目标，以及添加或编辑企业。仅限记录——见下方说明。

“写入”意味着在 Beyond Payday 中创建一行记录。仅此而已。

在这里删除账单会删除你保存的记录；它不会与账单方取消任何内容。删除资产不会关闭账户，删除债务也不会结清债务。Beyond Payday 与任何银行或卡片没有关联——其中的所有内容都是有人手动输入的——因此即使被要求，连接器也没有任何途径可以移动资金。

工具

连接器能做的所有事情，完整列出

33个工具——15个读取和18个写入。没有任何隐藏：这是全部功能面，只读连接只提供15个读取工具。

读取——每个连接都可用

工具	功能
财务概览 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_net_worth_history	你保存的仪表板快照，按最新优先：带日期的净资产、资产、负债和当时的月度数据记录。它不会重建你从未保存的历史。
SHTF 计划 beyondpayday_get_shtf_plan	你保存的困难时期计划——如果收入停止会采取的行动，按严重程度分组。仅限所有者或配偶，需要收入、账单和资产访问权限。
列出省钱提示 beyondpayday_list_savings_matches	“省钱”页面提供提示的账单，每个账单都有匹配的提示集和提示标题。一般性建议，不是针对你的服务商的建议。
账户资料 beyondpayday_get_profile	连接以谁的身份操作——显示名称、家庭角色、姓氏、时区，以及按姓名和关系列出的家庭成员。电子邮件地址和生日永远不会包含。

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

工具	功能
添加账单 beyondpayday_create_bill	记录新的循环账单，使其计入预算。这会创建一条记录——Beyond Payday 不会移动资金，也无法支付账单。
更新账单 beyondpayday_update_bill	更改现有账单记录的字段。仅更改提供的字段；其他所有内容保持不变。
删除账单 beyondpayday_delete_bill	永久删除账单记录及其与资产和企业的链接。它不会与账单方取消任何内容。
添加收入来源 beyondpayday_create_income	记录新的收入来源，使其计入预算和实得收入数字。补充薪酬——奖金、小费、每日津贴、401(k) 匹配——仍必须在应用中添加。
更新收入来源 beyondpayday_update_income	更改现有收入记录的字段。补充薪酬和工资扣除不能通过连接器编辑。
删除收入来源 beyondpayday_delete_income	永久删除收入记录及其工资扣除。
添加资产 beyondpayday_create_asset	记录新的账户、房产、车辆或投资，使其计入净资产。它不会开设或注资任何内容。
更新资产 beyondpayday_update_asset	更改现有资产记录的字段，例如其当前价值。这编辑的是记录，不会移动资金。
删除资产 beyondpayday_delete_asset	永久删除资产记录。它不会关闭任何真实账户。
添加债务 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 不能通过连接器设置。

安全与隐私

将财务交给助手值得一些细节

你添加连接器

在你的助手中，你粘贴一次 Beyond Payday 服务器地址。它会将你发送到我们这里登录。

你在这里批准

在 Beyond Payday 页面上，以你的身份登录，你选择只读或读写——你也可以拒绝。

助手获得一个受限密钥

它只覆盖你批准的内容。它每小时过期并自动续期，直到你撤销它。

每个请求都会重新检查

你的家庭权限会在每次调用时应用，因此连接器永远无法超出你的权限范围。

我们从不保留答案的副本 我们的日志会记录某个工具是否运行过、是哪一个、是否成功以及耗时多久。不会记录它返回了什么、你问了什么，也不会记录其中的任何数字。

你可以查看并随时终止连接

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

助手的连接如何建立到 Beyond Payday，以及建立后它被允许做什么。

与你已有的权限相同

每次工具调用都会按照应用本身使用的家庭权限系统进行校验。子账户只能访问分配给它的记录，与在应用中的情况完全一致——即使你是 Beyond Payday 的支持人员，也不会因此获得任何额外权限。

有些内容永远不会离开

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

如果你需要，可以只读连接

你在授权界面选择访问级别，并且有一个独立的只读服务器地址，用于那些本就不该提供选择权的连接。

账户级每小时限额

一个连接每小时可以进行 300 次读取调用和 60 次写入调用。限额按 Beyond Payday 账户计算，因此增加更多连接并不会获得更多额度。

撤销立即生效

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

我们记录它运行过，而不是它说了什么

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

如果出现问题，可以关闭它

你可以从设置 → AI 连接中撤销任何连接。在我们这边，管理员可以为单个账户关闭连接器，或者为所有人完全关闭——连接器位于一个紧急开关之后，并且默认处于关闭状态。

常见问题

为什么不直接把数字粘贴到聊天里问？

有三个原因。它不是猜测：你的助手读取的是你实际保存的数字，而不是你记得粘贴的内容或它在聊天中模糊回忆的内容。它有真正的计算器，因此计算更可能正确：税后收入会考虑 FICA、税前和税后扣除以及 1099 收入的预估税，退休计划会运行数千次市场回报的蒙特卡洛模拟，涵盖社会保障（包括配偶和遗属福利）、养老金和年金、最低分配要求、税收、通货膨胀、取款顺序和缩减开支，并给出成功率和结果范围，而不是一个猜测。债务偿还、假设情景和应急计划也以相同方式计算，因此每次询问都会得到相同答案。而且它的记忆比任何单个助手都持久：你的数据存储在 Beyond Payday 中，而不是聊天线程中，因此对话结束时不会丢失任何内容；当你更换 AI 助手时，连接新助手并可以从中断处继续，包括净资产历史记录。

除了聊天本身，我还能获得什么？

你的家庭共享一个计划。配偶可以连接自己的 AI 助手到相同的数据，孩子只能看到分配给他们的账单、收入、资产和债务。你可以验证任何答案：你的助手引用的每个数字也都在你的 Beyond Payday 仪表盘和图表中。即使你不聊天，它也会持续工作，通过电子邮件或推送发送账单到期、发薪日和预估税提醒，以及净资产随时间变化的快照。而且你始终掌控一切：Beyond Payday 与任何银行或卡片都没有连接，因此任何助手都无法移动资金；你可以将连接设为只读；你可以随时从设置 → AI 连接中撤销它；我们记录工具运行过，但从不记录你问了什么或它回答了什么。

这个功能支持哪些助手？

任何支持 MCP 的助手都可以，因为 Beyond Payday 是一个标准 MCP 服务器，没有客户端白名单。Claude 和 Claude Code 可以从其连接器设置中连接。ChatGPT 也可以——你需要先开启开发者模式，而且它的 Deep Research 功能需要自己的搜索和抓取工具，因此 Beyond Payday 的财务工具可能不会在那里显示。Cursor、带 GitHub Copilot 的 VS Code、Windsurf 等也可以以相同方式连接。随着更多助手采用该协议，列表会不断增长。

我的助手实际上能看到什么？

只能看到工具返回的内容，而且只有调用工具时才能看到。这些内容包括你的账单、收入、资产、债务、目标、企业、保存的情景、保存的净资产快照以及简短的个人资料——并按照你在应用中的家庭权限进行过滤。账号号码、雇主识别号、电子邮件地址和生日永远不会出现在结果中。

它能修改我的记录吗？

只有你在授权界面授予了读写权限才可以。如果是只读模式，每个写入工具都会拒绝并提示助手让你重新连接。即使有写入权限，工具也只能在 Beyond Payday 中添加、编辑和删除记录——任何地方都无法移动、发送或支付资金，因为 Beyond Payday 与任何银行或卡片都没有连接。

我可以撤销它吗？

可以，随时都可以，在 Beyond Payday 的设置 → AI 连接中操作。撤销会在连接器的下一个请求时生效。你也可以从助手一侧断开连接，访问密钥在签发后一小时内失效，除非续期。

Beyond Payday 会存储我的对话吗？

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

那孩子的账户呢？

孩子连接自己的账户时，只能看到自己的范围，与在应用中的情况相同：分配给他们的账单、收入、资产和债务。企业和保存的净资产快照对孩子返回为空，保存的情景只能由家庭所有者或配偶读取。

这个功能在哪些 Beyond Payday 套餐上可用？

所有套餐都可用，包括免费版，只要连接器处于预览阶段。唯一的例外是企业工具，它需要包含企业跟踪功能的套餐——这与应用本身的限制相同。你在助手一侧能做什么可能取决于该助手自己的套餐（例如，自定义连接器在某些应用中需要付费层级）。

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

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

你的助手基于你账户中的数字工作，并且可能对这些数字的含义理解错误。它说的任何内容都是信息，而不是财务、税务或投资建议——Beyond Payday 是一个跟踪和规划工具，它或读取它的助手都不能替代合格的专业人士。

给你的助手一些真实可用的数据

在 Beyond Payday 中跟踪你的账单、收入、资产和债务，然后连接一次，想怎么问就怎么问。连接器在预览期间对所有套餐开放。

无需先绑定卡片。已有账户？从设置 → 连接中连接即可。