2Slides Team
6 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 vs 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를, Codex가 Node를 설치할 수 없는 곳에서 실행될 때는 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]블록 하나를 추가하면(또는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
