Cara Menggunakan OpenAI Codex dengan 2Slides MCP Server (Panduan 2026)

Jawaban singkat (≤60 kata): OpenAI Codex bisa menghasilkan file PowerPoint nyata dengan menambahkan 2Slides MCP server ke ~/.codex/config.toml. Dapatkan key di 2slides.com/api, lalu tambahkan blok [mcp_servers.2slides] yang menjalankan npx -y 2slides-mcp@latest (stdio) atau blok url = "https://2slides.com/api/mcp?apikey=KEY" (Streamable HTTP). Atau jalankan codex mcp add 2slides --env API_KEY=xxx -- npx -y 2slides-mcp@latest. Lalu minta Codex membuatkan deck.

OpenAI Codex adalah agen coding CLI open-source dari OpenAI, dan ia adalah klien Model Context Protocol (MCP). Sambungkan ke 2Slides MCP server dan Codex bisa mengubah sebuah brief — atau sebuah file di repo Anda — menjadi .pptx jadi yang dapat diedit, semuanya dari terminal.

Panduan ini memberi Anda blok config.toml yang persis untuk kedua transport (stdio lokal dan Streamable HTTP jarak jauh), pintasan satu baris codex mcp add, fungsi tiap tool 2Slides, dan jebakan spesifik versi yang perlu diwaspadai pada server HTTP.

Mengapa memasangkan Codex dengan 2Slides?

Codex menalar kode dan konten; ia tidak menghasilkan file slide biner sendiri. 2Slides MCP server mengisi celah itu. Pembagian tugasnya:

• Codex membaca sumber Anda (spesifikasi, README, file data), merencanakan slide, dan memutuskan narasinya.
• 2Slides MCP server merender PowerPoint sungguhan — Fast PPT berbasis tema, atau slide berbasis gambar dengan narasi AI opsional dan paket aset yang bisa diekspor.

Anda meminta dalam bahasa biasa; Codex memanggil tool-nya; sebuah tautan unduhan kembali kepada Anda.

Apa yang Anda perlukan lebih dulu

1. Codex CLI terpasang (codex ada di PATH Anda).
2. Sebuah API key 2Slides dari 2slides.com/api — halaman itu juga menyediakan konfigurasi MCP dan endpoint Streamable HTTP.
3. Node.js untuk transport stdio (ia menjalankan npx -y 2slides-mcp@latest). Transport HTTP tidak butuh apa pun secara lokal.

Stdio vs Streamable HTTP: transport mana?

2Slides MCP server menawarkan keduanya. Tool-nya sama dengan cara mana pun — perbedaannya adalah di mana konektor berjalan.

Gunakan stdio di workstation Anda; gunakan Streamable HTTP saat Codex berjalan di tempat yang tidak bisa Anda pasangi Node.

Metode 1: stdio di config.toml

Sunting ~/.codex/config.toml dan tambahkan:

Field opsional yang didukung Codex untuk server stdio meliputi cwd, startup_timeout_sec (default 10d), dan tool_timeout_sec (default 60d). Jika Anda lebih suka meneruskan variabel lingkungan yang sudah ada alih-alih menuliskan key langsung, gunakan env_vars = ["API_KEY"].

Atau gunakan pintasan codex mcp add

Tanpa perlu menyunting file — ini menuliskan blok untuk Anda:

Semua yang ada setelah -- adalah perintah server. Jalankan codex mcp --help untuk daftar lengkap subcommand pada versi yang Anda pasang.

Metode 2: Streamable HTTP di config.toml

Arahkan Codex ke endpoint yang di-hosting:

Jika Anda lebih suka auth header ketimbang key di query-string, Codex mendukung variabel env bearer-token dan header statis:

Jebakan versi (penting): Codex mengarahkan server MCP HTTP melalui klien MCP Rust-nya. Versi terbaru menyambungkannya secara otomatis, tetapi beberapa build lama melempar error missing field command in mcp_servers sampai Anda mengaktifkan klien eksperimental. Jika ini terjadi pada Anda, tambahkan:

Periksa codex --version dulu — rilis yang lebih baru sudah memasukkannya, dan flag ini sedang diganti namanya menjadi [features].rmcp_client. Tampilkan blok ini hanya sebagai cadangan jika versi Anda mengeluh.

Verifikasi koneksi

Atau, di dalam Codex TUI, jalankan /mcp untuk melihat server aktif dan tool-nya. (Subcommand manajemen codex mcp masih terus berkembang; codex mcp --help adalah acuan resmi untuk build Anda.)

Hasilkan deck pertama Anda

Anda tidak memanggil tool secara manual — Anda meminta:

Codex menjalankan themes_search untuk menemukan sebuah themeId, lalu slides_generate (Fast PPT), dan mengembalikan sebuah downloadUrl — PowerPoint nyata dalam kira-kira 30–60 detik. Minta slide berbasis gambar dan ia beralih ke slides_create_pdf_slides, melakukan polling jobs_get sampai file-nya siap.

Daftar tool 2Slides MCP

Kesalahan umum dan pemecahan masalah

• missing field command in mcp_servers pada server HTTP. Versi Codex Anda butuh experimental_use_rmcp_client = true di bawah [features]. Upgrade Codex, atau tambahkan flag itu.
• Header tabel TOML vs tabel inline. [mcp_servers.2slides.env] adalah sub-tabel; jika Anda menuliskannya inline, tulis env = { API_KEY = "..." } pada baris server — jangan campur kedua gaya.
• Nama server harus unik. Tiap server dikunci oleh segmen [mcp_servers.NAME]; menggunakan ulang nama akan menimpa blok sebelumnya.
• Tidak ada .pptx tanpa tool-nya. Codex sendiri bisa membuat draf outline tetapi tidak bisa menghasilkan PowerPoint. Tambahkan 2Slides dulu.
• Tool timeout pada deck besar. Job besar atau bernarasi bisa melampaui tool_timeout_sec default 60 detik; naikkan nilainya, atau biarkan Codex melakukan polling jobs_get untuk job async.

Pertanyaan yang sering diajukan

Apakah OpenAI Codex mendukung MCP server?

Ya. Codex adalah klien MCP. Anda mengonfigurasi server di ~/.codex/config.toml di bawah [mcp_servers.NAME], atau menambahkannya dengan codex mcp add. Server stdio maupun HTTP jarak jauh sama-sama didukung.

Di mana Codex menyimpan konfigurasi MCP?

Di ~/.codex/config.toml (global). Proyek tepercaya juga bisa memakai .codex/config.toml lokal-proyek. Tiap server MCP adalah sebuah tabel [mcp_servers.NAME].

Stdio atau Streamable HTTP?

Stdio menjalankan npx -y 2slides-mcp@latest di mesin Anda dan merupakan default untuk pekerjaan lokal. Streamable HTTP mengarah ke endpoint https://2slides.com/api/mcp yang di-hosting dan tidak butuh instalasi apa pun — ideal untuk CI dan lingkungan jarak jauh. Tool sama, output sama.

Apakah ini menghasilkan PowerPoint nyata?

Ya — slides_generate mengembalikan .pptx yang dapat diedit. Tool Nano Banana mengembalikan deck berbasis gambar dan dapat menambahkan narasi AI serta paket aset yang bisa diekspor.

Di mana saya mendapatkan key dan konfigurasi?

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

Kesimpulan

Tambahkan satu blok [mcp_servers.2slides] ke config.toml (atau jalankan codex mcp add), dan Codex memperoleh sebuah tool yang mengubah brief apa pun menjadi PowerPoint jadi — tanpa meninggalkan terminal Anda.

Codex adalah agen penalaran yang tangguh; 2Slides adalah pembuat file yang selama ini hilang darinya. Untuk gambaran besarnya, lihat bagaimana MCP mengubah alur kerja presentasi dan peta ekosistem PowerPoint MCP server. Lebih suka agen Anthropic? Lihat cara menggunakan Claude Code dengan 2Slides MCP server.

Dapatkan key Anda dan konfigurasi yang persis di 2slides.com/api?tab=mcp dan kirim deck pertama buatan Codex Anda hari ini.

Sumber:

• OpenAI Codex — Model Context Protocol (official docs)
• OpenAI Codex — Configuration Reference
• 2Slides API & MCP server