mcp-handler, tarayıcı içi agent'lar için deneysel WebMCP desteği ekledi

Vercel, Model Context Protocol sunucuları geliştirmek için kullandığı mcp-handler kütüphanesine deneysel WebMCP desteği ekledi. Vercel bloguna göre bu değişiklik, bir sitenin mevcut MCP araçlarını, web tabanlı istemciler için ayrı bir entegrasyon kurmak yerine tek bir script etiketi ekleyerek tarayıcıda çalışan agent'lara açmasını sağlıyor.

WebMCP, araçları tarayıcı içi agent'lara açmak için önerilen bir web standardı. Vercel'in aktardığı modele göre bir sayfa sunduğu yetenekleri bildiriyor ve o sayfada çalışan bir agent bu araçları keşfedip çağırabiliyor — böylece MCP'nin sunucular ve masaüstü istemcileri için yerleştirdiği araç kullanım deseni web'in kendisine kadar uzanıyor.

Entegrasyon nasıl çalışıyor

Seçim araç bazında yapılıyor. Geliştiriciler createMcpHandler'a deneysel bir experimental_webMcp nesnesi geçiriyor ve açmak istedikleri araçların adlarını listeliyor — Vercel'in örneğinde roll_dice. Yalnızca adı geçen araçlar sayfaya açılıyor; sunucuda kayıtlı diğer her şey gizli kalıyor.

Sayfa daha sonra MCP endpoint'inin kendisinin sunduğu, ?webmcp-script query parametresiyle istenen bir script yüklüyor. Vercel'in gösterdiği kurulumda /api/mcp?webmcp-script adresini işaret eden bir etiket yeterli. Script yüklendiğinde, açılan araçları sayfaya kaydediyor ve her çağrıyı MCP sunucusuna proxy'liyor.

Bu proxy'leme, Vercel'in en çok vurguladığı detay. Çağrılar oturum açmış kullanıcı olarak iletiliyor; bu da sunucu tarafı kimlik doğrulamasına bağlı araçların, tarayıcı tarafında bir OAuth akışı olmadan çalışmaya devam etmesi anlamına geliyor. Tarayıcı hiçbir zaman token veya kimlik bilgisi pazarlığı yapmak zorunda kalmıyor — MCP sunucusu zaten isteği kimin yaptığını biliyor.

Özellik mcp-handler sürüm 2.2.0 ile geliyor. Vercel bunu deneysel olarak etiketliyor ve yapılandırma anahtarındaki experimental_ ön eki, altta yatan standart geliştikçe API'nin hâlâ değişebileceğine işaret ediyor.

Neden önemli

Günümüzdeki MCP dağıtımlarının çoğu tarayıcı dışındaki istemcileri hedefliyor — IDE'ler, masaüstü uygulamaları veya sunucudan sunucuya entegrasyonlar. Bu sürüm, aynı araçlara neredeyse ek kod olmadan ikinci bir yüzey kazandırıyor ve bu da tarayıcı tabanlı agent'larla deney yapmanın maliyetini önemli ölçüde düşürüyor.

Kimlik doğrulama modeli tartışmalı biçimde daha önemli kısım. Bir tarayıcı agent'ına OAuth bağlamak bu alanın en zor problemlerinden biri ve çağrıları kullanıcının mevcut oturumu üzerinden proxy'lemek bu sorunu tamamen ortadan kaldırıyor. Ziyaretçilerini zaten kimlik doğrulamasından geçiren siteler kimlik doğrulamalı araçları fiilen bedavaya kazanıyor ve izinler zaten bulundukları yerde, yani sunucuda uygulanmaya devam ediyor.

Sürüm aynı zamanda WebMCP'nin kendisiyle ilgili bir sinyal. Önerilen bir standart ancak uygulamalarla destek kazanır ve bir sunucu kütüphanesinin bunu benimsemesi — deneysel bir bayrak ardında bile olsa — spesifikasyon yazarlarına ve diğer uygulayıcılara test edebilecekleri somut bir şey veriyor. Bu desen yerleşirse, web agent'ların işaretleme ayrıştırmak yerine bildirilmiş araçları çağırdığı bir yer haline geliyor ve siteler pasif belgeler yerine agent iş akışlarının programatik katılımcılarına dönüşüyor.

Zaten mcp-handler çalıştıran ekipler için deneme yolu kısa: 2.2.0'a yükseltin, bir ya da iki aracı experimental_webMcp ile açın ve sayfaya script etiketini ekleyin.