# Turguz'u yapay zekâ asistanınıza bağlayın > Sunucularınızı, projelerinizi ve veritabanlarınızı kullandığınız asistandan yönetin. Asistan başına kurulum adımları, listede olmayan asistanlar için gereken değerler ve erişim anahtarıyla bağlanma. Turguz, yapay zekâ asistanlarının dış araçlara bağlanması için kullanılan açık standardı (MCP, Model Context Protocol) destekler. Bağladığınızda panelde yaptığınız işleri asistanınıza söyleyerek yaparsınız: sunucu açmak, projeyi yayına almak, veritabanı kurmak, kotanıza ve kullanımınıza bakmak. Asistan Turguz'a sizin hesabınızla girer. Her istek paneldeki yetki denetiminden geçer; panelde yapamadığınız bir işi asistanla da yapamazsınız. ## Neler yapabilirsiniz Asistanınıza şöyle şeyler söyleyebilirsiniz: - "Turguz'da hangi projelerim var, hangisi yayında?" - "Projemin dev ortamını son sürümle yayına al, site açılınca adresini söyle." - "Ubuntu kurulu küçük bir sunucu aç ve bana bağlanma komutunu ver." - "Bu ortama bir veritabanı bağla." - "Son dağıtım neden başarısız oldu? Günlüğe bak." Asistanın kullanabildiği araçlar paneldeki bölümlerle aynıdır: hesap, sunucular ve korunan diskler, kiralama ve kota, projeler, ortamlar ve dağıtımlar, veritabanları, internet erişimi, yayınlar ve alan adları, izinli adresler, ekip üyeleri ve bildirimler. Platform yöneticisinin ayrıca yönetim araçları vardır. Bazı adımları asistan sizin yerinize bitiremez: depo erişimine izin vermek için açılan Git sayfasını siz onaylarsınız, kendi alan adınızın DNS kaydını siz yazarsınız. Asistan ne yapacağınızı söyler. Kök alan adında (ör. `firma.com`) asistan önce www adını önerir; kök alanı doğrudan bağlarsanız sahiplik kaydını da yazmazsanız bağlama bir yöneticinin onayını bekler. Projenizi de asistanla yükleyebilirsiniz. Asistan bilgisayarınızda komut çalıştırabiliyorsa (örneğin terminaldeki asistanlar) projenin klasörünü panelin «Arşiv yükle»siyle aynı sınırla, tek seferde yükler: kısa süre geçerli ve bir kez kullanılan bir yükleme bağlantısı alır, arşivi bilgisayarınızdan doğrudan Turguz'a gönderir. Yükleme için dosyaların içeriği asistana gitmez. Komut çalıştıramayan bir asistan yalnız kendi yazdığı küçük projeleri yükleyebilir; daha büyüğünde asistanın verdiği komutu kendiniz çalıştırın ya da projeyi panelden yükleyin. ## Başlamadan önce - Bir Turguz hesabı ve en az bir kiracıda rol. «Kiracı yöneticisi» ve «Geliştirici» değişiklik yapabilir, «İzleyici» yalnız görür. - Turguz'un MCP adresi: `https://mcp.turguz.app/mcp` ## Nasıl eklenir Aşağıda her asistanın kendi bölümü var: asistanın desteklediğine göre tek tıklık bir bağlantı, uygulamanın kendi sunucu ekleme ekranında girilecek ad ve adres, terminalde çalıştıracağınız bir komut ya da ayar dosyasına ekleyeceğiniz bir blok. Burada yalnız Turguz'la gerçekten denenmiş kurulum yolları yazar; yenileri denendikçe eklenir. Asistanınız listede yoksa **Diğer asistanlar** bölümündeki değerleri kullanın; tarayıcıyla giriş yapamayan bir asistan [erişim anahtarıyla](#erisim-anahtariyla-baglanmak) bağlanır. ### Claude Code **Turguz'u ekleyin** Terminalde çalıştırın: ```bash claude mcp add turguz https://mcp.turguz.app/mcp --transport http --scope user ``` **Bağlanın** Claude Code'u açın, `/mcp` yazın, listeden **turguz**'u seçip **Authenticate**'e basın. Tarayıcıda Turguz'un giriş sayfası açılır; panelde kullandığınız hesapla girin. Tarayıcı kendiliğinden açılmazsa Claude Code'un ekrana yazdığı adresi tarayıcıda açın. Terminalden giriş yapmak isterseniz: `claude mcp login turguz` ### Claude masaüstü **Code** sekmesinde Turguz'u terminalden eklersiniz: Claude Code bölümündeki komutu bilgisayarınızın terminalinde bir kez çalıştırın. Sonra Code sekmesinde `/mcp` yazın, listeden **turguz**'u seçip girişi başlatın. Tarayıcıda Turguz'un giriş sayfası açılır; panelde kullandığınız hesapla girin. ### VS Code **Turguz'u ekleyin** VS Code'un MCP sunucusu ekleme komutuyla HTTP türünde bir sunucu ekleyin; ad olarak `Turguz`, adres olarak `https://mcp.turguz.app/mcp` girin. **Bağlanın** Sunucuyu ilk başlattığınızda giriş istenir. Tarayıcıda Turguz'un giriş sayfası açılır; panelde kullandığınız hesapla girin. ### Codex **Turguz'u ekleyin** Codex'in masaüstü uygulaması **ChatGPT** adıyla gelir: **Ayarlar › Eklentiler › MCP'ler › Ekle**'yi açın, **MCP sunucusu ekle**'yi seçin, türü **Akış destekli HTTP** yapın; ad olarak `Turguz`, adres olarak `https://mcp.turguz.app/mcp` girin ve **Kimliği Doğrula**'ya basın. **Bağlanın** Tarayıcıda Turguz'un giriş sayfası açılır; panelde kullandığınız hesapla girin. ### Antigravity **Yapılandırmayı açın** Dosya yolu: - Bütün projeler: `~/.gemini/antigravity/mcp_config.json` **Turguz'u ekleyin** ```json { "mcpServers": { "turguz": { "serverUrl": "https://mcp.turguz.app/mcp" } } } ``` **Bağlanın** Dosyada `mcpServers` zaten varsa yalnız `turguz` girdisini onun içine ekleyin. Antigravity'de **MCP Servers** listesinde **turguz**'u bulup **Authenticate**'e basın. Tarayıcıda Turguz'un giriş sayfası açılır; panelde kullandığınız hesapla girin. Onaydan sonra tarayıcıda gösterilen kodu kopyalayıp Antigravity'deki **Enter authorization code** alanına yapıştırın. Antigravity giriş bilgisini `~/.gemini/antigravity/mcp_oauth_tokens.json` dosyasında bilgisayardaki herkesin okuyabileceği izinle saklıyor. Girişten sonra terminalde bir kez çalıştırın: `chmod 600 ~/.gemini/antigravity/mcp_oauth_tokens.json` ### Diğer asistanlar - Sunucu adresi: `https://mcp.turguz.app/mcp` - İstemci kimliği: `turguz-mcp` Asistanınız burada yoksa MCP ayarına Turguz'un adresini HTTP bağlantısı olarak girin. Asistan tarayıcıyla giriş yapıyorsa istemci kimliğini `turguz-mcp` olarak girin. Dönüş adresi bilgisayarınızda olmalı: `http://localhost:/callback` ya da `http://127.0.0.1:/callback`. İstemci kimliği girilemeyen asistan tarayıcıyla bağlanamaz. Tarayıcıyla giriş yapamayan asistan kişisel erişim anahtarıyla bağlanır: anahtarı `Authorization: Bearer ` başlığı olarak ekleyin. Aynı tarifler panelde de var: **Ayarlar** sayfasındaki «Asistan bağlantısı» bölümünde asistanınızı seçin; adres ve komut kurulumunuza göre dolu gelir. ## Erişim anahtarıyla bağlanmak **Kurulumunuza bağlı:** Bu özellik kurulumunuzda açık değilse panelde görünmez; açılmasını istiyorsanız platform yöneticinize sorun. Erişim anahtarı kurulum ayarıdır; kapalıysa Ayarlar'daki anahtar bölümü bunu söyler. Tarayıcıyla giriş yapamayan bir asistan Turguz'a kişisel bir erişim anahtarıyla bağlanabilir. Anahtarı **Ayarlar** sayfasındaki **MCP erişim anahtarları** bölümünden oluşturursunuz: [Asistan erişim anahtarları](/docs/tr/hesap-ve-ekip#asistan-erisim-anahtarlari). Asistanınızın bölümünde **Erişim anahtarıyla bağlanın** adımı varsa onu kullanın. Yoksa asistanın MCP ayarına Turguz'un adresini (`https://mcp.turguz.app/mcp`) yazın ve anahtarı `Authorization: Bearer …` başlığı olarak ekleyin. Bunun için asistanınızın bir MCP sunucusuna özel başlık eklemeye izin vermesi gerekir. Anahtarı paylaşılan ya da depoya giren bir dosyaya yazmayın; bilgisayarınızda bir ortam değişkeninde (örneğin `TURGUZ_MCP_ANAHTARI`) tutun. Anahtarla yönetici araçları kapalıdır; anahtarı kaybederseniz iptal edip yenisini oluşturun. ## claude.ai ve Claude uygulamaları **Kurulumunuza bağlı:** Bu özellik kurulumunuzda açık değilse panelde görünmez; açılmasını istiyorsanız platform yöneticinize sorun. Bulut asistan bağlantısı kurulum ayarıdır; kapalıysa Ayarlar'daki asistan bölümü bunu söyler. Claude masaüstü uygulamasında ve claude.ai sitesinde Turguz'u özel bağdaştırıcı olarak ekleyebilirsiniz. Bu yolda bağlantıyı Anthropic'in sunucuları kurar. Bu yüzden önce sizin onayınız gerekir. 1. **Ayarlar** sayfasının **Asistan bağlantısı** bölümünde **Bulut asistanı kullanıyorum** kartını açın ve onay metnini onaylayın. Onay kişiseldir: yalnız sizin bağlantınızı açar, ne zaman verdiğiniz kayda geçer. 2. Claude'da **Ayarlar › Bağdaştırıcılar** (Settings › Connectors) bölümünde **Özel bağdaştırıcı ekle**'ye (Add custom connector) basın. 3. Ad olarak `Turguz`, adres olarak `https://mcp.turguz.app/mcp` girin ve **Bağlan**'a basın. Tarayıcıda Turguz'un giriş sayfası açılır; panelde kullandığınız hesapla girin. Bilmeniz gerekenler: - Asistanın eriştiği veri Anthropic'e gider ve yurt dışında işlenebilir. Bu bağlantı sizin kararınız ve sorumluluğunuzdadır; onayı kurumunuz adına ve kendi kullanımınız bakımından verirsiniz (sorumluluk reddi beyanı, madde 8.3, 2.1 ve 2.2). - Platform yöneticileri de, kiracı yasaklamadıkça, bulut asistanıyla kiracınıza erişebilir. - Kurumunuz bir kiracıda bulut asistanını yasaklayabilir. Yasaklı kiracıya bulut asistanıyla bağlanamazsınız; o kiracı asistanın gördüğü hiçbir yanıtta yer almaz. Yasağı kiracı yöneticisi aynı bölümden koyar ve kaldırır; platform yöneticisinin koyduğu yasağı yalnız platform yöneticisi kaldırır. - Girişiniz Anthropic'te saklanır. Bağdaştırıcıyı Claude'un ayarlarından kaldırınca bağlantı kesilir. - Asistan bu yolda da panelde yapabildiğiniz işleri, aynı yetkiyle yapar: talep açar, bildirimlerinizi okur, üyeleri ve ekipleri yönetir. Uygulama çıktıları (günlükler, konsol, komut çıktısı) ve dosyalar da asistana gider; bunlar uygulamanızın ziyaretçilerine ait kişisel veri taşıyabilir. - Yönetim araçları ve yakın zamanda yeniden giriş isteyen işler bu yolda yoktur; onları panelden ya da bilgisayarınızdaki asistandan yapın. - Parolalar, gizli değerler ve kişilerin adı, soyadı ve e-postası asistana gitmez; üyeler kullanıcı adı, rol ve ekibiyle görünür. - Kapsam genişlediğinde önceki onayınız geçmez; asistan "önce onay verin" der, yeni metni okuyup yeniden onaylarsınız. - Onayınızı geri alırsanız ya da kiracınız yasaklanırsa erişim hemen kesilir; asistan size nedenini söyler. ## Giriş ne kadar sürer Asistanın girişi 7 gün hiç kullanılmazsa sona erer; kullansanız da en geç 30 günde bir yeniden giriş istenir. Asistanı kullanmayı bırakmak için Turguz kaydını asistanın ayarlarından kaldırın (örneğin Claude Code'da: `claude mcp remove turguz -s user`). Giriş kendisi 7 gün kullanılmayınca kendiliğinden sona erer. Bağlantıyı panelden kesmek için **Ayarlar** sayfasındaki oturum listesinde asistanın oturumunu «Kapat» ile kapatın: asistan yeniden giriş ister, aynı asistanı hemen yeniden bağlayabilirsiniz. Girişin başkasının eline geçtiğini düşünüyorsanız oturumu kapatın ve platform yöneticisine haber verin. Erişim anahtarıyla bağlandıysanız anahtarı iptal edin; bağlantı bir dakika içinde kesilir. ## Yetki ve güvenlik - Asistan sizin hesabınızla çalışır ve rolünüzün izin verdiği işleri yapar. Yönetim araçları yalnız platform yöneticisinde çalışır; başkasında "yetkiniz yok" yanıtı verir. - Bir kiracıyı silmek gibi geri dönüşü olmayan işler yakın zamanda yapılmış bir giriş ister. Asistan bunu söylerse asistanın MCP ayarından girişi yenileyin (örneğin Claude Code'da: `/mcp` → turguz → yeniden giriş). Erişim anahtarıyla bağlı asistan bu işleri yapamaz; onları panelden yapın. - Uygulamalarınızın günlükleri, komut çıktıları ve dış sistemlerden gelen mesajlar asistana işaretler arasında, talimat değil veri oldukları uyarısıyla verilir. Bu riski azaltır ama ortadan kaldıramaz: geri dönüşü olmayan bir işi onaylamadan önce asistanın önerdiğini gözden geçirin. - Bağladığınız asistanın erişebildiği veriler o asistanın hizmet sağlayıcısına aktarılır; sağlayıcı yurt dışında olabilir. Bağlantı sizin kararınız ve sorumluluğunuzdadır (onayladığınız sorumluluk reddi beyanı, madde 8.3). - Asistan, «Sorumluluk Reddi Beyanı»nı onaylamamış bir hesapla çalışmaz ve Beyan'ı sizin yerinize onaylayamaz. Asistan onay gerektiğini söylerse panele girip Beyan'ı onaylayın. - Kimin hangi adresten ne zaman bağlandığını gösteren erişim kayıtları asistana hiç verilmez; yalnız panelde, platform yöneticisine görünür. ## Sorun giderme ### Giriş sayfası "redirect_uri" hatası veriyor Asistanın dönüş adresi Turguz'un beklediği biçimde değil. Komutu ya da bloğu bu sayfadaki bölümünden (ya da Ayarlar'dan) yeniden kopyalayın. Listede olmayan bir asistanda dönüş adresinin bilgisayarınızda olduğunu ve `/callback` ile bittiğini denetleyin. ### Araçlar iki kez görünüyor Turguz aynı adla iki yerde kayıtlı. Claude Code'da `claude mcp list` ile bakın ve fazlasını kaldırın: `claude mcp remove turguz -s local` ya da `claude mcp remove turguz -s project`. ### Uzak bir makinede giriş tamamlanmıyor Claude Code başka bir makinede çalışıyorsa giriş bağlantısını kendi bilgisayarınızın tarayıcısında açın. Girişten sonra tarayıcı `http://localhost` ile başlayan bir adrese gider ve "bağlanılamadı" der; bu beklenen bir durum. Adres çubuğundaki adresin tamamını kopyalayıp Claude Code'a yapıştırın. Claude masaüstü uygulamasından uzak bir makineye bağlıyken giriş tamamlanmıyorsa o makinede terminal açın, `claude` yazın ve girişi orada `/mcp` ile yapın. ### Asistan yeniden giriş istiyor Giriş süresi dolmuştur. Asistanın MCP ayarından girişi yeniden başlatın (örneğin Claude Code'da `/mcp` ile). ### Uzun bir bekleme yarıda kesiliyor Asistan bir araç çağrısının yanıt ya da ilerleme göndermediği için kesildiğini söylerse ("sent no response or progress") aynı adımı yeniden isteyin. Turguz'daki iş sürer; bekleyen araçlar kaldığı yerden devam eder. ### "Yetkiniz yok" yanıtı O iş rolünüzün dışında. Yönetim araçları yalnız platform yöneticisinde çalışır; bir kiracıda değişiklik yapmak için «Kiracı yöneticisi» ya da «Geliştirici» rolü gerekir.