2Slides Team
5 min read
Gemini CLI와 2Slides MCP 서버 사용법 (2026 가이드)
빠른 답변 (60단어 이내): Google의 Gemini CLI는 2Slides MCP 서버를 통해 실제 PowerPoint 파일을 생성할 수 있습니다. 2slides.com/api에서 키를 발급받은 뒤
~/.gemini/settings.json에mcpServers항목을 추가하세요. stdio는command: "npx",args: ["2slides-mcp"],env.API_KEY를, Streamable HTTP는httpUrl: "https://2slides.com/api/mcp?apikey=KEY"를 씁니다. 또는gemini mcp add를 실행하세요. 그다음 Gemini에게 덱을 만들어 달라고 요청하면 됩니다.
Gemini CLI는 Google의 오픈소스 터미널 AI 에이전트이며, Model Context Protocol(MCP)을 지원합니다. 2Slides MCP 서버에 연결하면 Gemini는 프롬프트 — 또는 작업 디렉터리의 파일 — 를 완성된 편집 가능한 .pptx로 바꿀 수 있습니다.
이 가이드는 두 가지 전송 방식(로컬 stdio와 원격 Streamable HTTP)에 대한 정확한 settings.json 블록, gemini mcp add 단축 명령, 그리고 각 2Slides 도구의 역할을 제공합니다.
Gemini CLI를 2Slides에 연결하는 이유는?
Gemini는 강력한 멀티모달 추론기이지만, 혼자서는 바이너리 .pptx 파일을 만들어 내지 못합니다. 2Slides MCP 서버가 바로 그 전용 생성기입니다.
- Gemini CLI는 소스를 읽고, 슬라이드를 계획하고, 카피를 작성합니다.
- 2Slides MCP 서버는 실제 PowerPoint를 렌더링합니다. 테마 기반 Fast PPT이거나, 선택적 AI 내레이션과 내보내기 가능한 번들을 갖춘 이미지 디자인 슬라이드입니다.
먼저 필요한 것
- Gemini CLI 설치 (
gemini가 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, 경량 구성 |
키 이름이 중요합니다: Gemini CLI는 Streamable HTTP에 **
httpUrl**을, 레거시 SSE에 **url**을 사용합니다. 2Slides Streamable HTTP 엔드포인트에는httpUrl을 쓰세요.
방법 1: settings.json의 stdio
Gemini CLI는 ~/.gemini/settings.json(전역)과 .gemini/settings.json(프로젝트)을 읽습니다. mcpServers 블록을 추가하세요.
{
"mcpServers": {
"2slides": {
"command": "npx",
"args": ["-y", "2slides-mcp@latest"],
"env": { "API_KEY": "YOUR_2SLIDES_API_KEY" }
}
}
}키를 인라인으로 넣고 싶지 않다면 env 값에서 셸 변수를 참조할 수도 있습니다(예: "API_KEY": "$TWOSLIDES_API_KEY").
방법 2: settings.json의 Streamable HTTP
호스팅된 엔드포인트에는 httpUrl을 사용하세요.
{
"mcpServers": {
"2slides-remote": {
"httpUrl": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"
}
}
}헤더 인증을 선호하시나요? headers 객체를 추가하세요: "headers": { "Authorization": "Bearer YOUR_2SLIDES_API_KEY" }.
또는 gemini mcp add 명령 사용
# stdio (-e sets env vars)
gemini mcp add -e API_KEY=YOUR_2SLIDES_API_KEY 2slides npx -y 2slides-mcp@latest
# Streamable HTTP
gemini mcp add --transport http 2slides-remote "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"이들은 동일한 mcpServers 항목을 settings.json에 기록합니다. 플래그로는 -t, --transport(stdio | sse | http), -e, --env, -H, --header, --timeout이 있습니다.
연결 확인
대화형 gemini 세션 안에서 실행하세요.
/mcp각 서버의 상태(CONNECTED / CONNECTING / DISCONNECTED)와 발견된 도구를 보여 줍니다. 원격 서버가 OAuth를 요구하면 /mcp auth를 사용하세요.
첫 덱 생성하기
그냥 요청하세요.
Read ./notes/market-update.md and generate a 9-slide briefing.
Find a professional theme from 2slides, build the PowerPoint,
and give me the download link.Gemini CLI는 themes_search → slides_generate(Fast PPT)를 실행하고 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을 사용함. Gemini CLI는url을 SSE로 취급합니다. 2Slides의 Streamable HTTP에는httpUrl을 쓰세요. /mcp에서 서버가 DISCONNECTED로 표시됨. API 키를 확인하고, stdio의 경우 Node.js가 설치되어 있는지 확인하세요.- 도구가 나열되지 않음.
settings.json을 편집한 뒤 세션을 다시 시작하거나,gemini mcp add를 다시 실행하세요. - 도구 없이는
.pptx없음. Gemini 단독으로는 개요를 작성하고, 2Slides가 파일을 만듭니다. - 빡빡한 폴링. 비동기 Nano Banana / 내레이션 작업은 Gemini가 약 20초마다
jobs_get을 폴링하게 두세요.
자주 묻는 질문
Gemini CLI는 MCP 서버를 지원하나요?
예. Gemini CLI는 MCP 클라이언트입니다. ~/.gemini/settings.json의 mcpServers 아래에서 서버를 설정하거나 gemini mcp add로 추가하세요. stdio, SSE, Streamable HTTP 전송 방식을 모두 지원합니다.
Streamable HTTP 서버의 설정 키는 무엇인가요?
httpUrl입니다. url은 레거시 SSE 서버에만 사용하세요. 2Slides Streamable HTTP 엔드포인트는 httpUrl에 들어갑니다.
Gemini CLI는 MCP 설정을 어디에 저장하나요?
~/.gemini/settings.json(전역) 또는 .gemini/settings.json(프로젝트)입니다. MCP 블록은 최상위 mcpServers 키입니다.
실제 PowerPoint가 생성되나요?
예. slides_generate는 편집 가능한 .pptx를 반환합니다. Nano Banana 도구는 선택적 AI 내레이션을 갖춘 이미지 디자인 덱을 반환합니다.
키와 설정은 어디서 받나요?
2slides.com/api?tab=mcp에서 받습니다. 키, 복사-붙여넣기용 설정, 그리고 Streamable HTTP 엔드포인트 URL이 있습니다.
핵심 정리
mcpServers항목 하나 — 로컬은command, 원격은httpUrl— 가 Gemini CLI를 슬라이드 생성기로 바꿉니다./mcp로 확인한 뒤 덱을 요청하기만 하면 됩니다.
더 넓은 그림은 MCP가 프레젠테이션 워크플로를 어떻게 바꾸고 있는지와 PowerPoint MCP 서버 생태계 지도를 참고하세요. 다른 터미널 에이전트에서 작업하시나요? 같은 서버를 사용하는 Claude Code, OpenAI Codex, Qwen Code를 보세요.
2slides.com/api?tab=mcp에서 키와 설정을 받아 Gemini CLI에서 1분 안에 첫 덱을 생성해 보세요.
출처:
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
