Claude Code ile 2Slides MCP Sunucusu Nasıl Kullanılır (2026 Rehberi)

Hızlı yanıt (≤60 kelime): Claude Code, 2Slides MCP sunucusuna bağlanarak gerçek PowerPoint dosyaları oluşturabilir. 2slides.com/api adresinden bir API anahtarı alın, ardından yerel stdio için claude mcp add 2slides -e API_KEY=xxx -- npx -y 2slides-mcp@latest, uzak Streamable HTTP için ise claude mcp add --transport http 2slides https://2slides.com/api/mcp?apikey=KEY komutunu çalıştırın. Sonra Claude Code'dan bir sunum hazırlamasını isteyin.

Claude Code, Anthropic'in terminal tabanlı kodlama ajanıdır ve Model Context Protocol (MCP) dilini doğal olarak konuşur. Bu, metni bitmiş bir .pptx dosyasına dönüştüren bir aracı, kabuğunuzdan hiç çıkmadan ona verebileceğiniz anlamına gelir. 2Slides MCP sunucusu işte bu araçtır: 2Slides'ın slayt üretimi, tema, anlatım ve dışa aktarma API'lerini Claude Code'un doğrudan çağırabileceği MCP araçları olarak sunan ince bir bağlayıcı.

Bu rehber, bağlanmanın iki yolunu da gösterir — yerel stdio ve uzak Streamable HTTP — hangisini seçeceğinizi, her aracın ne yaptığını ve tek satırlık bir isteği indirilebilir bir PowerPoint'e dönüştüren tam istemleri.

Claude Code'u 2Slides'a bağlamak neden mantıklı?

Claude Code, deponuz üzerinde akıl yürütmede, içerik taslağı hazırlamada ve bir savı yapılandırmada mükemmeldir. Kendi başına yapamadığı şey ise şekiller, grafikler, temalar ve konuşmacı notları içeren gerçek, düzenlenebilir bir .pptx üretmektir. Bu bir dosya üretme problemidir ve özel bir araca aittir.

Bölüm net:

• Claude Code kaynak materyalinizi (bir README, bir spesifikasyon, bir CSV, bir araştırma notu) okur, üzerinde akıl yürütür ve her slayta neyin gireceğine karar verir.
• 2Slides MCP sunucusu bu planı alır ve gerçek bir PowerPoint dosyası — ya da yapay zeka sesli anlatım ve MP4 dışa aktarma özellikli görsel tabanlı slaytlar — oluşturur.

Tüm süreç boyunca terminalde kalırsınız. İsteyin, ~30–60 saniye bekleyin, bir indirme bağlantısı alın.

Önce neye ihtiyacınız var

1. Claude Code kurulu ve kimliği doğrulanmış olmalı (claude PATH'inizde).
2. Bir 2Slides API anahtarı. 2slides.com/api adresinden oluşturun. Aynı sayfada kopyala-yapıştır bir MCP yapılandırması ve Streamable HTTP uç noktası bulunur.
3. Node.js (yerelde npx -y 2slides-mcp@latest çalıştıran stdio taşıması için). HTTP taşıması yerelde hiçbir şeye ihtiyaç duymaz.

Stdio mı Streamable HTTP mı: hangi taşıma?

2Slides MCP sunucusu iki taşımayı destekler. Her ikisi de aynı araç setini sunar; yalnızca bağlayıcının nerede çalıştığı bakımından farklılık gösterirler.

Pratik kural: günlük çalışma için kendi makinenizde stdio kullanın, Claude Code'un Node kuramayacağınız bir yerde (uzak bir makine, bir CI işi, kilitli bir konteyner) çalıştığı durumlarda ise Streamable HTTP kullanın.

Yöntem 1: stdio ile bağlanma (yerel)

Bunu bir kez çalıştırın. -- ayırıcısı, Claude Code'un kendi bayraklarını başlattığı komuttan ayırır:

Bilmeye değer birkaç nokta:

• --transport stdio (veya başka bir bayrağı) --env ile sunucu adı arasında tutun. --env birden fazla KEY=value çifti kabul ettiğinden, adı hemen ardına koymak CLI'nin adı başka bir env değişkeni olarak okumasına neden olabilir.
• -- sonrasındaki her şey sunucuya olduğu gibi iletilir (npx -y 2slides-mcp@latest).
• 2Slides'ı her projede kullanılabilir kılmak için --scope user, ekibiniz için paylaşılan bir .mcp.json dosyasına işlemek için ise --scope project ekleyin.

Ortaya çıkan .mcp.json (proje kapsamı) şöyle görünür — elle de düzenleyebilirsiniz:

Yöntem 2: Streamable HTTP ile bağlanma (uzak)

Yerel kurulum yok — Claude Code'u sadece barındırılan uç noktaya yönlendirin:

Anahtarı URL dışında tutmayı mı tercih ediyorsunuz? Onu bunun yerine bir başlık olarak gönderin:

Bağlantıyı doğrulama

Veya etkileşimli bir oturum içinde, bağlı sunucuları, araç sayılarını ve (uzak sunucular için) kimlik doğrulama durumunu görmek için /mcp slash komutunu çalıştırın.

İlk sunumunuzu oluşturun

Bağlandıktan sonra araçları elle çağırmazsınız — sadece istersiniz. Claude Code 2Slides araçlarını otomatik olarak zincirler:

Perde arkasında Claude Code, bir themeId bulmak için themes_search, ardından slides_generate (Fast PPT) çalıştırır ve size bir downloadUrl verir. Toplam süre: temalı bir PowerPoint için yaklaşık 30–60 saniye.

Şablon yerine özel, görsel tasarımlı slaytlar mı istiyorsunuz? Bunu isteyin; Claude Code Nano Banana yolunu (slides_create_pdf_slides) kullanacak, hazır olana kadar jobs_get ile yoklayacak ve bağlantıyı döndürecektir.

2Slides MCP araç yüzeyi

Bağlandıktan sonra Claude Code şu araçları görür:

Üç tipik zincir:

• Fast PPT: themes_search → slides_generate (eşzamanlı) → indirme.
• Nano Banana: slides_create_pdf_slides (eşzamansız) → jobs_get → indirme.
• Anlatımlı video varlıkları: slaytları oluştur → jobs_get → slides_generate_narration → jobs_get → slides_download_slides_pages_voices.

Sık yapılan hatalar ve sorun giderme

• Sunucu claude mcp list içinde görünmüyor. stdio için, --env/ad sıralamasının doğru olduğunu kontrol edin (--env ile ad arasında bir bayrak tutun). HTTP için, URL'yi ve API anahtarının geçerli olduğunu yeniden kontrol edin.
• API_KEY eksik. stdio sunucusu env değişkenine ihtiyaç duyar; HTTP sunucusu ?apikey= veya bir Authorization başlığına ihtiyaç duyar. Bunları karıştırmayın.
• Araç olmadan .pptx istemek. 2Slides bağlı değilken Claude Code bir taslak yazabilir ancak gerçek bir PowerPoint üretemez. Önce sunucuyu bağlayın.
• Temayı unutmak. themes_search çalıştırmaz veya bir stil belirtmezseniz, Fast PPT sizin için birini seçer. Görünümü kontrol etmek için onu belirtin.
• Çok hızlı yoklama. Eşzamansız işler (Nano Banana, anlatım) sıkı bir döngüde değil, yaklaşık her 20 saniyede bir jobs_get ile yoklanmalıdır.

Sık sorulan sorular

Claude Code MCP sunucularını doğal olarak destekliyor mu?

Evet. Claude Code birinci sınıf bir MCP istemcisidir. Sunucuları claude mcp add (stdio, SSE veya HTTP taşımaları) ile eklersiniz, claude mcp list ile listelersiniz ve oturum içinde /mcp ile incelersiniz. 2Slides sunucusu bunların hepsiyle çalışır.

Stdio mı Streamable HTTP mı — hangisini kullanmalıyım?

Yerel makinenizde stdio kullanın (sizin için npx -y 2slides-mcp@latest çalıştırır), Node kuramadığınız veya kurmak istemediğiniz her yerde — CI, konteynerler, uzak sunucular — Streamable HTTP kullanın. Her ikisi de aynı araçları sunar ve aynı çıktıyı üretir.

Bu, gerçek bir PowerPoint dosyası üretiyor mu?

Evet. Fast PPT yolu (slides_generate) gerçek şekiller ve temalar içeren düzenlenebilir bir .pptx döndürür. Nano Banana yolları görsel tasarımlı sunumlar döndürür ve yapay zeka sesli anlatım ile dışa aktarılabilir varlıklar ekleyebilir. Bunlar açabileceğiniz, düzenleyebileceğiniz ve sunabileceğiniz dosyalardır — ekran görüntüsü değil.

API anahtarını ve yapılandırmayı nereden alırım?

2slides.com/api?tab=mcp adresinden. Bu sayfa anahtarınızı, kullanıma hazır bir stdio yapılandırmasını ve Streamable HTTP uç noktası URL'sini gösterir.

2Slides sunucusunu ekibimle paylaşabilir miyim?

Evet. Depoya işlediğiniz paylaşılan bir .mcp.json dosyası yazmak için --scope project ile ekleyin. Takım arkadaşlarınızdan ilk kullanımda onaylamaları istenir. Özel, tüm projeler için bir kurulum için --scope user kullanın.

Özet

Claude Code düşünür; 2Slides MCP sunucusu dosyayı üretir. Bir kez bağlayın — yerel için stdio, uzak için Streamable HTTP — ve "bana bir sunum hazırla" terminalinizde tek bir cümleye dönüşsün.

Claude Code içinde yaşıyorsanız, bu bir fikirden (ya da deponuzdaki bir dosyadan) bitmiş, düzenlenebilir bir PowerPoint'e giden en hızlı yoldur. Slaytları ajanlara bağlamaya daha geniş bir bakış için, MCP'nin sunum iş akışlarını nasıl değiştirdiğine ve eksiksiz PowerPoint MCP sunucu ekosistemi haritasına bakın. CLI yerine masaüstü uygulamasını mı kullanıyorsunuz? Sunum oluşturmak için Claude MCP'yi nasıl kullanacağınıza bakın.

Anahtarınızı ve yapılandırmanızı 2slides.com/api?tab=mcp adresinden alın ve ilk sunumunuzu bir dakikadan kısa sürede terminalden oluşturun.

Kaynaklar:

• Claude Code — Connect to tools via MCP (official docs)
• 2Slides API & MCP server