Cloudways MCP: Access Token yetkileri, Claude·Cursor bağlantısı ve yapay zekâ ile sunucu yönetimi
Cloudways MCP'yi Claude Code'a bağlayıp salt okunur bir Access Token ile Cloudways sunucularını sohbet üzerinden sorgulama ayarını tamamladım. Adından dolayı Cloudways sunucusuna bir şey kurulduğu sanılabilir, ancak kaydın yapıldığı yer aslında yapay zekâ programı tarafındaki ayar dosyasıdır.
Aynı token ile sunucu listesini, hizmet durumunu ve CPU kullanımını sorguladım; önbellek boşaltma isteğinin yetki hatasıyla reddedildiğini de doğruladım.
1️⃣ Cloudways MCP nasıl çalışır
Cloudways MCP, Claude·Cursor·ChatGPT gibi yapay zekâ programlarının Cloudways API'sini sizin yerinize çağırmasını sağlayan bir bağlantı sunucusudur ve tüm Cloudways müşterilerine ek ücret olmadan sunulur.
Yapı üç parçaya ayrılır. Yapay zekâ programı (MCP istemcisi) isteği alıp kullanılacak aracı seçer; Cloudways'in işlettiği uzak MCP sunucusu (mcp.cloudways.com) bu isteği Cloudways API çağrısına dönüştürüp çalıştırır. Yönetilen Cloudways sunucusuna hiçbir şey kurulmaz.
Kayıt, Claude Code'un kurulu olduğu bilgisayarda yapılır; Windows PC'de de mümkündür. Bu kez Cloudways sunucusunda değil, Claude Code'u kurup kullandığım ayrı bir Linux sunucusunda yaptım.
250'den fazla araç vardır ama yapay zekâ programı ilk etapta 66 tanesini görür. Geri kalanlar istendiğinde bulunup çalıştırıldığı için ayrıca ayarlanacak bir şey yoktur.
2️⃣ Access Token oluşturma ve yetki kapsamı
MCP adresini kaydetseniz bile Access Token yoksa Cloudways istekleri kabul etmez. Token, Cloudways'in sağ üstündeki profil menüsünde [API Integration] bölümünden oluşturulur.
[Create Access Token] düğmesine bastığınızda ad, geçerlilik süresi ve yetki kapsamının belirlendiği bir pencere açılır; işleme oradan devam edilir.
Yetki kapsamı (Scope) üç türlüdür ve varsayılanı [Limited Access(Beta)]'dır. [Read-Only Access] sunucu durumunu, uygulama ayarlarını ve kullanımı yalnızca sorgular, oluşturma·değiştirme·silme yapamaz; [Full Access] hesap yetkileri dahilindeki tüm API'leri kullanır. [Limited Access] yalnızca seçilen işlevlere izin verir.
İlk bağlantıda [Read-Only Access] ile başlayın. [Read-Only Access] ile yanlışlıkla bir şey silme riski yoktur; ancak önbellek boşaltma ya da yedekleme gibi bir işlemi yaptırmak için [Limited Access] ile yalnızca o işlevi açmanız gerekir.
Geçerlilik süresi 1 günden süresiz seçeneğine kadar seçilebilir; testte 1 ay kullanıldı.
Token değeri yalnızca oluşturulurken bir kez gösterilir; pencere kapanınca tekrar görülemez ve iptal edip (Revoke) yenisini oluşturmak gerekir, bu yüzden token değerini sayfadan ayrılmadan kopyalayın.
Eski API Key yöntemi Ekim 2026'nın ortasında sona erdiği için API Key ile bağlanmış MCP'nin de Access Token'a geçirilmesi gerekir.
3️⃣ Claude·Cursor·VS Code bağlantı ayarları
Token oluşturulsa bile yapay zekâ programına kaydedilene kadar sohbette kullanılamaz. Claude Code uzak HTTP MCP'yi doğrudan desteklediği için tek satırlık bir komutla kaydedilir. Bu kez komutu, Claude Code'u kurup kullandığım ayrı bir Linux sunucusunun (Cloudways sunucusu değil) terminalinde çalıştırdım.
claude mcp add --transport http --header "X-Access-Token: YOUR_TOKEN" --header "X-Mcp-Host: claude-code" -s user cloudways https://mcp.cloudways.com/mcp/Komuttaki [cloudways] kayıt adıdır; [X-Access-Token] alanına oluşturduğunuz Access Token'ı, [X-Mcp-Host] alanına da kullandığınız yapay zekâ programının adını (claude-code) yazın. Yalnızca [cw_] ile başlayan değeri girin; yönergedeki açılı ayraçları (< >) da eklerseniz token olarak tanınmaz.
[-s user] ile kaydederseniz claude'u hangi klasörde çalıştırırsanız çalıştırın Cloudways araçları görünür; [-s local] ise yalnızca komutun çalıştırıldığı klasörde çalıştırıldığında görünür. İlk başta çalışma klasörüne local olarak kaydettim ama başka bir klasörde çalıştırınca araçlar görünmedi, bu yüzden user olarak değiştirdim.
user olarak kaydedilse bile Claude Code önce yalnızca araç adlarını, açıklamaları ise kullanım sırasında yüklediği için local'e göre token kullanımında büyük bir fark olmaz.
claude mcp list
cloudways: https://mcp.cloudways.com/mcp/ (HTTP) - ✔ Connected[claude mcp list] komutunu çalıştırın; [cloudways] satırının sonunda [Connected] görünüyorsa bağlantı kurulmuştur. Kaydettikten hemen sonra mevcut sohbette kullanılamaz. MCP araçları oturum başlarken yüklendiği için Cloudways araçları yeni açılan oturumdan itibaren görünür.
Kayıt bilgileri, Claude Code'un ayar dosyası olan ev klasöründeki [.claude.json] dosyasına yazılır; Linux root hesabında bu dosya [/root/.claude.json]'dır. user, bu dosyanın en üstündeki [mcpServers] bölümüne; local ise [projects] altında ilgili klasör yoluna kaydedilir. Windows'taki Claude Desktop'ta aynı adres ve token [%APPDATA%\Claude\claude_desktop_config.json] dosyasına yazılır.
Cursor·VS Code gibi diğer yapay zekâ programlarında da ayar dosyasına aynı adres ve token yazılır; programa özel biçim için Cloudways Yardım Merkezi yönergelerine bakın.
4️⃣ İstemlerle yapılabilecek işler
Read-Only token ile bağlıyken sırasıyla sunucu listesini, sunucu ayrıntılarını, hizmet durumunu, CPU kullanımını, uygulama listesini ve SSL sertifikası durumunu istedim; sorgu isteklerinin hepsi sonuç döndürdü. Aşağıdaki yanıt süreleri, Cloudways MCP sunucusunun sonucu döndürdüğü süredir ve yapay zekânın yanıtı düzenleme süresini içermez.
| İstek | Çalışan araç | Yanıt süresi | Yanıt içeriği |
|---|---|---|---|
| Sunucu listemi göster | server_list | 0,72 sn | 1 sunucu, çalışıyor (running), Vultr Seul bölgesi, 1 GB, MariaDB 10.11 |
| Sunucu ayrıntılarını söyle | server_get | 0,68 sn | Debian 12, 25 GB disk, 1 kurulu uygulama (WordPress) |
| Hizmet durumunu kontrol et | service_status | 5,10 sn | 8 çalışıyor (Nginx·Apache·MySQL·PHP 8.2-FPM·Redis·Varnish·Memcached·Imunify360), 1 durdurulmuş (New Relic) |
| Son 24 saatin CPU kullanımı | monitoring_server_graph | 1,75 sn | 5 dakika aralıklarla 288 değer, ortalama kullanım yaklaşık %13, en yüksek yaklaşık %30 |
| Uygulama listesini göster | app_list | 0,67 sn | 1 WordPress, bağlı alan adı cw.testpilotweb.com |
| SSL sertifikası durumunu kontrol et | app_get | 3,04 sn | Let's Encrypt kurulu ve doğrulandı, otomatik yenileme açık |
| Önbelleği boşalt | app_purge_cache | 0,42 sn | Çalıştırma reddedildi — 403 insufficient_scope |
CPU kullanımı boşta CPU (Idle CPU) oranı olarak döner; ortalama %86,8, yaklaşık %13 kullanıma karşılık gelir. SSL durumunu sorgulayan ayrı bir araç olmadığından durumu uygulama ayrıntılarındaki ([app_get]) Let’s Encrypt öğesinden kontrol ettim.
Yapay zekâdan ne istenirse çalıştırılacakmış gibi görünse de neyin çalışacağını token yetkileri belirler. Önbellek boşaltmayı istediğimde [app_purge_cache] aracı çalıştı, ancak Cloudways isteği [Cloudways API error (403): This token does not have access to this endpoint — insufficient_scope] hatasıyla reddetti.
Hangi araçların yazma işlemi yaptığını [get_write_tools] aracının döndürdüğü listeden kontrol edebilirsiniz.
5️⃣ Bağlantı hataları ve araç listesini yenileme
Bağlantı kurulmazsa önce [claude mcp list] çıktısında [cloudways] satırının [Connected] olup olmadığına bakın. Adres sondaki eğik çizgiye kadar [https://mcp.cloudways.com/mcp/] ile aynı değilse hata mesajı olmadan bağlantı kurulmaz; [401 Unauthorized] çıkarsa token yanlış girilmiş ya da iptal edilmiş veya süresi dolmuştur.
Token'ı değiştirirken [claude mcp remove cloudways -s user] ile kaydı silip yeni token ile yeniden kaydedin; terminalde [claude] komutu çalışmazsa Claude Code çalıştırılabilir dosyasını tam yoluyla belirterek çalıştırın.
Pencereyi kapatıp yeniden açınca araç listesinin de yenileneceği düşünülebilir, ancak Claude Desktop·Cursor gibi programlar ilk bağlantıdaki araç listesini saklar ve pencere kapansa bile sistem tepsisinde çalışmayı sürdürür. Cloudways araç ekledikten sonra yeni araçlar görünmüyorsa ayarlardan cloudways bağlantısını devre dışı bırakıp yeniden etkinleştirin ya da programı tamamen kapatıp (macOS'ta Cmd+Q, Windows'ta tepsi simgesinden Çıkış) yeniden başlatın.
🔢 SSS & önerilen içerikler
ℹ️ Satış ortaklığı bildirimi
Bu sitenin içeriklerinde satış ortaklığı bağlantıları bulunur. Bir ziyaretçi bu bağlantılar üzerinden ürün veya hizmet satın alırsa bu site satıcıdan komisyon alır. Bu süreçte alıcının ödediği tutar (kampanya indirimlerinde tutar düşer↓) artmaz. Yayımlanan fiyat, indirim ve stok bilgileri yazının yazıldığı zamana aittir ve gerçek durumdan farklı olabilir; bu yüzden satın almadan önce son bilgiyi satıcıdan kontrol etmenizi rica ederiz. Ürünler kendi ölçütlerimize göre seçilir ve değerlendirilir; komisyon alınıp alınmaması tanıtım sırasını veya değerlendirme içeriğini etkilemez.