Mini Accountant

Mini Accountant — MCP 设置

通过我们托管的 Model Context Protocol (MCP) 服务，将你的 AI 助手连接到 Mini Accountant 工作区。无需本地设置，也无需 API 密钥 — 该服务托管在远程，并受 OAuth 2.1 保护，因此你只需使用 Mini Accountant 账户登录一次，助手就能代表你操作。

• 服务： mini-accountant
• 传输方式： 可流式传输的 HTTP
• URL： https://mcp.miniaccountant.app/v1beta
• 身份验证： OAuth 2.1 / OIDC（授权码 + PKCE）— 系统会提示你登录。
• 需要登录： 是。该服务的权限范围限定于用户，因此需要登录，且不允许匿名访问。你需要拥有 Mini Accountant 账户；应用可免费下载，核心功能免费，另有可选的应用内订阅。
• 适用对象： 自由职业者和小型企业，包括使用多种货币收款的用户。

你可以做什么

连接后，助手可以：

• 发票 — 创建、读取、更新、删除；添加／更新／移除明细项和交易；更改发票上的客户。
• 客户 — 创建、读取、更新、删除；设置客户的付款方式。
• 费用 — 创建、读取、更新、删除；获取指定时间段的费用。
• 服务 — 管理可重复使用的产品／服务目录。
• 付款设置 — 管理客户引用的付款方式文档。
• 分析 — 运行报告查询；获取指定日期范围内的发票／交易／费用；估算某一时期的税额。
• 账户 — 读取和更新用户个人资料及应用设置。

系统还提供引导式 技能 和 提示词（例如“创建发票”），让助手自动找到合适的工作流。

可以这样向它提问

• “向 Acme 开具设计工作发票，工作 12 小时，每小时 €90。”
• “记录一笔 €400 的柏林行程费用。”
• “我上个月开了多少发票？其中有多少增值税？”
• “添加一位位于美国、使用美元银行转账付款的客户。”
• “哪些发票还没有收到任何付款？”
• “估算我第三季度的税额。”

助手会在你自己的 Mini Accountant 工作区中操作 — 使用的数据与你在 iOS、Android 和 Web 应用中看到的相同。

它不提供的功能

这里有必要明确说明，因为对比表往往会默认情况恰恰相反：

• 不支持定期或定时开票。 你可以一步复制现有发票，副本的日期会设为当天，这是最接近的替代方式。
• 不支持复式记账，也不提供审计跟踪。 这是面向小型企业的开票、费用和报告工具，而不是通用总账系统。
• 不支持工资管理。
• 不支持法定电子发票。 它不会将发票提交到国家电子发票体系，也不会按国家标准格式生成供会计师使用的导出文件。

---

在 Claude Code 中安装（插件）

最快的方式 — 将远程服务作为插件安装，无需手动配置文件。

/plugin marketplace add miniaccountant/mcp-setup
/plugin install mini-accountant@miniaccountant
/reload-plugins

然后运行 /mcp，并在系统提示时完成 OAuth 登录即可 — mini-accountant 工具现在已可在当前会话中使用。

不想使用市场？直接添加服务：

claude mcp add --transport http mini-accountant https://mcp.miniaccountant.app/v1beta

---

从其他客户端连接

使用相同的远程 URL 和 OAuth 登录方式 — 只有配置位置不同。

Claude Desktop / claude.ai connectors

添加指向服务 URL 的自定义连接器：

1. 打开 Settings → Connectors → Add custom connector（claude.ai），或在 Claude Desktop 中打开相应设置。
2. 名称：Mini Accountant
3. URL：https://mcp.miniaccountant.app/v1beta
4. 保存，然后连接；系统提示时使用你的 Mini Accountant 账户登录。

Cursor

添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（单个项目）：

{
  "mcpServers": {
    "mini-accountant": {
      "url": "https://mcp.miniaccountant.app/v1beta"
    }
  }
}

重新加载 Cursor，然后在 Cursor 打开 OAuth 提示时授权该服务。

VS Code（GitHub Copilot / MCP）及其他客户端

任何支持远程／可流式传输 HTTP MCP 服务的客户端都可以使用同一个 端点。使用客户端的 HTTP 服务形式：

{
  "servers": {
    "mini-accountant": {
      "type": "http",
      "url": "https://mcp.miniaccountant.app/v1beta"
    }
  }
}

---

身份验证

该服务实现了 OAuth 2.1 / OpenID Connect，支持：

• Authorization Code 授权 + PKCE (S256)、刷新令牌。
• 动态客户端注册（RFC 7591）——客户端会自动注册。
• 发现文档：
  • https://mcp.miniaccountant.app/.well-known/oauth-authorization-server
  • https://mcp.miniaccountant.app/.well-known/oauth-protected-resource
  • https://mcp.miniaccountant.app/.well-known/openid-configuration

符合规范的 MCP 客户端会自动发现这些信息——你只需要提供服务 URL。 令牌会颁发给你的账户；助手只能查看和更改你的数据。

---

故障排除

• 401 Unauthorized / 再次提示登录——访问令牌已过期 （TTL 为 1 小时）。重新执行客户端的连接／授权操作。
• 未显示工具——确认客户端已完成 OAuth 流程（在 Claude Code 中，运行 /mcp 并确认服务显示为已连接）。
• 工作区错误——退出连接器，然后使用正确的 Mini Accountant 账户重新连接。

支持

• 网站：https://ad.miniaccountant.app
• 支持：[email protected]