Banking Assistant (Metabind demo)

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

Demo de Metabind Finance

Un asistente de finanzas personales sin transcripción del chat. La aplicación hace una pregunta al iniciarse y usa la respuesta renderizada como pantalla de inicio; cada pregunta de seguimiento abre una vista diseñada específicamente para ella. El mismo asistente se ejecuta de forma nativa en iOS y Android a partir de una única definición de MCP App.

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

La demo de Finance en ejecución en la aplicación de iOS.

Qué es Metabind

Metabind crea agentes que responden en la propia interfaz de tu producto, no en una ventana de chat: interfaces interactivas que llevan a los clientes directamente a lo que buscan, con la marca que ya conocen. Se crea a partir de la interfaz, el sistema de diseño y las API que la aplicación ya tiene. Sin reescrituras. Está gobernado: solo renderiza componentes que hayas aprobado, y esto se aplica en cada renderizado. Además, está alojado: tú defines las herramientas y nosotros ejecutamos el servidor. El mismo agente se ejecuta dentro de tus propias aplicaciones de iOS, Android y web, y en Claude, ChatGPT y todos los hosts de MCP, sobre el estándar abierto MCP.

Esta demo muestra la parte que se ejecuta dentro de tu propia aplicación, renderizada como SwiftUI y Jetpack Compose nativos mediante Assistant SDK.

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

Qué es esta demo

Finance es un asistente deliberadamente sin transcripción. Al iniciarse, hace una pregunta — «¿Adónde fue a parar mi dinero este mes?» — y el resultado de MCP renderizado es la pantalla de inicio. Las preguntas posteriores se hacen desde una fila de botones en la parte inferior y se abren en hojas. Cada turno se dirige a una vista diseñada específicamente para él, en lugar de desplazarse por una lista de mensajes.

Tiene una estructura opuesta a la demo de Retail, donde la conversación en sí es el producto. Los mismos SDK, dos estructuras: lee ambas antes de decidir cuál se adapta a tu producto.

Al seguir este README de principio a fin, obtendrás:

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

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

Qué hay en esta carpeta

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

Antes de empezar

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

• La CLI de metabind, versión 0.9.0 o posterior:

  brew install metabindai/tap/metabind
  metabind --version
  

• Una clave de API de un proveedor de LLM (Anthropic, OpenAI o Google). El proxy de Metabind Agent la guarda en el servidor y ejecuta la conversación con ella; las aplicaciones nunca incluyen una clave de proveedor.

• Para iOS: Xcode 26+ (la aplicación tiene como objetivo iOS 17+).

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

Parte 1: instala el proyecto de MCP

Ejecuta estos comandos desde este directorio (finance/).

1. Regístrate en metabind.ai si aún no lo has hecho; así crearás tu cuenta y organización. Después, inicia sesión en la CLI y elige la organización en la que quieres instalar el proyecto:

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

   use --clear es importante si ya has usado la CLI. install en el paso 3 crea un proyecto solo si no hay ninguno asociado e instala el proyecto en el que ya esté asociado; por ejemplo, después de la demo de Retail. Establecer solo la organización no libera un proyecto asociado anteriormente; metabind status muestra el ámbito activo.

2. Comprueba qué declara el árbol antes de crear nada:

   metabind inspect --dir mcp
   

   Finance no declara secretos ni llamadas salientes: inspect es la forma de confirmarlo directamente en el árbol.

3. Instala:

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

   install genera identificadores nuevos para todo lo que crea, registra el origen del árbol y solo crea borradores: nada recibe tráfico hasta que lo publiques. Copia el ID del proyecto que muestra.

4. Asocia la CLI al nuevo proyecto y configura la clave de 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 de API con la que iniciarán sesión las aplicaciones:

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

   Copia el valor ahora: solo se muestra una vez, al crearlo. Una clave de API de Metabind autentica tanto el proxy de Agent como el servidor de MCP.

7. Opcionalmente, aplica la configuración del proyecto y la miniatura. install crea los componentes y las herramientas; la configuración de mcp/metabind.jsonc —las instrucciones de MCP y el prompt del sistema del agente— se aplica 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 las herramientas, así que vuelve a publicar para activarlos.

   El project get no es un adorno. project update se niega a escribir una entidad que la CLI no haya leído recientemente, para poder comprobar que el proyecto no haya cambiado mientras tanto:

   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 falla por este motivo.

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

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

Parte 2: ejecuta la aplicación de iOS

1. Crea la configuración local, ignorada por Git, a partir de su plantilla:

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

2. Completa los ID 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: introducirás la clave en el primer inicio. FINANCE_DEMO_BUNDLE_ID y DEVELOPMENT_TEAM solo son relevantes para las compilaciones firmadas en dispositivos.

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

   open MetabindFinanceDemo.xcodeproj
   

4. Introduce tu clave de API de Metabind en la pantalla de inicio y pulsa Start. La pantalla de inicio se carga con la pregunta «¿Adónde fue a parar mi dinero este mes?». Pulsa una pregunta de seguimiento sugerida o Ask anything para abrir la siguiente respuesta en una hoja.

Para obtener información sobre la firma, Xcode Cloud, TestFlight y el funcionamiento de la integración, consulta el README de la aplicación de iOS.

Parte 3: ejecuta la aplicación de Android

1. Proporciona a Gradle las credenciales de GitHub Packages, ya sea mediante 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, a partir de su plantilla y completa los mismos ID de la Parte 1:

   cd android
   cp local.properties.example local.properties
   

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

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

4. Introduce tu clave de API de Metabind y pulsa Start: el mismo flujo de primer inicio que en iOS.

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

Próximos pasos

• Edita el proyecto de MCP: cambia un componente, valídalo, súbelo y publícalo; consulta también la regla BEGIN SHARED FEED, que mantiene coherentes las cifras de todas las tarjetas.
• La demo de Retail: los mismos SDK con una estructura opuesta; la transcripción es el producto.
• Metabind para Apple y Metabind para Android: instalación del SDK y referencia de la 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/ incluyen sus propias copias porque están pensados para copiarse y usarse como plantillas.