Cash Page cho AI và lập trình viên
Cho trợ lý AI đọc và ghi sổ Cash Page của bạn qua MCP, hoặc tự viết công cụ với REST API.
Kết nối trợ lý AI
Cash Page có MCP server tại https://cashpage.app/mcp. Thêm địa chỉ này vào ứng dụng AI, đăng nhập Cash Page và bấm Cho phép. Không cần chép khoá.
- Claude (claude.ai, desktop): Settings → Connectors → Add custom connector. Tên: Cash Page. URL: địa chỉ ở trên.
- ChatGPT: Settings → Apps & Connectors → Advanced → bật Developer mode, rồi Create. Tên: Cash Page. URL: địa chỉ ở trên.
- Cursor, VS Code: Dùng nút cài một chạm trong Kết nối AI của app, hoặc thêm URL vào cấu hình MCP.
- Claude Code: Chạy lệnh dưới đây, rồi gõ /mcp để đăng nhập.
claude mcp add --transport http cash-page https://cashpage.app/mcp
Sau đó hỏi như “Quý này tôi chi bao nhiêu cho phần mềm?” hay “Ghi khoản chi 75 USD tiền Figma từ tài khoản Wise USD hôm qua.”
AI làm được gì
Các công cụ AI gọi được. Công cụ ghi chỉ chạy khi bạn cho phép quyền ghi.
get_overviewSổ của bạn, tiền tổng kết, ngày hôm nay và tổng tháng này.list_money_accountsTài khoản tiền kèm loại tiền và số dư.list_categoriesDanh mục thu và chi.list_transactionsTìm giao dịch theo ngày, loại, chữ, tài khoản hoặc danh mục.add_transactionGhi khoản thu, khoản chi hoặc chuyển khoản.update_transactionSửa một giao dịch.delete_transactionXoá một giao dịch.create_categoryTạo danh mục.get_month_summaryTổng thu, chi và còn lại của một tháng.get_profit_and_lossLãi lỗ theo danh mục, so với kỳ trước.get_cash_flowĐầu kỳ, tiền vào/ra và cuối kỳ của từng tài khoản.
REST API
Địa chỉ gốc https://cashpage.app/api/v1. Gửi khoá tạo trong Cài đặt → API và AI dưới dạng Authorization: Bearer cp_key_…. Dùng default thay cho {book} để chỉ sổ đầu tiên. Số tiền là số theo loại tiền của giao dịch (dấu chấm thập phân); tài khoản và danh mục gọi bằng tên được.
- GET
/meHồ sơ, quyền và các sổ của bạn. - GET
/booksDanh sách sổ. - GET
/books/{book}/accountsTài khoản tiền kèm số dư. - GET · POST
/books/{book}/categoriesXem hoặc tạo danh mục. - GET · POST
/books/{book}/transactionsXem (from, to, kind, search, limit) hoặc thêm. - GET · PATCH · DELETE
/books/{book}/transactions/{id}Xem, sửa hoặc xoá một giao dịch. - GET
/books/{book}/reports/summary?month=YYYY-MMTổng tháng. - GET
/books/{book}/reports/profit-and-loss?from&toLãi lỗ. - GET
/books/{book}/reports/cash-flow?from&toDòng tiền.
Ví dụ: thêm một khoản chi
curl -X POST https://cashpage.app/api/v1/books/default/transactions \
-H "Authorization: Bearer cp_key_…" \
-H "Content-Type: application/json" \
-d '{"kind":"expense","amount":75,"currency":"USD",
"account":"Wise USD","category":"Software","note":"Figma"}'Giới hạn và bảo mật
- Gói Miễn phí: 100 lượt gọi API và MCP mỗi ngày (đặt lại lúc 00:00 UTC). Gói Pro: không giới hạn, chặn lạm dụng ở 120 yêu cầu/phút.
- Khoá và token chỉ lưu dạng băm. Thu hồi khoá hay ngắt kết nối ứng dụng bất cứ lúc nào trong Cài đặt.
- Ứng dụng AI kết nối bằng OAuth 2.1 (PKCE). Access token có hạn 1 giờ và tự gia hạn.
- Lỗi trả JSON: { "error": { "code", "message" } } kèm mã HTTP (400, 401, 403, 404, 429).