2Slides Logo
어떤 AI 에이전트로든 2Slides MCP 서버 사용하기: 완전한 2026 가이드
2Slides Team
7 min read

어떤 AI 에이전트로든 2Slides MCP 서버 사용하기: 완전한 2026 가이드

빠른 답변 (60단어 이내): 2Slides MCP 서버를 사용하면 MCP 지원 AI 에이전트 어떤 것이든 실제 PowerPoint 파일을 생성할 수 있습니다. 실행 방식은 두 가지입니다. stdio(

API_KEY
환경 변수와 함께
npx 2slides-mcp
)와 Streamable HTTP(
https://2slides.com/api/mcp?apikey=KEY
)입니다. 2slides.com/api에서 키를 발급받고, 사용하는 에이전트 — Claude Code, Codex, OpenClaw, Gemini CLI, Qwen Code 등 — 에 서버를 추가한 뒤 덱을 요청하세요.

요즘 AI 에이전트라면 어느 것이든 슬라이드 개요를 작성할 수 있습니다. 하지만 그중 어느 것도 혼자서는 테마, 차트, 내레이션, 발표자 노트가 들어간 실제 편집 가능한

.pptx
를 건네주지 못합니다. 이는 파일 생성의 일이며, 2Slides MCP 서버는 어떤 Model Context Protocol 클라이언트에도 그 능력을 부여하는 범용 커넥터입니다.

서버 설정을 한 번만 작성하면, 어떤 에이전트를 쓰든 동일한 도구가 켜집니다. 이 가이드는 두 가지 전송 방식을 설명하고, 지원되는 클라이언트를 보여 주며, 각각에 대한 단계별 설정으로 연결해 줍니다.

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_KEY
로 가리키세요. (정확한 키 이름은 다릅니다. Gemini CLI와 Qwen Code는
httpUrl
을, OpenClaw는
url
+
transport: "streamable-http"
를, Claude Code와 Codex는
--transport http
플래그나
url
필드를 씁니다.)

2slides.com/api?tab=mcp에서 키, 바로 붙여넣을 수 있는 설정, 그리고 엔드포인트를 받으세요.

지원 에이전트 한눈에 보기

에이전트 / 클라이언트설정 위치StdioStreamable HTTP설정 가이드
Claude Code
.mcp.json
/
claude mcp add
✅ (
--transport http
)
가이드 →
OpenAI Codex
~/.codex/config.toml
✅ (
url
)
가이드 →
OpenClaw
~/.openclaw/openclaw.json
(
mcp.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" 참고
MiniMaxMini-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 서버에 도달합니다.

  1. 이들의 모델로 코딩 에이전트를 구동하기. 둘 다 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
  2. 이들 자체의 에이전트 런타임을 사용하기. Moonshot은 Kimi CLI(표준

    mcpServers
    /
    ~/.kimi/mcp.json
    설정을 갖춘 네이티브 MCP 클라이언트)를 제공하고, MiniMax는 표준
    mcp.json
    을 읽는 오픈소스 Mini-Agent를 배포합니다. 둘 다 위의 범용 stdio 또는 Streamable HTTP 블록과 똑같이 2Slides를 추가하면 됩니다.

어느 쪽이든 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_search
slides_generate
(Fast PPT)를 실행하고
downloadUrl
을 반환합니다. AI 보이스오버가 들어간 이미지 디자인 맞춤 슬라이드를 원하시나요? 그렇게 요청하면 에이전트가
slides_create_pdf_slides
jobs_get
slides_generate_narration
jobs_get
slides_download_pages_voices
를 연결합니다.

자주 묻는 질문

2Slides MCP 서버란 무엇인가요?

2Slides의 슬라이드 생성, 테마, 내레이션, 내보내기 API를 도구로 노출하는 Model Context Protocol 커넥터입니다. 여기에 연결하는 MCP 지원 에이전트라면 어떤 것이든 실제 편집 가능한 PowerPoint 파일(및 AI 내레이션이 들어간 이미지 디자인 덱)을 생성할 수 있습니다.

stdio와 Streamable HTTP 중 어떤 전송 방식을 써야 하나요?

Node.js(

npx 2slides-mcp
)를 실행할 수 있는 머신에서는 stdio를 쓰세요. 로컬 작업의 기본값입니다. 에이전트가 CI, 컨테이너, 아무것도 설치되지 않은 원격 머신에서 실행될 때는 Streamable HTTP(
https://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
는 실제 도형과 테마가 들어간 편집 가능한
.pptx
를 반환합니다. Nano Banana 도구는 이미지로 디자인된 덱을 반환하며 AI 음성 내레이션과 영상용 내보내기 가능한 에셋 번들을 추가할 수 있습니다.

MCP 서버는 무료인가요?

커넥터는 무료로 설치할 수 있고,

themes_search
/
jobs_get
/ 내보내기 호출은 무료입니다. 슬라이드 생성은 2Slides 크레딧을 소모합니다. Fast PPT는 페이지당 10크레딧, 이미지 디자인 및 내레이션 덱은 더 많이 듭니다.

핵심 정리

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