手上有一笔收入要记,你可以直接在 Claude 或 Codex 里说:
在 MarginDeck 里,给番茄钟记一笔 2026 年 8 月的 App Store 净收入,1280 美元。缺什么信息先问我。
助手把记录填好,你回到 MarginDeck 看一眼、点保存。之后想知道这个产品赚了多少,也直接在对话里问,不用把数字复制来复制去。
下面从连接开始,一步步走完:记收入、加成本、查利润,最后把一笔服务器费用分给两个产品。文中的产品和金额都是演示用的例子。
先选你正在用的客户端
需要 MarginDeck 1.6.0 或更新版本。打开侧边栏的“AI 连接”,点“开启”,再选择你用的客户端。连接背后用的是 MCP 协议,但你不需要了解它,平时还是在熟悉的聊天窗口里提问。
| 你用的是 | 在 MarginDeck 中选择 | 安装方式 |
|---|---|---|
| Claude 桌面应用 | Claude → Claude Desktop | 保存 .mcpb 安装包,在 Claude 里安装 |
| 终端里的 Claude Code | Claude → Claude Code 命令行 | 复制命令,在终端执行 |
| Codex(桌面应用、命令行或 IDE) | Codex | 复制命令,在终端执行 |
客户端需要和 MarginDeck 装在同一台 Mac 上。
Claude 桌面应用
- 在 MarginDeck 里点“存储 Claude 桌面应用安装包…”,把
.mcpb文件保存下来。 - 在 Claude 桌面应用打开“设置 → 扩展 → 高级设置 → 安装扩展…”,选择刚保存的文件,安装并启用。
- 新建一个对话,发送下一节的连接请求。
菜单和这里不一样的话,可以看 Claude 的本地扩展说明。
Codex 和 Claude Code
先确认已经装好对应客户端的命令行工具。在 MarginDeck 里点“复制命令”,粘贴到终端执行一次。命令里已经带上了 MarginDeck 的位置,直接用就行。
执行完后,Codex 用户重启 Codex,再新建会话;Claude Code 用户在终端运行 claude,打开新会话。
不想用终端的话,也可以展开“手动配置”,选择客户端的配置文件(Codex 是 ~/.codex/config.toml,Claude Code 是 ~/.claude.json),确认 MarginDeck 要添加的条目即可,文件里原有的其他连接不受影响。更多细节见 Codex MCP 文档和 Claude Code MCP 文档。
通常安装一次即可,移动 App 后需要更新连接配置。
发起第一次连接
在 AI 客户端里发送:
调用 MarginDeck get_status,告诉我连接状态;如果需要批准,请显示六位配对码。
当前连接还没批准时,助手会给你一个六位配对码。两分钟内把它输入 MarginDeck 的“AI 连接”页面,选好权限后点“批准”。只想查报表,允许读取财务信息就够了;想让助手帮你记收入、成本或建产品,还要允许它提出记录。
批准后回到聊天里说:
已批准,请继续。
配对页面也会提醒你:业务记录保存在你的 Mac 上,但你授权助手读取的内容,可能由它的服务商处理。
记一笔收入,再加一笔成本
先用一个产品把流程跑通,免费版支持一个未归档产品,够用。
如果还没有“番茄钟”这个产品,先让助手建一个:
在 MarginDeck 中新增一个名叫“番茄钟”的产品,状态为在售,上线日期是 2026 年 5 月 1 日。缺少的信息先问我,准备好后提交给我确认。
回到 MarginDeck 的“AI 连接”页面,核对这条记录并保存。之后每条记录都是这样:助手填好,你来保存。
然后发送开头那笔收入请求。如果这笔收入已经通过 RevenueCat、Stripe 或手动录入记过了,就跳过这步,免得记重。保存后,再加一笔成本:
给番茄钟新增一笔“服务器”成本,每月 20 美元,首次扣费日期为 2026 年 8 月 1 日,100% 归给番茄钟。分类如果还没确定,请先问我。
保存前看一眼周期是不是“每月”。选成一次性的话,只有 8 月会算这 20 美元。
现在问:
查询番茄钟 2026 年 8 月的收入、计划成本和估算贡献利润,用美元显示。
假设番茄钟 8 月只有这两笔记录,结果应该是:
| 收入 | 计划成本 | 估算贡献利润 |
|---|---|---|
| $1,280.00 | $20.00 | $1,260.00 |
贡献利润就是收入减去这个月计入的成本。如果你记的是扣除平台抽成后的净收入,就不要再把抽成当成本记一遍。这个数字用来做经营判断,不是会计或税后利润。
两个产品共用服务器时
这一步需要 Pro。假设你还有一个“剪贴板工具”,也跑在这台服务器上:
把已有的“服务器”成本从 2026 年 8 月起,改为番茄钟 50%、剪贴板工具 50%。请修改原来那笔,不要新增。
保存前看一下生效月份:写 8 月,新比例从 8 月生效,直到下一次分摊变更;只想从下个月开始,就写明下个月。分摊只改变两个产品各自承担多少,这台服务器每月还是 20 美元。
有些开销不一定要分给产品,比如记账工具的订阅,可以把它作为“共享成本”留在整个产品组合层面。怎么定分摊比例,可以参考共同成本分摊指南。
常见问题
下次再用,需要重新安装吗?
不需要。安装会一直保留,但授权只在 MarginDeck 运行期间有效:完全退出 MarginDeck、关闭 AI 连接或撤销权限后,下次要重新配对(只关窗口不算退出)。客户端重启连接时也可能要求重新配对。重新用时先让助手调用 get_status,按提示批准就行。
能在 Claude 网页版或手机上用吗?
不能。这是本机连接,需要在装了 MarginDeck 的那台 Mac 上使用 Claude 桌面应用、Claude Code 或 Codex。
助手说找不到 MarginDeck 的工具?
确认你装的是正在用的那个客户端(Claude 桌面应用和 Claude Code 要分别安装),MarginDeck 正在运行,AI 连接已开启,然后新建一个会话。
客户端显示已连接,却查不到数据?
“已连接”只说明连接通了,还需要在 MarginDeck 里批准访问。
我把 MarginDeck 挪了位置?
从新位置打开 MarginDeck,重新复制命令执行,或者更新手动配置。
MarginDeck 提示已有连接?
先点“恢复连接”。还不行的话,确认没有其他 MarginDeck 副本在运行,再用“替换连接”。
记账和查询跑通后,可以接着做一次月度经营回顾:从组合总额查到单个产品,找出利润变化的原因。