Banking Assistant (Metabind demo)

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

Démo Finance de Metabind

Un assistant de finances personnelles sans historique de conversation. L’application pose une question au lancement et utilise la réponse affichée comme écran d’accueil ; chaque question suivante s’ouvre sur une interface conçue à cet effet. Le même assistant fonctionne nativement sur iOS et Android à partir d’une seule définition d’application MCP.

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

La démo Finance, exécutée dans l’application iOS.

Qu’est-ce que Metabind ?

Metabind crée des agents qui répondent dans l’interface de votre propre produit, et non dans une fenêtre de discussion : des interfaces interactives qui mènent les clients directement à ce qu’ils recherchent, dans une marque qu’ils connaissent déjà. La solution s’appuie sur l’interface, le système de conception et les API déjà présents dans l’application. Aucune réécriture. Elle est gouvernée : seuls les composants que vous avez approuvés sont affichés, et cette règle est appliquée à chaque rendu. Elle est également hébergée : vous définissez les outils, nous exécutons le serveur. Le même agent fonctionne dans vos propres applications iOS, Android et web, ainsi que dans Claude, ChatGPT et tous les hôtes MCP, selon la norme ouverte MCP.

Cette démo présente la partie intégrée à votre propre application, affichée sous forme de véritables interfaces SwiftUI et Jetpack Compose natives grâce à l’Assistant SDK.

Commencer gratuitement sur metabind.ai · Lire la documentation

Présentation de cette démo

Finance est un assistant volontairement dépourvu d’historique de conversation. Une question est posée au lancement — « Où est passé mon argent ce mois-ci ? » — et le résultat MCP affiché constitue l’écran d’accueil. Les questions suivantes sont accessibles depuis une rangée de boutons en forme de pilule en bas de l’écran et s’ouvrent dans des feuilles. Chaque échange est dirigé vers une interface conçue à cet effet, plutôt que d’être ajouté à une liste de messages déroulante.

C’est l’inverse de la démo Retail, où la conversation elle-même est le produit. Les mêmes SDK, deux approches : consultez les deux avant de décider laquelle convient à votre produit.

En parcourant ce README du début à la fin, vous obtiendrez :

• Le projet MCP Finance — répartitions des dépenses, listes de transactions, abonnements et tendances de la valeur nette sous forme de composants BindJS reposant sur des données synthétiques — installé comme projet dans votre propre organisation Metabind.
• L’application iOS exécutée avec ce projet.
• L’application Android exécutée avec le même projet.

Toutes les données financières sont synthétiques. Rien ici ne se connecte à une véritable banque, ne lit de secret ni n’appelle un hôte externe.

Contenu de ce dossier

Répertoire	Contenu
apple/	Application iOS sur MetabindAI (MetabindAssistant), SDK épinglé par balise de version
android/	Application Android sur metabindai-android (MetabindAssistant), SDK épinglé dans le catalogue de versions
mcp/	Le projet MCP Finance : composants BindJS, outils et flux synthétique

Avant de commencer

• Un compte et une organisation Metabind — inscrivez-vous sur metabind.ai/signup.

• La CLI metabind, version 0.9.0 ou ultérieure :

  brew install metabindai/tap/metabind
  metabind --version
  

• Une clé API de fournisseur LLM (Anthropic, OpenAI ou Google). Le proxy Agent de Metabind la conserve côté serveur et exécute la conversation avec celle-ci : les applications ne contiennent jamais de clé de fournisseur.

• Pour iOS : Xcode 26+ (l’application cible iOS 17+).

• Pour Android : Android Studio, JDK 17+ et des identifiants GitHub Packages — GitHub exige une authentification même pour lire un package public.

Partie 1 — installer le projet MCP

Exécutez ces commandes depuis ce répertoire (finance/).

1. Inscrivez-vous sur metabind.ai si ce n’est pas déjà fait — cela crée votre compte et votre organisation. Connectez-vous ensuite à la CLI et choisissez l’organisation dans laquelle effectuer l’installation :

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

   use --clear est important si vous avez déjà utilisé la CLI. install à l’étape 3 crée un projet uniquement si aucun n’est associé, et installe le projet dans celui qui est déjà associé — par exemple, après la démo Retail. Définir l’organisation seule ne libère pas un projet associé précédemment ; metabind status affiche le périmètre actif.

2. Vérifiez ce que l’arborescence déclare avant de créer quoi que ce soit :

   metabind inspect --dir mcp
   

   Finance ne déclare aucun secret ni appel sortant — inspect permet de le confirmer à partir de l’arborescence elle-même.

3. Installez :

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

   install génère de nouveaux identifiants pour tout ce qu’il crée, enregistre l’origine de l’arborescence et ne crée que des brouillons : rien ne reçoit de trafic avant la publication. Copiez l’identifiant du projet affiché.

4. Associez la CLI au nouveau projet et définissez la clé LLM de l’agent :

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

5. Publiez :

   metabind publish
   

6. Générez la clé API utilisée par les applications pour s’authentifier :

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

   Copiez la valeur maintenant : elle ne s’affiche qu’une seule fois, lors de sa création. Une seule clé API Metabind authentifie à la fois le proxy Agent et le serveur MCP.

7. Facultatif : appliquez les paramètres du projet et sa miniature. install crée les composants et les outils ; les paramètres de mcp/metabind.jsonc — les instructions MCP et l’invite système de l’agent — sont appliqués par 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 réécrit les brouillons des outils ; publiez donc une nouvelle fois pour les mettre en production.

   Le project get n’est pas une simple formalité. project update refuse de modifier une entité que la CLI n’a pas lue récemment, afin de vérifier que le projet n’a pas changé entre-temps :

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

   Un projet que vous venez d’installer n’a jamais été lu ; sans cette étape, la première mise à jour échoue donc à cette vérification.

   Définissez thumbnailUrl après l’envoi, et non avant : project update remplace les objets de paramètres imbriqués au lieu de les fusionner. Écrire settings.mcp ici supprimerait donc les instructions que push vient d’appliquer.

[!NOTE] Configurez les clients avec les identifiants d’organisation et de projet affichés par install — les identifiants internes stables, et non le slug de l’organisation.

Partie 2 — exécuter l’application iOS

1. Créez la configuration locale ignorée par Git à partir de son modèle :

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

2. Renseignez les identifiants de la partie 1 :

   FINANCE_DEMO_ORG_ID = your_stable_internal_org_id
   FINANCE_DEMO_PROJECT_ID = your_project_id
   

   Laissez FINANCE_DEMO_API_KEY vide : vous saisirez la clé au premier lancement. FINANCE_DEMO_BUNDLE_ID et DEVELOPMENT_TEAM ne sont nécessaires que pour les versions signées sur appareil.

3. Ouvrez le projet et exécutez-le (⌘R) sur un simulateur iOS 17+ :

   open MetabindFinanceDemo.xcodeproj
   

4. Saisissez votre clé API Metabind sur l’écran de lancement et touchez Start. L’écran d’accueil s’affiche après avoir posé la question « Où est passé mon argent ce mois-ci ? ». Touchez une question de suivi suggérée ou Ask anything pour ouvrir la réponse suivante dans une feuille.

Pour la signature, Xcode Cloud, TestFlight et le fonctionnement de l’intégration, consultez le README de l’application iOS.

Partie 3 — exécuter l’application Android

1. Fournissez à Gradle les identifiants GitHub Packages, soit sous forme de variables d’environnement (GITHUB_ACTOR / GITHUB_TOKEN), soit dans ~/.gradle/gradle.properties :

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

2. Créez la configuration locale ignorée par Git à partir de son modèle, puis renseignez les mêmes identifiants que dans la partie 1 :

   cd android
   cp local.properties.example local.properties
   

3. Compilez, installez et lancez l’application sur un appareil ou un émulateur (API 26+, avec le bac à sable JavaScript de WebView disponible — BindJS exécute le code des composants dans androidx.javascriptengine) :

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

4. Saisissez votre clé API Metabind et touchez Start — le même parcours de premier lancement que sur iOS.

Pour l’architecture Compose et les différences délibérées par rapport à l’application iOS, consultez le README de l’application Android.

Et ensuite ?

• Modifier le projet MCP — changer un composant, valider, envoyer et publier — et découvrir la règle BEGIN SHARED FEED qui garantit la cohérence des chiffres de chaque carte.
• La démo Retail — les mêmes SDK, mais avec l’approche opposée : le produit, c’est l’historique de conversation.
• Metabind pour Apple et Metabind pour Android — installation des SDK et référence de l’API.
• docs.metabind.ai — les guides complets.

Licence

Apache 2.0. Consultez LICENSE et NOTICE à la racine du dépôt ; apple/, android/ et mcp/ contiennent leurs propres copies, car ils sont destinés à être copiés comme projets de démarrage.