关于 CashCtrl MCP by usefulapi
CashCtrl MCP by usefulapi 是用于读取和更新 CashCtrl 会计及业务记录的托管 MCP 服务,涵盖账户、订单、人员、薪资和报表;需要 CashCtrl PRO 账户及 API 用户。
主要功能
- 01查看账户、余额和日记账分录
- 02读取订单、人员及库存商品
- 03查看薪资单和财务期间数据
- 04获取报表数据
- 05创建或修改指定记录
适用场景
- 01核对账户余额和日记账分录
- 02查询订单、联系人及库存
- 03检查薪资单和财务期间
- 04创建日记账分录、订单或人员记录
MCP 相关
通过托管端点向 MCP 客户端提供 CashCtrl 数据查询及部分记录的创建、更新和删除工具。使用用户的 CashCtrl 凭据登录。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://cashctrl.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-cashctrl https://cashctrl.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-cashctrl":{"type":"http","url":"https://cashctrl.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-cashctrl":{"type":"http","url":"https://cashctrl.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-cashctrl":{"type":"http","url":"https://cashctrl.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-cashctrl":{"serverUrl":"https://cashctrl.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
28| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| dir | enum | 否 | 排序方向(每个列表都有自己的默认值)。ASC | DESC |
| sort | string | 否 | 用于排序的列(列表响应中的列名;每个列表都有自己的默认值)。 |
| query | string | 否 | 全文搜索。 |
| filter | array | 否 | 列筛选条件,必须全部匹配(AND)。 |
| category_id | integer | 否 | 仅包含此类别的账户(cashctrl_list_account_categories)。 |
| only_active | boolean | 否 | 仅包含启用的账户。 |
| fiscal_period_id | integer | 否 | 会计期间 ID(cashctrl_list_fiscal_periods);默认值为当前期间。 |
详细介绍
usefulapi 的 CashCtrl MCP
通过 Claude、Cursor 或任何 MCP 客户端使用 CashCtrl——账户和余额、银行账户、日记账分录、订单和发票、人员、商品、工资单、会计期间、税码、货币和报告,还可以记入日记账分录、创建订单和人员、更改订单状态,以及删除日记账分录或订单。需要 CashCtrl PRO 账户和 API 用户。 托管服务,无需本地安装:使用你自己的 CashCtrl 凭据连接。
实时端点: https://cashctrl.usefulapi.io/mcp · 主页: https://usefulapi.io/cashctrl
连接
- Claude(claude.ai、桌面版):打开 Customize → Connectors,点击 + Add → Add custom connector,然后粘贴
https://cashctrl.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http cashctrl https://cashctrl.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"cashctrl": {
"url": "https://cashctrl.usefulapi.io/mcp"
}
}
}
只添加 URL。请勿在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 CashCtrl 凭据。
分步设置说明、凭据查找方式和常见问题:https://usefulapi.io/cashctrl/
工具
| 工具 | 类型 | 功能 |
|---|---|---|
cashctrl_list_accounts | read | 列出账户 |
cashctrl_get_account | read | 获取账户 |
cashctrl_get_account_balance | read | 获取账户余额 |
cashctrl_list_account_categories | read | 列出账户类别 |
cashctrl_list_bank_accounts | read | 列出银行账户 |
cashctrl_list_journal | read | 列出日记账分录 |
cashctrl_get_journal_entry | read | 获取日记账分录 |
cashctrl_list_orders | read | 列出订单 |
cashctrl_get_order | read | 获取订单 |
cashctrl_list_order_categories | read | 列出订单类别 |
cashctrl_list_persons | read | 列出人员 |
cashctrl_get_person | read | 获取人员 |
cashctrl_list_articles | read | 列出库存商品 |
cashctrl_get_article | read | 获取库存商品 |
cashctrl_list_salary_statements | read | 列出工资单 |
cashctrl_get_salary_statement | read | 获取工资单 |
cashctrl_list_fiscal_periods | read | 列出会计期间 |
cashctrl_list_tax_codes | read | 列出税码 |
cashctrl_list_sequence_numbers | read | 列出序列号 |
cashctrl_list_currencies | read | 列出货币 |
cashctrl_get_report_tree | read | 获取报告树 |
cashctrl_get_report_data | read | 获取报告数据 |
cashctrl_create_journal_entry | write | 创建日记账分录 |
cashctrl_delete_journal_entries | write | 删除日记账分录 |
cashctrl_create_order | write | 创建订单 |
cashctrl_update_order_status | write | 更改订单状态 |
cashctrl_delete_orders | write | 删除订单 |
cashctrl_create_person | write | 创建个人或公司 |
cashctrl_usage_status | meta | 使用情况(免费套餐用量计量) |
cashctrl_request_feature | meta | 申请缺失的功能 |
cashctrl_upgrade | meta | 升级到 Pro(无限使用*) |
cashctrl_cancel_subscription | meta | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应在执行前请求确认);meta 工具用于报告使用情况、管理订阅或发送功能申请。
定价
| 方案 | 价格 | 限额 |
|---|---|---|
| 免费版 | $0 | 每月 50 次工具调用 |
| 专业版(按组织计费) | $9/月 或 $90/年(免费赠送 2 个月) | 不限量* |
*专业版在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多,请发送邮件至 [email protected]。
专业版仅适用于此服务。使用 cashctrl_upgrade 订阅(该命令会返回 Stripe Checkout 链接)。可随时使用 cashctrl_cancel_subscription 取消:专业版会持续至付费周期结束,当前周期不予退款;在此之前运行 cashctrl_upgrade 可撤销取消操作。也可以发送邮件至 [email protected]。
许可证
MIT © usefulapi。与 CashCtrl 无关联,也未获其认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。