Minitally

在 Claude Code 中接入 Minitally MCP

2026/05/07

Minitally 提供 Streamable HTTP MCP 入口，适合让 Agent 帮你完成轻量记账。Claude Code 和其他 MCP 客户端可以直接连接 https://mn.hekmon.com/mcp，认证使用你的 Minitally API Key。

这个方式适合：你在 Claude Code 里工作时顺手记一笔、搜索消费记忆，或让 Agent 汇总本月支出。

准备内容

  1. 一个 Minitally 账号。
  2. 在 Settings / API Keys 创建的 API Key。
  3. 如果使用当前源码版本，需要本机有 Node.js 和 pnpm。
  4. 本机已安装 Claude Code。

API Key 只放在环境变量或 Claude Code MCP 配置里。不要把 Key 粘贴到 prompt、代码提交、截图或共享日志中。

先验证 CLI 和 MCP

在本仓库根目录执行只读探测：

MINITALLY_API_KEY="mnt_xxx" pnpm --filter @minitally/cli dev expense list --limit 1
MINITALLY_API_KEY="mnt_xxx" pnpm --filter @minitally/cli dev mcp probe --mcp-endpoint https://mn.hekmon.com/mcp
MINITALLY_API_KEY="mnt_xxx" pnpm --filter @minitally/cli dev mcp tools --mcp-endpoint https://mn.hekmon.com/mcp

probe 应返回 minitally-agent，工具列表应包含：

create_expense
search_expenses
list_categories
list_tags
summarize_spending

可以用清晰的 request id 做一次写入测试：

MINITALLY_API_KEY="mnt_xxx" pnpm --filter @minitally/cli dev mcp call create_expense \
  --arg amount=18.5 \
  --arg counterparty="Coffee Shop" \
  --arg note="Claude Code MCP smoke test" \
  --arg requestId="claude-code-mcp-smoke-001" \
  --mcp-endpoint https://mn.hekmon.com/mcp

添加到 Claude Code

Claude Code 支持通过命令添加远程 HTTP MCP server：

claude mcp add --transport http --scope user \
  minitally https://mn.hekmon.com/mcp \
  --header "Authorization: Bearer [REDACTED:api-key]"

server 设置为：

  • Server URL：https://mn.hekmon.com/mcp
  • 认证：Settings / API Keys 里的 Bearer API Key

然后打开 Claude Code，执行：

/mcp

确认 minitally server 已连接。

推荐 prompt

让 Claude Code 做明确、可审计的动作：

Use Minitally to create an expense: 18.5 USD, Coffee Shop, today, note "team sync coffee".
Search Minitally for coffee expenses from this month and summarize the top patterns.

不要一上来就说“整理我的所有账本”这类宽泛指令，除非你希望 Agent 先追问边界。

安全建议

  • 给 Agent 单独创建一把 API Key。
  • 不再使用时，到 Settings / API Keys 撤销它。
  • 测试记录用可识别的 note 或 request id。
  • 确认 App 里来源标签和同步行为正常后，再扩大写入范围。
  • 如果你只想用终端 CLI 记账，参考 docs/Minitally_记账功能安装与接入指南.md。
管理员

管理员