Bir MCP Server’ı tarayıcı otomasyon ortamına bağlamak için sürüm kontrolü, kimlik bilgisi yönetimi, hizmet kaydı ve bağlantı doğrulamasını kapsayan pratik süreç; ayrıca boş araç listesi, kimlik doğrulama hatası ve bağlantı zaman aşımı için izlenecek sorun giderme sırası.
MCP (Model Context Protocol), her tarayıcı etkileşimini elle kodlamanıza gerek kalmadan bir AI asistanının tarayıcıyı yönetmesini sağlar. Asistan araçları gereken sırayla çağırabilir ve görevi kendi başına tamamlayabilir.
Uygulamada sorun çıkaran noktalar genellikle protokolün kendisinden çok neyin kurulacağı, nereye bağlanılacağı, kimlik bilgilerinin nasıl verileceği ve bağlantının gerçekten çalıştığının nasıl doğrulanacağıdır. Bu dört başlığı sırayla kontrol ettiğinizde sorunların çoğu yapılandırma aşamasında ortaya çıkar.
Önce üç şeyi doğrulayın
İlk olarak, yerel bir arayüz sağlayan tarayıcı otomasyon ortamı istemcisine ihtiyacınız vardır ve sürümünün yerel API desteği bulunmalıdır. Eski bir sürümde arayüz hiç olmayabilir; buna rağmen görünen belirti yalnızca araç listesinin boş olması olabilir. İkinci olarak Node.js 18 veya daha yeni bir sürüm gerekir. MCP Server’ların çoğu TypeScript ile uygulanır ve bir Node çalışma zamanı ister. Üçüncü olarak MCP destekleyen bir AI aracına ihtiyacınız vardır.
İstemci sürümünü kontrol etmeyi ilk sıraya koymak en iyisidir. Bağlantı kurulamaması veya araç listesinin boş olması gibi hataların önemli bir kısmı yalnızca eski sürümden kaynaklanır ve sunucuyla ilgili değildir.
Nereye bağlanılır?
İstemci başladığında yerel makinede loopback adresini dinleyen bir API hizmeti başlatır. Portu istemcinin arayüz ayarlarında görebilir ve değiştirebilirsiniz. Port kullanımdaysa başka bir port seçip istemciyi yeniden başlatın.
MCP Server ortama bu yerel adres üzerinden erişir ve trafik genel İnternet üzerinden geçmez. Bunun tersi de önemlidir: bu hizmet yalnızca yerelde kalmalı ve dışarıya açılmamalıdır.
Kimlik bilgileri nasıl verilir?
İstemci ayarlarından bir API Key oluşturun. Bazı uygulamalarda ID ve Key olmak üzere iki parça kullanılır. Bu kimlik bilgileri, hesabınızdaki tüm ortamların kontrolüne eşdeğerdir; bunları ele geçiren biri ortamlarınızı başlatabilir, değiştirebilir veya silebilir.
Temel güvenlik adımlarını atlamayın. Kimlik bilgilerini kod deposuna göndermeyin. Ortam değişkenleri veya yerel bir yapılandırma dosyası kullanın ve bu dosyayı ignore listesine ekleyin. Ekip üyeliği değiştiğinde kimlik bilgilerini hemen döndürün. Amaca göre ayrı kimlik bilgileri üretilebiliyorsa bunu yapın; sorunların kaynağını bulmak ve yalnızca ilgili kimlik bilgisini iptal etmek kolaylaşır. AI aracının yapılandırmasında endpoint ve kimlik bilgilerini ortam değişkenleriyle aktarın; komut satırına sabitleyip iz bırakmayın.
Hizmeti kaydedin
Kayıt işlemi genellikle AI aracının yapılandırma dosyasına bir hizmet tanımı eklemektir. Bu tanım üç bölümden oluşur: bir komut veya giriş dosyası yolu olan başlatma yöntemi; yerel endpoint ile kimlik bilgilerini içeren ortam değişkenleri; ve araç listesinde görünen adı belirleyen hizmet kimliği.
Kaydı tamamladıktan sonra AI aracını yeniden başlatın. Çoğu araç yapılandırmayı yalnızca açılışta bir kez okur; dosyayı değiştirip yeniden başlatmamak, pratikte hiç değiştirmemekle aynıdır.
Gerçekten çalıştığını nasıl doğrularsınız?
İki adım izleyin ve sıralamayı değiştirmeyin.
Önce araç listesine bakın. Tarayıcıyla ilgili araçlar görünmelidir; bu, hizmetin tanındığını doğrular. Ardından mevcut tüm ortamları listelemek gibi yalnızca okuma yapan bir görev verin. Salt okunur işlem yan etki oluşturmaz ama kimlik doğrulama, ağ ve hizmet katmanlarını tek seferde sınar. Bu adım geçmezse sonraki görevleri denemenin anlamı yoktur.
Bağlantı kurulduktan sonra neler yapılabilir?
Hizmet çalıştığında bir AI asistanı genellikle ortamları sorgulayıp arayabilir, ortam oluşturup temel parametreleri ayarlayabilir, ortamları başlatıp durdurabilir, bir ortama ağ çıkışı bağlayabilir ve sayfada gezinme, tıklama, form doldurma ve ekran görüntüsü alma gibi işlemler yapabilir.
Kullanım doğal dille gerçekleşir: hedefi tarif edersiniz, asistan hangi araçları hangi sırayla çağıracağına karar verir. Burada kolayca karışan bir ayrım vardır: AI ne yapılacağına karar verir, ortam katmanı ise işlemin hangi kimlikle yapılacağını belirler. Bu iki sorumluluğu ayrı düşünmek, sorun çıktığında hangi katmana bakılması gerektiğini netleştirir.
Bağlantı kurulamadığında sorun giderme sırası
Araç listesi boşsa önce yapılandırma dosyası yolunun doğru olduğunu kontrol edin, ardından AI aracını yeniden başlattığınızdan emin olun ve son olarak hizmeti elle başlatarak kendi başına açılıp açılamadığını deneyin. Bu üç adımdan biri başarısızsa henüz protokolden şüphelenmek için neden yoktur.
Kimlik doğrulama hatalarının genellikle iki kaynağı vardır: Key kopyalanırken fazladan bir karakter veya satır sonu eklenmiştir ya da ortam değişkeni doğru okunmamıştır. Key’i yeniden kopyalamak çoğu zaman yapılandırmayı tekrar tekrar değiştirmekten daha hızlıdır.
Bağlantı zaman aşımı çoğunlukla yerel tarafa işaret eder. İstemcinin çalışıp çalışmadığını ve portun kullanımda veya güvenlik duvarı tarafından engellenmiş olup olmadığını kontrol edin. MCP Server’ların çoğu istemcinin açık kalmasını gerektirir; istemci kapanınca araçlar çağrılamaz.
Hizmet bağlı olduğu halde işlemler yanlış yürüyorsa sorun çoğu zaman bekleme zamanlamasıdır. Asistanın sayfanın yüklenip yüklenmediğini tahmin etmesini beklemek yerine, devam etmeden önce hangi durumun oluşması gerektiğini talimatta açıkça belirtin.
Önceden fark edilmesi zor başka bir sorun da birden fazla görevin aynı ortamı paylaşmasıdır. Oturumlar, Cookies ve önbellek birbirinin üzerine yazılır, görevler birbirini etkilemeye başlar ve sonuç açık bir hata yerine rastgele başarısızlık gibi görünür. Daha güvenli yöntem, her göreve bağımsız bir ortam vermek ve toplu oluşturma ile geri toplamayı ortam katmanına bırakmaktır. PurpleMark’ın ortam izolasyonu ve merkezi yönetimi tam olarak bu katmanda yer alır; MCP bağlandıktan sonra görev orkestrasyonu ile kimlik yönetimi yine iki ayrı konudur.
İki ek tuzak
Bir otomasyon framework’ü tarayıcının kontrolünü aldığında driver sürümü, istemcinin kullandığı motor sürümüyle eşleşmelidir. İstemci genellikle kullanılabilir bir driver yolu döndürür, ancak sürümler yine de uyuşmayabilir. Driver’ı sürüm yönetim aracıyla otomatik eşitlemek çoğu zaman daha kolaydır; sayfa endpoint’i ise istemcinin döndürdüğü değeri kullanmaya devam edebilir. Bu iki yaklaşım birbiriyle çelişmez.
Diğer konu eşzamanlılıktır. Tek bir tarayıcı işlemi yaklaşık 300 ila 500MB bellek kullanır ve aynı makinede aynı anda 5’ten fazla ortam başlatılmaması önerilir. Bu sayının üzerine çıkıldığında başlatma hataları ve hatta işlem çökmeleri görülebilir. Sayfa işlemlerinde de sabit gecikmeler kullanmayın: sayfa yükleme zaman aşımını 30 saniye olarak ayarlayın, öğeler için en fazla 20 saniyelik açık beklemeler kullanın. Bu, sleep kullanmaktan daha kararlıdır.
Bir sınır
MCP, AI’ın tarayıcıyı teknik olarak nasıl yöneteceği sorununu çözer; herhangi bir platformun kurallarını değiştirmez. Görevin kendisi hâlâ hedef platformun hizmet koşullarına uymalıdır. Teknik olarak yapılabilir olmak ile kurallar açısından izin verilmek iki ayrı değerlendirmedir.
Protokol ve arayüz ayrıntıları için resmi belgelere başvurun ve başlamadan önce çalıştırmayı planladığınız görevin hedef platformda izinli olduğunu doğrulayın.
