PocketSmith Read-only

chính thức

Chỉ đọ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ềnTất cả 66 công cụ - đọc, tạo, cập nhật và xóaKết nối chỉ bằng một lần nhấp từ thư mục Claude hoặc ChatGPT
Chỉ đọc40 công cụ chỉ đọc - xem và phân tích, không thay đổiThiế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:

  1. Mở PocketSmith Complete Access trong thư mục Claude
  2. Nhấp vào Connect
  3. 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:

  1. Trên claude.ai hoặc trong Claude Desktop, mở Settings > Connectors
  2. Nhấp vào Add custom connector
  3. Nhập tên (ví dụ: "PocketSmith Read-only") và URL https://mcp-readonly.pocketsmith.com/mcp
  4. 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:

  1. Mở PocketSmith trong thư mục ứng dụng ChatGPT trên chatgpt.com
  2. Nhấp vào Connect
  3. 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:

  1. Mở Settings > Apps & Connectors và bật Developer mode (trong Advanced settings)
  2. Nhấp vào Create để thêm trình kết nối tùy chỉnh
  3. Nhập tên (ví dụ: "PocketSmith Read-only") và URL https://mcp-readonly.pocketsmith.com/mcp
  4. 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ềnhttps://mcp.pocketsmith.com/mcp
Chỉ đọchttps://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_snapshotGiá 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_comparisonSo sánh song song hai giai đoạn theo danh mục và bên nhận thanh toán
find_recurring_expensesPhá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_forecastDự 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_forecastDiễ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_accuracySo 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_budgetPhân tích ngân sách theo từng danh mục trong giai đoạn dự báo
get_budget_summarySố 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_analysisXu hướng chi tiêu theo thời gian và theo danh mục
delete_forecast_cacheBuộ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_transactionsTìm kiếm và lọc giao dịch theo ngày, danh mục, từ khóa, trạng thái
get_transactionXem đầy đủ thông tin chi tiết của một giao dịch
create_transactionThêm giao dịch mới
update_transactionChỉ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_transactionXóa giao dịch

Tài khoản và tổ chức tài chính

Công cụChức năng
list_accountsLiệt kê tất cả tài khoản theo người dùng hoặc tổ chức tài chính
get_accountXem chi tiết tài khoản, bao gồm số dư và tài khoản con
create_account / update_account / delete_accountQuản lý tài khoản
update_account_display_orderSắp xếp lại tài khoản
list_institutions / get_institutionXem các tổ chức tài chính
create_institution / update_institution / delete_institutionQuản lý tổ chức tài chính
list_transaction_accounts / get_transaction_account / update_transaction_accountXem 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_categoryXem hệ thống phân cấp danh mục
create_category / update_category / delete_categoryQuản lý danh mục
list_category_rules / create_category_ruleXem 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_eventXem các sự kiện dự báo ngân sách
create_event / update_event / delete_eventQuả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_attachmentXem biên lai và tài liệu đính kèm
create_attachment / update_attachment / delete_attachmentQuản lý tệp đính kèm
assign_transaction_attachment / unassign_transaction_attachmentLiê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_statusKiể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_connectionKí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_transactionsTì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_trendsBá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_expenseBá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_cashflowsBáo cáo dòng tiền (bảng theo từng tháng)
navigate_to_net_worthTrang 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_calendarLị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_summaryTó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_userXem và cập nhật hồ sơ người dùng và cài đặt
list_labelsXem tất cả nhãn giao dịch
list_saved_searchesXem các bộ lọc tìm kiếm giao dịch đã lưu
list_currencies / get_currencyDữ liệu tham chiếu tiền tệ
list_time_zonesDữ 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ợ