Banking Assistant (Metabind demo)

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

Demonstração do Metabind Finance

Um assistente de finanças pessoais sem transcrição de chat. O aplicativo faz uma pergunta na inicialização e usa a resposta renderizada como tela inicial; cada acompanhamento abre em uma superfície criada para um propósito específico. O mesmo assistente roda nativamente em iOS e Android a partir de uma única definição de aplicativo MCP.

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

O demo de Finance, rodando no aplicativo iOS.

O que é Metabind

A Metabind cria agentes que respondem na interface do seu próprio produto, não em uma janela de chat: interfaces interativas que levam os clientes direto ao que vieram buscar, na marca que eles já conhecem. É construído a partir da interface, do sistema de design e das APIs que o aplicativo já possui. Sem reescrita. É governado, renderizando apenas componentes que você aprovou, aplicado em cada renderização. E é hospedado: você define as ferramentas, nós executamos o servidor. O mesmo agente roda dentro dos seus aplicativos iOS, Android e web, e em Claude, ChatGPT e em todos os hosts MCP, no padrão aberto MCP.

Este demo mostra a parte "dentro do seu próprio aplicativo", renderizada como SwiftUI nativo e Jetpack Compose por meio do SDK do Assistente.

Comece grátis em metabind.ai · Leia a documentação

O que é este demo

Finance é um assistente deliberadamente sem transcrição. Uma pergunta é feita na inicialização — "Para onde foi meu dinheiro este mês?" — e o resultado MCP renderizado é a tela inicial. Perguntas posteriores vêm de uma barra de pílulas na parte inferior e abrem em folhas. Cada turno é roteado para uma superfície criada para um propósito específico, em vez de rolar em uma lista de mensagens.

É o formato oposto ao demo de Retail, onde a própria conversa é o produto. Mesmos SDKs, dois formatos — leia ambos antes de decidir qual é o do seu produto.

Trabalhando neste README de ponta a ponta, você obtém:

• O projeto MCP de 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 aplicativo iOS rodando contra esse projeto.
• O aplicativo Android rodando contra 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/	Aplicativo iOS em MetabindAI (MetabindAssistant), SDK fixado por tag de release
android/	Aplicativo Android em metabindai-android (MetabindAssistant), SDK fixado no catálogo de versões
mcp/	O projeto MCP de Finance: componentes BindJS, ferramentas e o feed sintético

Antes de começar

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

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

  brew install metabindai/tap/metabind
  metabind --version
  

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

• Para iOS: Xcode 26+ (o aplicativo tem como alvo 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 a partir deste 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 no 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 importa se você já usou o CLI antes. install no passo 3 cria um projeto somente quando nenhum está vinculado e instala no vinculado caso contrário — depois do demo de Retail, por exemplo. Definir a org sozinho não libera um projeto vinculado anteriormente; metabind status mostra o escopo ativo.

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

   metabind inspect --dir mcp
   

   Finance não declara segredos nem chamadas de saída — inspect é como você confirma isso a partir da própria árvore.

3. Instale:

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

   install gera novos ids para tudo o que cria, registra de onde a árvore veio e cria apenas rascunhos — nada serve tráfego até você publicar. Copie o id do projeto que ele imprime.

4. Defina o escopo do CLI para o novo projeto e defina a chave 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 com a qual os aplicativos fazem login:

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

   Copie o valor agora — ele é mostrado uma única vez, na criação. Uma chave de API Metabind autentica tanto o proxy do Agente quanto o servidor MCP.

7. Opcionalmente, aplique as configurações do projeto e a miniatura. install cria os componentes e ferramentas; as configurações em mcp/metabind.jsonc — as instruções 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 é decoração. project update se recusa a escrever uma entidade que o CLI não leu recentemente, para que possa detectar que o projeto não mudou por baixo de você:

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

   Um projeto que você acabou de instalar nunca foi lido, então a primeira atualização aciona isso sem ele.

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

[!NOTE] Configure os clientes com os ids de org e projeto que install imprimiu — os ids internos estáveis, não o slug da organização.

Parte 2 — executar o aplicativo 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ê digitará a chave no primeiro lançamento. FINANCE_DEMO_BUNDLE_ID e DEVELOPMENT_TEAM importam apenas para builds de dispositivos assinados.

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

   open MetabindFinanceDemo.xcodeproj
   

4. Digite sua chave de API Metabind na tela de inicialização e toque em Iniciar. A tela inicial carrega perguntando "Para onde foi meu dinheiro este mês?". Toque em um acompanhamento sugerido ou em Pergunte qualquer coisa para abrir a próxima resposta em uma folha.

Para assinatura, Xcode Cloud, TestFlight e como a integração funciona, veja o README do aplicativo iOS.

Parte 3 — executar o aplicativo Android

1. Dê ao Gradle credenciais para o GitHub Packages, seja como 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 código de componente em androidx.javascriptengine):

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

4. Digite sua chave de API Metabind e toque em Iniciar — o mesmo fluxo de primeiro lançamento do iOS.

Para a arquitetura Compose e as divergências deliberadas do aplicativo iOS, veja o README do aplicativo Android.

Para onde ir a seguir

• Edite o projeto MCP — altere um componente, valide, envie e publique, com os scripts de reconciliação que mantêm os valores de cada cartão consistentes.
• O demo de Retail — os mesmos SDKs com o formato oposto: a transcrição é 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. Veja LICENSE e NOTICE na raiz do repositório; apple/, android/ e mcp/ carregam suas próprias cópias porque são destinados a serem copiados como pontos de partida.