ElevenLabs MCP Claude Code: Hosted Kurulum, OAuth ve Yaratıcı Araçlar

Zaten Claude Code içinde çalışıyor ve başka bir panoya geçmeden ses ajanları veya yaratıcı üretim istiyorsanız, ElevenLabs MCP Claude Code yolu hosted bağlayıcıdır: tek HTTP kurulumu, tek OAuth girişi, ardından konuşma, transkript, dublaj, müzik, ses efektleri, görsel, video ve ajan yönetimi için doğal dil araçları. Yerel Python süreci yok. Yapılandırma dosyasına yapıştırılan API anahtarı yok.

Bu eğitim, Claude Code üzerinde tercih edilen hosted kurulumu, OAuth ve kapsamların nasıl çalıştığını, bağlandıktan sonra neler sorabileceğinizi, bunun eski yerel açık kaynak sunucudan farkını ve genellikle "bozuk" değil "kimlik doğrulama gerekli" anlamına gelen durum mesajlarını adım adım anlatır.

Öne Çıkanlar

• Hosted ElevenLabs MCP'yi tercih edin: claude mcp add --transport http elevenlabs https://api.elevenlabs.io/v1/mcp, ardından oturum içinde /mcp ile Authenticate (ElevenLabs MCP).
• Hosted kimlik doğrulama çalışma alanınıza kapsamlı OAuth'tur—Claude Code tarafında API anahtarı yoktur (hosted MCP docs).
• Bağlandıktan sonra ajanları yönetebilir ve ElevenCreative / Studio'ya düşen yaratıcı varlıklar (konuşma, Scribe transkriptleri, dublaj, müzik, SFX, görsel, video) üretebilirsiniz (product blog, Sep 2026).
• Çalışma alanınız izole ise varsayılan global host yerine EU / India / Singapore residency URL'lerini kullanın.
• Anthropic'in MCP ekosistemi aylık 400M SDK indirmesini aştı ve Claude dizininde 950'den fazla bağlayıcı listeliyor (Anthropic, Jul 28, 2026)—yine de güvendiğiniz her sunucuyu doğrulayın.

Terminal ekran görüntüsü: claude mcp add --transport http elevenlabs … ardından /mcp panelinde Needs authentication → Connected.

Claude Code İçinde ElevenLabs MCP Neden Önemli

Önce cevap: Claude Code, araçlar deponuzla aynı oturumda yaşadığında en güçlüdür. MCP (Model Context Protocol), uzak araçları bağlama yoludur; ElevenLabs, asistanın OAuth sonrası HTTP üzerinden bunları çağırabilmesi için hosted bir sunucu yayınlar—ses URL'leri, ajan kimlikleri veya Studio bağlantıları için sekmeler arasında gezinmeden.

Pratikte bu, destek ajanı taslağını, maliyet tahminini veya Studio'ya giden bir ses örneğini aynı sohbet içinde istemeniz demektir—ayrı bir ElevenLabs panosuna geçip kimlikleri kopyalamadan. Hosted bağlayıcı, Claude Code'un zaten beklediği uzak HTTP + OAuth modeline oturur; bu yüzden kurulum komutu diğer Claude Code MCP'leriyle aynı dilde kalır.

Claude Code, uzak sunucuları oturum dışındaki terminalden claude mcp add --transport http <name> <url> ile eklemenizi, ardından durum ve OAuth için /mcp kullanmanızı bekler (MCP servers, MCP quickstart).

ElevenLabs, Claude Code kurulumunu elevenlabs.io/mcp üzerinde belgeler. Eylül 2026 yaratıcı lansmanı ayrıca Claude, ChatGPT, Cursor, GrokBot ve Hermes'i listeler—yalnızca Claude / Claude Code adını geçen kısa bir SSS satırına değil, bu ürün kurulum bölümlerine öncelik verin.

Anthropic, her MCP sunucusuna güvendiğinizi doğrulamanızı uyarır—harici içerik çeken sunucular sizi prompt injection riskine maruz bırakabilir (MCP servers docs). OAuth kapsamlarını inceleyin ve yıkıcı araçları dikkatle onaylayın.

Hosted vs Yerel ElevenLabs MCP (Karıştırmayın)

Önce cevap: 2026'da Claude Code için hosted sunucuyla başlayın. Orijinal GitHub elevenlabs/elevenlabs-mcp projesi yerel yoldur (uvx elevenlabs-mcp + ELEVENLABS_API_KEY); ElevenLabs artık hosted'ı bakımı yapılan, yerel sunucusuz seçenek olarak konumlandırıyor. İkisini aynı istemci yapılandırmasında yan yana bırakmayın: stdio + API anahtarı kaydı, HTTP + OAuth girişiyle çakışır ve hangi yolun yanıt verdiğini karıştırır.

Basit karşılaştırma çubukları — "Kurulum adımları": Hosted = URL ekle + OAuth (2); Yerel = uvx kur + API anahtarı + istemci JSON (3+). Açıklama: Hosted yerel süreci ve anahtar yapıştırmayı kaldırır.

ElevenLabs'in MCP SSS'si aynı karşıtlığı çizer: yerel + API anahtarı karşısında hosted + OAuth, bakılacak bir şey yok (ElevenLabs MCP FAQ). uvx + Desktop JSON eğitimlerini, çevrimdışı yerel süreç gerekmedikçe eski yol olarak değerlendirin.

Claude Code'da Hosted ElevenLabs MCP Kurulumu

Önce cevap: Ekleme komutunu etkileşimli bir Claude Code oturumunun dışında çalıştırın, ardından oturum içinde /mcp ile kimlik doğrulayın.

1. Ön koşullar

• Claude Code kurulu ve oturum açılmış olmalı
• Yetkilendirmek istediğiniz çalışma alanına erişimi olan bir ElevenLabs hesabı
• api.elevenlabs.io (veya residency host'unuz) için ağ erişimi

2. HTTP sunucusunu ekleyin (terminal, claude dışında)

ElevenLabs, Claude Code kurulumunu şöyle belgeler:

claude mcp add --transport http elevenlabs https://api.elevenlabs.io/v1/mcp

Bu, Claude Code'un uzak desenine uyar: --transport http, bir ad (elevenlabs) ve MCP URL'si (MCP quickstart).

Varsayılan local kapsam sunucuyu geçerli projeye bağlar. Makinenizdeki her proje için:

claude mcp add --scope user --transport http elevenlabs https://api.elevenlabs.io/v1/mcp

.mcp.json ile ekip paylaşımı için:

claude mcp add --scope project --transport http elevenlabs https://api.elevenlabs.io/v1/mcp

Proje kapsamı ilk kullanımda etkileşimli onay ister (MCP scopes).

3. /mcp ile kimlik doğrulayın

Aynı projede (veya --scope user kullandıysanız herhangi bir projede) Claude Code'u başlatın:

claude

Ardından:

/mcp

elevenlabs'i seçin, Authenticate'i seçin ve tarayıcıda OAuth'u tamamlayın. Erişim onayladığınız çalışma alanına kapsamlıdır—Claude Code'da API anahtarı yoktur (hosted MCP). OAuth tamamlandığında istemci Connected durumuna geçer; kapsamları tarayıcı onay ekranında gözden geçirin ve yalnızca ihtiyacınız olan çalışma alanını seçin.

Claude Code /mcp panelinin yanında ElevenLabs çalışma alanı izinleri için tarayıcı OAuth onayı.

4. Bağlantıyı doğrulayın

Başka bir terminalden (veya oturumdan çıktıktan sonra):

claude mcp list
claude mcp get elevenlabs

Tanımanız gereken durumlar (MCP quickstart):

Kaldırmak için: claude mcp remove elevenlabs (ad birden fazla kapsamda varsa --scope geçin).

Önerilen doğrulama: OAuth sonrası Claude Code'dan ajanları listelemesini veya bir ajan için maliyet tahmini istemesini isteyin. Araçlar eksikse yeniden eklemeden önce /mcp üzerinden yeniden bağlanın.

Veri Yerleşimi URL'leri (EU, India, Singapore)

Önce cevap: İzole residency çalışma alanları varsayılan global URL yerine bölgesel MCP host'unu kullanmalı ve o ortamın hesabıyla OAuth yapmalıdır.

Kullanıcı kapsamında EU örneği:

claude mcp add --scope user --transport http elevenlabs-eu https://api.eu.residency.elevenlabs.io/v1/mcp

Ardından /mcp → o residency hesabıyla Authenticate; hesaplar farklıysa ayrı bir elevenlabs.io girişi değil (data residency).

Dört MCP uç noktasının (Global / EU / India / Singapore) harita tarzı diyagramı; açıklama: "Residency'yi bağlantı anında seçin; OAuth o çalışma alanını bağlar."

Bağlandıktan Sonra Neler Yapabilirsiniz

Önce cevap: Tek bağlayıcı ElevenAgents ve ElevenCreative'i kapsar. Hosted belgeler ajan CRUD, transkriptler, maliyet tahminleri ve TTS indirme bağlantılarını anlatır; Eylül 2026 ürün blogu aynı MCP üzerinde daha geniş yaratıcı üretimi ekler.

Ajan iş akışları (hosted MCP belgeleri)

Hosted MCP "What you can do" bölümüne göre asistanlar ajan oluşturup güncelleyebilir (prompt, ses, dil, ilk mesaj), listeleyip karşılaştırabilir / çoğaltabilir / silebilir, transkriptleri inceleyebilir, LLM maliyetini tahmin edebilir, widget bağlantılarını alabilir, bilgi tabanı boyutunu kontrol edebilir ve kısa ömürlü indirme bağlantısı olarak konuşma üretebilir.

Bu çağrılar doğal dilde kalır; ajan kimliği veya widget URL'sini panodan kopyalamanız gerekmez—bağlayıcı, onayladığınız çalışma alanı üzerinden çözümler. Şu tür istemleri deneyin:

• "Dokümanlarımız için destek ajanı oluştur—samimi, özlü, faturalandırmayı eskalasyonla yönlendir."
• "Checkout ajanım GPT-4o yerine Gemini 2.5 Flash'ta konuşma başına ne kadara mal olur?"
• "Production'ı çoğalt, sesi değiştir, ilk mesajı İspanyolca yap."
• "Ajanımın sesinin yeni selamlamamızı söylediği bir örnek üret."

Yaratıcı iş akışları (Eyl 2026 lansmanı)

Ses, müzik, görsel ve video MCP lansmanı (yayın: 14 Eyl 2026; güncelleme: 20 Eyl 2026) metinden konuşma, Scribe konuşmadan-metne (birçok dilde konuşmacı etiketleri ve zaman damgaları), dublaj, müzik ve SFX ile görsel ve videoyu (orada anlatılan düzenle / canlandır / lipsync akışları dahil) kapsar.

Varlıklar Studio'da bitirmek üzere ElevenCreative'e düşer. Yani taslak üretimi Claude Code oturumunda, hassas zaman çizelgesi ve son rötuş ise Studio'da kalır—iki araç arasında dosya taşımak yerine aynı ElevenLabs çalışma alanını kullanırsınız. Yöneticiler bağlantının hangi araçları çağırabileceğini kontrol eder; residency bağlantı anında seçilir.

Asistan iş parçacığından üretilmiş seslendirme, müzik yatağı ve video karesiyle ElevenCreative / Studio zaman çizelgesi.

Ajan silmek yıkıcıdır. Yazma ve silme çağrılarının onay gerektirmesi için MCP istemcinizin araç bazlı onay ayarlarını kullanın (hosted MCP — security).

Yaygın Durum ve Kimlik Doğrulama Sorunlarını Giderme

Önce cevap: Çoğu hata kapsam, OAuth veya yanlış URL kaynaklıdır—hosted yolda eksik ELEVENLABS_API_KEY değildir. Aşağıdaki durumları sırayla eleyin; Connected görürken araç çağıramıyorsanız sorun genellikle yeniden bağlanma veya yönetici izinleridir, yeniden mcp add değildir.

Needs authentication sonsuza dek

/mcp → Authenticate'i tamamlayın. Tarayıcı açılmazsa URL'yi terminalden kopyalayın. Başarısız bir geri çağrıdan sonra, istendiğinde tam yönlendirme URL'sini Claude Code'a yapıştırın (OAuth).

Failed to connect

• Global ile residency URL'sini birebir eşleştirin
• Ağ engellerini elemek için host'a curl -I çalıştırın
• claude mcp get elevenlabs çalıştırıp Issue satırını okuyun (mümkünse HTTP durumu)
• ElevenLabs istemciniz için bu kimlik modelini belgelemedikçe hosted MCP'yi --header içine API anahtarı yapıştırarak "düzeltmeyin"

Connected sonrası araçlar eksik

/mcp üzerinden yeniden bağlanın. OAuth izinlerinin ihtiyaç duyduğunuz eylemleri kapsadığını doğrulayın. Yöneticiler araçları kuruluş genelinde kapatabilir; kullanıcılar yönetici tarafından engellenen araçları yeniden açamaz (permissions).

Yalnızca bir klasörde çalışıyor

local kapsam kullandınız. --scope user ile yeniden ekleyin veya proje .mcp.json dosyasını commit edip her klonda onaylayın.

Yerel sunucuyla karışıklık

Yapılandırma hâlâ uvx elevenlabs-mcp başlatıyorsa o stdio kaydını kaldırın ve HTTP + OAuth kullanın (GitHub elevenlabs-mcp).

Akış şeması — Durum? → Needs auth → OAuth; Failed → URL/ağ; Connected ama boş araçlar → yeniden bağlan / izinler; Yerel uvx hâlâ var → hosted'a geç.

Daha Geniş Claude Code MCP Yığınınızla Uyum

Önce cevap: ElevenLabs, doküman, tarayıcı ve araştırma sunucularının yanında bir uzak HTTP MCP daha—onların yerine geçmez.

Bunu Claude Code'u Süper Güce Dönüştüren 5 MCP gibi küçük bir çekirdek setle eşleştirin. Kapsamlar arasında adları benzersiz tutun ki claude mcp list okunabilir kalsın. Aynı ada sahip local ve user kayıtları durum çıktısını karıştırır; residency için elevenlabs-eu gibi ayrı bir ad kullanmak listeyi temiz tutar.

Mobil ve ses ürünü ekipleri ajan denemelerinin yanında sıkça push ve kimlik doğrulamayı bağlar: OneSignal Expo ve Firebase Auth Expo uygulama çalışma zamanı kimliği ve bildirimleri kapsar—ElevenLabs MCP'yi değil.

Yumuşak CTA: ses odaklı bir Expo uygulaması mı geliştiriyorsunuz? Expo starter kit AGENTS.md, CLAUDE.md ve Claude Code ile Cursor için yedi MCP girişi sunar (Firebase, RevenueCat, Expo, OneSignal, Airbridge, HeroUI Native, Plunk via .mcp.json.example)—ElevenLabs ayrıdır; hosted bağlayıcıyı yukarıdaki adımlarla kendiniz ekleyin. Hazır kit mi yoksa sıfırdan mı yazmalısınız diye düşünüyorsanız bir Expo boilerplate'in neler içerdiğine bakın.

ElevenLabs, o kitin örnek MCP listesinde yoktur. Bu yazı, hosted bağlayıcıyı kendiniz nasıl ekleyeceğinizi anlatır.

SSS

Hosted ElevenLabs MCP, GitHub elevenlabs-mcp sunucusuyla aynı mı?

Hayır. Hosted uzak HTTP + OAuth'tur. GitHub projesi API anahtarlı eski yerel uvx sunucusudur; ElevenLabs hosted'ı tercih edilen yol olarak konumlandırır.

Claude Code için ElevenLabs API anahtarı gerekir mi?

Burada belgelenen hosted yol için hayır. OAuth ile giriş yaparsınız. API anahtarları yerel/deprecated sunucuya ve bu bağlayıcı dışındaki REST kullanımına aittir.

Hangi istemciler ElevenLabs MCP'yi destekler?

ElevenLabs, Claude Code kurulumunu elevenlabs.io/mcp üzerinde belgeler. Yaratıcı lansman ayrıca Claude, ChatGPT, Cursor, GrokBot ve Hermes'i listeler—yalnızca Claude / Claude Code adını geçen kısa bir SSS'ye değil, o kurulum bölümlerine öncelik verin.

Claude Code ile EU veri yerleşimini kullanabilir miyim?

Evet—varsayılan global yerine EU (veya India / Singapore) residency MCP URL'sini ekleyin, ardından o ortamın hesabıyla OAuth yapın.

Üretilen ses ve video nereye gider?

Eyl 2026 ürün bloguna göre üretimler, Studio'da iyileştirme için ElevenCreative çalışma alanınıza düşer.

Sonuç

ElevenLabs MCP'yi Claude Code'a almak bilinçli olarak kısadır: hosted HTTP uç noktasını ekleyin, /mcp ile kimlik doğrulayın, ardından ajanları ve yaratıcı üretimi tek oturumda tutun. Yerel API anahtarı sunucusu yerine hosted OAuth'u tercih edin, residency URL'lerini çalışma alanınıza eşleştirin ve Connected / Needs authentication / Failed to connect durumlarını ayrı düzeltmeler olarak ele alın.

Bağlandıktan sonra ajanlar ile konuşma, transkript, dublaj, müzik, SFX, görsel ve video için sade dil istemleri kullanın—sonra hassas kesimleri ElevenCreative Studio'da bitirin. Sunucuyu kendiniz ekleyin, silmeleri dikkatle onaylayın ve bir kitin varsayılan listesinde olmasını beklemek yerine diğer Claude Code MCP'lerinizin yanına koyun. Böylece ses ajanı ve yaratıcı üretim, depo bağlamınız ve mevcut MCP yığınınızla aynı oturumda kalır.

Sonraki adım: elevenlabs.io/mcp üzerinden kurulumu çalıştırın, OAuth'u tamamlayın ve Claude Code'dan ajanları listelemesini veya Studio için kısa bir ses örneği üretmesini isteyin.

Kaynaklar

1. ElevenLabs MCP — Claude Code ve diğer istemciler için kurulum bölümleri
2. ElevenLabs hosted MCP documentation — OAuth, residency URL'leri, ajan araçları, izinler
3. Introducing voice, music, image, and video generation in the ElevenLabs MCP — Aron Pammer & Aneri Amin; yayın 14 Eyl 2026; güncelleme 20 Eyl 2026
4. Claude Code — Connect to tools via MCP — taşımalar, kapsamlar, /mcp, güven uyarısı
5. Claude Code — MCP quickstart — ekleme, listeleme, durumlar, OAuth örneği
6. Bringing MCP 2026-07-28 to Claude — Anthropic; aylık 400M SDK indirme; 950+ bağlayıcı
7. elevenlabs/elevenlabs-mcp (GitHub) — yerel uvx sunucu; hosted lehine deprecated
8. Claude Code'u Süper Güce Dönüştüren 5 MCP — CodeBaseHub
9. OneSignal Expo: Production Push Setup and Common Errors — CodeBaseHub
10. Firebase Auth Expo: Email, Google, Apple + Routes — CodeBaseHub
11. What Is an Expo Boilerplate? — CodeBaseHub
12. Expo starter kit — yumuşak CTA hedefi