Cara Menggunakan QoderWake dengan 2Slides: MCP untuk Karyawan AI (2026)

Jawaban singkat (≤60 kata): Temukan ID Waker Anda dengan qoderwake waker list --json, lalu jalankan 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". Waker tersebut kemudian dapat mencari templat 2Slides dan menghasilkan .pptx yang dapat diedit, sesuai permintaan, dari DingTalk atau Feishu, atau berdasarkan jadwal.

QoderWake, dari tim Qoder di Alibaba, menyebut produknya sebagai "Karyawan AI Otonom, Sedang Bertugas". Setiap karyawan digital disebut sebagai Waker. Seorang Waker dipicu oleh pesan IM, jadwal, hook event, atau panggilan API, dan melakukan pekerjaannya sendiri. QoderWake berjalan di macOS 13+, Linux, dan Windows 10+. Layanan ini memiliki konsol web lokal di 127.0.0.1:19820 dan CLI lengkap, serta terhubung ke DingTalk dan Feishu.

Server dan skill MCP dipasang per Waker. Panduan ini menunjukkan cara memberikan mesin presentasi 2Slides kepada satu Waker (misalnya, "Asisten Pelaporan" Anda). Panduan ini menggunakan referensi CLI resmi QoderWake dan endpoint 2Slides yang kami uji langsung di produksi pada 30 September 2026.

Mengapa memberikan 2Slides kepada Waker?

• Waker dibuat untuk pekerjaan berulang, dan "mengubah angka minggu ini menjadi deck presentasi" adalah jenis pekerjaan yang tepat untuk itu.
• 2Slides menghasilkan file: PowerPoint berbasis templat yang dapat diedit (Fast PPT, 10 kredit per halaman), atau slide dengan desain gambar (Nano Banana, 100 kredit per halaman pada 1K/2K) dengan opsi narasi suara IA.
• Cakupan per-Waker berarti hanya Waker yang membutuhkan slide yang mendapatkan alat dan kunci akses tersebut.

Yang Anda butuhkan terlebih dahulu

1. QoderWake terinstal dan sudah masuk (login). Di macOS atau Linux, referensi CLI menyediakan penginstal satu baris:

Paket Windows dan macOS tersedia di situs web QoderWake. Jika shell tidak dapat menemukan qoderwake, gunakan ~/.qoderwake/bin/qoderwake.

1. Kunci API 2Slides dari 2slides.com/api (sk-2slides-...). Akun baru mendapatkan 500 kredit gratis, yang mencakup 50 halaman Fast PPT.
2. Node.js di perangkat, hanya untuk metode stdio.

Langkah 1: Temukan ID Waker

ID Waker dimulai dengan ag_. Salin ID untuk Waker yang bertugas membuat deck. Contoh di bawah ini menggunakan ag_xxx.

Metode 1: Hosted MCP melalui HTTP (direkomendasikan)

Tentang penggunaan tanda kutip. Sintaks CLI adalah --header KEY=VALUE (dapat diulang). Nilai di sini, Bearer YOUR_2SLIDES_API_KEY, mengandung spasi, jadi bungkus seluruh pasangan KEY=VALUE dalam tanda kutip ganda seperti yang ditunjukkan. Tanpa tanda kutip, shell akan membaginya menjadi dua argumen dan header hanya akan terbaca sebagai Bearer.

Ingin menghindari masalah parsing = dan spasi sepenuhnya? Gunakan bentuk JSON dari opsi yang sama, --headers <json>:

Di Windows PowerShell, tanda kutip tunggal juga berfungsi, tetapi mengutip JSON di berbagai shell bisa merepotkan. Dalam kasus tersebut, impor berbasis file di Metode 2 adalah pilihan yang lebih aman.

Cadangan tanpa header. Jika header tetap tidak terkirim (muncul 401 atau Authentication required saat alat diperbarui), lewati header sepenuhnya. 2Slides juga menerima kunci sebagai parameter kueri URL, dan kami telah menguji bentuk tersebut secara menyeluruh:

Perlakukan URL tersebut seperti kata sandi: jangan tempelkan ke dalam tugas atau tangkapan layar, dan rotasi kunci di 2slides.com/api jika bocor.

2Slides menggunakan kunci API biasa, bukan OAuth, jadi biarkan semua flag --oauth-* dalam posisi mati (off).

Metode 2: Impor JSON MCP

qoderwake mcp add juga menerima --json <json> atau --json-file <path> untuk mengimpor JSON MCP secara langsung. Simpan ini sebagai 2slides-mcp.json:

Referensi CLI tidak merinci bentuk JSON mana yang diterima pengimpor. Blok di atas adalah format mcpServers yang umum. Jika impor ditolak, gunakan flag Metode 1 yang terdokumentasi sepenuhnya. Hapus file setelahnya, atau jauhkan dari repositori Git apa pun, karena file tersebut berisi kunci Anda.

Metode 3: Server stdio lokal

Untuk menjalankan paket sumber terbuka 2slides-mcp di perangkat Waker:

--args menerima daftar yang dipisahkan koma, gaya yang sama dengan contoh sistem file resmi di referensi CLI. --env menerima JSON. Ini memerlukan Node.js pada mesin tempat Waker berjalan, dan QoderWake secara default menetap di perangkat (device-resident).

Verifikasi koneksi

Ambil <mid> dari mcp list. Kemudian kirimkan tes baca-saja (read-only) ke Waker. Panduan QoderWake sendiri menyarankan untuk memvalidasi konektor baru dengan panggilan baca-saja terlebih dahulu:

themes_search gratis, jadi pengujian ini tidak memakan biaya. Jika konektor tidak berfungsi dengan baik, qoderwake mcp toggle --waker-id ag_xxx --mcp-id <mid> --enabled false akan menonaktifkannya tanpa menghapusnya.

Metode 4: Unggah skill 2Slides

Skill QoderWake adalah paket kemampuan berversi git yang dapat Anda bandingkan (diff) dan kembalikan (roll back). Anda mengunggah "file Markdown atau arsip yang berisi SKILL.md". Skill resmi 2Slides tersedia di github.com/2slides/slides-generation-2slides-skills. Kompres menjadi zip sehingga SKILL.md berada di root arsip:

Ini akan mengabaikan bundel .skill lama yang ada di repositori. Skrip Python pada skill tersebut (Python 3 dan requests) membaca kunci dari variabel lingkungan SLIDES_2SLIDES_API_KEY.

Aturan rahasia. Dokumentasi QoderWake menyatakan: "Jangan pernah menaruh rahasia, token, atau cookie dalam tugas, memori, basis pengetahuan, file peran, atau tangkapan layar." Kredensial harus berada di bidang yang dilindungi atau variabel lingkungan. Jadi, jangan pernah menempelkan kunci Anda ke dalam prompt tugas atau meminta Waker untuk "mengingatnya". QoderWake tidak mendokumentasikan cara meneruskan variabel lingkungan ke skrip skill, jadi kami menyarankan pembagian ini:

• Gunakan konektor MCP (Metode 1) untuk panggilan API yang sebenarnya. Kunci tersimpan di header-nya.
• Gunakan skill hanya jika variabel SLIDES_2SLIDES_API_KEY sudah diatur di lingkungan tempat Waker berjalan. Periksa dengan tugas pengujian yang menjalankan scripts/search_themes.py --query minimal --limit 1.

Hasilkan deck pertama Anda

Waker akan memanggil themes_search, lalu slides_generate, dan mengembalikan downloadUrl. Dalam pengujian produksi kami, deck Fast PPT sebanyak 3 halaman selesai dalam waktu sekitar 22 detik. Tautan akan kedaluwarsa setelah 1 jam. Dokumentasi QoderWake menyebutkan bahwa pengiriman file "bergantung pada kemampuan saluran. Gunakan tautan yang dikembalikan atau artefak tugas". Jadi, mintalah Waker untuk segera mengirimkan tautan tersebut, atau unduh .pptx ke dalam ruang kerjanya. Anda kemudian dapat mengambilnya dari sesi dengan qoderwake session artifacts --session-id sess_xxx.

Contoh penggunaan untuk karyawan AI

Dicuicu oleh DingTalk atau Feishu. Setelah Waker dipasangkan dengan saluran DingTalk atau Feishu, rekan tim dapat mengirim pesan "@Reporting Assistant buatkan pembaruan 6 slide tentang rencana perekrutan Q4". Waker akan mengumpulkan konteks, memanggil 2Slides, dan membalas dengan tautan tersebut.

Deck mingguan sesuai jadwal. Referensi CLI mendokumentasikan otomatisasi terjadwal:

Jalankan sekali dengan run-now dan periksa hasilnya dengan qoderwake automation detail sebelum membiarkannya berjalan sendiri.

Alat MCP 2Slides

Apa yang sudah dikonfirmasi vs. belum didokumentasikan (per 30 September 2026)

Pemecahan Masalah

• "daemon unreachable". Jalankan qoderwake status. Jika daemon tidak berjalan, qoderwake start. Jika port sudah terpakai, qoderwake start --port auto.
• 401 dari QoderWake sendiri. Jalankan qoderwake whoami, dan qoderwake login lagi jika diperlukan.
• 401 dari 2Slides. Header mungkin terkirim tanpa kunci. Tambahkan kembali dengan --header yang dikutip atau format JSON --headers.
• Alat hilang. Jalankan qoderwake mcp refresh-tools, dan pastikan konektor diaktifkan dengan mcp toggle ... --enabled true.
• stdio gagal. Pastikan Node.js terinstal di perangkat Waker dan --args dipisahkan dengan koma.
• Kesalahan dalam eksekusi. qoderwake log --level error --limit 100 atau qoderwake trace list --status failed.
• Tautan kedaluwarsa. downloadUrl bertahan selama 1 jam. Minta Waker untuk menyimpan file sebagai artefak tugas.

Pertanyaan yang sering diajukan

Apakah QoderWake mendukung server MCP kustom?

Ya. Setiap Waker dapat memasang beberapa server MCP melalui stdio, HTTP, atau SSE, menggunakan qoderwake mcp add --waker-id <id> atau layar Konektor MCP Kustom di konsol.

Apa perintah tepat untuk menambahkan 2Slides ke Waker?

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". Beri tanda kutip pada seluruh pasangan header, karena nilainya mengandung spasi.

Di mana saya harus menyimpan kunci API 2Slides di QoderWake?

Di header konektor MCP (--header atau --headers) atau --env untuk stdio. Jangan pernah menaruhnya di tugas, memori, basis pengetahuan, atau file peran. Dokumentasi QoderWake melarang hal itu secara eksplisit.

Bisakah Waker mengirim PowerPoint ke DingTalk atau Feishu?

Waker selalu dapat membalas dengan tautan unduhan 2Slides. Apakah file itu sendiri dilampirkan bergantung pada saluran tersebut. Dokumentasi QoderWake menyarankan untuk menggunakan tautan yang dikembalikan atau artefak tugas. Tautan akan kedaluwarsa setelah 1 jam.

Bisakah Waker membuat deck setiap minggu secara otomatis?

Ya. Buat otomatisasi terjadwal dengan qoderwake automation create schedule dan ekspresi cron. Uji dengan automation run-now sebelum dijalankan tanpa pengawasan.

Berapa biayanya?

Akun 2Slides baru mendapatkan 500 kredit gratis. Fast PPT berbiaya 10 kredit per halaman, jadi deck mingguan berisi 8 slide adalah 80 kredit. Pencarian tema, pemantauan pekerjaan, dan ekspor bersifat gratis.

Kesimpulan

Satu perintah qoderwake mcp add mengubah Waker menjadi karyawan AI yang mampu mengirimkan deck presentasi nyata. Simpan kunci API di header MCP, picu melalui DingTalk, Feishu, atau jadwal cron, dan simpan .pptx dalam waktu kurang dari satu jam.

Panduan terkait: agen AI pribadi yang dapat membuat slide, QwenWork dengan 2Slides, WorkBuddy dengan 2Slides, menggunakan agen AI apa pun dengan server MCP 2Slides, dan skill agen vs server MCP.

Dapatkan kunci dan konfigurasi Anda di 2slides.com/api?tab=mcp.

Sumber:

• Referensi CLI QoderWake
• Skill dan integrasi QoderWake
• Halaman produk QoderWake
• API dan server MCP 2Slides
• Skill 2Slides di GitHub
• 2slides-mcp di GitHub