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 создаёт агентов, которые отвечают в собственном интерфейсе вашего продукта, а не в окне чата: интерактивные интерфейсы, которые сразу приводят клиентов к тому, за чем они пришли, в знакомом им бренде. Всё создаётся на основе интерфейса, дизайн-системы и API, которые уже есть в приложении. Никакой переработки. Работа агентов регулируется: они отображают только одобренные вами компоненты, и это правило применяется при каждом отображении. А ещё агенты размещаются на нашей стороне: вы определяете инструменты, мы запускаем сервер. Один и тот же агент работает в ваших приложениях для iOS, Android и веба, а также в Claude, ChatGPT и на любом MCP-хосте, использующем открытый стандарт MCP.

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

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

Что представляет собой эта демонстрация

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

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

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

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

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

Что находится в этой папке

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

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

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

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

  brew install metabindai/tap/metabind
  metabind --version
  

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

• Для 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. На шаге 3 команда install создаёт проект, только если ни один проект не привязан, а в противном случае устанавливает проект в привязанный — например, после демонстрации 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 используется для аутентификации и прокси Agent, и сервера 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. Укажите учётные данные GitHub Packages для Gradle — либо через переменные окружения (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 Sandbox в 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 — изменение компонента, проверка, отправка и публикация — и правило BEGIN SHARED FEED, которое гарантирует согласованность цифр на всех карточках.
• Демонстрация Retail — те же SDK, но противоположный подход: продуктом становится история диалога.
• Metabind для Apple и Metabind для Android — установка SDK и справочник по API.
• docs.metabind.ai — полные руководства.

Лицензия

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