Máy chủ MCP của Lipi
Cập nhật lần cuối:
Đây là bản dịch tham khảo. Bản tiếng Anh là bản có giá trị pháp lý.
Tóm tắt. Lipi có một máy chủ MCP từ xa tại
https://api.lipi.com.np/mcp. Hãy thêm nó vào trợ lý AI của bạn, đăng nhập Lipi và chọn Chỉ đọc hoặc Toàn quyền. Khi đó trợ lý có thể trả lời các câu hỏi về tiền bạc của bạn và, với Toàn quyền, giữ sổ sách của bạn luôn cập nhật. Bạn có thể xem mọi hành động của trợ lý và ngắt kết nối bất cứ lúc nào trong Lipi tại Cài đặt → Trợ lý AI.
Máy chủ làm được gì
Máy chủ MCP của Lipi cho phép trợ lý AI dùng sổ sách Lipi của bạn: tài khoản, chi tiêu và thu nhập, ngân sách, khoản vay ngân hàng và EMI, sổ vay mượn, chia tiền, tài sản, hóa đơn và báo cáo. Bạn có thể hỏi những câu như:
- Tháng này tôi chi bao nhiêu cho ăn uống so với tháng trước?
- Ngân sách nào của tôi sắp vượt?
- Tài sản ròng của tôi là bao nhiêu, và bao nhiêu phần thay đổi là do tỷ giá đô la biến động?
- Thêm Rs 1,250 tiền tạp hóa tại Bhatbhateni hôm nay từ tài khoản Nabil của tôi.
- Đây là ảnh sao kê khoản vay mua nhà của tôi, hãy cập nhật lịch EMI.
Trợ lý làm được những gì bạn làm được trong ứng dụng Lipi, với cùng các bước kiểm tra và giới hạn của gói, và không hơn. Bạn cần có tài khoản Lipi. Đăng ký miễn phí.
Kết nối
URL máy chủ giống nhau ở mọi nơi:
https://api.lipi.com.np/mcp
Lần đầu trợ lý kết nối, nó mở trang đăng nhập Lipi trong trình duyệt của bạn. Hãy đăng nhập, chọn mức truy cập và chọn Cho phép.
Claude (claude.ai, máy tính và điện thoại)
- Mở Settings → Connectors và chọn Add custom connector.
- Đặt tên là
Lipi, dán URL máy chủ và chọn Add. - Chọn Connect và đăng nhập Lipi.
Claude Code
Cài plugin Lipi. Plugin thêm máy chủ và các kỹ năng tùy chọn như đánh giá hằng tháng và dự báo dòng tiền:
/plugin marketplace add LipiTechnology/lipi-expense-tracker
/plugin install lipi-expense-tracker@lipi
Sau đó chạy /mcp, chọn lipi và đăng nhập. Để chỉ thêm máy chủ, hãy chạy claude mcp add --transport http lipi https://api.lipi.com.np/mcp.
ChatGPT
Lipi có trong thư mục plugin của ChatGPT, nên bạn không cần URL máy chủ hay chế độ nhà phát triển. Các bước giống nhau trên web, ứng dụng máy tính và ứng dụng điện thoại.
- Trong ChatGPT, mở Plugins ở thanh bên (hoặc mở Lipi trong thư mục Plugins).
- Mở Lipi, chọn Install plugin, rồi Connect.
- Khi ChatGPT chuyển bạn sang Lipi, hãy đăng nhập, chọn mức truy cập và chọn Cho phép.
Để dùng trong một cuộc trò chuyện, gõ @Lipi, hoặc chọn + rồi chọn Lipi. ChatGPT cũng tự dùng Lipi khi bạn hỏi về tiền bạc. Để ngắt kết nối, mở Settings → Plugins, chọn Lipi và chọn Disconnect, hoặc gỡ nó trong Lipi tại Cài đặt → Trợ lý AI.
Các trợ lý khác
Mọi ứng dụng khách hỗ trợ máy chủ MCP từ xa qua Streamable HTTP với OAuth đều dùng được. Ví dụ:
| Trợ lý | Tệp | Thêm |
|---|---|---|
| Cursor | ~/.cursor/mcp.json |
{ "mcpServers": { "lipi": { "url": "https://api.lipi.com.np/mcp" } } } |
| VS Code (GitHub Copilot) | .vscode/mcp.json |
{ "servers": { "lipi": { "type": "http", "url": "https://api.lipi.com.np/mcp" } } } |
| Codex | ~/.codex/config.toml |
[mcp_servers.lipi] với url = "https://api.lipi.com.np/mcp", rồi codex mcp login lipi |
| Gemini CLI | ~/.gemini/settings.json |
{ "mcpServers": { "lipi": { "httpUrl": "https://api.lipi.com.np/mcp" } } } |
Plugin, kỹ năng và cách thiết lập cho nhiều trợ lý hơn có trên GitHub.
Mức truy cập
Bạn chọn một mức khi kết nối, và có thể đổi sau trong Lipi tại Cài đặt → Trợ lý AI.
- Chỉ đọc (mặc định). Trợ lý có thể xem tài khoản, giao dịch, ngân sách, khoản vay, tài sản, hóa đơn và báo cáo của bạn. Nó không thể thay đổi gì.
- Toàn quyền. Trợ lý còn có thể thêm, sửa và xóa bản ghi. Mọi thao tác ghi đều qua cùng các bước kiểm tra và giới hạn của gói như trong ứng dụng.
Với cả hai mức, trợ lý không bao giờ thấy được mật khẩu của bạn, không đổi được thông tin đăng nhập của bạn và không xóa được tài khoản Lipi của bạn. Lipi yêu cầu trợ lý hỏi bạn trước khi xóa bất cứ thứ gì và cho bạn xem những gì nó sẽ ghi trước khi thay đổi hàng loạt.
Công cụ
Mỗi công cụ đều được gắn nhãn cho trợ lý của bạn: công cụ đọc được đánh dấu chỉ đọc, công cụ xóa được đánh dấu có tính phá hủy, và không công cụ nào vươn ra ngoài dữ liệu Lipi của chính bạn. Một số công cụ cần Premium; ở gói Miễn phí, chúng sẽ nói rõ điều đó thay vì trả lời.
| Nhóm | Đọc | Ghi (Toàn quyền) |
|---|---|---|
| Khởi đầu và hồ sơ | get_overview, get_plan, get_settings, list_notifications, search |
update_settings, mark_notifications_read |
| Tài khoản | list_accounts, get_account, get_account_balance_trend |
create_account, update_account, delete_account |
| Danh mục | list_categories |
create_category, update_category, delete_category |
| Giao dịch | list_transactions, get_transaction, get_transaction_summary |
create_transaction, create_transactions, create_transfer, update_transaction, delete_transaction |
| Ngân sách | list_budgets, get_budget_progress |
create_budget, update_budget, delete_budget |
| Báo cáo | get_cash_flow, get_savings_rate, get_net_worth_trend, get_spending_forecast, get_recurring_expenses, get_category_movers, get_bills_radar, get_unusual_spend, get_spending_by_intent, get_intent_trend, get_activity_log |
export_transactions_csv |
| Định kỳ và đã lên lịch | list_recurring, list_scheduled |
create_recurring, update_recurring, toggle_recurring, post_recurring_now, delete_recurring, create_scheduled, update_scheduled, post_scheduled_now, cancel_scheduled, delete_scheduled |
| Khoản vay ngân hàng và EMI | list_bank_loans, get_bank_loan |
save_bank_loan, set_bank_loan_rows, pay_bank_loan_rows, unpay_bank_loan_rows, save_bank_loan_event, delete_bank_loan_event, delete_bank_loan |
| Sổ vay mượn | list_ledgers, get_ledger |
save_ledger, save_ledger_entry, delete_ledger_entry, delete_ledger |
| Chia tiền | list_splits, get_split, get_splits_summary |
create_split, update_split, record_split_settlement |
| Tài sản | list_assets, get_asset_summary |
create_asset, update_asset, delete_asset |
| Hóa đơn | list_invoices, get_invoice, list_clients, list_identities |
create_invoice, update_invoice, set_invoice_status, record_invoice_payment, save_client, delete_invoice |
| Biên lai và tệp | get_scan, read_document |
scan_receipt, attach_file |
| Tỷ giá và thị trường | list_currencies, get_exchange_rates, convert_currency, get_metal_prices, get_nepse_index |
Máy chủ cũng cung cấp một tài nguyên hướng dẫn, lipi://guide, với đầy đủ các quy trình, và hai lời nhắc mẫu: đánh giá hằng tháng và nhập lịch trả nợ khoản vay.
Quy ước
- Tiền là chuỗi số thập phân như
"1500.00", theo loại tiền của tài khoản. - Ngày theo lịch Gregory,
YYYY-MM-DD. Nếu bạn nói theo Bikram Sambat, trợ lý sẽ quy đổi và nên nói rõ nó đang dùng lịch nào. - Khoản chi ra thuộc một trong ba nhóm: chi tiêu, loại trừ (bảo hiểm, đầu tư, gốc khoản vay) hoặc thuế. Các tổng số cho biết chúng bao gồm nhóm nào.
- Chuyển tiền giữa các tài khoản của chính bạn là một lần chuyển khoản, không phải một khoản chi tiêu cộng một khoản thu nhập.
- Tỷ giá được lấy theo ngày của giao dịch, không phải hôm nay.
Đăng nhập và bảo mật
- Máy chủ dùng OAuth 2.1 với PKCE (S256) và đăng ký ứng dụng khách động. Địa chỉ khám phá là
https://api.lipi.com.np/.well-known/oauth-authorization-servervàhttps://api.lipi.com.np/.well-known/oauth-protected-resource/mcp. - Mỗi token được gắn với
https://api.lipi.com.np/mcpvà không dùng được ở nơi nào khác. - Token truy cập có hiệu lực 1 giờ. Token làm mới có hiệu lực 90 ngày và được đổi mới mỗi lần dùng.
- Mỗi kết nối được gửi tối đa 120 yêu cầu mỗi phút.
- Trợ lý của bạn không bao giờ thấy mật khẩu Lipi của bạn. Bạn đăng nhập trên trang riêng của Lipi.
Xem hoạt động và ngắt kết nối
Mở Lipi và vào Cài đặt → Trợ lý AI. Tại đó bạn xem được từng trợ lý đã kết nối, quyền truy cập bạn đã cấp, lần dùng gần nhất, và nhật ký mọi hành động nó đã thực hiện. Nhật ký được lưu 30 ngày.
Chọn Ngắt kết nối để dừng một trợ lý ngay lập tức. Nó không thể kết nối lại nếu không hỏi bạn lần nữa.
Quyền riêng tư
Khi bạn hỏi trợ lý một điều gì đó, các bản ghi Lipi cần thiết để trả lời sẽ được gửi đến nhà cung cấp của trợ lý đó, chẳng hạn Anthropic hoặc OpenAI. Điều xảy ra với chúng ở đó thuộc thỏa thuận giữa bạn và nhà cung cấp ấy. Những gì Lipi lưu về mỗi kết nối nằm trong chính sách quyền riêng tư của chúng tôi. Việc dùng máy chủ thuộc điều khoản dịch vụ của chúng tôi.
Khắc phục sự cố
- Trợ lý nói nó không thể thay đổi. Bạn đã kết nối với mức Chỉ đọc. Hãy đổi sang Toàn quyền trong Cài đặt → Trợ lý AI.
- Một công cụ báo cần Premium. Tính năng đó thuộc Premium, giống như trong ứng dụng.
- Đăng nhập cứ bị hỏi lại. Quyền truy cập của bạn đã bị ngắt hoặc token làm mới đã hết hạn sau 90 ngày không dùng. Hãy kết nối lại.
- Số tiền trông sai. Hãy kiểm tra loại tiền của tài khoản và nhóm khoản chi. Các tổng số theo loại tiền mặc định dùng tỷ giá của ngày mỗi giao dịch.
Hỗ trợ
Gửi email tới support@lipi.com.np. Với câu hỏi về quyền riêng tư, gửi email tới privacy@lipi.com.np.
Lipi Technology, Balkumari-9, Lalitpur, Nepal (số đăng ký công ty 610048917) vận hành Lipi và máy chủ MCP của Lipi. Email chính thức: info@lipi.com.np.