2Slides Logo
Qwen Code와 2Slides MCP 서버 사용법 (2026 가이드)
2Slides Team
5 min read

Qwen Code와 2Slides MCP 서버 사용법 (2026 가이드)

빠른 답변 (60단어 이내): Alibaba의 Qwen Code CLI는 2Slides MCP 서버를 통해 실제 PowerPoint 파일을 생성할 수 있습니다. 2slides.com/api에서 키를 발급받은 뒤

~/.qwen/settings.json
mcpServers
항목을 추가하세요. stdio는
command: "npx"
,
args: ["2slides-mcp"]
,
env.API_KEY
를, Streamable HTTP는
httpUrl: "https://2slides.com/api/mcp?apikey=KEY"
를 씁니다. 또는
qwen mcp add
를 실행하세요. 그다음 Qwen에게 덱을 만들어 달라고 요청하면 됩니다.

Qwen Code는 Alibaba의 오픈소스 터미널 코딩 에이전트(Gemini CLI의 포크)로, Qwen 모델 패밀리에 맞춰 튜닝되었습니다. 네이티브 Model Context Protocol(MCP) 클라이언트이므로, 2Slides MCP 서버를 연결하면 Qwen Code는 브리프 — 또는 저장소의 파일 — 를 완성된 편집 가능한

.pptx
로 바꿀 수 있습니다.

이 가이드는 두 가지 전송 방식(로컬 stdio와 원격 Streamable HTTP)에 대한 정확한

~/.qwen/settings.json
블록,
qwen mcp add
단축 명령, 그리고 2Slides 도구 목록을 제공합니다.

Qwen Code를 2Slides에 연결하는 이유는?

Qwen Code는 코드와 콘텐츠를 분석하지만 바이너리 슬라이드 파일을 만들어 내지는 못합니다. 그 일을 하는 생성기가 바로 2Slides MCP 서버입니다.

  • Qwen Code는 소스를 읽고, 덱을 계획하고, 카피를 작성합니다. 영어와 중국어 콘텐츠 모두에 강합니다.
  • 2Slides MCP 서버는 실제 PowerPoint를 렌더링합니다. 테마 기반 Fast PPT이거나, 선택적 AI 내레이션과 내보내기 가능한 번들을 갖춘 이미지 디자인 슬라이드입니다.

2Slides는 간체·번체 중국어를 포함해 20개 출력 언어를 지원하므로, Qwen이 계획한 중국어 덱이 올바른 CJK 줄바꿈으로 렌더링됩니다.

먼저 필요한 것

  1. Qwen Code 설치 (
    qwen
    이 PATH에 있어야 함).
  2. 2Slides API 키, 2slides.com/api에서 발급.
  3. Node.js, stdio 전송 방식용(
    npx 2slides-mcp
    ). HTTP 전송 방식은 로컬에 아무것도 필요하지 않습니다.

stdio vs Streamable HTTP: 어떤 전송 방식을 쓸까?

둘 다 동일한 도구를 노출합니다. 차이는 설정 키입니다.

Stdio (로컬)Streamable HTTP (원격)
설정 키
command
/
args
/
env
httpUrl
로컬 Node.js필요불필요
적합한 경우로컬 개발원격/CI, 경량 구성

키 이름이 중요합니다: Qwen Code는 (Gemini CLI와 마찬가지로) Streamable HTTP에 **

httpUrl
**을, 레거시 SSE에 **
url
**을 사용합니다. 2Slides Streamable HTTP 엔드포인트에는
httpUrl
을 쓰세요.

방법 1: settings.json의 stdio

Qwen Code는

~/.qwen/settings.json
(전역)과
.qwen/settings.json
(프로젝트)을 읽습니다.
mcpServers
블록을 추가하세요.

{ "mcpServers": { "2slides": { "command": "npx", "args": ["2slides-mcp"], "env": { "API_KEY": "YOUR_2SLIDES_API_KEY" } } } }

키를 셸 환경에 두고 싶다면

env
값은
$VAR_NAME
확장을 지원합니다.

방법 2: settings.json의 Streamable HTTP

호스팅된 엔드포인트에는

httpUrl
을 사용하세요.

{ "mcpServers": { "2slides-remote": { "httpUrl": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY" } } }

선택적 헤더 인증:

"headers": { "Authorization": "Bearer YOUR_2SLIDES_API_KEY" }
.

또는
qwen mcp add
명령 사용

# stdio qwen mcp add -e API_KEY=YOUR_2SLIDES_API_KEY 2slides npx 2slides-mcp # Streamable HTTP qwen mcp add --transport http 2slides-remote "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"

관련 명령:

qwen mcp list
,
qwen mcp remove <name>
, 그리고 대화형 관리 화면을 여는 단독
qwen mcp
.

연결 확인

대화형

qwen
세션 안에서:

/mcp

서버별 연결 상태, 설정 세부 정보, 발견된 도구를 표시합니다. OAuth로 보호된 서버에는

/mcp auth
를 사용하세요.

첫 덱 생성하기

영어나 중국어로 그냥 요청하세요.

读取 ./季度总结.md,生成一个 10 页的季度业务回顾。 先从 2slides 搜索一个简洁的商务主题,再生成 PowerPoint, 最后把下载链接给我。

Qwen Code는

themes_search
slides_generate
(Fast PPT)를
responseLanguage: "Simplified Chinese"
로 실행하고
downloadUrl
을 반환합니다. 이미지로 디자인된 맞춤 슬라이드의 경우
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_pages_voices
페이지 + 오디오를 ZIP으로 내보내기무료
jobs_get
비동기 작업이 완료될 때까지 폴링무료

흔한 실수와 문제 해결

  • Streamable HTTP에
    url
    을 사용함.
    Qwen Code는
    url
    을 SSE로 취급합니다. 2Slides Streamable HTTP 엔드포인트에는
    httpUrl
    을 쓰세요.
  • /mcp
    에서 서버 DISCONNECTED.
    API 키를 확인하고, stdio의 경우 Node.js가 있는지 확인하세요.
  • 편집 후 도구가 사라짐. 세션을 다시 시작하거나,
    qwen mcp add
    를 다시 실행하세요.
  • Qwen 단독으로
    .pptx
    를 기대함.
    Qwen은 덱을 계획하고, 2Slides가 파일을 렌더링합니다.
  • 잘못된 출력 언어. CJK 콘텐츠가 올바르게 렌더링되도록 덱 언어를 명시적으로 설정하세요(Qwen이
    slides_generate
    responseLanguage
    를 전달합니다).

자주 묻는 질문

Qwen Code는 MCP 서버를 지원하나요?

예. Qwen Code는 MCP 클라이언트입니다(Gemini CLI에서 포크됨).

~/.qwen/settings.json
mcpServers
아래에서 서버를 설정하거나
qwen mcp add
로 추가하세요. stdio와 Streamable HTTP를 모두 지원합니다.

Streamable HTTP 서버의 설정 키는 무엇인가요?

httpUrl
입니다.
url
은 레거시 SSE에만 사용하세요. 2Slides Streamable HTTP 엔드포인트는
httpUrl
에 들어갑니다.

Qwen Code는 중국어 덱에 적합한가요?

예. Qwen 모델은 중국어 처리가 뛰어나고, 2Slides는 적절한 CJK 렌더링으로 간체·번체 중국어 출력을 지원합니다. 이 조합은 이중 언어 및 중국어 비즈니스 덱에 잘 맞습니다.

실제 PowerPoint가 생성되나요?

예.

slides_generate
는 편집 가능한
.pptx
를 반환합니다. Nano Banana 도구는 선택적 AI 내레이션을 갖춘 이미지 디자인 덱을 반환합니다.

키와 설정은 어디서 받나요?

2slides.com/api?tab=mcp에서 받습니다. 키, 복사-붙여넣기용 설정, 그리고 Streamable HTTP 엔드포인트가 있습니다.

핵심 정리

mcpServers
항목 하나 — 로컬은
command
, 원격은
httpUrl
— 가 Qwen Code를 영어로든 중국어로든 슬라이드 생성기로 바꿉니다.
/mcp
로 확인한 뒤 요청하기만 하면 됩니다.

더 넓은 그림은 MCP가 프레젠테이션 워크플로를 어떻게 바꾸고 있는지PowerPoint MCP 서버 생태계 지도를 참고하세요. 다른 에이전트를 사용하시나요? 같은 서버를 사용하는 Gemini CLI, Claude Code, OpenAI Codex를 보세요.

2slides.com/api?tab=mcp에서 키와 설정을 받아 오늘 첫 Qwen 생성 덱을 만들어 보세요.

출처:

About 2Slides

Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.

Try For Free