2Slides Team
4 min read
OpenAI Codex で 2Slides MCP サーバーを使う方法（2026年版ガイド）
クイックアンサー（60語以内）: OpenAI Codex は、
~/.codex/config.tomlに 2Slides MCP サーバーを追加することで、本物の PowerPoint ファイルを生成できます。まず 2slides.com/api でキーを取得し、npx -y 2slides-mcp@latestを実行する[mcp_servers.2slides]ブロック（stdio）か、url = "https://2slides.com/api/mcp?apikey=KEY"ブロック（Streamable HTTP）を追加します。あるいはcodex mcp add 2slides --env API_KEY=xxx -- npx -y 2slides-mcp@latestを実行します。あとは Codex にデッキ作成を頼むだけです。
OpenAI Codex は OpenAI のオープンソース CLI コーディングエージェントであり、Model Context Protocol（MCP）クライアントです。2Slides MCP サーバーに接続すれば、Codex はブリーフ（あるいはリポジトリ内のファイル）を、完成した編集可能な .pptx に変換できます。すべてターミナルからです。
このガイドでは、両トランスポート（ローカルの stdio とリモートの Streamable HTTP）の正確な config.toml ブロック、ワンライナーの codex mcp add ショートカット、各 2Slides ツールの役割、そして HTTP サーバーで注意すべきバージョン固有の落とし穴を解説します。
なぜ Codex を 2Slides と組み合わせるのか？
Codex はコードとコンテンツについて推論しますが、単体ではバイナリのスライドファイルを出力できません。2Slides MCP サーバーがそのギャップを埋めます。役割分担は次のとおりです。
- Codex はソース（仕様書、README、データファイル）を読み、スライドを計画し、ストーリーを決めます。
- 2Slides MCP サーバー は実際の PowerPoint をレンダリングします。テーマベースの Fast PPT、または任意で AI ナレーションとエクスポート可能なアセットバンドルを伴う画像デザインのスライドです。
平易な言葉で頼めば、Codex がツールを呼び出し、ダウンロードリンクが返ってきます。
まず必要なもの
- Codex CLI のインストール（
codexが PATH に通っていること）。 - 2Slides の API キー — 2slides.com/api から取得します。このページには MCP 設定と Streamable HTTP エンドポイントも掲載されています。
- Node.js（stdio トランスポート用、
npx -y 2slides-mcp@latestを実行します）。HTTP トランスポートはローカルに何も必要ありません。
stdio と Streamable HTTP：どちらのトランスポート？
2Slides MCP サーバーは両方を提供します。どちらでも同じツールで、違いはコネクターがどこで動くかだけです。
| Stdio プロトコル | Streamable HTTP プロトコル | |
|---|---|---|
| 実行場所 | ローカル（npx -y 2slides-mcp@latest 経由） | リモート（2Slides がホスト） |
| ローカルの Node.js | 必須 | 不要 |
| 設定スタイル | command + args + env | url（任意で bearer_token_env_var） |
| 向いている用途 | ローカル開発、フルコントロール | リモート/CI マシン、軽量構成 |
ワークステーションでは stdio を、Node をインストールできない場所で Codex を動かすときは Streamable HTTP を使いましょう。
方法1：config.toml の stdio
~/.codex/config.toml を編集し、次を追加します。
[mcp_servers.2slides]
command = "npx"
args = ["-y", "2slides-mcp@latest"]
[mcp_servers.2slides.env]
API_KEY = "YOUR_2SLIDES_API_KEY"Codex が stdio サーバー向けにサポートする任意フィールドには、cwd、startup_timeout_sec（デフォルト10秒）、tool_timeout_sec（デフォルト60秒）があります。キーをインラインで書く代わりに既存の環境変数を渡したい場合は、env_vars = ["API_KEY"] を使います。
または codex mcp add ショートカットを使う
ファイル編集は不要で、ブロックを自動で書き込んでくれます。
codex mcp add 2slides --env API_KEY=YOUR_2SLIDES_API_KEY -- npx -y 2slides-mcp@latest-- の後ろはすべてサーバーコマンドです。インストール済みバージョンのサブコマンド一覧は codex mcp --help で確認してください。
方法2：config.toml の Streamable HTTP
Codex をホスト型エンドポイントに指し示します。
[mcp_servers.2slides_remote]
url = "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"クエリ文字列のキーよりヘッダー認証を好む場合、Codex は bearer トークンの環境変数と静的ヘッダーをサポートします。
[mcp_servers.2slides_remote]
url = "https://2slides.com/api/mcp"
bearer_token_env_var = "TWOSLIDES_TOKEN"バージョンの落とし穴（重要）: Codex は HTTP MCP サーバーを Rust 製の MCP クライアント経由でルーティングします。最近のバージョンはこれを自動的に設定しますが、一部の古いビルドでは、実験的クライアントを有効にするまで missing field command in mcp_servers というエラーが出ます。その場合は次を追加してください。
[features]
experimental_use_rmcp_client = trueまず codex --version を確認しましょう。新しいリリースはこれを内蔵しており、このフラグは [features].rmcp_client にリネームされつつあります。このブロックは、お使いのバージョンがエラーを出した場合のフォールバックとしてのみ使ってください。
接続を確認する
codex mcp list # 設定済みの MCP サーバーを一覧表示
codex mcp get 2slidesまたは、Codex の TUI 内で /mcp を実行すると、アクティブなサーバーとそのツールを確認できます。（codex mcp 管理サブコマンドはまだ進化中です。お使いのビルドでは codex mcp --help が正です。）
最初のデッキを生成する
ツールを手動で呼び出すのではなく、頼むだけです。
Read ./docs/launch-plan.md and generate a 10-slide launch deck.
Use a modern, dark business theme from 2slides. Return the
download link when it's done.Codex は themes_search を実行して themeId を見つけ、次に slides_generate（Fast PPT）を実行して downloadUrl を返します。おおよそ30〜60秒で本物の PowerPoint が手に入ります。画像デザインのスライドを頼めば、slides_create_pdf_slides に切り替わり、ファイルの準備ができるまで jobs_get をポーリングします。
2Slides MCP のツール一覧
| ツール | 役割 | クレジット |
|---|---|---|
themes_search | Fast PPT 用の themeId を探す | 無料 |
slides_generate | テーマベースの PowerPoint（Fast PPT）、同期/非同期 | 10 / ページ |
slides_create_pdf_slides | テキストから画像デザインのカスタムスライド（Nano Banana） | 100 / ページ (1K/2K), 200 (4K) |
slides_create_like_this | 参照画像のスタイルに合わせたスライド | 100 / ページ (1K/2K), 200 (4K) |
slides_generate_narration | Nano Banana ジョブに AI 音声ナレーションを追加 | 210 / ページ |
slides_download_slides_pages_voices | ページ + 音声を ZIP としてエクスポート | 無料 |
jobs_get | 非同期ジョブを完了までポーリング | 無料 |
よくある間違いとトラブルシューティング
- HTTP サーバーで
missing field command in mcp_serversが出る。 お使いの Codex バージョンには[features]配下のexperimental_use_rmcp_client = trueが必要です。Codex をアップグレードするか、フラグを追加してください。 - TOML のテーブルヘッダー vs インラインテーブル。
[mcp_servers.2slides.env]はサブテーブルです。インラインにする場合は、サーバー行にenv = { API_KEY = "..." }と書きます。両方のスタイルを混在させないでください。 - サーバー名は一意でなければならない。 各サーバーは
[mcp_servers.NAME]セグメントでキー付けされます。名前を再利用すると先のブロックが上書きされます。 - ツールなしでは
.pptxは作れない。 Codex 単体ではアウトラインを下書きできても PowerPoint は出力できません。先に 2Slides を追加してください。 - 大きなデッキでのツールタイムアウト。 大きなジョブやナレーション付きジョブは、デフォルトの 60秒
tool_timeout_secを超えることがあります。値を上げるか、非同期ジョブは Codex にjobs_getでポーリングさせましょう。
よくある質問
OpenAI Codex は MCP サーバーをサポートしていますか？
はい。Codex は MCP クライアントです。~/.codex/config.toml の [mcp_servers.NAME] 配下でサーバーを設定するか、codex mcp add で追加します。stdio とリモート HTTP の両サーバーがサポートされています。
Codex は MCP 設定をどこに保存しますか？
~/.codex/config.toml（グローバル）です。信頼されたプロジェクトでは、プロジェクトローカルの .codex/config.toml も使えます。各 MCP サーバーは [mcp_servers.NAME] テーブルです。
stdio と Streamable HTTP、どちら？
stdio はあなたのマシンで npx -y 2slides-mcp@latest を実行し、ローカル作業のデフォルトです。Streamable HTTP はホスト型の https://2slides.com/api/mcp エンドポイントを指し、何もインストールせずに済みます。CI やリモート環境に最適です。ツールも出力も同じです。
本物の PowerPoint を生成しますか？
はい — slides_generate は編集可能な .pptx を返します。Nano Banana ツールは画像デザインのデッキを返し、AI ナレーションとエクスポート可能なアセットバンドルを追加できます。
キーと設定はどこで入手できますか？
2slides.com/api?tab=mcp です。あなたの API キー、コピー&ペーストできる設定、そして Streamable HTTP のエンドポイント URL が揃っています。
まとめ
config.tomlに[mcp_servers.2slides]ブロックを1つ追加する（またはcodex mcp addを実行する）だけで、Codex はどんなブリーフも完成した PowerPoint に変えるツールを手に入れます。ターミナルを離れる必要はありません。
Codex は強力な推論エージェントであり、2Slides は欠けていたファイルジェネレーターです。全体像については、MCP がプレゼンテーションのワークフローをどう変えているか と PowerPoint MCP サーバーのエコシステム全体図 をご覧ください。Anthropic のエージェントがお好みですか？ Claude Code で 2Slides MCP サーバーを使う方法 を参照してください。
2slides.com/api?tab=mcp でキーと正確な設定を入手し、今日 Codex で生成した最初のデッキを世に出しましょう。
出典:
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
