Banking Assistant (Metabind demo)

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

Demostración de Metabind Finance

Un asistente de finanzas personales sin transcripción de chat. La aplicación hace una pregunta al iniciarse y usa la respuesta renderizada como su pantalla de inicio; cada seguimiento se abre en una superficie diseñada para ese propósito. El mismo asistente se ejecuta de forma nativa en iOS y Android desde una única definición de aplicación MCP.

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

La demostración de Finance, ejecutándose en la aplicación iOS.

Qué es Metabind

Metabind crea agentes que responden en la interfaz propia de tu producto, no en una ventana de chat: interfaces interactivas que llevan a los clientes directamente a lo que buscaban, con la marca que ya conocen. Está construido desde la interfaz, el sistema de diseño y las APIs que la aplicación ya tiene. Sin reescrituras. Está gobernado, renderizando solo componentes que has aprobado, aplicado en cada renderizado. Y está alojado: tú defines las herramientas, nosotros ejecutamos el servidor. El mismo agente se ejecuta dentro de tus propias aplicaciones iOS, Android y web, y en Claude, ChatGPT y cada host MCP, sobre el estándar abierto MCP.

Esta demostración muestra la parte de "dentro de tu propia aplicación", renderizada como SwiftUI nativo y Jetpack Compose a través del SDK de Assistant.

Empieza gratis en metabind.ai · Lee la documentación

Qué es esta demostración

Finance es un asistente deliberadamente sin transcripción. Se hace una pregunta al iniciarse — "¿A dónde fue mi dinero este mes?" — y su resultado MCP renderizado es la pantalla de inicio. Las preguntas posteriores vienen de una barra de píldoras en la parte inferior y se abren en hojas. Cada turno se enruta a una superficie diseñada para ese propósito en lugar de desplazarse en una lista de mensajes.

Es la forma opuesta a la demostración de Retail, donde la conversación en sí es el producto. Mismos SDKs, dos formas — lee ambos antes de decidir cuál es la de tu producto.

Trabajando este README de principio a fin, obtienes:

• El proyecto MCP de Finance — desgloses de gastos, listas de transacciones, suscripciones y tendencias de patrimonio neto como componentes BindJS sobre datos sintéticos — instalado como proyecto en tu propia organización Metabind.
• La aplicación iOS ejecutándose contra ese proyecto.
• La aplicación Android ejecutándose contra el mismo proyecto.

Todos los datos financieros son sintéticos. Nada aquí se conecta a un banco real, lee un secreto o llama a un host externo.

Qué hay en esta carpeta

Directorio	Contenido
apple/	Aplicación iOS en MetabindAI (MetabindAssistant), SDK fijado por etiqueta de versión
android/	Aplicación Android en metabindai-android (MetabindAssistant), SDK fijado en el catálogo de versiones
mcp/	El proyecto MCP de Finance: componentes BindJS, herramientas y el feed sintético

Antes de empezar

• Una cuenta y organización de Metabind — regístrate en metabind.ai/signup.

• El CLI metabind, 0.9.0 o más reciente:

  brew install metabindai/tap/metabind
  metabind --version
  

• Una clave API de proveedor de LLM (Anthropic, OpenAI o Google). El proxy de agente de Metabind la mantiene en el servidor y ejecuta la conversación con ella — las aplicaciones nunca envían una clave de proveedor.

• Para iOS: Xcode 26+ (la aplicación apunta a iOS 17+).

• Para Android: Android Studio, JDK 17+ y credenciales de GitHub Packages — GitHub requiere autenticación incluso para leer un paquete público.

Parte 1 — instalar el proyecto MCP

Ejecuta estos desde este directorio (finance/).

1. Regístrate en metabind.ai si aún no lo has hecho — eso crea tu cuenta y organización. Luego inicia sesión en el CLI y elige la organización en la que instalar:

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

   use --clear importa si has usado el CLI antes. install en el paso 3 crea un proyecto solo cuando no hay ninguno vinculado, e instala en el vinculado en caso contrario — después de la demostración de Retail, por ejemplo. Establecer la organización sola no libera un proyecto vinculado antes; metabind status muestra el ámbito activo.

2. Mira lo que declara el árbol antes de crear nada:

   metabind inspect --dir mcp
   

   Finance no declara secretos ni llamadas salientes — inspect es cómo confirmas eso desde el propio árbol.

3. Instala:

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

   install genera nuevos ids para todo lo que crea, registra de dónde vino el árbol y crea solo borradores — nada sirve tráfico hasta que publiques. Copia el id del proyecto que imprime.

4. Limita el CLI al nuevo proyecto y establece la clave LLM del agente:

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

5. Publica:

   metabind publish
   

6. Genera la clave API con la que inician sesión las aplicaciones:

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

   Copia el valor ahora — se muestra una sola vez, en la creación. Una clave API de Metabind autentica tanto el proxy de agente como el servidor MCP.

7. Opcionalmente, aplica la configuración del proyecto y la miniatura. install crea los componentes y herramientas; la configuración en mcp/metabind.jsonc — las instrucciones MCP y el prompt del sistema del agente — se aplican mediante 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 reescribe los borradores de herramientas, así que publica una vez más para liberarlos.

   El project get no es decorativo. project update se niega a escribir una entidad que el CLI no ha leído recientemente, para poder detectar que el proyecto no se ha movido por debajo de ti:

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

   Un proyecto que acabas de instalar nunca se ha leído, así que la primera actualización activa esto sin él.

   Establece thumbnailUrl después de enviar, no antes: project update reemplaza los objetos de configuración anidados en lugar de fusionarlos, así que escribir settings.mcp aquí eliminaría las instrucciones que push acaba de aplicar.

[!NOTE] Configura los clientes con los ids de organización y proyecto que install imprimió — los ids internos estables, no el slug de la organización.

Parte 2 — ejecutar la aplicación iOS

1. Crea la configuración local ignorada por git desde su plantilla:

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

2. Completa los ids de la Parte 1:

   FINANCE_DEMO_ORG_ID = your_stable_internal_org_id
   FINANCE_DEMO_PROJECT_ID = your_project_id
   

   Deja FINANCE_DEMO_API_KEY vacío — ingresarás la clave en el primer inicio. FINANCE_DEMO_BUNDLE_ID y DEVELOPMENT_TEAM importan solo para compilaciones de dispositivos firmados.

3. Abre el proyecto y ejecútalo (⌘R) en un simulador de iOS 17+:

   open MetabindFinanceDemo.xcodeproj
   

4. Ingresa tu clave API de Metabind en la pantalla de inicio y toca Iniciar. La pantalla de inicio se carga preguntando "¿A dónde fue mi dinero este mes?". Toca un seguimiento sugerido o Pregunta cualquier cosa para abrir la siguiente respuesta en una hoja.

Para la firma, Xcode Cloud, TestFlight y cómo funciona la integración, consulta el README de la aplicación iOS.

Parte 3 — ejecutar la aplicación Android

1. Da a Gradle credenciales para GitHub Packages, ya sea como variables de entorno (GITHUB_ACTOR / GITHUB_TOKEN) o en ~/.gradle/gradle.properties:

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

2. Crea la configuración local ignorada por git desde su plantilla y completa los mismos ids de la Parte 1:

   cd android
   cp local.properties.example local.properties
   

3. Compila, instala e inicia en un dispositivo o emulador (API 26+, con el Sandbox de JavaScript de WebView disponible — BindJS ejecuta código de componentes en androidx.javascriptengine):

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

4. Ingresa tu clave API de Metabind y toca Iniciar — el mismo flujo de primer inicio que en iOS.

Para la arquitectura de Compose y las divergencias deliberadas de la aplicación iOS, consulta el README de la aplicación Android.

A dónde ir después

• Edita el proyecto MCP — cambia un componente, valida, envía y publica, con los scripts de reconciliación que mantienen las cifras de cada tarjeta acordes.
• La demostración de Retail — los mismos SDKs con la forma opuesta: la transcripción es el producto.
• Metabind para Apple y Metabind para Android — instalación del SDK y referencia de API.
• docs.metabind.ai — las guías completas.

Licencia

Apache 2.0. Consulta LICENSE y NOTICE en la raíz del repositorio; apple/, android/ y mcp/ llevan sus propias copias porque están pensados para copiarse como plantillas.