WebMCP

Alexandra Klepper

François Beaufort

Kasper Kulikowski

Yayınlanma tarihi: 18 Mayıs 2026, Son güncelleme tarihi: 7 Ekim 2026

WebMCP, yapay zeka ajanları için yapılandırılmış araçlar oluşturmanıza ve sunmanıza yardımcı olmak amacıyla önerilen bir web standardıdır. WebMCP, JavaScript sağlar ve HTML form öğelerine ek açıklama ekler. Böylece temsilciler, kullanıcı deneyimini desteklemek için sayfa özellikleriyle tam olarak nasıl etkileşim kuracaklarını bilir. Bu sayede temsilci etkinleştirme performansını ve güvenilirliğini önemli ölçüde artırabilirsiniz.

Yapay zeka ajanları daha yeni bir teknolojidir. İnsanların son derece karmaşık ve teknik görevleri daha iyi tamamlamasına yardımcı olabilirler. WebMCP, temsilci görevlerinin tamamlanmasında daha yüksek doğruluk sunar ve progresif geliştirme olarak eklenebilir.

Açıklayıcı	Web	Uzantılar	Chrome Durumu	Amaç
GitHub	Kaynak denemesi		Görünüm	Deneme niyeti

Neden WebMCP?

WebMCP, web uygulamaları ile temsilciler arasındaki boşluğu dolduran etkileşim kuralları sağlayarak verimliliği, güvenilirliği ve görev tamamlamayı artırır. Web sitesi, bir düğmenin veya alanın amacını anlamak için öğeyi inceleyen bir temsilci yerine öğenin amacını bildirir. Böylece öğe, amaçlandığı şekilde kullanılır.

Bu yöntem, çok sayıda adım içerebilen ve her adımın temsilci tarafından yorumlanmasına açık olan etkinleştirmeden daha güvenilirdir.

Web siteleri, tool tanımlayarak arama veya satın alma gibi açık amaçları paylaşabilir. Araçlar web sayfanızda görünür şekilde çalışır. Böylece kullanıcılar, görevlerin beklendiği gibi tamamlandığına dair güven kazanır. Bu sayede markanız ve insan odaklı tasarım seçimleriniz de korunur.

WebMCP şunları destekler:

• Keşif: Sayfaların, checkout veya filter_results gibi araçları temsilcilere kaydetmesi için standart bir yöntem.
• JSON şemaları: Halüsinasyonları veya yanlış anlamaları azaltmak için girişlerin ve beklenen çıkışların açık tanımları.
• Durum: Temsilcinin, gerçek zamanlı olarak işlem yapabileceği kaynakları bilmesi için mevcut sayfa bağlamının ortak bir şekilde anlaşılması.

Amacımız, ajan tabanlı yeteneklere sahip tüm tarayıcıların uygulayabileceği ve yararlanabileceği API'ler oluşturarak kullanıcılarınızın görevleri daha kolay tamamlamasını sağlamaktır. Bu süreci GitHub'dan takip edebilirsiniz.

Kullanım alanları

WebMCP'yi kullanabileceğiniz birçok yöntem vardır. Örneğin:

• Müşterilerinizin destek almasına yardımcı olun. Müşterilere yazılım sunuyorsanız birçok farklı soruyu yanıtlamak için karmaşık bir destek akışınız olabilir. WebMCP'yi kullanarak temsilcinin doğru forma daha hızlı gitmesine ve alanları kullanıcı tarafından sağlanan bilgilerle doldurmasına yardımcı olabilirsiniz.
• Seyahat rezervasyonunu iyileştirme Temsilcilerin karmaşık, birden fazla şehri kapsayan ve birden fazla yolcunun olduğu seyahatler için daha az adımla rezervasyon yapmasına yardımcı olun.

Satın alma işlemi gibi bazı işlemler hassas olabilir. Onay iletişim kutusuyla kullanıcı etkileşimi isteğinde bulunmak için bir komut ekleyebilirsiniz.

Pratik anlamda, araçlarınız aşağıdaki görevleri gerçekleştirebilir:

• Yapılandırılmış formları doldurma: Temsilcilerin, kullanıcıyla yapılan görüşmeden toplanan verileri form alanlarıyla doğru şekilde eşleştirmesine yardımcı olacak bir submit_application aracı oluşturun. Örneğin, bir alanın tam ad mı yoksa ayrı ad ve soyadı mı gerektirdiğini ayırt edebilirsiniz.
• İnsan öncelikli arayüzlerde müşteri temsilcisi etkileşimlerini destekleme: Belirli alanlar insan kullanıcılar için tasarlanmıştır ancak temsilciler tarafından anlaşılmayabilir. Rezervasyon veya etkinlik rezervasyonunda karmaşık tarih ve saat seçimine olanak tanıyan bir date_pick aracı oluşturabilirsiniz.
• Daha hızlı uygulama hata ayıklama: Geliştirici ayarları sayfasında bir run_diagnostics aracı oluşturabilirsiniz. Böylece temsilci, normalde iç içe yerleştirilmiş menülerde gizli olan düzeltmeleri tetikleyebilir.

Kullanım alanınız eksik mi? WebMCP için paylaşmak istediğiniz heyecan verici bir fikriniz mi var? GitHub'da soru sorma ve tartışmalara katılma

Başlayın

Chrome 149'dan itibaren WebMCP kaynak denemesine katılın. Kaynak denemelerini kullanmaya başlama hakkında daha fazla bilgi edinin.

Yerel WebMCP

WebMCP, yerel geliştirme için Chrome flag'i olarak kullanılabilir:

1. Chrome'u açıp chrome://flags/#enable-webmcp-testing adresine gidin.
2. İşareti Etkin olarak ayarlayın.
3. Değişiklikleri uygulamak için Chrome'u yeniden başlatın.

WebMCP API'lerini kullanma

Web sitesi araçlarınızı ayarlamak için kullanabileceğiniz iki API vardır:

• Imperative API: Form girişi, gezinme araçları, durum yönetimi veya diğer işlevler gibi farklı araç türlerini standart JavaScript ile tanımlayın.
• Bildirim API'si: WebMCP aracı oluşturmak için standart HTML formlarına ek açıklamalar ekleyin.

Chrome Geliştirici Araçları ile WebMCP araçlarında hata ayıklayabilir ve tarayıcının JSON şemasını nasıl ayrıştırdığını doğrulayabilirsiniz.

Sınırlamalar

WebMCP, karmaşık görevleri temsilciler ve insanlar için daha basit hale getirmeyi amaçlasa da bazı sınırlamalar vardır:

• Başsız tarama: WebMCP araçlarını başsız ortamlarda çalıştırmak mümkün olsa da bu API, öncelikle insan müdahalesi gerektiren yerel tarayıcı iş akışları için tasarlanmıştır.
• Karmaşık arayüzler için ek yük: Siteniz çok karmaşıksa uygulama ve arayüz durumunu yönetmek için JavaScript'i yeniden düzenlemeniz veya eklemeniz gerekebilir.
• Araçların keşfedilebilirliği: İstemciler ve tarayıcılar, çağrılabilir araçları olup olmadığını öğrenmek için bir siteyi doğrudan ziyaret etmelidir.

İzin politikası

Her iki API de tools İzin Politikası tarafından kontrol edilir. Politika varsayılan olarak self değerine ayarlanır. Bu değer, üst düzey ve aynı kaynak bağlamlarında araç kaydına izin verir ve çapraz kaynak iFrame'ler için bu özelliği devre dışı bırakır.

Çapraz kaynaklı bir iFrame'de WebMCP araçlarına izin vermek için iFrame'e allow="tools" özelliğini ekleyin.

Demo

Hem zorunlu hem de açıklayıcı uygulamaları kapsayan demo örnekleri mevcuttur:

• WebMCP zaMaker, WebMCP Imperative API'yi kullanır.
• Seyahat demosu (React), WebMCP Imperative API'yi kullanır.
• Le Petit Bistro demosu, WebMCP Declarative API'yi kullanır.

Demo kaynak kodunu GitHub'da da inceleyip keşfedebilirsiniz.

Araçlarınızı test etmek için bir temsilciyi taklit etme

WebMCP araçlarının demolarımızda ve uygulamalarınızda nasıl çalıştığını görmenize yardımcı olmak için iki Chrome uzantısı geliştirdik.

Doğal dil istemleriyle WebMCP araçlarını incelemek, izlemek ve çalıştırmak için Örnek Temsilci Tabanlı Chrome Uzantısı'nı yükleyin. Bu uzantı, özellikle WebMCP notlarına her zaman güvenir. Bu notlar, temsilciyi hassas işlemler konusunda uyarabilir. Bu, bir aracın ek açıklamalarla nasıl farklı performans gösterebileceğini gösterir.

Bu uzantı, varsayılan olarak AI SDK'sı içeren küçük bir Node sunucusu kullanır. API anahtarları gereklidir ve yerel sunucuda kalır. İstemleriniz varsayılan olarak gemini-3.6-flash modeline gönderilir ancak model seçimini ve API sağlayıcısını uzantının .env dosyasında değiştirebilirsiniz. OpenAI, Google ve Anthropic için alanlar vardır. Alternatif olarak, uzantıyı başka bir sağlayıcının modelini kullanacak şekilde özelleştirebilirsiniz.

Alternatif olarak, Prompt API ile istemci tarafı bir model kullanabilirsiniz. Bu işlem için API anahtarları gerekmez ve veriler cihazınızda kalır. Bunun için chrome://flags/#prompt-api-tool-use ayarını etkinleştirin.

Bir temsilciyle denemeler yapmak ve WebMCP araçlarının canlı demolarda veya kendi uygulamalarınızda nasıl çalıştığını görmek için Model Context Tool Inspector uzantısını yükleyin. Temsilcinin WebMCP araçlarıyla beklendiği gibi etkileşim kurup kurmadığını belirlemek için doğal dil istemlerini kullanın.

Gemini'ı kullanarak araçlarınızı çağırmak için uzantının arayüzünde sağladığınız bir API anahtarınız olmalıdır. İstemleriniz varsayılan olarak gemini-3.6-flash modeline gönderilir. Deneme yapmak için farklı bir Gemini modeli seçebilir veya uzantı kodunu başka bir sağlayıcının modelini kullanacak şekilde özelleştirebilirsiniz.

Etkileşim kurma ve geri bildirim paylaşma

WebMCP, aktif olarak tartışılmaktadır ve gelecekte değiştirilebilir. Bu API'leri denediyseniz geri bildirimlerinizi bizimle paylaşabilirsiniz.

• WebMCP kaynak denemesine katılın ve Chrome Durumu'nda Chrome için uygulamayı takip edin.
• WebMCP açıklayıcısını okuyun, soru sorun ve tartışmaya katılın.
• WebMCP ile ilgili en iyi uygulamaları okuyun.
• WebMCP aracı güvenlik kılavuzumuzu ve en iyi uygulamalarımızı okuyun.
• Chrome'un uygulamasıyla ilgili geri bildiriminiz varsa Chromium hata kaydı oluşturun.