Banking Assistant (Metabind demo)

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

Демо Metabind Finance

Персональный финансовый ассистент без чат-транскрипта. Приложение задает один вопрос при запуске и использует полученный ответ как домашний экран; каждый последующий вопрос открывается на специально созданной поверхности. Один и тот же ассистент нативно работает на iOS и Android из одного определения MCP App.

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

Демо Finance, запущенное в приложении iOS.

Что такое Metabind

Metabind создает агентов, которые отвечают в собственном интерфейсе вашего продукта, а не в окне чата: интерактивные интерфейсы, которые сразу ведут клиентов к тому, за чем они пришли, в уже знакомом им бренде. Он построен на основе UI, дизайн-системы и API, которые уже есть в приложении. Без переписывания. Он управляемый: рендерит только компоненты, которые вы одобрили, и это обеспечивается при каждом рендере. И он размещен: вы определяете инструменты, мы запускаем сервер. Тот же агент работает внутри ваших собственных iOS, Android и веб-приложений, а также в Claude, ChatGPT и любом MCP-хосте на открытом стандарте MCP.

Это демо показывает часть «внутри вашего собственного приложения», отрисованную как настоящий нативный SwiftUI и Jetpack Compose через Assistant SDK.

Начать бесплатно на metabind.ai · Читать документацию

Что это за демо

Finance — это намеренно ассистент без транскрипта. Один вопрос задается при запуске — «Куда ушли мои деньги в этом месяце?» — и его отрисованный MCP-результат и есть домашний экран. Последующие вопросы приходят из нижней панели-пилюли и открываются в шторках. Каждый ход направляется на специально созданную поверхность вместо прокрутки в списке сообщений.

Это противоположная форма демо Retail, где сам разговор и есть продукт. Те же SDK, две формы — прочитайте обе, прежде чем решать, какая из них подходит вашему продукту.

Проработав этот README от начала до конца, вы получите:

• MCP-проект Finance — разбивку расходов, списки транзакций, подписки и тренды чистого капитала как BindJS-компоненты на синтетических данных — установленный как проект в вашей собственной организации Metabind.
• Приложение iOS, работающее с этим проектом.
• Приложение Android, работающее с тем же проектом.

Все финансовые данные синтетические. Ничто здесь не подключается к реальному банку, не читает секреты и не вызывает внешний хост.

Что в этой папке

Каталог	Содержимое
apple/	Приложение iOS на MetabindAI (MetabindAssistant), SDK закреплен по тегу релиза
android/	Приложение Android на metabindai-android (MetabindAssistant), SDK закреплен в каталоге версий
mcp/	MCP-проект Finance: BindJS-компоненты, инструменты и синтетический поток данных

Перед началом

• Учетная запись и организация Metabind — зарегистрируйтесь на metabind.ai/signup.

• CLI metabind, версия 0.9.0 или новее:

  brew install metabindai/tap/metabind
  metabind --version
  

• Ключ API провайдера LLM (Anthropic, OpenAI или Google). Прокси-агент Metabind хранит его на серверной стороне и ведет разговор с его помощью — приложения никогда не содержат ключ провайдера.

• Для iOS: Xcode 26+ (приложение поддерживает iOS 17+).

• Для Android: Android Studio, JDK 17+ и учетные данные GitHub Packages — GitHub требует аутентификацию даже для чтения публичного пакета.

Часть 1 — установка MCP-проекта

Выполните эти команды из этого каталога (finance/).

1. Зарегистрируйтесь на metabind.ai, если вы еще не сделали этого — это создаст вашу учетную запись и организацию. Затем войдите в CLI и выберите организацию для установки:

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

   use --clear имеет значение, если вы уже использовали CLI ранее. install на шаге 3 создает проект только тогда, когда ни один не привязан, и устанавливает в привязанный в противном случае — например, после демо Retail. Установка организации сама по себе не освобождает проект, привязанный ранее; metabind status показывает активную область действия.

2. Посмотрите, что объявляет дерево, прежде чем что-либо создавать:

   metabind inspect --dir mcp
   

   Finance не объявляет секретов и исходящих вызовов — inspect — это способ подтвердить это из самого дерева.

3. Установите:

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

   install создает новые идентификаторы для всего, что создает, записывает, откуда пришло дерево, и создает только черновики — ничего не обслуживает трафик, пока вы не опубликуете. Скопируйте идентификатор проекта, который он выведет.

4. Ограничьте CLI новым проектом и задайте ключ LLM агента:

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

5. Опубликуйте:

   metabind publish
   

6. Создайте ключ API, с которым приложения входят в систему:

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

   Скопируйте значение сейчас — оно показывается один раз, при создании. Один ключ API Metabind аутентифицирует и прокси-агента, и MCP-сервер.

7. По желанию примените настройки проекта и миниатюру. install создает компоненты и инструменты; настройки в mcp/metabind.jsonc — MCP-инструкции и системный промпт агента — применяются командой 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 перезаписывает черновики инструментов, поэтому опубликуйте еще раз, чтобы выпустить их.

   project get — не украшение. project update отказывается записывать сущность, которую CLI не читал недавно, чтобы можно было определить, что проект не изменился под вами:

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

   Проект, который вы только что установили, никогда не читался, поэтому первое обновление вызывает это без него.

   Установите thumbnailUrl после отправки, а не до: project update заменяет вложенные объекты настроек, а не объединяет их, поэтому запись settings.mcp здесь удалила бы инструкции, которые push только что применил.

[!NOTE] Настройте клиенты с идентификаторами организации и проекта, которые вывела команда install — стабильными внутренними идентификаторами, а не слагом организации.

Часть 2 — запуск приложения iOS

1. Создайте локальную конфигурацию, игнорируемую git, из ее шаблона:

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

2. Заполните идентификаторы из Части 1:

   FINANCE_DEMO_ORG_ID = your_stable_internal_org_id
   FINANCE_DEMO_PROJECT_ID = your_project_id
   

   Оставьте FINANCE_DEMO_API_KEY пустым — вы введете ключ при первом запуске. FINANCE_DEMO_BUNDLE_ID и DEVELOPMENT_TEAM имеют значение только для сборок на подписанном устройстве.

3. Откройте проект и запустите его (⌘R) на симуляторе iOS 17+:

   open MetabindFinanceDemo.xcodeproj
   

4. Введите ваш ключ API Metabind на экране запуска и нажмите Start. Домашний экран загружается с вопросом «Куда ушли мои деньги в этом месяце?». Нажмите предложенный последующий вопрос или Ask anything, чтобы открыть следующий ответ в шторке.

О подписи, Xcode Cloud, TestFlight и о том, как работает интеграция, см. README приложения iOS.

Часть 3 — запуск приложения Android

1. Предоставьте Gradle учетные данные для GitHub Packages — либо как переменные окружения (GITHUB_ACTOR / GITHUB_TOKEN), либо в ~/.gradle/gradle.properties:

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

2. Создайте локальную конфигурацию, игнорируемую git, из ее шаблона и заполните те же идентификаторы из Части 1:

   cd android
   cp local.properties.example local.properties
   

3. Соберите, установите и запустите на устройстве или эмуляторе (API 26+, с доступной песочницей JavaScript WebView — BindJS выполняет код компонентов в androidx.javascriptengine):

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

4. Введите ваш ключ API Metabind и нажмите Start — тот же процесс первого запуска, что и на iOS.

Об архитектуре Compose и намеренных отличиях от приложения iOS см. README приложения Android.

Куда дальше

• Редактировать MCP-проект — изменить компонент, проверить, отправить и опубликовать, используя скрипты согласования, которые поддерживают согласованность цифр на каждой карточке.
• Демо Retail — те же SDK с противоположной формой: транскрипт и есть продукт.
• Metabind для Apple и Metabind для Android — установка SDK и справочник API.
• docs.metabind.ai — полные руководства.

Лицензия

Apache 2.0. См. LICENSE и NOTICE в корне репозитория; apple/, android/ и mcp/ содержат собственные копии, потому что они предназначены для копирования как стартовые шаблоны.