2Slides ile QoderWake Kullanımı: Yapay Zeka Çalışanları için MCP (2026)

Q: QoderWake özel MCP sunucularını destekliyor mu?

Evet. Her Waker, qoderwake mcp add --waker-id komutunu veya konsoldaki Özel MCP Bağlayıcıları ekranını kullanarak stdio, HTTP veya SSE üzerinden birden fazla MCP sunucusu bağlayabilir.

Q: 2Slides'ı bir Waker'a eklemek için gereken tam komut nedir?

qoderwake mcp add --waker-id agxxx --name 2slides --transport http --http-url https://2slides.com/api/mcp --header "Authorization=Bearer YOUR2SLIDESAPIKEY". Değer bir boşluk içerdiğinden, tüm üstbilgi çiftini tırnak içine alın.

Q: 2Slides API anahtarını QoderWake'te nerede saklamalıyım?

MCP bağlayıcısının üstbilgisinde (--header veya --headers) veya stdio için --env içinde. Asla bir göreve, belleğe, bilgi tabanına veya rol dosyasına koymayın. QoderWake dokümantasyonu bunu açıkça yasaklar.

Q: Bir Waker her hafta otomatik olarak sunum hazırlayabilir mi?

Evet. qoderwake automation create schedule ve bir cron ifadesi ile zamanlanmış bir otomasyon oluşturun. Gözetimsiz çalışmadan önce automation run-now ile test edin.

Hızlı cevap (≤60 kelime): qoderwake waker list --json ile Waker ID'nizi bulun, ardından qoderwake mcp add --waker-id ag_xxx --name 2slides --transport http --http-url https://2slides.com/api/mcp --header "Authorization=Bearer YOUR_2SLIDES_API_KEY" komutunu çalıştırın. Bu Waker artık 2Slides şablonlarını arayabilir ve DingTalk, Feishu üzerinden veya bir takvime bağlı olarak, talep üzerine düzenlenebilir bir .pptx dosyası döndürebilir.

Alibaba bünyesindeki Qoder ekibi tarafından geliştirilen QoderWake, ürününü "İş Başındaki Otonom Yapay Zeka Çalışanları" olarak tanımlıyor. Her bir dijital çalışana Waker adı veriliyor. Bir Waker; anlık mesajlaşma (IM) iletileri, zamanlanmış görevler, hook olayları veya API çağrıları ile tetiklenerek işi kendi başına hallediyor. QoderWake; macOS 13+, Linux ve Windows 10+ üzerinde çalışıyor. 127.0.0.1:19820 adresinde yerel bir web konsoluna ve tam kapsamlı bir CLI'a sahip olan sistem; DingTalk ve Feishu ile entegre olabiliyor.

MCP sunucuları ve becerileri Waker başına atanır. Bu kılavuz, bir Waker'a (örneğin "Raporlama Asistanınız") 2Slides sunum motorunun nasıl ekleneceğini göstermektedir. Bu süreçte, resmi QoderWake CLI referansı ve 30 Eylül 2026 tarihinde canlı üretim ortamında test ettiğimiz 2Slides uç noktaları kullanılmıştır.

Bir Waker'a neden 2Slides yetkisi verilmeli?

Waker'lar tekrarlayan işler için tasarlanmıştır ve "bu haftanın rakamlarını bir sunuma dönüştür" görevi tam olarak bu türden bir iştir.
Dosyayı 2Slides üretir: Şablon tabanlı, düzenlenebilir bir PowerPoint (Fast PPT, sayfa başına 10 kredi) veya isteğe bağlı AI seslendirme içeren görsel tasarımlı slaytlar (1K/2K çözünürlükte sayfa başına 100 kredi ile Nano Banana).
Waker bazlı kapsam, yalnızca sunuma ihtiyaç duyan Waker'ın ilgili araca ve anahtara sahip olması anlamına gelir.

Başlamadan önce gerekenler

QoderWake kurulu ve oturum açılmış olmalı. macOS veya Linux üzerinde, CLI referansı tek satırlık bir yükleyici sunar:

curl -fsSL https://qoder-ide.oss-ap-southeast-1.aliyuncs.com/qoderwake/install.sh | bash
qoderwake login
qoderwake start      # daemon on 127.0.0.1:19820

Windows ve macOS paketleri QoderWake web sitesinde mevcuttur. Eğer kabuk (shell) qoderwake komutunu bulamazsa, ~/.qoderwake/bin/qoderwake kullanın.

2Slides API anahtarı. 2slides.com/api (sk-2slides-...) adresinden alınabilir. Yeni hesaplara 50 Fast PPT sayfasını karşılayan 500 ücretsiz kredi tanımlanır.
Node.js. Cihazda kurulu olmalıdır (yalnızca stdio yöntemi için gereklidir).

Adım 1: Waker ID'yi Bulun

qoderwake waker list --json

Waker ID'leri ag_ ile başlar. Sunum yapacak olan Waker'ın ID'sini kopyalayın. Aşağıdaki örneklerde ag_xxx kullanılacaktır.

Yöntem 1: HTTP üzerinden Barındırılan MCP (Önerilen)

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --description "2Slides presentation generator" \
  --transport http \
  --http-url https://2slides.com/api/mcp \
  --header "Authorization=Bearer YOUR_2SLIDES_API_KEY"

Tırnak işaretleri hakkında. CLI sözdizimi --header KEY=VALUE şeklindedir (tekrarlanabilir). Buradaki değer olan Bearer YOUR_2SLIDES_API_KEY bir boşluk içerir, bu nedenle tüm KEY=VALUE çiftini gösterildiği gibi çift tırnak içine alın. Tırnak işaretleri olmadan kabuk bunu iki bağımsız argümana böler ve üstbilgi (header) yalnızca Bearer olarak iletilir.

= ve boşluk ayrıştırma sorunlarından tamamen kaçınmak mı istiyorsunuz? Aynı seçeneğin JSON formunu, yani --headers <json> kullanın:

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --transport http \
  --http-url https://2slides.com/api/mcp \
  --headers '{"Authorization":"Bearer YOUR_2SLIDES_API_KEY"}'

Windows PowerShell'de tek tırnak da işe yarar, ancak JSON'u farklı kabuklar arasında tırnak içine almak zahmetli olabilir. Bu durumda, Yöntem 2'deki dosya tabanlı içe aktarma daha güvenli bir seçimdir.

Üstbilgisiz (Header-free) yedek plan. Eğer üstbilgi hala iletilmiyorsa (araçlar yenilendiğinde 401 veya Authentication required hatası alınıyorsa), üstbilgileri tamamen atlayın. 2Slides, anahtarı bir URL sorgu parametresi olarak da kabul eder ve bu yöntemi uçtan uca test ettik:

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --transport http \
  --http-url "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"

Bu URL'ye bir şifre gibi davranın: görevlere veya ekran görüntülerine yapıştırmayın ve sızması durumunda anahtarı 2slides.com/api adresinden yenileyin.

2Slides, OAuth değil, düz bir API anahtarı kullanır; bu nedenle tüm --oauth-* bayraklarını kapalı bırakın.

Yöntem 2: MCP JSON İçe Aktarma

qoderwake mcp add komutu, MCP JSON dosyasını doğrudan içe aktarmak için --json <json> veya --json-file <path> parametrelerini de kabul eder. Bunu 2slides-mcp.json olarak kaydedin:

{
  "mcpServers": {
    "2slides": {
      "type": "streamable-http",
      "url": "https://2slides.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_2SLIDES_API_KEY"
      }
    }
  }
}

qoderwake mcp add --waker-id ag_xxx --json-file 2slides-mcp.json

CLI referansı, içe aktarıcının hangi JSON yapılarını kabul ettiğini açıkça belirtmez. Yukarıdaki blok yaygın olan mcpServers formatıdır. İçe aktarma reddedilirse, tam olarak belgelenmiş olan Yöntem 1'deki bayrakları kullanın. Anahtarınızı içerdiği için işlemden sonra dosyayı silin veya herhangi bir Git deposunun dışında tutun.

Yöntem 3: Yerel stdio sunucusu

Açık kaynaklı 2slides-mcp paketini Waker'ın cihazında çalıştırmak için:

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --transport stdio \
  --command npx \
  --args "-y,2slides-mcp@latest" \
  --env '{"API_KEY":"YOUR_2SLIDES_API_KEY"}'

--args, CLI referansındaki resmi dosya sistemi örneğiyle aynı stilde, virgülle ayrılmış bir liste alır. --env ise JSON alır. Bu yöntem, Waker'ın çalıştığı makinede Node.js gerektirir ve QoderWake varsayılan olarak cihazda yerleşik (device-resident) çalışır.

Bağlantıyı Doğrulayın

qoderwake mcp list --waker-id ag_xxx                      # 2slides should be listed
qoderwake mcp refresh-tools --waker-id ag_xxx --mcp-id <mid>
qoderwake mcp get --waker-id ag_xxx --mcp-id <mid>        # inspect the entry

mcp list çıktısından <mid> değerini alın. Ardından Waker'a salt okunur bir test gönderin. QoderWake'in kendi yönlendirmesi (guidance), yeni bir bağlayıcıyı (connector) önce salt okunur bir çağrı ile doğrulamaktır:

List the tools you have from 2slides, then search for a "minimal" theme and show me the themeId.

themes_search ücretsizdir, dolayısıyla bu testin bir maliyeti yoktur. Bir bağlayıcı hatalı çalışırsa, qoderwake mcp toggle --waker-id ag_xxx --mcp-id <mid> --enabled false komutu onu silmeden devre dışı bırakır.

Yöntem 4: 2Slides yeteneğini yükleyin

QoderWake yetenekleri (skills), diff alabileceğiniz ve geri alabileceğiniz git versiyonlu özellik paketleridir. "SKILL.md içeren bir Markdown dosyası veya arşiv" yüklersiniz. Resmi 2Slides yeteneği github.com/2slides/slides-generation-2slides-skills adresindedir. SKILL.md dosyasının arşivin kök dizininde yer alacağı şekilde zippeleyin:

git clone https://github.com/2slides/slides-generation-2slides-skills
cd slides-generation-2slides-skills
zip -r ../2slides-skill.zip SKILL.md scripts references
cd ..
qoderwake skill upload 2slides-skill.zip --waker-id ag_xxx

Bu işlem, depodaki eski .skill paketini dışarıda bırakır. Yeteneğin Python betikleri (Python 3 ve requests), anahtarı SLIDES_2SLIDES_API_KEY ortam değişkeninden okur.

Gizli bilgi kuralı. QoderWake dokümantasyonu şöyle der: "Görevlere, belleğe, bilgi tabanlarına, rol dosyalarına veya ekran görüntülerine asla gizli bilgiler, belirteçler (tokens) veya çerezler koymayın." Kimlik bilgileri korumalı alanlara veya ortam değişkenlerine aittir. Bu nedenle anahtarınızı asla bir görev istemine yapıştırmayın veya Waker'a onu "hatırlamasını" söylemeyin. QoderWake, ortam değişkenlerini yetenek betiklerine aktarmanın bir yolunu belgelemediği için şu ayrımı öneriyoruz:

Gerçek API çağrıları için MCP bağlayıcısını (Yöntem 1) kullanın. Anahtar, bağlayıcının üst bilgisinde (header) tutulur.
Yetenek seçeneğini yalnızca Waker'ın çalıştığı ortamda SLIDES_2SLIDES_API_KEY değişkeni zaten tanımlanmışsa kullanın. Bunu scripts/search_themes.py --query minimal --limit 1 komutunu çalıştıran bir test göreviyle kontrol edin.

İlk sunumunuzu oluşturun

Read sales_week39.csv in the project, summarize the key movements,
and build an 8-slide weekly sales review with 2slides. Search for a
clean business theme first, then generate the PowerPoint and send
me the download link.

Waker önce themes_search, ardından slides_generate çağrısı yapmalı ve bir downloadUrl döndürmelidir. Üretim testimizde, 3 sayfalık bir Fast PPT sunumu yaklaşık 22 saniyede hazırlandı. Bağlantının süresi 1 saat sonra dolar. QoderWake dokümantasyonu, dosya tesliminin "kanal yeteneklerine bağlı olduğunu; döndürülen bağlantının veya görev yapıtının (artifact) kullanılmasını" belirtir. Bu nedenle Waker'ın bağlantıyı hemen paylaşmasını sağlayın veya .pptx dosyasını çalışma alanına indirin. Daha sonra qoderwake session artifacts --session-id sess_xxx ile dosyayı oturumdan alabilirsiniz.

Bir yapay zeka çalışanı için kullanım durumları

DingTalk veya Feishu üzerinden tetikleme. Bir Waker, DingTalk veya Feishu kanalıyla eşleştirildiğinde, bir ekip üyesi "@Raporlama Asistanı Q4 işe alım planı hakkında 6 slaytlık bir güncelleme hazırla" şeklinde mesaj gönderebilir. Waker bağlamı toplar, 2Slides'ı çağırır ve bağlantıyla yanıt verir.

Zamanlanmış haftalık sunum. CLI referansı, zamanlanmış otomasyonları belgeler:

qoderwake automation create schedule --waker-id ag_xxx \
  --name "Weekly Sales Deck" \
  --schedule-type cron --cron "0 9 * * 1" \
  --timezone Asia/Shanghai \
  --prompt "Build this week's 8-slide sales review from the latest CSV with 2slides and post the download link"
qoderwake automation run-now --waker-id ag_xxx --automation-id tr_xxx   # test once

Kendi başına çalışmasına izin vermeden önce run-now ile bir kez çalıştırın ve sonucu qoderwake automation detail ile kontrol edin.

2Slides MCP araçları

Araç	İşlevi	Krediler
`themes_search`	1.500'den fazla tema arasından bir `themeId` bulur	Ücretsiz
`slides_generate`	Temaya dayalı düzenlenebilir PowerPoint (Fast PPT), senkron veya asenkron	Sayfa başına 10
`slides_create_pdf_slides`	Metinden görsel tasarımlı slaytlar (Nano Banana)	Sayfa başına 100 (1K/2K), 200 (4K)
`slides_create_like_this`	Bir referans görselin stiline uygun slaytlar	Sayfa başına 100 (1K/2K), 200 (4K)
`slides_generate_narration`	Bir Nano Banana işi için AI-Sprachnarration	Sayfa başına 210
`slides_download_slides_pages_voices`	Sayfa görselleri, ses ve transkript içeren ZIP	Ücretsiz
`jobs_get`	Asenkron bir işi sorgular (her 20 ila 30 saniyede bir)	Ücretsiz

Onaylananlar vs. henüz belgelenmemiş olanlar (30 Eylül 2026 itibarıyla)

Öğe	Durum
`waker list`, `mcp add` bayrakları (`--transport`, `--http-url`, `--header`, `--headers`, `--json`, `--command`, `--args`, `--env`), `skill upload`	QoderWake CLI referansında onaylandı
MCP ve yetenekler Waker başınadır; gizli bilgiler görevlere veya belleğe girmemelidir	QoderWake dokümantasyonunda onaylandı
2Slides uç noktası, Bearer yetkilendirmesi, 7 araç	2Slides tarafından canlı test edildi
`mcp add --json` tarafından kabul edilen tam JSON yapısı	Belgelenmedi; `mcpServers` formu en iyi çaba olarak gösterildi
`--header`'ün `=` içeren bir değeri nasıl böldüğü	Belgelenmedi; tüm çifti tırnak içine alın veya `--headers` JSON kullanın
Yetenek betiklerine ortam değişkeni aktarma	Belgelenmedi

Sorun Giderme

"daemon unreachable". qoderwake status komutunu çalıştırın. Daemon çalışmıyorsa qoderwake start. Port doluysa qoderwake start --port auto.
QoderWake kaynaklı 401 hatası. qoderwake whoami komutunu ve gerekirse tekrar qoderwake login komutunu çalıştırın.
2Slides kaynaklı 401 hatası. Üstbilgi muhtemelen anahtar olmadan ulaştı. Tırnak içine alınmış --header veya --headers JSON formuyla yeniden ekleyin.
Araçlar eksik. qoderwake mcp refresh-tools komutunu çalıştırın ve bağlayıcının mcp toggle ... --enabled true ile etkinleştirildiğini kontrol edin.
stdio hatası. Waker'ın cihazında Node.js'in kurulu olduğundan ve --args değerinin virgülle ayrıldığından emin olun.
Çalışma sırasında hatalar. qoderwake log --level error --limit 100 veya qoderwake trace list --status failed.
Bağlantı süresi doldu. downloadUrl 1 saat geçerlidir. Waker'ın dosyayı bir görev yapıtı olarak kaydetmesini sağlayın.

Sıkça sorulan sorular

QoderWake özel MCP sunucularını destekliyor mu?

Evet. Her Waker, qoderwake mcp add --waker-id <id> komutunu veya konsoldaki Özel MCP Bağlayıcıları ekranını kullanarak stdio, HTTP veya SSE üzerinden birden fazla MCP sunucusu bağlayabilir.

2Slides'ı bir Waker'a eklemek için gereken tam komut nedir?

qoderwake mcp add --waker-id ag_xxx --name 2slides --transport http --http-url https://2slides.com/api/mcp --header "Authorization=Bearer YOUR_2SLIDES_API_KEY". Değer bir boşluk içerdiğinden, tüm üstbilgi çiftini tırnak içine alın.

2Slides API anahtarını QoderWake'te nerede saklamalıyım?

MCP bağlayıcısının üstbilgisinde (--header veya --headers) veya stdio için --env içinde. Asla bir göreve, belleğe, bilgi tabanına veya rol dosyasına koymayın. QoderWake dokümantasyonu bunu açıkça yasaklar.

Bir Waker, PowerPoint dosyasını DingTalk veya Feishu'ya gönderebilir mi?

Waker her zaman 2Slides indirme bağlantısıyla yanıt verebilir. Dosyanın kendisinin eklenip eklenmeyeceği kanala bağlıdır. QoderWake dokümantasyonu, döndürülen bağlantının veya görev yapıtının kullanılmasını önerir. Bağlantının süresi 1 saat sonra dolar.

Bir Waker her hafta otomatik olarak sunum hazırlayabilir mi?

Evet. qoderwake automation create schedule ve bir cron ifadesi ile zamanlanmış bir otomasyon oluşturun. Gözetimsiz çalışmadan önce automation run-now ile test edin.

Maliyeti ne kadar?

Yeni 2Slides hesapları 500 ücretsiz kredi alır. Fast PPT sayfa başına 10 kredi tutar, yani haftalık 8 slaytlık bir sunum 80 kredidir. Tema arama, iş sorgulama ve dışa aktarmalar ücretsizdir.

Önemli notlar

Tek bir qoderwake mcp add komutu, bir Waker'ı gerçek sunumlar hazırlayan bir yapay zeka çalışanına dönüştürür. Anahtarı MCP başlığında tutun, DingTalk, Feishu veya bir cron zamanlaması üzerinden tetikleyin ve bir saat içinde .pptx dosyasını kaydedin.

İlgili kılavuzlar: slayt yapabilen kişisel yapay zeka ajanları, 2Slides ile QwenWork, 2Slides ile WorkBuddy, herhangi bir yapay zeka ajanını 2Slides MCP sunucusu ile kullanma ve ajan becerileri ile MCP sunucularının karşılaştırması.

Anahtarınızı ve yapılandırmanızı 2slides.com/api?tab=mcp adresinden alın.

Kaynaklar: