PocketSmith Read-only
chính thứcChỉ đọc: giao dịch, ngân sách, dự báo và thông tin chuyên sâu từ công cụ quản lý tài chính cá nhân PocketSmith.
Bạn có thể làm gì với PocketSmith Read Only MCP?
- Kiểm tra tình hình tài chính — Yêu cầu tổng quan về tài sản ròng, tốc độ chi tiêu so với ngân sách và tình trạng ngân sách theo danh mục.
- So sánh chi tiêu — So sánh chi tiêu giữa hai giai đoạn theo danh mục và bên nhận thanh toán để xem có gì thay đổi.
- Phát hiện chi phí định kỳ — Tìm các gói đăng ký và hóa đơn định kỳ, kèm tần suất và tổng chi phí hằng năm.
- Dự báo dòng tiền và tài sản ròng — Dự báo số dư tài khoản và tài sản ròng trong tương lai bằng công cụ dự báo của PocketSmith.
- Tìm kiếm giao dịch — Tra cứu giao dịch theo ngày, danh mục, từ khóa hoặc trạng thái.
- Liên kết trực tiếp — Nhận liên kết đến đúng trang, báo cáo hoặc kết quả tìm kiếm đã lọc trên PocketSmith đang được đề cập.
Máy chủ MCP được lưu trữ
npx add-mcp 'https://mcp-readonly.pocketsmith.com/mcp'Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác
Tài liệu
Máy chủ MCP
Kết nối tài khoản PocketSmith của bạn với bất kỳ trợ lý AI nào hỗ trợ Model Context Protocol.
Kết nối trợ lý AI với PocketSmith thông qua Model Context Protocol (MCP) sẽ cho phép trợ lý truy cập trực tiếp vào dữ liệu tài chính, ngân sách và dự báo của bạn. Trợ lý có thể cung cấp thông tin chuyên sâu và thông tin hữu ích, cũng như thực hiện một số thao tác thay bạn.
Chức năng
Máy chủ MCP của PocketSmith cho phép trợ lý AI đọc và quản lý dữ liệu PocketSmith thay bạn. Thay vì chuyển qua lại giữa trợ lý AI và PocketSmith, bạn có thể đặt câu hỏi và thực hiện thao tác bằng ngôn ngữ tự nhiên:
- Xem lại chi tiêu, ngân sách và giá trị tài sản ròng
- Tìm kiếm và phân loại giao dịch
- Tạo và cập nhật sự kiện ngân sách
- Phân tích xu hướng và so sánh chi tiêu giữa các giai đoạn
- Kiểm tra trạng thái đồng bộ nguồn cấp dữ liệu ngân hàng và yêu cầu làm mới
- Nhận liên kết trực tiếp đến đúng trang hoặc báo cáo trong PocketSmith
Có hai chế độ truy cập:
| Chế độ | Mô tả | Cách kết nối |
|---|---|---|
| Toàn quyền | Tất cả 66 công cụ - đọc, tạo, cập nhật và xóa | Kết nối chỉ bằng một lần nhấp từ thư mục Claude hoặc ChatGPT |
| Chỉ đọc | 40 công cụ chỉ đọc - xem và phân tích, không thay đổi | Thiết lập thủ công dưới dạng trình kết nối tùy chỉnh (thêm vài bước) |
Hầu hết mọi người nên chọn chế độ toàn quyền. Mọi thao tác xóa luôn cần bạn phê duyệt rõ ràng trước, và bạn có thể yêu cầu trợ lý hỏi ý kiến trước khi thực hiện bất kỳ thay đổi nào khác. Hãy chọn chế độ chỉ đọc nếu bạn muốn đảm bảo trợ lý không bao giờ có thể thay đổi dữ liệu của mình.
Kết nối
Chế độ toàn quyền có trong danh sách ứng dụng của Claude và ChatGPT, vì vậy chỉ cần một lần nhấp để kết nối. Chế độ chỉ đọc hiện chưa có trong danh sách của cả hai, nên bạn cần thêm thủ công dưới dạng trình kết nối tùy chỉnh bằng URL trong mục Các ứng dụng MCP khác bên dưới.
Claude (claude.ai, Claude Desktop và ứng dụng di động)
Toàn quyền:
- Mở PocketSmith Complete Access trong thư mục Claude
- Nhấp vào Connect
- Bạn sẽ được chuyển hướng đến PocketSmith để cấp quyền truy cập
Các trình kết nối được liên kết với tài khoản Claude của bạn, vì vậy sau khi kết nối trên claude.ai, PocketSmith cũng sẽ có trong Claude Desktop và các ứng dụng di động Claude.
Chỉ đọc:
- Trên claude.ai hoặc trong Claude Desktop, mở Settings > Connectors
- Nhấp vào Add custom connector
- Nhập tên (ví dụ: "PocketSmith Read-only") và URL
https://mcp-readonly.pocketsmith.com/mcp - Nhấp vào Connect bên cạnh trình kết nối mới, rồi cấp quyền truy cập trong PocketSmith
Claude Code
# Full access
claude mcp add pocketsmith --transport http https://mcp.pocketsmith.com/mcp
# Read-only
claude mcp add pocketsmith-readonly --transport http https://mcp-readonly.pocketsmith.com/mcp
Claude Code sẽ nhắc bạn xác thực qua OAuth trong lần sử dụng đầu tiên.
ChatGPT (chatgpt.com và ứng dụng máy tính)
Toàn quyền:
- Mở PocketSmith trong thư mục ứng dụng ChatGPT trên chatgpt.com
- Nhấp vào Connect
- Bạn sẽ được chuyển hướng đến PocketSmith để cấp quyền truy cập
Các ứng dụng được liên kết với tài khoản ChatGPT của bạn, vì vậy sau khi kết nối trên chatgpt.com, PocketSmith cũng sẽ có trong ứng dụng ChatGPT dành cho máy tính. Nếu ứng dụng không xuất hiện, hãy khởi động lại ứng dụng máy tính.
Chỉ đọc:
Bạn phải thiết lập chế độ chỉ đọc trên chatgpt.com, không phải trong ứng dụng máy tính:
- Mở Settings > Apps & Connectors và bật Developer mode (trong Advanced settings)
- Nhấp vào Create để thêm trình kết nối tùy chỉnh
- Nhập tên (ví dụ: "PocketSmith Read-only") và URL
https://mcp-readonly.pocketsmith.com/mcp - Nhấp vào Connect - bạn sẽ được chuyển hướng đến PocketSmith để cấp quyền truy cập
Không sử dụng tùy chọn Settings > Plugins > Add MCP server trong ứng dụng máy tính - các máy chủ được thêm ở đó chỉ dùng được trong Codex, không dùng được trong ChatGPT.
Không gian làm việc Business/Enterprise/Edu: trước tiên, quản trị viên không gian làm việc phải bật ứng dụng hoặc thêm trình kết nối từ Workspace settings; sau đó, từng người dùng kết nối và cấp quyền cho tài khoản PocketSmith của riêng mình.
Codex
Toàn quyền: nếu bạn đã kết nối PocketSmith từ thư mục ứng dụng ChatGPT, ứng dụng sẽ tự động có trong Codex từ cuộc trò chuyện tiếp theo. Nếu chưa, hãy thêm ứng dụng từ dòng lệnh:
codex mcp add pocketsmith --transport http https://mcp.pocketsmith.com/mcp
Chỉ đọc:
codex mcp add pocketsmith-readonly --transport http https://mcp-readonly.pocketsmith.com/mcp
Codex sẽ nhắc bạn xác thực qua OAuth trong lần sử dụng đầu tiên.
Các ứng dụng MCP khác
| Chế độ | URL |
|---|---|
| Toàn quyền | https://mcp.pocketsmith.com/mcp |
| Chỉ đọc | https://mcp-readonly.pocketsmith.com/mcp |
Bất kỳ ứng dụng MCP nào hỗ trợ truyền tải HTTP và OAuth đều có thể kết nối bằng các URL này. Máy chủ hỗ trợ OAuth 2.0 with PKCE và công bố siêu dữ liệu khám phá tại /.well-known/oauth-authorization-server và /.well-known/oauth-protected-resource.
Xác thực
Quá trình xác thực được xử lý tự động thông qua OAuth. Khi kết nối lần đầu, bạn sẽ được chuyển hướng đến PocketSmith để đăng nhập và cấp quyền truy cập. Trợ lý AI nhận được mã thông báo giới hạn theo chế độ truy cập bạn chọn (toàn quyền hoặc chỉ đọc) và không bao giờ thấy mật khẩu PocketSmith của bạn.
Mã thông báo được mã hóa và không lưu trạng thái - không có dữ liệu nào được lưu trên máy chủ MCP. Bạn có thể thu hồi quyền truy cập bất cứ lúc nào từ trang các ứng dụng được ủy quyền của PocketSmith.
Ví dụ sử dụng
"Tháng này tôi đang tiến triển thế nào?"
Yêu cầu kiểm tra tình hình tài chính để nhận bản tóm tắt tổng quan nhanh:
Bạn: Tình hình tài chính của tôi tháng này thế nào? Tôi có đang theo đúng ngân sách không?
Sử dụng công cụ financial_health_snapshot để trả về giá trị tài sản ròng, tốc độ chi tiêu trong tháng hiện tại so với ngân sách, trạng thái ngân sách theo từng danh mục và các việc cần xử lý như giao dịch chưa phân loại.
"Tôi đang trả tiền cho những dịch vụ đăng ký nào?"
Tìm các khoản phí định kỳ mà bạn có thể đã quên:
Bạn: Bạn có thể tìm tất cả chi phí định kỳ và dịch vụ đăng ký của tôi không? Tôi muốn biết mỗi tháng mình đang trả bao nhiêu và tổng chi phí hằng năm.
Sử dụng công cụ find_recurring_expenses để quét lịch sử giao dịch, xác định các khoản phí thường xuyên theo bên nhận thanh toán, phân loại tần suất và tính tổng chi phí hằng năm.
"So sánh chi tiêu của tôi với tháng trước"
Xem tiền của bạn đã được chi tiêu khác đi như thế nào:
Bạn: So sánh chi tiêu tháng này với tháng trước. Những danh mục nào tăng hoặc giảm?
Sử dụng công cụ spending_comparison để phân tích từng giai đoạn theo danh mục và bên nhận thanh toán, làm nổi bật những thay đổi cũng như các bên nhận thanh toán mới xuất hiện hoặc không còn xuất hiện.
"Xem lại tình hình tài chính tháng Ba"
Nhận bản đánh giá toàn diện cuối tháng:
Bạn: Hãy đánh giá đầy đủ tháng 3 năm 2025 - thu nhập, chi phí, tỷ lệ tiết kiệm và mức độ thực hiện ngân sách của tôi.
Sử dụng công cụ month_end_review để tạo báo cáo chi tiết gồm tóm tắt thu nhập/chi phí, tỷ lệ tiết kiệm, chênh lệch ngân sách theo từng danh mục, các bên nhận thanh toán hàng đầu, giao dịch đáng chú ý và ảnh chụp giá trị tài sản ròng.
"Phân loại các giao dịch gần đây của tôi"
Dọn dẹp các giao dịch chưa được phân loại:
Bạn: Tôi có khá nhiều giao dịch chưa phân loại trong tuần qua. Bạn có thể xem và phân loại giúp tôi không?
Sử dụng list_transactions để tìm các giao dịch chưa phân loại gần đây, sau đó dùng list_categories để xem cây danh mục và update_transaction để gán danh mục phù hợp dựa trên tên bên nhận thanh toán. (Yêu cầu chế độ toàn quyền.)
"Tài khoản tiết kiệm của tôi sẽ có số dư bao nhiêu sau 6 tháng?"
Dự báo số dư tài khoản trong tương lai:
Bạn: Dựa trên ngân sách của tôi, số dư tài khoản tiết kiệm sẽ như thế nào trong 6 tháng tới?
Sử dụng cash_flow_forecast để dự báo số dư trong tương lai bằng công cụ dự báo của PocketSmith, cho biết xu hướng của từng tài khoản và cảnh báo những thời điểm số dư có thể giảm xuống dưới ngưỡng an toàn.
"Đưa tôi đến đó"
Nhận liên kết trực tiếp đến đúng trang hoặc báo cáo trong ứng dụng web PocketSmith:
Bạn: Chi tiêu cho thực phẩm của tôi đã thay đổi thế nào trong năm qua? Hãy gửi liên kết để tôi tự xem chi tiết.
Sử dụng get_trend_analysis để tóm tắt xu hướng, sau đó dùng navigate_to_trends để tạo liên kết sâu đến báo cáo Trends - được lọc sẵn theo danh mục Groceries và khoảng thời gian - để bạn tiếp tục khám phá trong PocketSmith. Mọi công cụ điều hướng đều hoạt động theo cách này: trợ lý trả lời, sau đó gửi cho bạn liên kết đến đúng trang, báo cáo hoặc kết quả tìm kiếm giao dịch mà trợ lý vừa đề cập.
Các công cụ hiện có
Thông tin chuyên sâu (công cụ phân tích tổng hợp)
Các công cụ này kết hợp nhiều lệnh gọi API để tạo ra phân tích phong phú, sẵn sàng sử dụng:
| Công cụ | Chức năng |
|---|---|
financial_health_snapshot | Giá trị tài sản ròng, tốc độ chi tiêu, trạng thái ngân sách, việc cần xử lý |
month_end_review | Đánh giá toàn diện một giai đoạn với thu nhập/chi phí, tỷ lệ tiết kiệm, chênh lệch ngân sách và các bên nhận thanh toán hàng đầu |
spending_comparison | So sánh song song hai giai đoạn theo danh mục và bên nhận thanh toán |
find_recurring_expenses | Phát hiện dịch vụ đăng ký và hóa đơn định kỳ, kèm tổng chi phí hằng năm |
cash_flow_forecast | Dự báo số dư tài khoản trong tương lai, kèm cảnh báo vùng nguy hiểm |
net_worth_forecast | Diễn biến giá trị tài sản ròng với xu hướng lịch sử, dự báo và các mốc dự kiến |
forecast_accuracy | So sánh số dư thực tế với dự báo để đánh giá độ tin cậy của ngân sách |
Lập ngân sách
| Công cụ | Chức năng |
|---|---|
get_budget | Phân tích ngân sách theo từng danh mục trong giai đoạn dự báo |
get_budget_summary | Số liệu thực tế về chi phí/thu nhập so với ngân sách trong một khoảng thời gian |
get_trend_analysis | Xu hướng chi tiêu theo thời gian và theo danh mục |
delete_forecast_cache | Buộc tính toán lại ngân sách sau khi chỉnh sửa hàng loạt |
Giao dịch
| Công cụ | Chức năng |
|---|---|
list_transactions | Tìm kiếm và lọc giao dịch theo ngày, danh mục, từ khóa, trạng thái |
get_transaction | Xem đầy đủ thông tin chi tiết của một giao dịch |
create_transaction | Thêm giao dịch mới |
update_transaction | Chỉnh sửa giao dịch (bên nhận thanh toán, danh mục, nhãn, ghi chú, khoản chia nhỏ) |
delete_transaction | Xóa giao dịch |
Tài khoản và tổ chức tài chính
| Công cụ | Chức năng |
|---|---|
list_accounts | Liệt kê tất cả tài khoản theo người dùng hoặc tổ chức tài chính |
get_account | Xem chi tiết tài khoản, bao gồm số dư và tài khoản con |
create_account / update_account / delete_account | Quản lý tài khoản |
update_account_display_order | Sắp xếp lại tài khoản |
list_institutions / get_institution | Xem các tổ chức tài chính |
create_institution / update_institution / delete_institution | Quản lý tổ chức tài chính |
list_transaction_accounts / get_transaction_account / update_transaction_account | Xem và cập nhật tài khoản giao dịch |
Danh mục và quy tắc
| Công cụ | Chức năng |
|---|---|
list_categories / get_category | Xem hệ thống phân cấp danh mục |
create_category / update_category / delete_category | Quản lý danh mục |
list_category_rules / create_category_rule | Xem và tạo quy tắc tự động phân loại |
Sự kiện ngân sách
| Công cụ | Chức năng |
|---|---|
list_events / get_event | Xem các sự kiện dự báo ngân sách |
create_event / update_event / delete_event | Quản lý các sự kiện ngân sách định kỳ và một lần |
Tệp đính kèm
| Công cụ | Chức năng |
|---|---|
list_attachments / get_attachment | Xem biên lai và tài liệu đính kèm |
create_attachment / update_attachment / delete_attachment | Quản lý tệp đính kèm |
assign_transaction_attachment / unassign_transaction_attachment | Liên kết/hủy liên kết tệp đính kèm với giao dịch |
Nguồn cấp dữ liệu
| Công cụ | Chức năng |
|---|---|
get_data_feeds_connection_status | Kiểm tra trạng thái đồng bộ nguồn cấp dữ liệu ngân hàng và thông tin nhà cung cấp |
refresh_data_feeds_connection | Kích hoạt đồng bộ hóa cho một hoặc tất cả kết nối nguồn cấp dữ liệu ngân hàng |
Điều hướng
Các công cụ này tạo liên kết sâu để trợ lý có thể đưa bạn đến đúng trang PocketSmith cho cuộc trò chuyện — được lọc sẵn theo tài khoản, danh mục và ngày phù hợp, cùng mọi tùy chọn điều khiển khác trên trang cần thiết cho báo cáo.
| Công cụ | Chức năng |
|---|---|
navigate_to_transactions | Tìm kiếm giao dịch, được lọc sẵn theo tài khoản, danh mục, từ khóa hoặc ngày |
navigate_to_budget | Điều hướng đến trang ngân sách, với các thiết lập ngày và tùy chọn khác có thể điều khiển qua liên kết |
navigate_to_trends | Báo cáo xu hướng chi tiêu hoặc thu nhập theo danh mục theo thời gian, với mọi tùy chọn có thể điều khiển qua liên kết |
navigate_to_income_expense | Báo cáo Thu nhập & Chi phí (báo cáo lãi lỗ) với các tùy chọn lọc, phạm vi ngày và tùy chọn khác có sẵn qua liên kết |
navigate_to_cashflows | Báo cáo dòng tiền (bảng theo từng tháng) |
navigate_to_net_worth | Trang Giá trị tài sản ròng, với mọi tùy chọn lọc và tùy chọn khác có sẵn qua liên kết |
navigate_to_calendar | Lịch các sự kiện và số dư ngân sách đã lên lịch và dự báo, cùng phạm vi ngày có sẵn qua liên kết |
navigate_to_account_summary | Tóm tắt tài khoản cho một tài khoản và tháng cụ thể |
Khác
| Công cụ | Chức năng |
|---|---|
get_current_user / update_user | Xem và cập nhật hồ sơ người dùng và cài đặt |
list_labels | Xem tất cả nhãn giao dịch |
list_saved_searches | Xem các bộ lọc tìm kiếm giao dịch đã lưu |
list_currencies / get_currency | Dữ liệu tham chiếu tiền tệ |
list_time_zones | Dữ liệu tham chiếu múi giờ |
Mô hình dữ liệu PocketSmith
Hiểu hệ thống phân cấp của PocketSmith sẽ giúp ích khi đặt câu hỏi:
Institution (e.g. "Sample Bank")
→ Account (container/group, e.g. "Everyday Credit Card")
→ Transaction Account (where transactions live)
→ Scenario (where budget forecast events live)
- Tổ chức tài chính đại diện cho ngân hàng hoặc nhà cung cấp dịch vụ tài chính
- Tài khoản nhóm một hoặc nhiều tài khoản giao dịch và kịch bản
- Tài khoản giao dịch lưu trữ các bản ghi giao dịch thực tế
- Kịch bản lưu trữ các sự kiện ngân sách điều khiển công cụ dự báo của PocketSmith
- Danh mục có cấu trúc phân cấp (cha/con) và được dùng chung cho tất cả tài khoản
- Nhãn là thẻ bạn có thể thêm vào giao dịch để nhóm linh hoạt
Quyền riêng tư & bảo mật
- Chính sách quyền riêng tư của PocketSmith: https://www.pocketsmith.com/legal/privacy-policy/
- Thông tin đăng nhập PocketSmith của bạn không bao giờ được chia sẻ với trợ lý AI
- Mã thông báo OAuth được mã hóa bằng AES-256-GCM và không lưu trạng thái (không có dữ liệu nào được lưu ở phía máy chủ)
- Mọi giao tiếp API đều sử dụng mã hóa TLS
- Bạn có thể thu hồi quyền truy cập bất cứ lúc nào từ các ứng dụng được PocketSmith ủy quyền
Hỗ trợ
- Trợ giúp & hỗ trợ: https://learn.pocketsmith.com
- Liên hệ bộ phận hỗ trợ: help@pocketsmith.com