Naftiko Shipyard: MCP Sunucusunu 2 Dakikada Cloudflare’da Konumlandırın

İşletmelerin dijital dönüşümünde veri entegrasyonunun karmaşıklığını azaltmak için tasarlanan Naftiko Framework, artık MCP sunucularını sadece iki dakika içinde Cloudflare Containers üzerinden dağıtmanıza olanak tanıyor. Bu yeni yaklaşım, geliştiricilerin karmaşık yapılandırmalarla uğraşmadan AI araçlarına doğrudan bağlanabilen özel sunucular oluşturmasını sağlıyor.

Naftiko Shipyard ile neler dağıtılıyor?

Naftiko Shipyard aracılığıyla yalnızca bir tıklama ile aşağıdaki bileşenler otomatik olarak devreye alınıyor:

• Üç protokol adaptörü (tek bir yetenek YAML dosyasından):
• MCP sunucusu (POST /mcp yöntemiyle): list-ships, get-ship, list-legacy-vessels, create-voyage, get-ship-with-crew, get-voyage-manifest gibi işlevleri destekliyor.
• REST adaptörü: Aynı alan adında /api uç noktaları üzerinden erişilebiliyor.
• Beceri sunucusu (/skill): Yapılandırılmış ajan keşfi için beceri gruplarını yönetiyor.

Bu bileşenler, iki harici API’yi tüketiyor:

• Denizcilik Sicili API’si (mocks.naftiko.net/rest/naftiko-shipyard-maritime-registry-api/1.0.0-alpha2) — bearer token doğrulaması.
• Eski Liman API’si (mocks.naftiko.net/rest/naftiko-shipyard-legacy-dockyard-api/1.0.0-alpha2) — API anahtarı doğrulaması.

Her iki API de Naftiko tarafından sağlanan sahte uç noktalar olup, dağıtım sırasında otomatik olarak dummy token’larla çalışacak şekilde ayarlanıyor. Bu sayede, herhangi bir gerçek API anahtarı ya da kimlik bilgisi gerekmemektedir.

MCP sunucusu için ise, dağıtım sırasında otomatik olarak oluşturulan dummy bir bearer token (sk-mcp-YYYYYYYYYYYY) kullanılıyor.

Cloudflare mimarisi nasıl çalışıyor?

Naftiko Framework’un çekirdek motoru, ghcr.io/naftiko/framework:latest imajı olarak sunuluyor. Bu imaj, Cloudflare Containers üzerinde Docker konteynerleri olarak çalıştırılıyor. Dağıtım işlemi, sadece beş dosya aracılığıyla tamamlanıyor:

• Yeteneğe ait YAML dosyası (yapılandırmayı tanımlayan dosya).
• Üç ortak import dosyası (ortak bağımlılıkları ve yapılandırmaları içeriyor).
• Dockerfile (çevre kurulumunu otomatikleştiriyor).
• wrangler.json (Cloudflare Worker yapılandırmasını tanımlıyor).
• Worker kodu (gelen istekleri ilgili porta yönlendiriyor):

  /mcp → 3001
  /skill → 3003
  Diğer tüm istekler → REST adaptörü (3002)

Bu mimari, Naftiko’nun üretimdeki gerçek projelerinde de kullanılan aynı yapıya sahip**. Örneğin, manage-companies projesi de bu şekilde çalıştırılıyor. Shipyard’in sunduğu bu uçtan uca dağıtım modeli, yalnızca bir eğitim örneği değil, aynı zamanda üretimde de doğrudan uygulanabilir bir şablon sunuyor.

Tek tıklama ile canlıya alın: Adım adım süreç

Dağıtım işlemi, sadece iki ila üç dakika sürüyor ve tamamen otomatikleştirilmiş bir süreç izliyor:

1. Cloudflare hesabınıza giriş yapın (henüz hesabınız yoksa ücretsiz olarak kaydolabilirsiniz).
2. Naftiko Shipyard deposunu fork’layın (GitHub üzerinden).
3. Cloudflare’daki "Deploy with Workers" butonuna tıklayın.
4. Cloudflare, otomatik olarak aşağıdaki adımları gerçekleştiriyor:

• Depoyu fork’luyor.
• Bir Worker ve bir Container oluşturuyor.
• Dockerfile’ı derliyor.
• *.workers.dev alan adını atıyor.

İşlem tamamlandığında, aşağıdaki uç noktalar kullanıma hazır hale geliyor:

• Ana sayfa: `
• MCP sunucusu: `
• REST adaptörü: `
• Beceri sunucusu: `

Bu MCP uç noktası, doğrudan AI araçlarınıza bağlanmanızı sağlıyor.

AI araçlarınıza MCP sunucusunu ekleyin

AI yardımcılarınızla entegrasyon sağlamak için MCP sunucusunun URL’sini aşağıdaki gibi yapılandırmanız gerekiyor. Varsayılan bearer token’ı değiştirmediyseniz, sk-mcp-YYYYYYYYYYYY değerini kullanabilirsiniz.

Claude Desktop

Claude Desktop yapılandırma dosyasını düzenleyin:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "naftiko-shipyard": {
      "type": "streamable-http",
      "url": "
      "headers": {
        "Authorization": "Bearer sk-mcp-YYYYYYYYYYYY"
      }
    }
  }
}

Değişiklikleri kaydedin ve Claude Desktop’u yeniden başlatın. MCP araçları araç çubuğunda görünecektir.

Claude Code

Komut satırı üzerinden MCP sunucusunu ekleyin:

claude mcp add --transport http naftiko-shipyard  \
  --header "Authorization: Bearer sk-mcp-YYYYYYYYYYYY"

Yapılandırmayı doğrulamak için claude mcp list komutunu çalıştırın.

ChatGPT (Pro ve Enterprise planları)

ChatGPT’ye özel bir MCP bağlayıcı ekleyin:

1. Ayarlar → Bağlayıcılar → Özel → Yeni ekle.
2. Sunucu URL’si: `
3. Yetkilendirme: Özel başlık olarak Authorization, değeri ise Bearer sk-mcp-YYYYYYYYYYYY olarak ayarlayın.

Gemini CLI

Gemini ayar dosyasını düzenleyin:

~/.gemini/settings.json

{
  "mcpServers": {
    "naftiko-shipyard": {
      "httpUrl": "
      "headers": {
        "Authorization": "Bearer sk-mcp-YYYYYYYYYYYY"
      }
    }
  }
}

Değişiklikleri kaydedin ve Gemini’yi yeniden başlatın. /mcp list komutuyla yapılandırmayı doğrulayın.

Neden bu önemli?

Shipyard’in sunduğu bu uçtan uca dağıtım modeli, yalnızca bir eğitim örneği değil. Gerçek bir Naftiko yeteneğinin nasıl yapılandırıldığına dair birebir bir örnektir. Aynı tek tıklama deseni kullanılarak:

• Yeteneğe ait YAML dosyasını değiştirin.
• Depoyu fork’layın ve yeniden dağıtın.
• Farklı bir MCP sunucusunu aynı URL üzerinden çalıştırın.

Bu, geliştiricilere kontrol edilebilir, üretim kalitesinde bir MCP sunucusu sunmanın kapısını açıyor. AI araçlarınıza entegre edebileceğiniz kamu erişimine açık bir MCP uç noktası oluşturmak artık sadece birkaç dakika sürüyor.

Geliştirici topluluğunun gelecekteki projelerinde bu modelin ne kadar yaygınlaşacağını ve AI entegrasyonunun ne kadar basitleşeceğini görmek heyecan verici. AI çağında, veri entegrasyonunun karmaşasını ortadan kaldıran araçlar, geliştiricilerin yeniliklere odaklanmasını sağlayacak.