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는 프롬프트 — 또는 작업 디렉터리의 파일 — 를 완성된 편집 가능한

로 바꿀 수 있습니다.

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

블록, 단축 명령, 그리고 각 2Slides 도구의 역할을 제공합니다.

Gemini CLI를 2Slides에 연결하는 이유는?

Gemini는 강력한 멀티모달 추론기이지만, 혼자서는 바이너리

파일을 만들어 내지 못합니다. 2Slides MCP 서버가 바로 그 전용 생성기입니다.

• Gemini CLI는 소스를 읽고, 슬라이드를 계획하고, 카피를 작성합니다.
• 2Slides MCP 서버는 실제 PowerPoint를 렌더링합니다. 테마 기반 Fast PPT이거나, 선택적 AI 내레이션과 내보내기 가능한 번들을 갖춘 이미지 디자인 슬라이드입니다.

먼저 필요한 것

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

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

둘 다 동일한 도구를 노출합니다. 차이는 설정 키와 커넥터가 실행되는 위치입니다.

키 이름이 중요합니다: Gemini CLI는 Streamable HTTP에 **

httpUrl

**을, 레거시 SSE에 **

url

**을 사용합니다. 2Slides Streamable HTTP 엔드포인트에는

httpUrl

을 쓰세요.

방법 1: settings.json의 stdio

Gemini CLI는

(전역)과 (프로젝트)을 읽습니다. 블록을 추가하세요.

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

키를 인라인으로 넣고 싶지 않다면

값에서 셸 변수를 참조할 수도 있습니다(예: ).

방법 2: settings.json의 Streamable HTTP

호스팅된 엔드포인트에는

을 사용하세요.

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

헤더 인증을 선호하시나요?

객체를 추가하세요: .

또는

gemini mcp add

명령 사용

# stdio (-e sets env vars)
gemini mcp add -e API_KEY=YOUR_2SLIDES_API_KEY 2slides npx 2slides-mcp

# Streamable HTTP
gemini mcp add --transport http 2slides-remote "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"

이들은 동일한

항목을 에 기록합니다. 플래그로는 (stdio | sse | http), , , 이 있습니다.

연결 확인

대화형

세션 안에서 실행하세요.

/mcp

각 서버의 상태(CONNECTED / CONNECTING / DISCONNECTED)와 발견된 도구를 보여 줍니다. 원격 서버가 OAuth를 요구하면

를 사용하세요.

첫 덱 생성하기

그냥 요청하세요.

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는

→ (Fast PPT)를 실행하고 을 반환합니다. 이미지로 디자인된 맞춤 슬라이드의 경우 를 사용하고 덱이 준비될 때까지 을 폴링합니다.

2Slides MCP 도구 목록

흔한 실수와 문제 해결

• 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 클라이언트입니다.

의 아래에서 서버를 설정하거나 로 추가하세요. stdio, SSE, Streamable HTTP 전송 방식을 모두 지원합니다.

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

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

Gemini CLI는 MCP 설정을 어디에 저장하나요?

(전역) 또는 (프로젝트)입니다. MCP 블록은 최상위 키입니다.

실제 PowerPoint가 생성되나요?

예.

는 편집 가능한 를 반환합니다. 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분 안에 첫 덱을 생성해 보세요.

출처:

• Gemini CLI — MCP servers (official docs)
• 2Slides API & MCP server