关于 Cashly
Cashly 提供托管的个人财务 MCP 服务和 REST API,供用户及 AI Agent 管理个人财务记录。它涵盖交易、账户、债务、分期贷款、订阅和待缴账单,访问范围限定为已授权用户的数据。
主要功能
- 01记录和管理收入与支出
- 02跟踪账户、债务和贷款
- 03管理分期贷款与订阅
- 04查看待缴账单和统计数据
- 05通过 MCP 或 REST API 连接
适用场景
- 01记录一笔消费或收入
- 02比较不同月份的支出
- 03查询近期到期账单
- 04记录贷款或订阅付款
MCP 相关
托管的远程 MCP 服务提供读取和管理 Cashly 数据的工具,涵盖交易、债务、账户、分期贷款、订阅和账单。客户端通过 Streamable HTTP 使用 OAuth 2.1 或 API 密钥连接。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://cashly.corenexis.com/api/mcpclaude mcp add --transport http com-corenexis-cashly https://cashly.corenexis.com/api/mcp{"mcpServers":{"com-corenexis-cashly":{"type":"http","url":"https://cashly.corenexis.com/api/mcp"}}}在 Cursor 中打开{"servers":{"com-corenexis-cashly":{"type":"http","url":"https://cashly.corenexis.com/api/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-corenexis-cashly":{"type":"http","url":"https://cashly.corenexis.com/api/mcp"}}}{"mcpServers":{"com-corenexis-cashly":{"serverUrl":"https://cashly.corenexis.com/api/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Cashly API 和 MCP 服务
费用、分期付款和债务跟踪工具,提供 REST API 和远程 MCP 服务。
让 ChatGPT、Claude、n8n 或你自己的 AI Agent 以任意货币读取和记录你的资金情况。
网站 · MCP 指南 · API 文档 · Google Play · MCP 注册表
Cashly 是什么?
Cashly 是一款面向 Android 和 Web 的免费个人理财应用,全球用户均可使用,支持任意货币和时区。它可以跟踪支出和收入、银行账户、信用卡和钱包的实际余额、分期付款和贷款、借出和借入的资金,以及即将到期的账单。它绝不会索要银行登录信息、读取短信或展示广告。
此代码库是 Cashly 开发者接口的公开入口:
| MCP 服务 | https://cashly.corenexis.com/api/mcp - 远程服务,Streamable HTTP,OAuth 2.1 或 API 密钥 |
| REST API | https://cashly.corenexis.com/api/v1 - JSON,x-api-key 标头 |
| Webhooks | 为每次创建、更新和删除操作发送经过签名的事件 |
| n8n | 社区节点 @corenexis/n8n-nodes-cashly |
| 注册表名称 | Official MCP Registry 上的 com.corenexis/cashly |
该服务由 Corenexis 托管。无需安装或运行任何内容:将客户端指向此 URL 即可。
你可以用它做什么
向助手提出诸如此类的请求:
- “记录今天通过 UPI 支付的 450 元杂货费用。”
- “与上个月相比,我这个月在食品上的支出是多少?”
- “未来 7 天内有哪些账单到期?”
- “将本月的汽车贷款分期标记为已支付。”
- “谁欠我钱?每笔还剩多少?”
- “创建一张名为 Travel Card、额度为 2,00,000 的信用卡。”
每项操作都只会处理已登录用户自己的数据,且不会转移真实资金:记录付款只会更新跟踪记录。
快速开始
1. 获取访问权限
- ChatGPT 和其他 OAuth 客户端: 无需密钥。登录 Cashly 并批准访问即可。
- 其他所有情况: 在 Cashly 的 设置 -> 开发者 -> API 密钥 中创建 API 密钥。密钥格式为
cn_cashly_...,权限可以是读写或只读。每个账户最多可创建 5 个密钥。
API、MCP 和 webhook 访问权限包含在 Cashly Pro 和 Pro Plus 方案中。
2. 连接客户端
ChatGPT(OAuth,无需密钥)
- 在 ChatGPT 中,前往 Settings -> Apps (Connectors) -> Advanced,开启 Developer mode。
- 点击 Create app(添加自定义 MCP 服务):
- 名称:
Cashly - 服务 URL:
https://cashly.corenexis.com/api/mcp - 身份验证:OAuth(将客户端 ID 和密钥留空 — ChatGPT 会自行注册)
- 名称:
- 点击 Connect,登录 Cashly 并点击 Allow。如果 ChatGPT 只能查看,请勾选 Read only。
Claude Code
claude mcp add --transport http cashly https://cashly.corenexis.com/api/mcp \
--header "x-api-key: cn_cashly_your_key_here"
Claude Desktop
将以下内容添加到 claude_desktop_config.json(参见 examples/claude_desktop_config.json):
{
"mcpServers": {
"cashly": {
"command": "npx",
"args": [
"-y", "mcp-remote", "https://cashly.corenexis.com/api/mcp",
"--header", "x-api-key:cn_cashly_your_key_here"
]
}
}
}
Cursor、VS Code 和其他 MCP 客户端
任何支持远程 Streamable HTTP 服务的客户端都可以通过以下方式连接:
{
"mcpServers": {
"cashly": {
"url": "https://cashly.corenexis.com/api/mcp",
"headers": { "x-api-key": "cn_cashly_your_key_here" }
}
}
}
n8n
- **工作流:**安装社区节点
@corenexis/n8n-nodes-cashly(Settings -> Community nodes)。 其中包含所有 Cashly 操作以及即时 Webhook 触发器。 - **AI Agent:**添加 MCP Client 节点(或在 AI Agent 节点中使用 MCP Client Tool),传输方式设为
HTTP Streamable,端点为
https://cashly.corenexis.com/api/mcp,并在请求头中设置x-api-key和你的密钥。
curl / 任意 HTTP 客户端
# List the tools
curl -X POST https://cashly.corenexis.com/api/mcp \
-H "x-api-key: cn_cashly_your_key_here" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# Log an expense
curl -X POST https://cashly.corenexis.com/api/mcp \
-H "x-api-key: cn_cashly_your_key_here" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "create_transaction",
"arguments": { "type": "debit", "amount": 500, "category": "Groceries" }
}
}'
MCP 工具
共 71 个工具。读取操作标记为只读,删除操作标记为破坏性操作,因此客户端可以在执行前询问。
| 类别 | 工具 |
|---|---|
| 账户 | get_profile、health_check、get_rate_limit_status、get_usage、get_user、update_user、get_billing_status、get_billing_payments、list_signed_in_devices、list_connected_apps、update_notifications |
| 参考信息和统计 | get_categories、get_payment_methods、get_stats |
| 交易 | list_transactions、get_transaction、create_transaction、update_transaction、delete_transaction |
| 债务(借出和借入) | list_debts、get_debt、create_debt、update_debt、delete_debt、record_debt_payment、settle_debt、add_to_debt、unsettle_debt |
| 账户 | list_accounts,以及银行账户、信用卡、借记卡和钱包的列表/创建/更新/删除操作 |
| 分期付款和贷款 | list_emis、get_emi、get_emi_payments、create_emi、update_emi、delete_emi、record_emi_payment |
| 订阅 | list_subscriptions、get_subscription、get_subscription_payments、create_subscription、update_subscription、delete_subscription、record_subscription_payment |
| 即将到期的账单 | get_upcoming_bills、record_bill_payment、skip_upcoming_bill |
| Webhook | list_webhook_events、list_webhooks、get_webhook、create_webhook、update_webhook、rotate_webhook_secret、delete_webhook、send_webhook_test、list_webhook_deliveries |
包含参数的完整列表:docs/mcp.md。
REST API
基础 URL 为 https://cashly.corenexis.com/api/v1,请求头为 x-api-key: <key>(或 Authorization: Bearer <key>)。
curl https://cashly.corenexis.com/api/v1/transactions \
-H "x-api-key: cn_cashly_your_key_here" \
-H "User-Agent: my-app/1.0"
资源:/me、/usage、/categories、/payment-methods、/stats、/transactions、/debts、
/accounts、/banks、/credit-cards、/debit-cards、/wallets、/emis、/subscriptions、
/upcoming-bills、/webhooks。数据资源支持列表、获取、创建、更新和删除操作。
详情、速率限制和错误代码:docs/rest-api.md。Webhook:docs/webhooks.md。
安全和隐私
- 使用 OAuth 2.1 和 PKCE,以及动态客户端注册;访问令牌有效期为一小时。
- API 密钥可以设为只读;每个请求都仅能访问密钥所有者的数据。
- 可随时在 Settings -> Developer 中撤销密钥和已连接的应用。
- 不需要银行登录信息,不访问短信,不涉及银行卡号。数据绝不会出售或与广告商共享。
链接
- 网站:https://cashly.corenexis.com
- 无需账号即可试用应用:https://cashly.corenexis.com/api/auth/demo
- Android:https://play.google.com/store/apps/details?id=com.corenexis.cashly
- MCP 指南:https://cashly.corenexis.com/developer/mcp
- API 文档:https://cashly.corenexis.com/developer/api
- 支持:https://helpdesk.corenexis.com 或 [email protected]
Cashly 由 Corenexis 开发。此仓库包含文档和示例; Cashly 服务本身由 Corenexis 托管。示例采用 MIT License 发布。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。