Banking Assistant (Metabind demo)

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

Metabind Finance demosu

Sohbet dökümü olmayan bir kişisel finans asistanı. Uygulama açılışta tek bir soru sorar ve oluşturulan yanıtı ana ekranı olarak kullanır; sonraki her soru amaca özel bir yüzeyde açılır. Aynı asistan, tek bir MCP App tanımından yerel olarak hem iOS hem de Android'de çalışır.

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

Finance demosu, iOS uygulamasında çalışırken.

Metabind nedir

Metabind, sohbet penceresinde değil, ürününüzün kendi arayüzünde yanıt veren ajanlar geliştirir: müşterileri doğrudan aradıkları şeye götüren, zaten bildikleri markayı taşıyan etkileşimli arayüzler. Uygulamanın zaten sahip olduğu arayüz, tasarım sistemi ve API'ler kullanılarak oluşturulur. Baştan yazmaya gerek yok. Yönetişim altındadır; yalnızca onayladığınız bileşenleri oluşturur ve bu kural her oluşturma işleminde uygulanır. Ayrıca barındırılır: araçları siz tanımlarsınız, sunucuyu biz çalıştırırız. Aynı ajan kendi iOS, Android ve web uygulamalarınızın içinde, ayrıca açık MCP standardını kullanan Claude, ChatGPT ve tüm MCP ana bilgisayarlarında çalışır.

Bu demo, Assistant SDK aracılığıyla gerçek yerel SwiftUI ve Jetpack Compose olarak oluşturulan, kendi uygulamanızın içindeki deneyimi gösterir.

metabind.ai'de ücretsiz başlayın · Belgeleri okuyun

Bu demo nedir

Finance, bilerek sohbet dökümü içermeyen bir asistandır. Açılışta tek bir soru sorulur — "Bu ay param nereye gitti?" — ve oluşturulan MCP sonucu ana ekranın ta kendisidir. Sonraki sorular alttaki hap şeridinden gelir ve sayfalarda açılır. Her tur, mesaj listesinde aşağı kaydırılmak yerine amaca özel bir yüzeye yönlendirilir.

Bu, konuşmanın kendisinin ürün olduğu Retail demosunun tam tersidir. Aynı SDK'lar, iki farklı biçim — ürününüz için hangisinin uygun olduğuna karar vermeden önce ikisini de inceleyin.

Bu README'yi baştan sona izleyerek şunları elde edersiniz:

• Kendi Metabind kuruluşunuza proje olarak yüklenmiş Finance MCP projesi — sentetik veriler üzerinde BindJS bileşenleri olarak harcama dökümleri, işlem listeleri, abonelikler ve net değer eğilimleri.
• Bu projeye bağlanan iOS uygulaması.
• Aynı projeye bağlanan Android uygulaması.

Tüm finansal veriler sentetiktir. Buradaki hiçbir şey gerçek bir bankaya bağlanmaz, gizli bilgi okumaz veya harici bir ana bilgisayarı çağırmaz.

Bu klasörde neler var

Dizin	İçerik
apple/	MetabindAI üzerinde iOS uygulaması (MetabindAssistant), SDK sürüm etiketiyle sabitlenmiştir
android/	metabindai-android üzerinde Android uygulaması (MetabindAssistant), SDK sürüm kataloğunda sabitlenmiştir
mcp/	Finance MCP projesi: BindJS bileşenleri, araçlar ve sentetik veri akışı

Başlamadan önce

• Bir Metabind hesabı ve kuruluşu — şu adresten kaydolun: metabind.ai/signup.

• metabind CLI, 0.9.0 veya üzeri:

  brew install metabindai/tap/metabind
  metabind --version
  

• Bir LLM sağlayıcısının API anahtarı (Anthropic, OpenAI veya Google). Metabind Agent proxy'si anahtarı sunucu tarafında tutar ve konuşmayı bu anahtarla yürütür — uygulamalar sağlayıcı anahtarını hiçbir zaman içermez.

• iOS için: Xcode 26+ (uygulama iOS 17+ sürümünü hedefler).

• Android için: Android Studio, JDK 17+ ve GitHub Packages kimlik bilgileri — GitHub, herkese açık bir paketi okumak için bile kimlik doğrulaması ister.

Bölüm 1 — MCP projesini yükleme

Bunları bu dizinden (finance/) çalıştırın.

1. Henüz kaydolmadıysanız metabind.ai adresinden kaydolun — bu, hesabınızı ve kuruluşunuzu oluşturur. Ardından CLI'da oturum açın ve yükleme yapılacak kuruluşu seçin:

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

   Daha önce CLI'ı kullandıysanız use --clear önemlidir. 3. adımdaki install, yalnızca bağlı bir proje yoksa proje oluşturur; aksi takdirde bağlı projeye yükleme yapar — örneğin Retail demosundan sonra. Yalnızca kuruluşu ayarlamak, daha önce bağlanmış bir projeyi serbest bırakmaz; etkin kapsamı metabind status gösterir.

2. Herhangi bir şey oluşturmadan önce ağaçta nelerin tanımlandığını görün:

   metabind inspect --dir mcp
   

   Finance hiçbir gizli bilgi veya dışarı giden çağrı tanımlamaz — bunu doğrudan ağaçtan doğrulamak için inspect kullanılır.

3. Yükleyin:

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

   install, oluşturduğu her şey için yeni kimlikler üretir, ağacın kaynağını kaydeder ve yalnızca taslaklar oluşturur — yayımlayana kadar hiçbir şey trafik sunmaz. Yazdırdığı proje kimliğini kopyalayın.

4. CLI'ı yeni projeye yönlendirin ve ajanın LLM anahtarını ayarlayın:

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

5. Yayımlayın:

   metabind publish
   

6. Uygulamaların oturum açarken kullanacağı API anahtarını oluşturun:

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

   Değeri şimdi kopyalayın — oluşturulurken yalnızca bir kez gösterilir. Tek bir Metabind API anahtarı hem Agent proxy'sinde hem de MCP sunucusunda kimlik doğrulaması yapar.

7. İsteğe bağlı olarak proje ayarlarını ve küçük resmi uygulayın. install bileşenleri ve araçları oluşturur; mcp/metabind.jsonc içindeki ayarlar — MCP talimatları ve ajan sistem istemi — push tarafından uygulanır:

   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 araç taslaklarını yeniden yazar; bu nedenle bunları yayımlamak için bir kez daha yayımlayın.

   project get süs amaçlı değildir. project update, CLI'ın yakın zamanda okumadığı bir varlığa yazmayı reddeder; böylece projenin siz bakmıyorken değişmediğinden emin olabilir:

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

   Yeni yüklediğiniz proje henüz hiç okunmadığından, ilk güncelleme bu adım olmadan başarısız olur.

   thumbnailUrl ayarını gönderdikten sonra yapın, öncesinde değil: project update iç içe ayar nesnelerini birleştirmek yerine değiştirir; dolayısıyla burada settings.mcp yazmak, push tarafından az önce uygulanan talimatları siler.

[!NOTE] İstemcileri, install tarafından yazdırılan kuruluş ve proje kimlikleriyle yapılandırın — kuruluş kısa adıyla değil, kararlı dahili kimliklerle.

Bölüm 2 — iOS uygulamasını çalıştırma

1. Şablonundan, git tarafından yok sayılan yerel yapılandırma dosyasını oluşturun:

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

2. Bölüm 1'deki kimlikleri girin:

   FINANCE_DEMO_ORG_ID = your_stable_internal_org_id
   FINANCE_DEMO_PROJECT_ID = your_project_id
   

   FINANCE_DEMO_API_KEY alanını boş bırakın — anahtarı ilk açılışta gireceksiniz. FINANCE_DEMO_BUNDLE_ID ve DEVELOPMENT_TEAM yalnızca imzalı cihaz derlemelerinde önemlidir.

3. Projeyi açın ve iOS 17+ simülatöründe çalıştırın (⌘R):

   open MetabindFinanceDemo.xcodeproj
   

4. Açılış ekranında Metabind API anahtarınızı girin ve Start düğmesine dokunun. Ana ekran, "Bu ay param nereye gitti?" sorusunu sorarak yüklenir. Sonraki önerilen sorulardan birine veya Ask anything seçeneğine dokunarak sonraki yanıtı bir sayfada açın.

İmzalama, Xcode Cloud, TestFlight ve entegrasyonun nasıl çalıştığı hakkında bilgi için iOS uygulamasının README dosyasına bakın.

Bölüm 3 — Android uygulamasını çalıştırma

1. GitHub Packages için Gradle kimlik bilgilerini ortam değişkenleri (GITHUB_ACTOR / GITHUB_TOKEN) olarak veya ~/.gradle/gradle.properties dosyasında sağlayın:

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

2. Şablonundan, git tarafından yok sayılan yerel yapılandırma dosyasını oluşturun ve Bölüm 1'deki aynı kimlikleri girin:

   cd android
   cp local.properties.example local.properties
   

3. API 26+ sürümüne sahip bir cihazda veya emülatörde derleyin, yükleyin ve başlatın (WebView JavaScript Sandbox kullanılabilir olmalıdır — BindJS, bileşen kodunu androidx.javascriptengine içinde çalıştırır):

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

4. Metabind API anahtarınızı girin ve Start düğmesine dokunun — iOS'takiyle aynı ilk açılış akışı.

Compose mimarisi ve iOS uygulamasından bilinçli olarak farklılaşan yönler hakkında bilgi için Android uygulamasının README dosyasına bakın.

Sonraki adımlar

• MCP projesini düzenleyin — bir bileşeni değiştirin, doğrulayın, gönderin ve yayımlayın — ayrıca her karttaki rakamların birbiriyle tutarlı olmasını sağlayan BEGIN SHARED FEED kuralını inceleyin.
• Retail demosu — aynı SDK'lar, ancak tam tersi biçim: ürünün kendisi sohbet dökümüdür.
• Apple için Metabind ve Android için Metabind — SDK kurulumu ve API başvurusu.
• docs.metabind.ai — tüm kılavuzlar.

Lisans

Apache 2.0. Depo kökündeki LICENSE ve NOTICE dosyalarına bakın; apple/, android/ ve mcp/ ise başlangıç şablonları olarak kopyalanmaları amaçlandığından kendi kopyalarını içerir.