Cara Menggunakan Claude Code dengan 2Slides MCP Server (Panduan 2026)

Jawaban singkat (≤60 kata): Claude Code bisa menghasilkan file PowerPoint nyata dengan terhubung ke 2Slides MCP server. Dapatkan API key di 2slides.com/api, lalu jalankan claude mcp add 2slides -e API_KEY=xxx -- npx -y 2slides-mcp@latest untuk stdio lokal, atau claude mcp add --transport http 2slides https://2slides.com/api/mcp?apikey=KEY untuk Streamable HTTP jarak jauh. Setelah itu cukup minta Claude Code membuatkan deck.

Claude Code adalah agen coding berbasis terminal dari Anthropic, dan ia berbicara Model Context Protocol (MCP) secara native. Artinya, Anda bisa memberinya sebuah tool yang mengubah teks menjadi file .pptx jadi tanpa pernah meninggalkan shell Anda. 2Slides MCP server adalah tool itu: sebuah konektor ringan yang mengekspos API pembuatan slide, theming, narasi, dan ekspor milik 2Slides sebagai tool MCP yang bisa dipanggil langsung oleh Claude Code.

Panduan ini menunjukkan dua cara menghubungkannya — stdio lokal dan Streamable HTTP jarak jauh — mana yang sebaiknya dipilih, apa fungsi tiap tool, dan prompt persis yang mengubah permintaan satu baris menjadi PowerPoint siap unduh.

Mengapa menghubungkan Claude Code ke 2Slides sama sekali?

Claude Code sangat baik dalam menalar isi repo Anda, menyusun draf konten, dan membangun argumen. Yang tidak bisa ia lakukan sendiri adalah menghasilkan .pptx nyata yang dapat diedit, lengkap dengan shape, grafik, tema, dan catatan pembicara. Itu adalah persoalan pembuatan file, dan itu menjadi tugas tool khusus.

Pembagiannya jelas:

• Claude Code membaca materi sumber Anda (sebuah README, sebuah spesifikasi, sebuah CSV, sebuah catatan riset), menalarnya, dan memutuskan apa yang masuk ke tiap slide.
• 2Slides MCP server mengambil rencana itu dan merender file PowerPoint sungguhan — atau slide berbasis gambar dengan narasi suara AI dan ekspor MP4.

Anda tetap berada di terminal sepanjang waktu. Minta, tunggu ~30–60 detik, dapatkan URL unduhan.

Apa yang Anda perlukan lebih dulu

1. Claude Code terpasang dan terotentikasi (claude ada di PATH Anda).
2. Sebuah API key 2Slides. Buat satu di 2slides.com/api. Halaman yang sama menyediakan konfigurasi MCP siap salin-tempel dan endpoint Streamable HTTP.
3. Node.js (untuk transport stdio, yang menjalankan npx -y 2slides-mcp@latest secara lokal). Transport HTTP tidak memerlukan apa pun secara lokal.

Stdio vs Streamable HTTP: transport mana?

2Slides MCP server mendukung dua transport. Keduanya mengekspos set tool yang identik; perbedaannya hanya di mana konektor berjalan.

Patokan praktis: gunakan stdio di mesin Anda sendiri untuk pekerjaan sehari-hari, dan Streamable HTTP saat Claude Code berjalan di tempat yang tidak bisa Anda pasangi Node (server jarak jauh, job CI, container yang terkunci).

Metode 1: Hubungkan via stdio (lokal)

Jalankan ini sekali. Pemisah -- membagi flag milik Claude Code sendiri dari perintah yang ia jalankan:

Beberapa hal yang perlu diketahui:

• Tetap letakkan --transport stdio (atau flag lain) di antara --env dan nama server. Karena --env menerima beberapa pasangan KEY=value, meletakkan nama tepat setelahnya bisa membuat CLI membaca nama tersebut sebagai variabel env lain.
• Semua yang ada setelah -- diteruskan ke server apa adanya (npx -y 2slides-mcp@latest).
• Tambahkan --scope user agar 2Slides tersedia di setiap proyek, atau --scope project untuk mencantumkannya ke .mcp.json bersama bagi tim Anda.

.mcp.json yang dihasilkan (scope project) tampak seperti ini — Anda juga bisa menyuntingnya secara manual:

Metode 2: Hubungkan via Streamable HTTP (jarak jauh)

Tanpa instalasi lokal — cukup arahkan Claude Code ke endpoint yang di-hosting:

Lebih suka menjaga key tetap di luar URL? Kirim sebagai header saja:

Verifikasi koneksi

Atau, di dalam sesi interaktif, jalankan slash command /mcp untuk melihat server yang terhubung, jumlah tool, dan (untuk server jarak jauh) status auth-nya.

Hasilkan deck pertama Anda

Setelah terhubung, Anda tidak memanggil tool secara manual — Anda cukup meminta. Claude Code merangkai tool 2Slides secara otomatis:

Di balik layar, Claude Code menjalankan themes_search untuk menemukan sebuah themeId, lalu slides_generate (Fast PPT) dan menyerahkan sebuah downloadUrl kepada Anda. Total waktu: kira-kira 30–60 detik untuk PowerPoint bertema.

Ingin slide kustom yang didesain berbasis gambar alih-alih template? Mintalah, dan Claude Code akan menggunakan jalur Nano Banana (slides_create_pdf_slides), melakukan polling jobs_get sampai siap, lalu mengembalikan tautannya.

Daftar tool 2Slides MCP

Claude Code melihat tool berikut setelah terhubung:

Tiga rangkaian umum:

• Fast PPT: themes_search → slides_generate (sync) → unduh.
• Nano Banana: slides_create_pdf_slides (async) → jobs_get → unduh.
• Aset video bernarasi: buat slide → jobs_get → slides_generate_narration → jobs_get → slides_download_slides_pages_voices.

Kesalahan umum dan pemecahan masalah

• Server tidak muncul di claude mcp list. Untuk stdio, periksa urutan --env/nama sudah benar (jaga ada flag di antara --env dan nama). Untuk HTTP, periksa kembali URL dan pastikan API key valid.
• API_KEY hilang. Server stdio butuh variabel env; server HTTP butuh ?apikey= atau header Authorization. Jangan tertukar.
• Meminta .pptx tanpa tool-nya. Tanpa 2Slides terhubung, Claude Code bisa menulis outline tetapi tidak bisa menghasilkan PowerPoint nyata. Hubungkan server-nya dulu.
• Lupa tema. Jika Anda tidak menjalankan themes_search atau menyebut gaya, Fast PPT akan memilihkannya untuk Anda. Tentukan agar Anda bisa mengendalikan tampilannya.
• Polling terlalu cepat. Job async (Nano Banana, narasi) sebaiknya dipolling dengan jobs_get sekitar setiap 20 detik, bukan dalam loop yang rapat.

Pertanyaan yang sering diajukan

Apakah Claude Code mendukung MCP server secara native?

Ya. Claude Code adalah klien MCP kelas satu. Anda menambahkan server dengan claude mcp add (transport stdio, SSE, atau HTTP), mendaftarnya dengan claude mcp list, dan memeriksanya dalam sesi dengan /mcp. Server 2Slides bekerja dengan semua ini.

Stdio atau Streamable HTTP — mana yang sebaiknya saya pakai?

Gunakan stdio di mesin lokal Anda (ia menjalankan npx -y 2slides-mcp@latest untuk Anda) dan Streamable HTTP di mana pun Anda tidak bisa atau tidak ingin memasang Node — CI, container, server jarak jauh. Keduanya mengekspos tool yang sama dan menghasilkan output identik.

Apakah ini menghasilkan file PowerPoint nyata?

Ya. Jalur Fast PPT (slides_generate) mengembalikan .pptx yang dapat diedit dengan shape dan tema sungguhan. Jalur Nano Banana mengembalikan deck berbasis gambar dan dapat menambahkan narasi suara AI serta aset yang bisa diekspor. Ini adalah file yang bisa Anda buka, edit, dan presentasikan — bukan screenshot.

Di mana saya mendapatkan API key dan konfigurasi?

Di 2slides.com/api?tab=mcp. Halaman itu menampilkan key Anda, konfigurasi stdio siap salin-tempel, dan URL endpoint Streamable HTTP.

Bisakah saya berbagi server 2Slides dengan tim saya?

Ya. Tambahkan dengan --scope project untuk menulis .mcp.json bersama yang Anda commit ke repo. Rekan tim akan diminta menyetujuinya saat pertama kali digunakan. Gunakan --scope user untuk setup pribadi di semua proyek.

Kesimpulan

Claude Code yang berpikir; 2Slides MCP server yang membuat file-nya. Hubungkan sekali — stdio untuk lokal, Streamable HTTP untuk jarak jauh — dan "buatkan saya deck" menjadi satu kalimat di terminal Anda.

Jika Anda hidup di dalam Claude Code, inilah jalur tercepat dari sebuah ide (atau sebuah file di repo Anda) menuju PowerPoint jadi yang dapat diedit. Untuk gambaran lebih luas tentang menyambungkan slide ke dalam agen, lihat bagaimana MCP mengubah alur kerja presentasi dan peta lengkap ekosistem PowerPoint MCP server. Memakai aplikasi desktop alih-alih CLI? Lihat cara menggunakan Claude MCP untuk menghasilkan presentasi.

Ambil key dan konfigurasi Anda di 2slides.com/api?tab=mcp dan hasilkan deck pertama Anda dari terminal dalam waktu kurang dari satu menit.

Sumber:

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