

어떤 AI 에이전트로든 2Slides MCP 서버 사용하기: 완전한 2026 가이드
빠른 답변 (60단어 이내): 2Slides MCP 서버를 사용하면 MCP 지원 AI 에이전트 어떤 것이든 실제 PowerPoint 파일을 생성할 수 있습니다. 실행 방식은 두 가지입니다. stdio(
환경 변수와 함께API_KEY)와 Streamable HTTP(npx 2slides-mcp)입니다. 2slides.com/api에서 키를 발급받고, 사용하는 에이전트 — Claude Code, Codex, OpenClaw, Gemini CLI, Qwen Code 등 — 에 서버를 추가한 뒤 덱을 요청하세요.https://2slides.com/api/mcp?apikey=KEY
요즘 AI 에이전트라면 어느 것이든 슬라이드 개요를 작성할 수 있습니다. 하지만 그중 어느 것도 혼자서는 테마, 차트, 내레이션, 발표자 노트가 들어간 실제 편집 가능한
.pptx서버 설정을 한 번만 작성하면, 어떤 에이전트를 쓰든 동일한 도구가 켜집니다. 이 가이드는 두 가지 전송 방식을 설명하고, 지원되는 클라이언트를 보여 주며, 각각에 대한 단계별 설정으로 연결해 줍니다.
2Slides MCP 서버란?
2Slides의 슬라이드 생성 API를 MCP 도구로 노출하는 작은 커넥터입니다. 에이전트가 연결되면 다음을 호출할 수 있습니다.
| 도구 | 기능 | 크레딧 |
|---|---|---|
themes_search | 테마 기반 덱용 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_pages_voices | 페이지 + 오디오를 ZIP으로 내보내기 | 무료 |
jobs_get | 비동기 작업이 완료될 때까지 폴링 | 무료 |
에이전트는 사고를 담당합니다. 파일을 읽고, 논리를 구성하고, 카피를 작성합니다. 서버는 파일을 담당합니다. 평범한 언어로 요청하면 약 30~60초 만에 다운로드 URL이 돌아옵니다.
두 가지 전송 방식: stdio vs Streamable HTTP
2Slides MCP 서버는 두 프로토콜을 모두 지원합니다. 둘은 동일한 도구를 노출하며, 커넥터가 실행되는 위치만 다릅니다.
| Stdio 프로토콜 | Streamable HTTP 프로토콜 | |
|---|---|---|
| 실행 위치 | 로컬, npx 2slides-mcp | 원격, 2Slides가 호스팅 |
| 로컬 Node.js 필요 여부 | 예 | 아니요 |
| 인증 | API_KEY | URL의 ?apikey=Authorization |
| 엔드포인트 / 명령 | npx 2slides-mcp | https://2slides.com/api/mcp?apikey=KEY |
| 적합한 경우 | 로컬 개발, 완전한 제어, 오프라인 친화 | CI, 컨테이너, 원격 머신, 경량 클라이언트 |
범용 stdio 설정(대부분의 클라이언트가 받아들이는 형태):
{ "mcpServers": { "2slides": { "command": "npx", "args": ["2slides-mcp"], "env": { "API_KEY": "YOUR_2SLIDES_API_KEY" } } } }
범용 Streamable HTTP: 클라이언트를
https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEYhttpUrlurltransport: "streamable-http"--transport httpurl2slides.com/api?tab=mcp에서 키, 바로 붙여넣을 수 있는 설정, 그리고 엔드포인트를 받으세요.
지원 에이전트 한눈에 보기
| 에이전트 / 클라이언트 | 설정 위치 | Stdio | Streamable HTTP | 설정 가이드 |
|---|---|---|---|---|
| Claude Code | .mcp.jsonclaude mcp add | ✅ | ✅ (--transport http | 가이드 → |
| OpenAI Codex | ~/.codex/config.toml | ✅ | ✅ (url | 가이드 → |
| OpenClaw | ~/.openclaw/openclaw.jsonmcp.servers | ✅ | ✅ (transport: streamable-http | 가이드 → |
| Gemini CLI | ~/.gemini/settings.json | ✅ | ✅ (httpUrl | 가이드 → |
| Qwen Code | ~/.qwen/settings.json | ✅ | ✅ (httpUrl | 가이드 → |
| Claude Desktop | claude_desktop_config.json | ✅ | — | 가이드 → |
| Kimi (Moonshot) | Kimi CLI 또는 Claude Code 경유 | ✅ | ✅ | 아래 "Kimi & MiniMax" 참고 |
| MiniMax | Mini-Agent 또는 Claude Code 경유 | ✅ | ✅ | 아래 "Kimi & MiniMax" 참고 |
연결된 각 가이드에는 정확한 설정 블록, (존재하는 경우) 한 줄짜리
... mcp add에이전트 고르기
- Claude Code — Anthropic의 CLI. , 또는 원격은
claude mcp add --env API_KEY=xxx --transport stdio 2slides -- npx 2slides-mcp. 개인용과 팀용 스코프를 지원합니다.--transport http - OpenAI Codex — 의
config.toml블록, 또는[mcp_servers.2slides]. 원격은codex mcp add 2slides --env API_KEY=xxx -- npx 2slides-mcp블록으로.url - OpenClaw — 의
openclaw.json아래 항목 하나.mcp.servers으로 검증. 도구는openclaw mcp probe 2slides --json/coding프로필에 노출됩니다.messaging - Gemini CLI — 의
settings.json(원격은mcpServers), 또는httpUrl.gemini mcp add - Qwen Code — 의 동일한 형태. 중국어 덱에 강합니다.
~/.qwen/settings.json
Kimi와 MiniMax: 두 가지 추가 경로
Kimi(Moonshot)도 MiniMax도 위 에이전트들처럼 그 자체로 다듬어진 MCP 네이티브 CLI는 아니지만, 둘 다 두 가지 신뢰할 만한 경로로 2Slides MCP 서버에 도달합니다.
-
이들의 모델로 코딩 에이전트를 구동하기. 둘 다 Anthropic 호환 엔드포인트를 노출하므로, 이들을 대상으로 Claude Code를 실행하고 Claude Code 자체의 MCP 설정을 통해 2Slides를 붙일 수 있습니다.
# Kimi K2 via Moonshot export ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic" export ANTHROPIC_AUTH_TOKEN="YOUR_MOONSHOT_KEY" claude # then: claude mcp add ... 2slides -- npx 2slides-mcp # MiniMax export ANTHROPIC_BASE_URL="https://api.minimax.io/anthropic" export ANTHROPIC_AUTH_TOKEN="YOUR_MINIMAX_KEY" claude -
이들 자체의 에이전트 런타임을 사용하기. Moonshot은 Kimi CLI(표준
/mcpServers설정을 갖춘 네이티브 MCP 클라이언트)를 제공하고, MiniMax는 표준~/.kimi/mcp.json을 읽는 오픈소스 Mini-Agent를 배포합니다. 둘 다 위의 범용 stdio 또는 Streamable HTTP 블록과 똑같이 2Slides를 추가하면 됩니다.mcp.json
어느 쪽이든 2Slides 도구는 동일합니다. 바뀌는 것은 호스트 에이전트뿐입니다.
실제 예시 (어떤 에이전트든)
상호작용은 클라이언트와 무관하게 동일합니다. 다음과 같이 요청합니다.
Read ./Q3-report.md and build a 12-slide executive summary. Find a clean business theme from 2slides, generate the PowerPoint, then return the download link.
에이전트는
themes_searchslides_generatedownloadUrlslides_create_pdf_slidesjobs_getslides_generate_narrationjobs_getslides_download_pages_voices자주 묻는 질문
2Slides MCP 서버란 무엇인가요?
2Slides의 슬라이드 생성, 테마, 내레이션, 내보내기 API를 도구로 노출하는 Model Context Protocol 커넥터입니다. 여기에 연결하는 MCP 지원 에이전트라면 어떤 것이든 실제 편집 가능한 PowerPoint 파일(및 AI 내레이션이 들어간 이미지 디자인 덱)을 생성할 수 있습니다.
stdio와 Streamable HTTP 중 어떤 전송 방식을 써야 하나요?
Node.js(
npx 2slides-mcphttps://2slides.com/api/mcp?apikey=KEY어떤 AI 에이전트가 동작하나요?
MCP 클라이언트라면 무엇이든 가능합니다. 이 가이드는 Claude Code, OpenAI Codex, OpenClaw, Gemini CLI, Qwen Code, Claude Desktop을 직접 다루며, 추가로 Claude Code나 자체 에이전트 런타임을 통한 Kimi와 MiniMax도 다룹니다. Cursor, Windsurf 등 다른 MCP 클라이언트도 동일한 범용 설정을 사용합니다.
에이전트마다 다른 API 키가 필요한가요?
아니요. 2Slides API 키 하나가 모든 클라이언트와 두 전송 방식 전반에서 동작합니다. 2slides.com/api?tab=mcp에서 한 번만 만드세요.
실제 PowerPoint 파일이 생성되나요?
예.
slides_generate.pptxMCP 서버는 무료인가요?
커넥터는 무료로 설치할 수 있고,
themes_searchjobs_get핵심 정리
2Slides MCP 서버를 한 번만 설정하면(로컬은 stdio, 원격은 Streamable HTTP), 사용하는 모든 MCP 에이전트가 완성된 PowerPoint까지 가는 한 문장짜리 길을 얻습니다. 에이전트가 사고하고, 2Slides가 파일을 만듭니다.
2026년의 변화는 "덱 하나 만들어 줘"가 더 이상 채팅 묘기가 아니라는 점입니다. 이제 그것은 에이전트가 사용자를 대신해 호출하는 도구이며, 실제 파일을 돌려줍니다. 아래에서 클라이언트를 고르면, 그 설정 가이드를 다 읽기도 전에 첫 덱이 나올 것입니다.
더 많은 맥락은 PowerPoint MCP 서버 생태계 지도와 AI 프레젠테이션 에이전트 만드는 법을 참고하세요.
2slides.com/api?tab=mcp에서 API 키, 복사-붙여넣기용 설정, Streamable HTTP 엔드포인트를 받으세요 — 서버 하나로, 모든 에이전트를.
출처:
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free