← Tüm blog yazıları

MCP ile Aklınızdaki Siteyi Nasıl Yaparsınız?

“Siteme bir harita ekle” dediğinizde bir tasarımcı da bir yapay zekâ asistanı da aynı şeyi merak eder. Oyuncu haritada neyi bulacak? Bizim örneğimizde cevap basit. Sunucuya yeni katılan biri iskeleyi, pazarı ve başlangıç madenini

MCP ile Aklınızdaki Siteyi Nasıl Yaparsınız?
“Siteme bir harita ekle” dediğinizde bir tasarımcı da bir yapay zekâ asistanı da aynı şeyi merak eder. Oyuncu haritada neyi bulacak? Bizim örneğimizde cevap basit. Sunucuya yeni katılan biri iskeleyi, pazarı ve başlangıç madenini telefondan bulabilsin. Bu rehberi hazırlarken MCP (Model Context Protocol) üzerinden bir yapay zekâ asistanını sitenizin araçlarına bağlayabilirsiniz.

İlk mesajınızda oyuncunun yapacağı işi anlatın

MCP sayesinde asistan, bağlandığı yazılımın hangi araçları sunduğunu öğrenip ihtiyacı olan aracı çağırabilir. Burada “ajan” dediğimiz şey, isteğinizi okuyup bu araçlarla çalışabilen asistan. Hangi dosyayı okuyabildiği, bir taslak hazırlayıp hazırlayamadığı veya sitenize yazıp yazamadığı seçtiğiniz bağlantıya ve verdiğiniz izinlere bağlı.

İlk denemede bizim harita örneğimizi kendi sitenize uyarlayabilirsiniz. Bir kitapçı için aynı istek, üç şubenin adresini telefonda kolay okunur bir sayfada göstermek olabilir. İşe, asistanın erişebildiği bir sayfayı seçip mevcut başlığını ve içeriğini sormakla başlayın. Sizin gördüğünüz sayfayı tarif edebiliyorsa ne eklemek istediğinizi somut bir örnekle anlatın.
Sunucum için “Yeni Oyuncu Rehberi” hazırlamak istiyorum. İskele, pazar ve başlangıç madeni için üç yer kartı olsun. Telefonda yer adı ile koordinatlar yan yana okunabilsin. Önce mevcut temayı incele ve bana bir taslak göster.
Bu tarif renk, yazı tipi veya dosya adı içermiyor ama sonucu değerlendirmek kolay. Telefonunuzdan pazarı bulup koordinatını okuyabiliyor musunuz? İlk taslakta bunu deneyin. Eğer üç konum uzun süre sabit kalacaksa sayfaya yazılmış üç kart işi görebilir. Ekibiniz her hafta konum ekleyecekse her seferinde tema kodu açmak istemezsiniz. Modülü konuşmanın zamanı o zaman gelir.

SFTP ile temanın doğru yerine dokunmak

Yetkili SFTP bağlantısı, ajanın düzenlenebilen tema dosyalarını okuyup değişiklik hazırlamasını sağlar. Kullandığınız sistem tema dosyalarını SFTP ile sunuyorsa bağlantıyı kendi barındırma veya tema yönetim aracınızdan hazırlayabilirsiniz. Önce etkin temayı ve hedef sayfayı okutun. “Rehber başlığının hemen altında göster” dediğinizde asistan o başlığın geçtiği gerçek şablonu bulabilir. Sayfanızdaki iki ayrı başlık benzerse birkaç komşu satırı da isteyin. Böylece mobil menüdeki bağlantı ile sayfanın içindeki başlığı ayırt edebilirsiniz.

Aşağıdaki küçük parça, bir taslakta görmek isteyeceğiniz farkı anlatır. İlk satır temada zaten var. İkinci satır, yeni listeyi yerleştirmek için önerilen bölgedir. Buradaki kimlik örneğe aittir.
<h2>Yeni Oyuncu Rehberi</h2>
<div id="rehber-konumlari"></div>
Boş bir bölüm ekleyince harita kendiliğinden oluşmaz. Bu satırın görevi, konum listesinin sayfada nerede görüneceğini belirlemektir. Ajandan mevcut dosya sürümünü esas alarak yalnız bu noktayı değiştirmesini, taslağı eşitlemesini ve önizlemeyi açmasını isteyin. Bu arada ekipten biri aynı şablonu düzenlemişse güncel içeriği tekrar okuyup farkı ona göre hazırlayın. “74. satıra yaz” talimatı başına birkaç satır eklenen bir dosyada artık başka bir yere denk gelebilir.

Oyuncu sayfayı açtığında modül ne yapar?

Örnek harita modülünün üç parçasını düşünün. Paket tanımı modülün kimliğini, sürümünü, hedef temayı ve sunduğu işlemleri bildirir. Şablon, oyuncunun gördüğü liste için yer ve görünüm sağlar. Modülün API tarafı ise gösterilecek konumları okur. Örneğin ziyaretçi rehberi açtığında sayfa konum listesini ister. Okuma işlemi kayıtlı isimleri ve koordinatları döndürür. Görünüm de “Pazar” adını kendi koordinatlarıyla aynı karta yerleştirir.

Bu ayrımın karşılığını pazar taşındığında görürsünüz. Yetkili bir yönetim işlemiyle koordinat kaydını güncellersiniz. Sayfa yeni listeyi okuduğunda aynı kartta yeni koordinat görünür. Kartın rengini düzeltmek için bu kez konum kayıtlarına dokunmanız gerekmez. Liste boşsa “Henüz konum eklenmedi” yazması, veri alınamadığında ise yüklemenin başarısız olduğunu söylemesi iyi bir ayrıntıdır. O iki durumda yöneticinin yapacağı iş farklıdır.

Geliştirici tarafında herkese açık konumları döndüren işlem yalnız okumaya açılabilir. Kayıt değiştiren işlem ise yetkili oturum, POST isteği ve CSRF doğrulaması gerektirir. Modülün veri erişiminde kendisine sağlanan veritabanı nesnesi ve parametreli sorgular kullanılır. Şablon tarafı HTML veya panelin desteklediği şablon diliyle hazırlanır. Çalıştırılacak PHP kodunun yeri paketin API alanıdır.

Ajana ikinci mesajda ne söylersiniz?

İlk taslağı telefonunuzda açtınız. İskele ve maden rahat okunuyor ama “Eski Şehir Pazarı” iki satıra düşünce koordinatlar sağdan taşıyor. Ajana yalnızca “Mobil kötü olmuş, düzelt” derseniz o da baştan bir kart tasarlamayı deneyebilir. Oysa sizin sevdiğiniz taraflar var. Bunu tarifinize katın. “Kartların sırası ve isimleri güzel. Uzun yer adında koordinatlar ekranın dışına çıkıyor. Adı üst satırda, koordinatı altında gösterecek bir mobil düzen dene. Masaüstünde yan yana kalsın.” Bu mesajdaki her cümleyi sonraki önizlemede kendiniz kontrol edebilirsiniz.

Bir de aynı hafta pazarı başka yere taşıdığınızı düşünün. Sorun bu kez yazının sığması mı, kartın yanlış koordinat göstermesi mi? Sayfa görünümünü yeniletmeden önce ajandan konum listesinin pazar için döndürdüğü değeri okumasını isteyin. Dönen değer de eskiyse düzeltilecek şey kayıttır. Liste yeni koordinatı döndürdüğü hâlde kart eski değeri gösteriyorsa bu kez görünümün hangi alanı kullandığına bakarsınız. Bu ayrım sayesinde çalışan şablonu her veri düzeltmesinde yeniden hazırlatmazsınız.

Son olarak ajandan bir sonraki kişinin anlayacağı kadar kısa bir teslim notu isteyin. Haritayı açan sayfa hangisi, konum adları nereden geliyor, tasarım değişecekse hangi şablona bakılacak? Ekibinize yeni katılan geliştirici ilk görevinde “Başlangıç madeni taşındı” mesajını aldığında o üç satır işine yarayacak.

SFTP’deki taslaktan çalışan pakete

Ajana önce mevcut modül durumunu ve hedef temayı inceletin. Bu örnekteki modül sistemi, SFTP çalışma alanındaki kaynakları taslak olarak tutuyor. Kendi altyapınızda modülün kaynak biçimini ve nasıl etkinleştirildiğini o sistemin belgelerinden öğrenebilirsiniz. PHP kaynaklarını burada .php.txt uzantısıyla görmeniz beklenen davranıştır. Asistan ZIP’i yeniden hazırlarken dosyaları paketin içinde özgün .php adlarına döndürür. Dosyayı SFTP’de kaydetmek, sitenizde o kodu çalıştırmaz.

Paketin tanımını, hedeflediği şablonları ve API dosyalarını inceleyin. Ardından ZIP, modül yükleyicisinden doğrulanarak yüklenir ve seçilen site ile temaya uygulanır. Bir paket hedef şablonu bütünüyle içerebilir. Sizin tasarımınızda korunacak bir bölüm varsa uygulamadan önce önerilen dosyayı mevcut sürümle karşılaştırın. Tema yöneticiniz dosya farklarını gösteriyorsa eklenen ve kaldırılan satırları oradan okuyun. Aynı karşılaştırmayı dosyaların uygulama öncesi ve sonrası kopyalarıyla da yapabilirsiniz.

“Yüklendi” mesajından sonra pazarı bulun

Deneme sitesinde rehberi oturum açmadan ziyaret edin. Üç yer görünüyor mu? Pazarın koordinatını deneme kaydında değiştirip sayfayı yeniden açın. Oyuncu yeni değeri okuyabiliyor, diğer iki yer aynı kalıyor ve ziyaretçiye yönetim işlemi açılmıyorsa modülün hem veri hem görünüm tarafını sınamışsınız demektir. Sonra telefona geçip uzun bir konum adıyla okuyun.

Menüye “Oyuncu Rehberi” bağlantısını en son eklemek işinizi kolaylaştırır. Böylece oyuncular bir vaatle karşılaşmaz. Bağlantıya dokunduklarında gerçekten pazara giden yolu bulurlar.
Sıfır Risk lisans maliyeti olmadan Ücretsiz Deneme
Zonely web siteniz ve mağazanız tek panelde
Topluluğunuz oyunla Discord arasında bir arada
Zonely web siteniz için Güçlü Altyapı
Sizin Alan Adınız sizin markanız Zonely Gücüyle

“10 üzerinden 10 veriyorum bu kadar özellik diğer yazılımlarda bile yok.”

— tekno [maxland.com.tr]

“Destek kısmı cidden çok hızlı ve gerekli her şeyle ilgileniyorlar.”

— Rentr [cyraxnw.com]

“Üzerinde cidden durulmuş ve önerileri dikkate alan bir yazılım firması.”

— Forrise [mineghost.net.tr]

Topluluğunuz, tek merkezde.

Mağaza, oyun ve iletişim.

Sitenizin görünümünü düzenleyin, satışlarınızı takip edin ve oyuncularınıza ulaşın. Topluluğunuzu yönetmek için kullandığınız araçları aynı panelde bir araya getirin.

Mağazanızı yayına hazırlayın.

Ürünlerinizi ve kategorilerinizi oluşturun. Fiyat, stok ve teslimat ayarlarını belirleyip satışlarınızı kendi sitenizden yönetin.

Keşfedin

Satıştan teslimata.

Ürünlerinizi sunucu komutlarına bağlayın. Desteklenen oyun bağlantılarıyla siparişin ardından yetki, eşya ve paket teslimatını otomatik yürütün.

Keşfedin

Görünümünüz size ait.

Hazır bir tema seçin; renkleri, yazı tiplerini, menüleri ve sayfaları markanıza göre düzenleyin. Değişikliklerinizi yayına almadan önce inceleyin.

Keşfedin

Desteği tek yerden yönetin.

Üyelerinizin sorularını karşılayın, görüşmeleri takip edin ve destek taleplerini ekibinizle paylaşın. Yardım içeriklerinizi herkesin ulaşabileceği bir yerde toplayın.

Keşfedin

Discord ile bağlantıda kalın.

Site üyelikleriyle Discord hesaplarını eşleyin. Rol bağlantıları ve bildirimlerle web sitenizi ve topluluğunuzu birlikte yönetin.

Keşfedin

Mağazanızın nabzını tutun.

Sipariş, ödeme ve kullanıcı hareketlerini inceleyin. Ürünlerinizi ve satış dönemlerini karşılaştırarak mağazanızın nasıl ilerlediğini görün.

Keşfedin

Ekibiniz birlikte çalışsın.

Destek, içerik ve yönetim görevleri için rol izinlerini belirleyin. Her ekip üyesine ihtiyacı olan erişimi verin; yapılan işlemleri kayıtlarından takip edin.

Keşfedin

Dosyalarınız elinizin altında.

Şablon editörüyle tema dosyalarınızı düzenleyin. Dosya ve veritabanı araçlarıyla verilerinize ulaşın, yedeklerinizi alın ve sitenizi geliştirin.

Keşfedin

Zonely’yi Birlikte Geliştirelim

topluluğun bir parçası olun

Sorularınızı paylaşın, deneyimlerden yararlanın ve önerilerinizi bize ulaştırın. Projenizi geliştirirken Zonely topluluğuyla bağlantıda kalın.

Duyuruları, sürüm yeniliklerini ve kullanım ipuçlarını takip edin.

Topluluğa katılın; sorularınızı ve deneyimlerinizi paylaşın.

Hataları bildirin, önerilerinizi iletin ve geliştirmelere katkıda bulunun.
Canlı destek için buradayız! 👋