TanStack AI ajanları artık Vercel Connect üzerinden OAuth korumalı MCP sunucularını çağırabiliyor

Vercel, ajanları OAuth korumalı MCP sunucularına bağlama mekanizması olan Vercel Connect'in desteklediği çerçevelere TanStack AI'ı ekledi. Vercel blogunda yayımlanan bir yazıya göre, TanStack AI ile geliştirilen ajanlar artık bu sunuculara Connect üzerinden erişebiliyor; bu da geliştiricilerin OAuth kimlik bilgilerini kendilerinin saklaması veya yenilemesi gerektiği anlamına gelmiyor.

Entegrasyon nasıl çalışıyor

Destek, @vercel/connect/tanstack-ai adlı yeni bir subpath export olarak geliyor ve bir connectMCPTransport yardımcı fonksiyonunu ortaya çıkarıyor. Fonksiyon, sıradan bir TanStack transport yapılandırmasını alıyor — örneğin bir MCP endpoint'ini işaret eden bir HTTP transport — ve ona Connect destekli bir auth provider bağlıyor.

Vercel'e göre bu provider, ajanın yaptığı her MCP isteğinin önünde çalışıyor; böylece her çağrıya eklenen token güncel oluyor ve konuşmanın ortasında süresi dolabilecek önbelleğe alınmış bir kimlik bilgisi olmuyor.

Vercel'in yayımladığı örnek kodda bir server route, Linear için bir MCP client oluşturuyor. createMCPClient çağrısı, sarmalanmış transport'u, OAuth bağlantısının tanımlayıcısını (oauth/linear) ve yetkilendirmeyi belirli bir son kullanıcıya sabitleyen bir subject alıyor — örnekte, gelen istekten çözümlenen bir ID. Tamamlanan client, TanStack'ın chat fonksiyonuna bir model adaptörüyle birlikte devrediliyor; adaptör örnekte bir Anthropic Claude modelini Vercel AI gateway üzerinden yönlendiriyor. Model böylece Linear'ın araçlarını konuşmanın bir parçası olarak çağırabiliyor ve route yanıtları server-sent events olarak geri akıtıyor.

Onay, model çalışmadan önce çözülüyor

Entegrasyonun diğer yarısı, henüz erişim izni vermemiş kullanıcıları kapsıyor. Bu durumda createMCPClient, model daha çağrılmadan önce bir consent challenge ile başarısız oluyor. Geliştiriciler bu başarısızlığı getConsentChallenge yardımcı fonksiyonuyla yakalıyor ve kullanıcıyı bağlantıyı onaylaması için Connect'in onay URL'sine yönlendiriyor.

Vercel, neden erken başarısız olmanın önemli olduğunu şöyle açıklıyor: bir tool call içinde oluşan onay hatası, kullanıcıya bir yönlendirme olarak değil, modele sıradan bir hata dizisi olarak ulaşırdı. Ajan sadece bir başarısızlık bildirirdi ve bunu düzeltmek için gereken onay akışından kimse geçmezdi.

Neden önemli

OAuth, ajan mimarileri için her zaman tam oturmadı. Token'ların güvenli şekilde saklanması, süreleri dolduğunda yenilenmesi ve doğru kimliğe göre kapsamlandırılması gerekiyor — bir modelin tool call'ları ise insanın izlemediği anlarda gerçekleşiyor. Auth provider'ı her MCP isteğinden önce çalıştırarak ve token'ları kullanıcı başına bir subject'e bağlayarak Connect, bu mekanizmayı uygulama kodundan çıkarıp platforma taşıyor.

Kullanıcı başına tasarım, buradaki en kritik tercih. Belirli bir kullanıcı olarak yetkilendirilmiş bir Linear client, genel bir servis kimlik bilgisi altında hareket etmek yerine o kullanıcının izinlerini ve görünürlüğünü devralıyor — bu da etkin bir şekilde, ajanın sizin ticket'larınızı mı yoksa herkesin ticket'larını mı gördüğü arasındaki fark.

TanStack AI üzerinde zaten geliştirme yapan ekipler için, çalışan bir MCP bağlantısı artık bir transport yapılandırması, bir bağlantı ID'si ve bir subject'e indirgeniyor; onay ise bir yönlendirmeyle ele alınıyor. Vercel, TanStack AI'ın Connect'in desteklenen çerçeve ve adaptör listesine katıldığını ve yeni başlayan geliştiriciler için entegrasyon dokümantasyonunun mevcut olduğunu belirtiyor.