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

빠른 답변 (60단어 이내): 2Slides MCP 서버를 사용하면 MCP 지원 AI 에이전트 어떤 것이든 실제 PowerPoint 파일을 생성할 수 있습니다. 실행 방식은 두 가지입니다. stdio(API_KEY 환경 변수와 함께 npx -y 2slides-mcp@latest)와 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 도구로 노출하는 작은 커넥터입니다. 에이전트가 연결되면 다음을 호출할 수 있습니다.

에이전트는 사고를 담당합니다. 파일을 읽고, 논리를 구성하고, 카피를 작성합니다. 서버는 파일을 담당합니다. 평범한 언어로 요청하면 약 30~60초 만에 다운로드 URL이 돌아옵니다.

두 가지 전송 방식: stdio vs Streamable HTTP

2Slides MCP 서버는 두 프로토콜을 모두 지원합니다. 둘은 동일한 도구를 노출하며, 커넥터가 실행되는 위치만 다릅니다.

범용 stdio 설정(대부분의 클라이언트가 받아들이는 형태):

범용 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에서 키, 바로 붙여넣을 수 있는 설정, 그리고 엔드포인트를 받으세요.

지원 에이전트 한눈에 보기

연결된 각 가이드에는 정확한 설정 블록, (존재하는 경우) 한 줄짜리 ... mcp add 단축 명령, 그리고 연결을 확인하는 방법이 있습니다.

에이전트 고르기

• Claude Code — Anthropic의 CLI. claude mcp add 2slides -e API_KEY=xxx -- npx -y 2slides-mcp@latest, 또는 원격은 --transport http. 개인용과 팀용 스코프를 지원합니다.
• OpenAI Codex — config.toml의 [mcp_servers.2slides] 블록, 또는 codex mcp add 2slides --env API_KEY=xxx -- npx -y 2slides-mcp@latest. 원격은 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 -y 2slides-mcp@latest # 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 도구는 동일합니다. 바뀌는 것은 호스트 에이전트뿐입니다.

실제 예시 (어떤 에이전트든)

상호작용은 클라이언트와 무관하게 동일합니다. 다음과 같이 요청합니다.

에이전트는 themes_search → slides_generate(Fast PPT)를 실행하고 downloadUrl을 반환합니다. AI 보이스오버가 들어간 이미지 디자인 맞춤 슬라이드를 원하시나요? 그렇게 요청하면 에이전트가 slides_create_pdf_slides → jobs_get → slides_generate_narration → jobs_get → slides_download_slides_pages_voices를 연결합니다.

자주 묻는 질문

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

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

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

Node.js(npx -y 2slides-mcp@latest)를 실행할 수 있는 머신에서는 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년의 변화는 "덱 하나 만들어 줘"가 더 이상 채팅 묘기가 아니라는 점입니다. 이제 그것은 에이전트가 사용자를 대신해 호출하는 도구이며, 실제 파일을 돌려줍니다. 아래에서 클라이언트를 고르면, 그 설정 가이드를 다 읽기도 전에 첫 덱이 나올 것입니다.

• Claude Code · OpenAI Codex · OpenClaw · Gemini CLI · Qwen Code

더 많은 맥락은 PowerPoint MCP 서버 생태계 지도와 AI 프레젠테이션 에이전트 만드는 법을 참고하세요.

2slides.com/api?tab=mcp에서 API 키, 복사-붙여넣기용 설정, Streamable HTTP 엔드포인트를 받으세요 — 서버 하나로, 모든 에이전트를.

출처:

• 2Slides API & MCP server
• Model Context Protocol (official site)