MCP sunucusu: AI uygulamalarında görsel, video ve konuşma

Claude, ChatGPT, Cursor, VS Code ve diğer yapay zekâ uygulamalarına Zurelay’in görsel, video ve konuşma modellerini ekleyin. MCP sunucusunu bir kez bağlayın, oturum açın ve sohbette bir görsel, video klip veya seslendirme isteyin: Nano Banana, GPT Image, Seedance, Kling, Wan veya Gemini TTS ile oluşturulur, ücreti API ile aynı fiyatlardan Zurelay bakiyenizden düşülür.

https://api.zurelay.com/mcp

Uzak bir sunucudur (Streamable HTTP), bu yüzden kurulum gerektirmez. Uygulamadan oturum açın veya bir API anahtarı gönderin. Resmî MCP Registry’de com.zurelay/mcp olarak listelenir.

Ne işe yarar

Sohbet modelleri burada araç olarak sunulmaz: bir model üzerinde çalışan uygulamanın zaten bir modeli vardır. Claude Code, Cursor veya başka bir uygulamayı Zurelay’in sohbet modelleriyle çalıştırmak için temel URL’sini değiştirin (bkz. Entegrasyonlar).

Uygulamanızı bağlayın

Aşağıdaki tüm uygulamalar oturum açabilir: zurelay.com’da bir kez onay verirsiniz ve anahtar yapıştırmanız gerekmez. Oturum açamayan uygulamalar veya tarayıcı açılmaması gereken kurulumlar (sunucular, CI) ise API anahtarı gönderir.

Claude (web, masaüstü ve mobil)

Zurelay’i Claude’a ekle, formu doldurulmuş olarak açar. Elle eklemek için:

1. Özelleştir, ardından Bağlayıcılar bölümüne gidin, Ekle ve ardından Özel bağlayıcı ekle seçeneğini seçin.
2. Adını Zurelay yapın ve MCP sunucusu URL’si olarak https://api.zurelay.com/mcp yapıştırın. OAuth istemcisi için iki seçenek de çalışır: Claude’un yayımlanmış kimliğini kullan veya Otomatik kaydet. Ardından ekleyin.
3. Bağlan seçeneğini seçin. Zurelay açılır: oturum açın, günlük harcama limiti belirleyin ve İzin ver seçeneğini seçin.
4. Bir sohbette + menüsünü, ardından Bağlayıcılar bölümünü açın, Zurelay’i etkinleştirin ve ne istediğinizi söyleyin: “Şunun 16:9 bir posterini oluştur…”, “Bunu 5 saniyelik bir klibe dönüştür”, “Bunu sakin bir sesle oku”.

Bağlayıcılar web’de, masaüstü uygulamasında ve telefonunuzda, tüm planlarda çalışır (Free, bir özel bağlayıcıya izin verir). Team ve Enterprise planlarında bir hesap sahibi, Kuruluş ayarları, Bağlayıcılar bölümünden (Ekle, Özel, Web) Zurelay’i ekler; ardından her üye kendi Zurelay hesabını bağlar.

Claude Code

claude mcp add --scope user --transport http zurelay https://api.zurelay.com/mcp

Ardından Claude Code’da /mcp yazın, zurelay seçeneğini seçin ve açılan tarayıcıda oturum açın (veya claude mcp login zurelay çalıştırın). Bunun yerine API anahtarı kullanırsanız tarayıcı gerekmez:

claude mcp add --scope user --transport http zurelay https://api.zurelay.com/mcp \
  --header "Authorization: Bearer $ZURELAY_API_KEY"

--scope user, bunu tüm klasörler için ekler. Bu seçeneği kullanmazsanız yalnızca Claude Code’u ekleme işlemini yaptığınız klasörde çalıştırdığınızda görünür; projenin .mcp.json dosyası üzerinden paylaşmak için --scope project kullanın (anahtarları paylaşılan dosyalara koymayın: .mcp.json, ${ZURELAY_API_KEY} değerini ortamdan okur). Komutu Claude Code içinde değil, normal bir terminalde çalıştırın ve Claude Code zaten açıksa yeniden başlatın.

ChatGPT

1. Ayarlar, Güvenlik ve oturum açma bölümünde Geliştirici modu seçeneğini açın (Plus, Pro, Business, Enterprise ve Edu; çalışma alanı yöneticisinin izin vermesi gerekebilir).
2. ChatGPT Eklentileri bölümünü açın ve + düğmesine basın. Adını Zurelay yapın ve bağlantı URL’si olarak https://api.zurelay.com/mcp girip OAuth’u seçin.
3. Zurelay’de oturum açın ve İzin ver seçeneğini seçin. Bir sohbette + menüsünü açın, Geliştirici modu seçeneğini ve ardından Zurelay’i seçin.

ChatGPT yalnızca oturum açarak bağlanabilir: API anahtarı gönderemez.

Cursor

Zurelay’i Cursor’a ekle seçeneğini kullanın, ardından oturum açmak için Cursor’ın MCP ayarlarında yanındaki Bağlan seçeneğini seçin. Ya da ~/.cursor/mcp.json (tüm projeler) veya .cursor/mcp.json (tek proje) dosyasına ekleyin:

{
  "mcpServers": {
    "zurelay": {
      "url": "https://api.zurelay.com/mcp"
    }
  }
}

VS Code

Zurelay’i VS Code’a ekle seçeneğini kullanın veya projenizdeki .vscode/mcp.json dosyasına ekleyin (ya da Komut Paleti’nden MCP: Sunucu Ekle komutunu çalıştırıp HTTP’yi seçin). Copilot’un ajan modu ilk kez kullandığında VS Code sizden oturum açmanızı ister. API anahtarı kullanırsanız anahtarı bir kez ister ve şifrelenmiş olarak saklar:

{
  "servers": {
    "zurelay": {
      "type": "http",
      "url": "https://api.zurelay.com/mcp"
    }
  }
}

Yapay zeka ajanları

Sürekli çalışan ve kişisel ajanlar da sunucuyu aynı şekilde ekler: Grok Bot ve Meta Muse, bunu isteyen bir mesaj yapıştırdığınızda; OpenAI dots, ChatGPT’nin eklentileri üzerinden; Gemini Spark, Manus ve Perplexity ise bağlayıcı ayarlarından. OpenClaw ve Hermes Agent da bunu kullanabilir veya onayladığınız bir bağlantı üzerinden kendilerine ait bir anahtar almalarını sağlayan Zurelay becerisini kullanabilir. Her ajanın adımları Yapay zekâ ajanları sayfasındadır.

Codex, Gemini CLI ve diğer uygulamalar

Streamable HTTP üzerinden MCP’yi destekleyen tüm uygulamalar çalışır. Codex codex mcp login zurelay ile, Gemini CLI ise /mcp auth zurelay ile oturum açar; anahtar kullanmak için çoğu uygulama Authorization üst bilgisini kabul eder:

# or: codex mcp add zurelay --url 'https://api.zurelay.com/mcp' --bearer-token-env-var ZURELAY_API_KEY
[mcp_servers.zurelay]
url = "https://api.zurelay.com/mcp"
bearer_token_env_var = "ZURELAY_API_KEY"

Oturum açma veya API anahtarı

Giriş yapmak kolay ve daha güvenli yoldur. Uygulama zurelay.com’u açar; burada e-postayla gelen kodla giriş yapar, harcamaların yapılacağı çalışma alanını ve günlük harcama limitini seçip izin verirsiniz. Ardından Zurelay, Anahtarlar sayfanıza bu limitle, “Claude (MCP)” gibi uygulamanın adını taşıyan bir anahtar ekler. Uygulama API anahtarını hiç görmez: bir saat geçerli bir erişim belirteci ve her kullanımda değişen bir yenileme belirteci tutar. İkisi de yalnızca MCP sunucusunda çalışır, API’nin diğer bölümlerinde kullanılamaz. Limiti Anahtarlar sayfasından değiştirebilir veya anahtarı iptal ederek uygulamanın bağlantısını kesebilirsiniz.

API anahtarı Authorization: Bearer zr_live_… başlığına eklenir. Anahtarın tüm ayarları geçerlidir: bütçeleri, istek hızı limiti, izin verilen modeller ve IP adresleri. Yoğun çalışan bir ajanın planladığınızdan fazla harcamaması için uygulamaya özel, günlük bütçesi olan bir anahtar oluşturun (bkz. Anahtar limitleri ve kuralları). Claude ve ChatGPT gibi uygulamalar kendi sunucularından istek gönderir; bu yüzden onlar için oluşturduğunuz anahtarda izin verilen IP adreslerini boş bırakın.

Fiyatlar, bağlantılar ve bekleme

• Fiyatlar API ile aynıdır: modeller sayfasından her modelin fiyatına bakın veya yapay zekâdan list_models çağrısı yapmasını isteyin. Başarısız istekler için ücret alınmaz; videolar ise yalnızca tamamlandığında ücretlendirilir.
• Bir araç yaklaşık 35 saniye içinde yanıt verir. Görseller ve konuşma genellikle bu sürede hazır olur; daha uzun süren işlemler (çoğu video) bir kimlikle döner ve yapay zekâ get_result çağrısı yapar. Bu çağrı her seferinde en fazla 45 saniye daha bekler.
• Sonuçlar, depolama alanımızdaki dosyalara yönlendiren ve 24 saat geçerli olan bağlantılardır. Görseller ve videolar Kitaplığınızda 30 gün kalır ve her istek, diğerleri gibi İstekler sayfanızda görünür.
• Görseller ayrıca küçük bir önizlemeyle döner; böylece yapay zekâ ürettiği görseli görüp düzenleyebilir. Bağlamdan tasarruf etmek için önizlemeleri dahil etmemesini isteyin.

Bilgisayarınızdaki dosyalar

Bir görseli düzenlemek veya bir kareyi canlandırmak için modelin dosyaya bir bağlantı üzerinden erişmesi gerekir. Zaten internette olan dosyaları https bağlantılarıyla iletebilirsiniz. Bilgisayarınızdaki dosyalar için komut çalıştırabilen uygulamalar (Claude Code, Cursor, Codex) create_upload_link kullanır: en fazla 20 MB boyutunda tek bir PNG, JPEG, WebP, MP4, MOV, MP3 veya WAV dosyası, 15 dakika içinde yüklenir. Dönen bağlantı 2 saat geçerlidir ve dosya 2 gün sonra silinir. Yükleme bağlantıları için hesapta kredi bulunmalıdır.

# 1. The agent calls create_upload_link and gets a one-time URL.
# 2. It uploads the file with curl:
curl -sS -T ./product-photo.png 'https://api.zurelay.com/mcp/uploads/…'
# {"url":"https://…/inputs/2026-10-05/….png","type":"image/png","bytes":482113,…}
# 3. It passes that url to generate_image's reference_images or generate_video's first_frame.

Güvenlik

• Giriş işlemi MCP belirtimine uyar: PKCE ile OAuth 2.1 (yalnızca S256), yalnızca kayıtlı yönlendirme adresleri ve 5 dakika geçerli tek kullanımlık kodlar. Bir kod ikinci kez kullanılırsa o kod karşılığında verilen erişim sonlandırılır.
• Belirteçler rastgele oluşturulur ve yalnızca SHA-256 özetleri olarak saklanır. Erişim belirteçleri bir saat geçerlidir ve yalnızca MCP sunucusunda çalışır. Yenileme belirteçleri her kullanımda değişir; bir belirtecin bir dakikadan fazla süre geçtikten sonra yeniden kullanılması, kopyalandığı anlamına gelir. Bu durumda bağlantı kesilir ve anahtarı iptal edilir.
• Her bağlantı, Anahtarlar sayfanızda kendi günlük limiti olan ve çalışma alanınızın üyelerine görünen bir anahtardır. Anahtarı iptal etmek veya çalışma alanından ayrılmak uygulamanın bağlantısını keser.
• İzin sayfası başka bir sitenin içinde gösterilemez; uygulamanın Zurelay tarafından tanınmadığını ve sizi nereye yönlendireceğini belirtir.
• Yükleme bağlantıları imzalıdır, tek dosya kabul eder ve 15 dakika sonra geçersiz olur; yüklenen dosyalar 2 gün sonra silinir.
• Her anahtarın ve çalışma alanının MCP çağrıları için kendi istek hızı limiti vardır; toplu isteklerdeki her çağrı ayrı sayılır.

Geliştiriciler için

Sunucu, Streamable HTTP üzerinden MCP 2025-11-25 (ayrıca 2025-06-18, 2025-03-26 ve 2024-11-05) kullanır: https://api.zurelay.com/mcp adresine POST ile JSON-RPC gönderin ve JSON yanıt alın. Oturum tutmaz; bu nedenle sunucudan gönderilen olaylar yoktur ve GET 405 yanıtı verir. Belirteç olmadan, https://api.zurelay.com/.well-known/oauth-protected-resource/mcp adresini gösteren WWW-Authenticate ile 401 yanıtı verir; yetkilendirme sunucusunun meta verileri https://api.zurelay.com/.well-known/oauth-authorization-server adresindedir ve dinamik istemci kaydı desteklenir.

curl https://api.zurelay.com/mcp \
  -H "Authorization: Bearer $ZURELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "generate_image",
      "arguments": { "prompt": "A lighthouse at dusk, oil painting", "model": "nano-banana-pro" }
    }
  }'

Sorun giderme

• zurelay, Claude Code’un şu listesinde görünmüyor /mcp: başka bir klasör için eklenmiştir veya Claude Code zaten çalışıyordur. Claude Code’u kapatın, yukarıdaki komutu (--scope user ile) normal bir terminalde çalıştırın ve Claude Code’u yeniden başlatın. claude mcp list, giriş yapana kadar kimlik doğrulama gerektiğini gösterir.
• Uygulama sürekli giriş yapmanızı istiyor: oluşturduğu anahtar iptal edilmiştir veya giriş yetkisi bir yıldır kullanılmamıştır. Yeniden bağlayın.
• “Zurelay bakiyeniz tükendi” veya “günlük bütçesine ulaştı”: Faturalandırma sayfasından kredi ekleyin veya Anahtarlar sayfasından anahtarın limitini artırın.
• “Bu belirteç, Zurelay’in MCP sunucusu üzerinden bağlanan bir uygulamaya ait”: API’ye bir uygulamanın belirtecini gönderdiniz. Orada API anahtarı kullanın.
• Video takılmış görünüyor: yapay zekâdan yeniden get_result çağrısı yapmasını isteyin; videolar 1 ila 5 dakika sürer, model yoğunken bazen daha uzun sürebilir.