Banking Assistant (Metabind demo)

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

Demo Finance do Metabind

Um assistente de finanças pessoais sem histórico de conversa. O app faz uma pergunta ao ser iniciado e usa a resposta renderizada como tela inicial; cada pergunta de acompanhamento abre uma interface criada para esse fim. O mesmo assistente é executado nativamente no iOS e no Android a partir de uma única definição de MCP App.

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

O demo Finance em execução no app para iOS.

O que é o Metabind

O Metabind cria agentes que respondem na própria interface do seu produto, não em uma janela de chat: interfaces interativas que levam os clientes diretamente ao que vieram buscar, na marca que já conhecem. Ele é criado com base na interface, no sistema de design e nas APIs que o app já tem. Sem reescrita. É governado: renderiza apenas componentes que você aprovou, com essa regra aplicada a cada renderização. E é hospedado: você define as ferramentas, nós executamos o servidor. O mesmo agente é executado nos seus próprios apps para iOS, Android e web, e também no Claude, ChatGPT e em todos os hosts MCP, com base no padrão aberto MCP.

Este demo mostra a experiência dentro do seu próprio app, renderizada como SwiftUI e Jetpack Compose nativos de verdade por meio do Assistant SDK.

Comece gratuitamente em metabind.ai · Leia a documentação

O que é este demo

Finance é um assistente intencionalmente sem histórico de conversa. Ao iniciar, ele faz uma pergunta — "Para onde foi meu dinheiro este mês?" — e o resultado MCP renderizado é a tela inicial. As perguntas seguintes vêm de uma faixa de opções na parte inferior e abrem em folhas. Cada interação é direcionada a uma interface criada para esse fim, em vez de ser adicionada a uma lista de mensagens com rolagem.

É o oposto de o demo Retail, em que a própria conversa é o produto. Os mesmos SDKs, dois formatos — leia os dois antes de decidir qual se encaixa no seu produto.

Ao seguir este README do início ao fim, você terá:

• O projeto MCP Finance — detalhamentos de gastos, listas de transações, assinaturas e tendências de patrimônio líquido como componentes BindJS sobre dados sintéticos — instalado como um projeto na sua própria organização Metabind.
• O app para iOS em execução com esse projeto.
• O app para Android em execução com o mesmo projeto.

Todos os dados financeiros são sintéticos. Nada aqui se conecta a um banco real, lê um segredo ou chama um host externo.

O que há nesta pasta

Diretório	Conteúdo
apple/	App para iOS em MetabindAI (MetabindAssistant), SDK fixado por tag de versão
android/	App para Android em metabindai-android (MetabindAssistant), SDK fixado no catálogo de versões
mcp/	O projeto MCP Finance: componentes BindJS, ferramentas e feed sintético

Antes de começar

• Uma conta e uma organização Metabind — cadastre-se em metabind.ai/signup.

• A CLI metabind, versão 0.9.0 ou mais recente:

  brew install metabindai/tap/metabind
  metabind --version
  

• Uma chave de API de um provedor de LLM (Anthropic, OpenAI ou Google). O proxy do Metabind Agent a mantém no servidor e executa a conversa com ela — os apps nunca incluem uma chave de provedor.

• Para iOS: Xcode 26+ (o app tem como alvo o iOS 17+).

• Para Android: Android Studio, JDK 17+ e credenciais do GitHub Packages — o GitHub exige autenticação até mesmo para ler um pacote público.

Parte 1 — instalar o projeto MCP

Execute estes comandos neste diretório (finance/).

1. Cadastre-se em metabind.ai se ainda não tiver feito isso — isso cria sua conta e organização. Em seguida, entre na CLI e escolha a organização na qual instalar:

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

   use --clear é importante se você já usou a CLI. install na etapa 3 cria um projeto somente quando nenhum estiver vinculado e, caso contrário, instala no projeto vinculado — por exemplo, após o demo Retail. Definir apenas a organização não libera um projeto vinculado anteriormente; metabind status mostra o escopo ativo.

2. Confira o que a árvore declara antes de criar qualquer coisa:

   metabind inspect --dir mcp
   

   O Finance não declara segredos nem chamadas de saída — inspect permite confirmar isso diretamente na árvore.

3. Instale:

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

   install gera novos IDs para tudo o que cria, registra a origem da árvore e cria apenas rascunhos — nada recebe tráfego até você publicar. Copie o ID do projeto exibido.

4. Defina o escopo da CLI para o novo projeto e configure a chave de LLM do agente:

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

5. Publique:

   metabind publish
   

6. Gere a chave de API usada pelos apps para autenticação:

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

   Copie o valor agora — ele é exibido apenas uma vez, no momento da criação. Uma única chave de API Metabind autentica tanto o proxy do Agent quanto o servidor MCP.

7. Opcionalmente, aplique as configurações do projeto e a miniatura. install cria os componentes e as ferramentas; as configurações em mcp/metabind.jsonc — as instruções do MCP e o prompt de sistema do agente — são aplicadas por 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 reescreve os rascunhos das ferramentas, então publique mais uma vez para liberá-los.

   O project get não é mera formalidade. project update se recusa a gravar uma entidade que a CLI não tenha lido recentemente, para garantir que o projeto não tenha sido alterado enquanto isso:

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

   Um projeto recém-instalado nunca foi lido, então a primeira atualização falha sem esse comando.

   Defina thumbnailUrl depois de enviar as alterações, não antes: project update substitui objetos de configurações aninhados em vez de mesclá-los, então gravar settings.mcp aqui removeria as instruções que push acabou de aplicar.

[!NOTE] Configure os clientes com os IDs de organização e projeto exibidos por install — os IDs internos estáveis, não o slug da organização.

Parte 2 — executar o app para iOS

1. Crie a configuração local, ignorada pelo Git, a partir do modelo:

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

2. Preencha os IDs da Parte 1:

   FINANCE_DEMO_ORG_ID = your_stable_internal_org_id
   FINANCE_DEMO_PROJECT_ID = your_project_id
   

   Deixe FINANCE_DEMO_API_KEY vazio — você informará a chave na primeira inicialização. FINANCE_DEMO_BUNDLE_ID e DEVELOPMENT_TEAM só são necessários para compilações assinadas em dispositivos.

3. Abra o projeto e execute-o (⌘R) em um simulador com iOS 17+:

   open MetabindFinanceDemo.xcodeproj
   

4. Insira sua chave de API Metabind na tela de inicialização e toque em Start. A tela inicial é carregada com a pergunta "Para onde foi meu dinheiro este mês?". Toque em uma pergunta de acompanhamento sugerida ou em Ask anything para abrir a próxima resposta em uma folha.

Para saber mais sobre assinatura, Xcode Cloud, TestFlight e o funcionamento da integração, consulte o README do app para iOS.

Parte 3 — executar o app para Android

1. Forneça credenciais do GitHub Packages ao Gradle, seja por variáveis de ambiente (GITHUB_ACTOR / GITHUB_TOKEN) ou em ~/.gradle/gradle.properties:

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

2. Crie a configuração local, ignorada pelo Git, a partir do modelo e preencha os mesmos IDs da Parte 1:

   cd android
   cp local.properties.example local.properties
   

3. Compile, instale e inicie em um dispositivo ou emulador (API 26+, com o JavaScript Sandbox do WebView disponível — o BindJS executa o código dos componentes em androidx.javascriptengine):

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

4. Insira sua chave de API Metabind e toque em Start — o mesmo fluxo de primeira inicialização do iOS.

Para conhecer a arquitetura do Compose e as diferenças intencionais em relação ao app para iOS, consulte o README do app para Android.

Próximos passos

• Editar o projeto MCP — altere um componente, valide, envie e publique — e conheça a regra BEGIN SHARED FEED que mantém os valores de todos os cartões consistentes.
• O demo Retail — os mesmos SDKs no formato oposto: o histórico de conversa é o produto.
• Metabind para Apple e Metabind para Android — instalação do SDK e referência da API.
• docs.metabind.ai — os guias completos.

Licença

Apache 2.0. Consulte LICENSE e NOTICE na raiz do repositório; apple/, android/ e mcp/ têm cópias próprias porque foram feitos para serem copiados como projetos iniciais.