Banking Assistant (Metabind demo)

npx add-mcp 'https://mcp.metabind.ai/IgJH0BzIn4LlfnCbcDc7/projects/GLbHk5i3GLlIYcF63XFl'

Bản demo Metabind Finance

Trợ lý tài chính cá nhân không có bản ghi hội thoại. Ứng dụng đặt một câu hỏi khi khởi chạy và dùng câu trả lời đã hiển thị làm màn hình chính; mọi câu hỏi tiếp theo đều mở trên một giao diện được thiết kế riêng. Cùng một trợ lý chạy nguyên bản trên iOS và Android từ một định nghĩa MCP App duy nhất.

https://github.com/user-attachments/assets/9a840b88-dc88-4ab4-927e-0a8dc651dbe3

Bản demo Finance đang chạy trong ứng dụng iOS.

Metabind là gì

Metabind xây dựng các tác nhân trả lời ngay trong giao diện sản phẩm của bạn, chứ không phải trong cửa sổ trò chuyện: các giao diện tương tác đưa khách hàng thẳng đến nội dung họ cần, với thương hiệu họ đã quen thuộc. Sản phẩm được xây dựng từ giao diện người dùng, hệ thống thiết kế và API mà ứng dụng đã có. Không cần viết lại. Sản phẩm được quản trị, chỉ hiển thị các thành phần bạn đã phê duyệt và áp dụng quy tắc đó ở mỗi lần hiển thị. Sản phẩm được lưu trữ: bạn định nghĩa các công cụ, chúng tôi chạy máy chủ. Cùng một tác nhân chạy trong các ứng dụng iOS, Android và web của riêng bạn, cũng như trên Claude, ChatGPT và mọi MCP host, theo tiêu chuẩn mở MCP.

Bản demo này cho thấy phần chạy bên trong ứng dụng của riêng bạn, được hiển thị dưới dạng SwiftUI và Jetpack Compose nguyên bản thực sự thông qua Assistant SDK.

Bắt đầu miễn phí tại metabind.ai · Đọc tài liệu

Bản demo này là gì

Finance là một trợ lý được thiết kế có chủ đích để không có bản ghi hội thoại. Một câu hỏi được đặt ra khi khởi chạy — "Tháng này tiền của tôi đã đi đâu?" — và kết quả MCP được hiển thị chính là màn hình chính. Các câu hỏi tiếp theo được chọn từ thanh gợi ý dạng viên thuốc ở dưới cùng và mở trong các trang tính. Mỗi lượt được chuyển đến một giao diện được thiết kế riêng thay vì cuộn trong danh sách tin nhắn.

Đây là hình thái đối lập với bản demo Retail, nơi chính cuộc hội thoại là sản phẩm. Cùng SDK, hai hình thái — hãy đọc cả hai trước khi quyết định hình thái nào phù hợp với sản phẩm của bạn.

Khi làm theo README này từ đầu đến cuối, bạn sẽ có:

• Dự án Finance MCP — các thành phần BindJS cho phân tích chi tiêu, danh sách giao dịch, gói đăng ký và xu hướng giá trị tài sản ròng trên dữ liệu tổng hợp — được cài đặt thành một dự án trong tổ chức Metabind của riêng bạn.
• Ứng dụng iOS chạy với dự án đó.
• Ứng dụng Android chạy với cùng dự án.

Toàn bộ dữ liệu tài chính đều là dữ liệu tổng hợp. Không có gì ở đây kết nối với ngân hàng thật, đọc thông tin bí mật hay gọi đến máy chủ bên ngoài.

Có gì trong thư mục này

Thư mục	Nội dung
apple/	Ứng dụng iOS trên MetabindAI (MetabindAssistant), SDK được ghim theo thẻ phát hành
android/	Ứng dụng Android trên metabindai-android (MetabindAssistant), SDK được ghim trong danh mục phiên bản
mcp/	Dự án Finance MCP: các thành phần BindJS, công cụ và nguồn cấp dữ liệu tổng hợp

Trước khi bắt đầu

• Tài khoản và tổ chức Metabind — đăng ký tại metabind.ai/signup.

• CLI metabind, phiên bản 0.9.0 trở lên:

  brew install metabindai/tap/metabind
  metabind --version
  

• Khóa API của nhà cung cấp LLM (Anthropic, OpenAI hoặc Google). Proxy Metabind Agent lưu khóa ở phía máy chủ và chạy cuộc hội thoại với khóa đó — các ứng dụng không bao giờ đóng gói khóa của nhà cung cấp.

• Với iOS: Xcode 26+ (ứng dụng hỗ trợ iOS 17+).

• Với Android: Android Studio, JDK 17+ và thông tin xác thực GitHub Packages — GitHub yêu cầu xác thực ngay cả khi đọc một gói công khai.

Phần 1 — cài đặt dự án MCP

Chạy các lệnh này từ thư mục này (finance/).

1. Đăng ký tại metabind.ai nếu bạn chưa đăng ký — thao tác này tạo tài khoản và tổ chức của bạn. Sau đó đăng nhập vào CLI và chọn tổ chức để cài đặt vào:

   metabind auth login
   metabind org list
   metabind use --clear
   metabind use --org <org-id>
   

   use --clear rất quan trọng nếu bạn đã từng dùng CLI. install ở bước 3 chỉ tạo dự án khi chưa có dự án nào được liên kết, còn nếu đã có thì sẽ cài đặt vào dự án đang liên kết — chẳng hạn sau bản demo Retail. Chỉ đặt tổ chức sẽ không giải phóng dự án đã liên kết trước đó; metabind status cho biết phạm vi đang hoạt động.

2. Xem cây khai báo những gì trước khi tạo bất cứ thứ gì:

   metabind inspect --dir mcp
   

   Finance không khai báo thông tin bí mật hay lệnh gọi ra ngoài — inspect là cách bạn xác nhận điều đó ngay từ cây.

3. Cài đặt:

   metabind install --dir mcp --name "Banking Assistant" --yes
   

   install tạo id mới cho mọi thứ mà lệnh này tạo, ghi lại nguồn gốc của cây và chỉ tạo các bản nháp — chưa có gì phục vụ lưu lượng cho đến khi bạn phát hành. Sao chép id dự án mà lệnh in ra.

4. Đặt phạm vi CLI vào dự án mới và thiết lập khóa LLM của tác nhân:

   metabind use --project <project-id>
   echo $ANTHROPIC_API_KEY | metabind agent set --provider anthropic --api-key-stdin
   

5. Phát hành:

   metabind publish
   

6. Tạo API key để các ứng dụng dùng khi đăng nhập:

   metabind api-key create --name "Banking Assistant"
   

   Sao chép giá trị ngay bây giờ — giá trị chỉ hiển thị một lần khi tạo. Một API key Metabind xác thực cả proxy Agent lẫn máy chủ MCP.

7. Tùy chọn: áp dụng cài đặt dự án và hình thu nhỏ. install tạo các thành phần và công cụ; các cài đặt trong mcp/metabind.jsonc — hướng dẫn MCP và lời nhắc hệ thống của tác nhân — được áp dụng bằng push:

   metabind asset upload mcp/assets/files/project-thumbnail.png
   metabind sync repair --out mcp --org <org-id> --project <project-id>
   metabind push --out mcp
   metabind project get <project-id>
   metabind project update <project-id> \
     --data '{"settings":{"thumbnailUrl":"<url from asset upload>"}}'
   metabind publish
   

   push viết lại các bản nháp công cụ, vì vậy hãy phát hành thêm một lần nữa để đưa chúng vào hoạt động.

   project get không phải chỉ để trang trí. project update từ chối ghi một thực thể mà CLI chưa đọc gần đây, để có thể xác định dự án chưa bị thay đổi trong lúc bạn thao tác:

   CONFLICT: Refusing project update <project-id>: no recent read recorded.
   

   Dự án bạn vừa cài đặt chưa từng được đọc, nên lần cập nhật đầu tiên sẽ gặp lỗi này nếu không có bước đó.

   Đặt thumbnailUrl sau khi đẩy thay đổi, không phải trước đó: project update thay thế các đối tượng cài đặt lồng nhau thay vì hợp nhất chúng, vì vậy ghi settings.mcp ở đây sẽ xóa các hướng dẫn mà push vừa áp dụng.

[!NOTE] Cấu hình các ứng dụng bằng id tổ chức và dự án mà install đã in ra — các id nội bộ ổn định, không phải slug của tổ chức.

Phần 2 — chạy ứng dụng iOS

1. Tạo cấu hình cục bộ được gitignore từ mẫu:

   cd apple
   cp Config/Local.xcconfig.example Config/Local.xcconfig
   

2. Điền các id từ Phần 1:

   FINANCE_DEMO_ORG_ID = your_stable_internal_org_id
   FINANCE_DEMO_PROJECT_ID = your_project_id
   

   Để trống FINANCE_DEMO_API_KEY — bạn sẽ nhập khóa ở lần khởi chạy đầu tiên. FINANCE_DEMO_BUNDLE_ID và DEVELOPMENT_TEAM chỉ cần thiết cho các bản dựng thiết bị có ký.

3. Mở dự án và chạy (⌘R) trên trình mô phỏng iOS 17+:

   open MetabindFinanceDemo.xcodeproj
   

4. Nhập API key Metabind trên màn hình khởi chạy rồi chạm Start. Màn hình chính tải bằng cách hỏi "Tháng này tiền của tôi đã đi đâu?". Chạm vào một câu hỏi gợi ý tiếp theo hoặc Ask anything để mở câu trả lời tiếp theo trong một trang tính.

Để biết về ký ứng dụng, Xcode Cloud, TestFlight và cách tích hợp hoạt động, xem README của ứng dụng iOS.

Phần 3 — chạy ứng dụng Android

1. Cung cấp thông tin xác thực GitHub Packages cho Gradle, bằng biến môi trường (GITHUB_ACTOR / GITHUB_TOKEN) hoặc trong ~/.gradle/gradle.properties:

   gpr.user=your-github-username
   gpr.key=your-github-token
   

2. Tạo cấu hình cục bộ được gitignore từ mẫu rồi điền cùng các id từ Phần 1:

   cd android
   cp local.properties.example local.properties
   

3. Dựng, cài đặt và khởi chạy trên thiết bị hoặc trình mô phỏng (API 26+, có WebView JavaScript Sandbox — BindJS chạy mã thành phần trong androidx.javascriptengine):

   ./gradlew :app:installDebug
   adb shell am start -n ai.metabind.finance.demo/.MainActivity
   

4. Nhập API key Metabind rồi chạm Start — quy trình khởi chạy lần đầu giống như trên iOS.

Để biết về kiến trúc Compose và những điểm khác biệt có chủ đích so với ứng dụng iOS, xem README của ứng dụng Android.

Tiếp theo nên làm gì

• Chỉnh sửa dự án MCP — thay đổi một thành phần, xác thực, đẩy thay đổi và phát hành — cùng quy tắc BEGIN SHARED FEED giúp các số liệu trên mọi thẻ luôn nhất quán.
• Bản demo Retail — cùng SDK nhưng có hình thái đối lập: bản ghi hội thoại là sản phẩm.
• Metabind cho Apple và Metabind cho Android — hướng dẫn cài đặt SDK và tài liệu tham khảo API.
• docs.metabind.ai — tài liệu hướng dẫn đầy đủ.

Giấy phép

Apache 2.0. Xem LICENSE và NOTICE tại thư mục gốc của kho lưu trữ; apple/, android/ và mcp/ có bản sao riêng vì chúng được thiết kế để sao chép ra ngoài làm bộ khởi đầu.