AI 连接

用 Claude 或 Codex,记收入、分摊成本、查产品利润

从第一次连接到查出一笔收入扣除成本后还剩多少,走完 MarginDeck AI 连接的使用流程。

手上有一笔收入要记,你可以直接在 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 桌面应用

  1. 在 MarginDeck 里点“存储 Claude 桌面应用安装包…”,把 .mcpb 文件保存下来。
  2. 在 Claude 桌面应用打开“设置 → 扩展 → 高级设置 → 安装扩展…”,选择刚保存的文件,安装并启用。
  3. 新建一个对话,发送下一节的连接请求。

菜单和这里不一样的话,可以看 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 副本在运行,再用“替换连接”。

记账和查询跑通后,可以接着做一次月度经营回顾:从组合总额查到单个产品,找出利润变化的原因。