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 줄바꿈으로 렌더링됩니다.
먼저 필요한 것
- Qwen Code 설치 (
qwen이 PATH에 있어야 함). - 2Slides API 키, 2slides.com/api에서 발급.
- Node.js, stdio 전송 방식용(
npx -y 2slides-mcp@latest). 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": ["-y", "2slides-mcp@latest"],
"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 -y 2slides-mcp@latest
# 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_slides_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
