OpenAI Codex ile 2Slides MCP Sunucusu Nasıl Kullanılır (2026 Rehberi)

Hızlı yanıt (≤60 kelime): OpenAI Codex, ~/.codex/config.toml dosyasına 2Slides MCP sunucusunu ekleyerek gerçek PowerPoint dosyaları üretebilir. 2slides.com/api adresinden bir anahtar alın, ardından npx -y 2slides-mcp@latest çalıştıran bir [mcp_servers.2slides] bloğu (stdio) veya bir url = "https://2slides.com/api/mcp?apikey=KEY" bloğu (Streamable HTTP) ekleyin. Ya da codex mcp add 2slides --env API_KEY=xxx -- npx -y 2slides-mcp@latest komutunu çalıştırın. Sonra Codex'ten bir sunum hazırlamasını isteyin.

OpenAI Codex, OpenAI'nin açık kaynaklı CLI kodlama ajanıdır ve bir Model Context Protocol (MCP) istemcisidir. Onu 2Slides MCP sunucusuna bağlayın; Codex bir özeti — ya da deponuzdaki bir dosyayı — tamamen terminalden, bitmiş ve düzenlenebilir bir .pptx'e dönüştürebilir.

Bu rehber, her iki taşıma için (yerel stdio ve uzak Streamable HTTP) tam config.toml bloklarını, tek satırlık codex mcp add kısayolunu, her 2Slides aracının ne yaptığını ve HTTP sunucularıyla dikkat edilmesi gereken sürüme özgü tuzağı verir.

Codex'i 2Slides ile neden eşleştirmeli?

Codex, kod ve içerik üzerinde akıl yürütür; kendi başına ikili slayt dosyaları üretmez. 2Slides MCP sunucusu bu boşluğu doldurur. İş bölümü:

• Codex kaynağınızı (spesifikasyon, README, veri dosyası) okur, slaytları planlar ve anlatıya karar verir.
• 2Slides MCP sunucusu gerçek PowerPoint'i — tema tabanlı Fast PPT ya da isteğe bağlı yapay zeka anlatımı ve dışa aktarılabilir bir varlık paketi içeren görsel tasarımlı slaytlar — oluşturur.

Sade bir dille istersiniz; Codex araçları çağırır; bir indirme bağlantısı geri gelir.

Önce neye ihtiyacınız var

1. Codex CLI kurulu (codex PATH'inizde).
2. Bir 2Slides API anahtarı 2slides.com/api adresinden — bu sayfada ayrıca MCP yapılandırması ve Streamable HTTP uç noktası bulunur.
3. Node.js stdio taşıması için (npx -y 2slides-mcp@latest çalıştırır). HTTP taşıması yerelde hiçbir şeye ihtiyaç duymaz.

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

2Slides MCP sunucusu her ikisini de sunar. Her iki yolda da aynı araçlar — fark, bağlayıcının nerede çalıştığıdır.

İş istasyonunuzda stdio kullanın; Codex'in Node kuramayacağınız bir yerde çalıştığı durumlarda Streamable HTTP kullanın.

Yöntem 1: config.toml içinde stdio

~/.codex/config.toml dosyasını düzenleyin ve şunu ekleyin:

Codex'in stdio sunucuları için desteklediği isteğe bağlı alanlar arasında cwd, startup_timeout_sec (varsayılan 10sn) ve tool_timeout_sec (varsayılan 60sn) bulunur. Anahtarı satır içine yazmak yerine mevcut bir ortam değişkenini geçirmeyi tercih ederseniz env_vars = ["API_KEY"] kullanın.

Veya codex mcp add kısayolunu kullanın

Dosya düzenleme gerekmez — bu, bloğu sizin için yazar:

-- sonrasındaki her şey sunucu komutudur. Kurulu sürümünüzdeki tam alt komut listesi için codex mcp --help çalıştırın.

Yöntem 2: config.toml içinde Streamable HTTP

Codex'i barındırılan uç noktaya yönlendirin:

Sorgu dizesi anahtarı yerine başlık kimlik doğrulamasını tercih ederseniz, Codex bir bearer-token env değişkenini ve statik başlıkları destekler:

Sürüm tuzağı (önemli): Codex, HTTP MCP sunucularını Rust MCP istemcisi üzerinden yönlendirir. Son sürümler bunu otomatik olarak ayarlar, ancak bazı eski derlemeler deneysel istemciyi etkinleştirene kadar missing field command in mcp_servers hatası verir. Bu sizin başınıza gelirse, şunu ekleyin:

Önce codex --version kontrol edin — daha yeni sürümler bunu içinde barındırır ve bayrak [features].rmcp_client olarak yeniden adlandırılıyor. Bu bloğu yalnızca sürümünüz şikayet ederse yedek olarak gösterin.

Bağlantıyı doğrulama

Veya Codex TUI içinde, etkin sunucuları ve araçlarını görmek için /mcp çalıştırın. (codex mcp yönetim alt komutları hâlâ gelişiyor; derlemeniz için codex mcp --help yetkili kaynaktır.)

İlk sunumunuzu oluşturun

Araçları elle çağırmazsınız — istersiniz:

Codex, bir themeId bulmak için themes_search, ardından slides_generate (Fast PPT) çalıştırır ve bir downloadUrl döndürür — yaklaşık 30–60 saniyede gerçek bir PowerPoint. Görsel tasarımlı slaytlar isterseniz slides_create_pdf_slides'a geçer ve dosya hazır olana kadar jobs_get ile yoklar.

2Slides MCP araç yüzeyi

Sık yapılan hatalar ve sorun giderme

• Bir HTTP sunucusunda missing field command in mcp_servers. Codex sürümünüz [features] altında experimental_use_rmcp_client = true gerektirir. Codex'i güncelleyin veya bayrağı ekleyin.
• TOML tablo başlıkları ve satır içi tablolar. [mcp_servers.2slides.env] bir alt tablodur; satır içine alırsanız sunucu satırına env = { API_KEY = "..." } yazın — her iki stili karıştırmayın.
• Sunucu adı benzersiz olmalı. Her sunucu [mcp_servers.NAME] bölümüyle anahtarlanır; bir adı yeniden kullanmak önceki bloğun üzerine yazar.
• Araç olmadan .pptx olmaz. Codex tek başına bir taslak hazırlayabilir ancak bir PowerPoint üretemez. Önce 2Slides'ı ekleyin.
• Büyük sunumlarda araç zaman aşımları. Büyük veya anlatımlı işler 60sn varsayılan tool_timeout_sec'i aşabilir; bunu yükseltin ya da eşzamansız işler için Codex'in jobs_get ile yoklamasına izin verin.

Sık sorulan sorular

OpenAI Codex MCP sunucularını destekliyor mu?

Evet. Codex bir MCP istemcisidir. Sunucuları ~/.codex/config.toml içinde [mcp_servers.NAME] altında yapılandırırsınız ya da codex mcp add ile eklersiniz. Hem stdio hem uzak HTTP sunucuları desteklenir.

Codex MCP yapılandırmasını nerede saklar?

~/.codex/config.toml içinde (global). Güvenilir projeler ayrıca proje-yerel bir .codex/config.toml kullanabilir. Her MCP sunucusu bir [mcp_servers.NAME] tablosudur.

Stdio mı Streamable HTTP mı?

Stdio, makinenizde npx -y 2slides-mcp@latest çalıştırır ve yerel çalışma için varsayılandır. Streamable HTTP, barındırılan https://2slides.com/api/mcp uç noktasını gösterir ve kurulu hiçbir şeye ihtiyaç duymaz — CI ve uzak ortamlar için idealdir. Aynı araçlar, aynı çıktı.

Gerçek bir PowerPoint üretiyor mu?

Evet — slides_generate düzenlenebilir bir .pptx döndürür. Nano Banana araçları görsel tasarımlı sunumlar döndürür ve yapay zeka anlatımı ile dışa aktarılabilir bir varlık paketi ekleyebilir.

Anahtarı ve yapılandırmayı nereden alırım?

2slides.com/api?tab=mcp adresinden: API anahtarınız, kopyala-yapıştır bir yapılandırma ve Streamable HTTP uç noktası URL'si.

Özet

config.toml'a tek bir [mcp_servers.2slides] bloğu ekleyin (veya codex mcp add çalıştırın); Codex, herhangi bir özeti terminalinizden çıkmadan bitmiş bir PowerPoint'e dönüştüren bir araç kazanır.

Codex güçlü bir akıl yürütme ajanıdır; 2Slides ise eksik olan dosya üreticisidir. Daha büyük resim için, MCP'nin sunum iş akışlarını nasıl değiştirdiğine ve PowerPoint MCP sunucu ekosistemi haritasına bakın. Anthropic'in ajanını mı tercih ediyorsunuz? Claude Code ile 2Slides MCP sunucusunu nasıl kullanacağınıza bakın.

Anahtarınızı ve tam yapılandırmayı 2slides.com/api?tab=mcp adresinden alın ve ilk Codex ile oluşturulmuş sunumunuzu bugün yayınlayın.

Kaynaklar:

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