Studio'yu yapay zeka asistanınıza kurdurun
Bilgisayarınızdaki Claude Code, Codex veya Cursor gibi bir yapay zeka kodlama asistanı, Studio'yu sizin için yayına alabilir. Siz hazır yönergeleri yapıştırırsınız. Asistanınız, Studio paketinin içinde gelen kurulum yönergelerini okur, web barındırmanızın mı yoksa bir Cloudflare hesabının mı daha uygun olduğunu sizinle birlikte belirler ve bir şeyi değiştirmeden önce sorar.
- En iyi
- Bilgisayarında komut çalıştırabilen bir yapay zeka kodlama asistanını zaten kullanan kişiler; Studio'nun iki türü için de: web barındırmada veya Cloudflare'de.
- İhtiyacınız olanlar
- Windows veya Mac için Maxisnap (Studio'su olan hesapla oturum açılmış); bilgisayarınızda bir yapay zeka kodlama asistanı; ve barındırma giriş bilgileriniz ya da bir Cloudflare hesabı.
- Süre
- Çoğunlukla işi asistan yapar: sizin göreviniz asistanın sorularını yanıtlamak ve her değişikliği onaylamaktır.
- Elde edeceğiniz
- Diğer kurulum seçenekleriyle aynı Studio, web barındırmanızda ya da kendi Cloudflare hesabınızda.
Asistanınızın izlediği yönergeler
Her Studio paketi, yapay zeka asistanları için yazılmış yönergeler içerir. Bu yönergeler Studio'nun her iki sürümünü, tam kurulum adımlarını, nelerin gizli kalması gerektiğini ve sonucun nasıl kontrol edileceğini açıklar. Ayrıca asistanınıza şunları yapmasını söyler:
- Bir sunucuda ya da hesapta yapılacak her yükleme, dağıtım veya değişiklikten önce size sormak ve neyi değiştireceğini tam olarak söylemek.
- Orada zaten bulunanları asla silmemek, üzerine yazmamak veya yeniden adlandırmamak: web sitesi dosyaları, DNS kayıtları, Worker'lar, kovalar veya veritabanları. Studio yalnızca yeni şeyler ekler.
- Anahtarları ve parolaları oluşturduğu dosyaların dışında tutmak.
- Sonunda size Studio adresini ve Yönetici anahtarını vermek; böylece Maxisnap'i bağlayabilirsiniz.
Studio'yu bilgisayarınıza indirin
- Windows'ta: Maxisnap'te Ayarlar → Hesap → Maxisnap Studio kurulum sihirbazını açın, “Başlayın” düğmesine, ardından “Paneli indir” düğmesine tıklayın. Maxisnap, Studio ZIP dosyasını İndirilenler klasörünüze kaydeder ve o klasörü açar.
- Mac'te: Maxisnap'te Settings → Welcome & Help → Studio Setup Guide bölümünü açın, “Get Started” düğmesine, ardından “Download Dashboard” düğmesine tıklayın. Maxisnap, Studio ZIP dosyasını İndirilenler klasörünüze kaydeder.
ZIP dosyasını ayıklayın. Windows'ta dosyaya sağ tıklayın ve “Tümünü Ayıkla” seçeneğini seçin. Mac'te dosyaya çift tıklayın.
Ayıklanmış klasörün konumunu kopyalayın; bunu 3. adımda yapıştıracaksınız. Windows'ta klasöre sağ tıklayın ve “Yol olarak kopyala” seçeneğini seçin. Mac'te klasörü seçin ve Option+Command+C tuşlarına basın.
Yapay zeka asistanları için yönerge dosyası o klasörde bulunur:
AGENTS.md
İsterseniz markalamanızı sabitleyin
“Maxisnap Studio - Start Here.html” dosyasına çift tıklayın, logonuzu, renklerinizi ve yazı tiplerinizi tasarlayın ve “Lock in my branding” düğmesine tıklayın. Asistanınız bunu kullanır. Bu adımı atlayıp markalamayı daha sonra panelinizde Branding bölümünden de değiştirebilirsiniz.
Yönergeleri kopyalayın
Bu yönergeleri kopyalayın, açılı parantezler içindeki satırı Studio klasörünüzle değiştirin ve asistanınıza yapıştırın.
Set up Maxisnap Studio for me. Maxisnap Studio is a self-hosted dashboard for the screenshots and screen recordings the Maxisnap desktop app uploads: a private library plus branded share links. It comes in two editions with the same features: a PHP app for ordinary web hosting, and a Cloudflare Worker that uses R2 and D1. Everything is in this folder on my computer: <the folder where I extracted the Studio download> Start by reading AGENTS.md in that folder. It explains both editions, the exact install steps, what must stay private, and how to check the result. If I locked in my branding, it is in snaps.zip; AGENTS.md says what to do if it is missing. Goal: Work out with me whether the PHP edition (my web hosting) or the Cloudflare Workers edition fits my setup, then install it. Rules: - Ask me before you upload, deploy, or change anything on a server or in an account, and tell me exactly what you will change. - Never delete, overwrite or rename existing website files, DNS records, Workers, buckets or databases. Studio only adds new things. - Keep keys and passwords out of files you create and out of chat transcripts where you can. - When it works, give me the Studio address and the Admin key so I can connect the Maxisnap app (on Windows, Settings, Account, Maxisnap Studio setup wizard, step 4; on a Mac, Settings, Welcome & Help, Studio Setup Guide, “I already have a dashboard”).Kopyala Kopyalandı Kopyalandı. Asistanınıza yapıştırın. Tarayıcınız kopyalamayı engelledi. Bunun yerine metni seçip kopyalayın.
Asistanınızın sorularını yanıtlayın
- Web sitenizin nerede olduğunu söyleyin: web barındırmada (cPanel, hPanel, Plesk gibi), Cloudflare'de ya da henüz hiçbir yerde. Web siteniz yoksa Cloudflare sürümü güvenli seçimdir.
- Web barındırma için neyi nereye yükleyeceğinizi söyler veya barındırmanıza erişim verirseniz yüklemeyi sizin için yapar.
- Cloudflare için sizden bir Cloudflare API token'ı ister. Token'ı Cloudflare'de My Profile → API Tokens altında, asistanınızın listelediği izinlerle oluşturun ve terminale kendiniz yapıştırın.
Cloudflare hesabı, depolama ve token adımları için ücretsiz Cloudflare hesabı rehberine bakın.
Evet demeden önce planını kontrol edin
Bir Cloudflare dağıtımından önce asistanınız size planı gösterir. “Will create” bir Worker, bir R2 kovası ve bir D1 veritabanını listeler; “Will not touch” ise hesaptaki diğer her şeyi listeler. Web barındırmada hangi klasörü ekleyeceğini söyler. Yalnızca liste doğru göründüğünde evet deyin.
Maxisnap'i bağlayın ve deneyin
Her şey çalıştığında asistanınız size Studio'nuzun adresini ve Yönetici anahtarını verir. Anahtarı parola yöneticiniz gibi güvenli bir yerde saklayın.
- Windows için Maxisnap: Ayarlar → Hesap → Maxisnap Studio kurulum sihirbazını açın, “Başlayın” düğmesine tıklayın, ardından “Maxisnap'ı bağlayın” başlıklı 4. adıma gelene kadar “İleri” düğmesine tıklayın. Studio'nuzun adresini ve anahtarını yapıştırın, “Bağlantıyı test et” düğmesine, ardından “İleri” düğmesine, son sayfada da “Bitir ve Kaydet” düğmesine tıklayın. Hem kurulumda gösterilen Yönetici anahtarı hem de panelinizdeki People & access bölümünden alınan bir yükleme kodu çalışır.
- Mac için Maxisnap: Settings → Welcome & Help → Studio Setup Guide bölümünü açın ve “I already have a dashboard” seçeneğini seçin. Studio'nuzun adresini ve anahtarını yapıştırın, “Test Connection” düğmesine, ardından “Next” düğmesine, sonra da “Finish & Save” düğmesine tıklayın.
Bir şey yakalayın ve düzenleyicide “Yükle” düğmesine tıklayın. Windows'ta Ctrl+Alt+7 bir bölgeyi yakalar ve hemen yükler. Paylaşım bağlantısı panonuza kopyalanır.
Sonraki adımlar: ekibinizi panelde People & access altından ekleyin (herkes kendi kodunu ve rolünü alır) ve logonuzu veya renklerinizi istediğiniz zaman Branding altından değiştirin.
Bir şeyler ters giderse
Asistanınız dosyaları açamadığını veya komutları çalıştıramadığını söylüyor
Bilgisayarınızda çalışan ve bir klasör üzerinde işlem yapabilen, Claude Code, Codex veya Cursor gibi bir kodlama asistanı kullanın. Tarayıcı sekmesindeki bir sohbet Studio klasörünüzü göremez ve dağıtım aracını çalıştıramaz.
Asistanınız yönerge dosyasını bulamıyor
Yönergelere yapıştırdığınız klasörü kontrol edin. ZIP dosyası değil, ayıklanmış Studio klasörü olmalıdır ve içinde yapay zeka asistanları için yönerge dosyası bulunur.
Asistanınız Node.js'in eksik ya da çok eski olduğunu söylüyor
Cloudflare dağıtım aracı Node.js 20 veya daha yeni bir sürüm gerektirir. nodejs.org adresinden güncel LTS sürümünü kurun ya da asistanınızın, ne yapacağını size söyledikten sonra kurmasına izin verin, ardından baştan başlayın. Web barındırmada çalışan Studio için Node.js gerekmez.
Asistanınız sizden sohbete bir token veya parola yapıştırmanızı istiyor
Bunun yerine, komut istediğinde terminale yapıştırın; böylece sohbet geçmişinde kalmaz. Bir Cloudflare token'ını zaten sohbete yapıştırdıysanız, Studio'nuz çalışmaya başladıktan sonra onu Cloudflare'de My Profile → API Tokens altında silin ve bir dahaki sefere gerektiğinde yenisini oluşturun.
Asistanınız bir şeyi silmek, değiştirmek veya yeniden adlandırmak istiyor
Hayır deyin. Studio yalnızca yeni şeyler ekler ve yönergeleri asistanınıza mevcut web sitesi dosyalarını, DNS kayıtlarını, Worker'ları, kovaları veya veritabanlarını asla silmemesini, üzerine yazmamasını ya da yeniden adlandırmamasını söyler. Bunun yerine yeni bir ad seçmesini isteyin.
Asistanınız markalama dosyanızın eksik olduğunu söylüyor
Markalamayı henüz sabitlemediniz. “Maxisnap Studio - Start Here.html” dosyasını açın, markalamanızı tasarlayın ve “Lock in my branding” düğmesine tıklayın ya da asistanınıza Maxisnap görünümüyle devam etmesini söyleyin. Bunu daha sonra panelinizde Branding bölümünden değiştirebilirsiniz.
Asistanınızın son kontrolü 401 veya 404 yanıtı veriyor
{"error":"unauthorized"}
401, anahtarın yanlış olduğu anlamına gelir: Yönetici anahtarını kurulumda gösterildiği haliyle aynen kullanın. 404 veya kısa bir yanıt yerine bir web sayfası gelmesi, adresin ya da klasörün yanlış olduğu veya web barındırmada Studio'nun .htaccess kurallarının yok sayıldığı anlamına gelir.
Cloudflare dağıtımı yarıda kaldı
Asistanınızdan aynı dağıtım komutunu aynı klasörden yeniden çalıştırmasını isteyin. Komut deployment.json dosyasını okur ve hiçbir şeyi iki kez oluşturmadan kaldığı yerden devam eder.
Maxisnap, asistanınızdan aldığınız adres ve anahtarla bağlanmıyor
Adres, Studio panelinizi açtığınız adrestir ve şununla başlar: https://, örneğin https://yourcompany.com/snaps. Anahtarı başında ve sonunda boşluk olmadan kopyalayın. Mevcut bir Studio'yu bağlama rehberi, her mesajın ne anlama geldiğini anlatır.
Hâlâ yardıma mı ihtiyacınız var?
Bize e-posta gönderin; bir kişi, genellikle bir iş günü içinde size geri yazar. Bu bilgiler, size tek seferde yanıt vermemize yardımcı olur:
- Seçtiğiniz kurulum seçeneği ve bulunduğunuz adım.
- Ekranın bir ekran görüntüsü, varsa hata mesajının tamamıyla birlikte.
- Studio'nuzun nereye kurulacağı: yeni ya da mevcut bir Cloudflare hesabı veya web barındırma şirketinizin adı.
- Maxisnap sürümünüz: Windows'ta Ayarlar, ardından Hakkında; Mac'te Maxisnap altında, ardından About Maxisnap.
Lütfen Yönetici anahtarınızı, bir Cloudflare anahtarını veya bir parolayı göndermeyin. Size yardım etmemiz için bunlara ihtiyacımız yok.
Diğer kurulum rehberleri
- Web sitem yok
Studio'yu ücretsiz bir Cloudflare hesabına kurun
- İşletmem zaten Cloudflare kullanıyor
Studio'yu işletmenizin Cloudflare hesabına ekleyin
- Web barındırmam var
Studio'yu web barındırmanıza kurun
- Web geliştiricisiyim
Web geliştiricileri için Studio kurulumu
- Zaten bir Studio'm var
Maxisnap'i Studio'nuza bağlayın