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

빠른 답변 (60단어 이내): Claude Code는 2Slides MCP 서버에 연결해 실제 PowerPoint 파일을 생성할 수 있습니다. 2slides.com/api에서 API 키를 발급받은 뒤, 로컬 stdio는

claude mcp add --env API_KEY=xxx --transport stdio 2slides -- npx 2slides-mcp

를, 원격 Streamable HTTP는

claude mcp add --transport http 2slides https://2slides.com/api/mcp?apikey=KEY

를 실행하세요. 그다음 Claude Code에게 덱을 만들어 달라고 요청하기만 하면 됩니다.

Claude Code는 Anthropic의 터미널 기반 코딩 에이전트이며, Model Context Protocol(MCP)을 기본으로 지원합니다. 즉, 셸을 벗어나지 않고도 텍스트를 완성된

파일로 바꿔 주는 도구를 Claude Code에 부여할 수 있다는 뜻입니다. 2Slides MCP 서버가 바로 그 도구로, 2Slides의 슬라이드 생성, 테마, 내레이션, 내보내기 API를 Claude Code가 직접 호출할 수 있는 MCP 도구로 노출하는 얇은 커넥터입니다.

이 가이드에서는 연결하는 두 가지 방법(로컬 stdio와 원격 Streamable HTTP)과 어느 쪽을 선택해야 하는지, 각 도구가 무엇을 하는지, 그리고 한 줄짜리 요청을 다운로드 가능한 PowerPoint로 바꿔 주는 정확한 프롬프트를 살펴봅니다.

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

Claude Code는 저장소를 분석하고, 콘텐츠를 작성하고, 논리를 구성하는 데 탁월합니다. 다만 혼자서는 도형, 차트, 테마, 발표자 노트가 들어간 실제 편집 가능한

를 만들어 낼 수 없습니다. 이는 파일 생성의 문제이며, 전용 도구가 담당해야 할 영역입니다.

역할 분담은 명확합니다.

• Claude Code는 소스 자료(README, 사양서, CSV, 리서치 노트)를 읽고, 분석한 뒤, 각 슬라이드에 무엇을 담을지 결정합니다.
• 2Slides MCP 서버는 그 계획을 받아 실제 PowerPoint 파일을 렌더링합니다. 또는 AI 음성 내레이션과 MP4 내보내기를 갖춘 이미지 기반 슬라이드를 생성합니다.

처음부터 끝까지 터미널 안에 머무릅니다. 요청하고, 약 30~60초 기다리면, 다운로드 URL이 나옵니다.

먼저 필요한 것

1. Claude Code 설치 및 인증 (
   claude
   가 PATH에 있어야 함).
2. 2Slides API 키. 2slides.com/api에서 발급하세요. 같은 페이지에 복사-붙여넣기용 MCP 설정과 Streamable HTTP 엔드포인트가 있습니다.
3. Node.js (
   npx 2slides-mcp
   를 로컬에서 실행하는 stdio 전송 방식에 필요). HTTP 전송 방식은 로컬에 아무것도 필요하지 않습니다.

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

2Slides MCP 서버는 두 가지 전송 방식을 지원합니다. 둘 다 동일한 도구 세트를 노출하며, 커넥터가 실행되는 위치만 다릅니다.

경험칙: 일상적인 작업은 본인 컴퓨터에서 stdio를 쓰고, Claude Code가 Node를 설치할 수 없는 곳(원격 머신, CI 작업, 잠긴 컨테이너)에서 실행될 때는 Streamable HTTP를 쓰세요.

방법 1: stdio로 연결하기 (로컬)

다음을 한 번 실행하세요.

구분자는 Claude Code 자체 플래그와 그것이 실행하는 명령을 분리합니다.

claude mcp add --env API_KEY=YOUR_2SLIDES_API_KEY --transport stdio 2slides -- npx 2slides-mcp

알아두면 좋은 몇 가지:

• --transport stdio
  (또는 다른 플래그)를
  --env
  와 서버 이름 사이에 두세요.
  --env
  는 여러 개의
  KEY=value
  쌍을 받기 때문에, 이름을 바로 뒤에 두면 CLI가 그 이름을 또 다른 환경 변수로 읽을 수 있습니다.
• --
  뒤의 모든 것은 서버에 그대로 전달됩니다(
  npx 2slides-mcp
  ).
• 모든 프로젝트에서 2Slides를 사용하려면
  --scope user
  를, 팀이 공유하는
  .mcp.json
  에 커밋하려면
  --scope project
  를 추가하세요.

결과로 생성되는

(프로젝트 스코프)은 다음과 같습니다. 직접 손으로 편집할 수도 있습니다.

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

방법 2: Streamable HTTP로 연결하기 (원격)

로컬 설치 없이 Claude Code를 호스팅된 엔드포인트로 가리키기만 하면 됩니다.

claude mcp add --transport http 2slides https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY

키를 URL에 두고 싶지 않다면 헤더로 보내세요.

claude mcp add --transport http 2slides https://2slides.com/api/mcp \
  --header "Authorization: Bearer YOUR_2SLIDES_API_KEY"

연결 확인

claude mcp list          # 2slides가 나타나고 연결되어야 합니다
claude mcp get 2slides   # 설정과 발견된 도구를 표시합니다

또는 대화형 세션 안에서

슬래시 명령을 실행하면 연결된 서버, 도구 개수, (원격 서버의 경우) 인증 상태를 확인할 수 있습니다.

첫 덱 생성하기

연결되면 도구를 직접 호출하지 않습니다. 그냥 요청하면 됩니다. Claude Code가 2Slides 도구를 자동으로 연결합니다.

Search the 2slides themes for a clean "business" style, then
generate a 7-slide deck introducing our Q3 roadmap. Pull the
content from ./ROADMAP.md. Return the download link.

내부적으로 Claude Code는

를 실행해 를 찾고, 이어서 (Fast PPT)를 실행한 뒤 을 건넵니다. 테마가 적용된 PowerPoint까지 총 소요 시간은 대략 30~60초입니다.

템플릿 대신 이미지로 디자인된 맞춤 슬라이드를 원하시나요? 그렇게 요청하면 Claude Code가 Nano Banana 경로(

)를 사용하고, 준비될 때까지 을 폴링한 뒤 링크를 반환합니다.

2Slides MCP 도구 목록

연결되면 Claude Code는 다음 도구들을 보게 됩니다.

대표적인 세 가지 체인:

• Fast PPT:
  themes_search
  →
  slides_generate
  (동기) → 다운로드.
• Nano Banana:
  slides_create_pdf_slides
  (비동기) →
  jobs_get
  → 다운로드.
• 내레이션 영상 에셋: 슬라이드 생성 →
  jobs_get
  →
  slides_generate_narration
  →
  jobs_get
  →
  slides_download_pages_voices
  .

흔한 실수와 문제 해결

• claude mcp list
  에 서버가 나타나지 않음. stdio의 경우
  --env
  /이름 순서가 올바른지 확인하세요(
  --env
  와 이름 사이에 플래그를 두세요). HTTP의 경우 URL과 API 키 유효성을 다시 확인하세요.
• API_KEY
  누락. stdio 서버는 환경 변수가 필요하고, HTTP 서버는
  ?apikey=
  또는
  Authorization
  헤더가 필요합니다. 둘을 혼동하지 마세요.
• 도구 없이
  .pptx
  요청. 2Slides가 연결되어 있지 않으면 Claude Code는 개요를 작성할 수는 있어도 실제 PowerPoint를 만들어 낼 수 없습니다. 먼저 서버를 연결하세요.
• 테마를 잊음.
  themes_search
  를 실행하지 않거나 스타일을 지정하지 않으면 Fast PPT가 알아서 하나를 고릅니다. 모양을 제어하려면 직접 지정하세요.
• 너무 빠른 폴링. 비동기 작업(Nano Banana, 내레이션)은 빡빡한 루프가 아니라 약 20초마다
  jobs_get
  으로 폴링해야 합니다.

자주 묻는 질문

Claude Code는 MCP 서버를 기본 지원하나요?

예. Claude Code는 일급 MCP 클라이언트입니다.

(stdio, SSE, HTTP 전송)로 서버를 추가하고, 로 나열하며, 세션 안에서는 로 확인합니다. 2Slides 서버는 이 모두와 함께 동작합니다.

stdio와 Streamable HTTP 중 무엇을 써야 하나요?

본인 로컬 컴퓨터에서는 stdio(

를 대신 실행해 줌)를, Node를 설치할 수 없거나 설치하고 싶지 않은 곳(CI, 컨테이너, 원격 서버)에서는 Streamable HTTP를 쓰세요. 둘 다 동일한 도구를 노출하며 동일한 결과물을 만듭니다.

실제 PowerPoint 파일이 생성되나요?

예. Fast PPT 경로(

)는 실제 도형과 테마가 들어간 편집 가능한 를 반환합니다. Nano Banana 경로는 이미지로 디자인된 덱을 반환하며 AI 음성 내레이션과 내보내기용 에셋을 추가할 수 있습니다. 이는 스크린샷이 아니라 열고, 편집하고, 발표할 수 있는 파일입니다.

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

2slides.com/api?tab=mcp에서 받습니다. 이 페이지에는 키, 바로 붙여넣을 수 있는 stdio 설정, 그리고 Streamable HTTP 엔드포인트 URL이 표시됩니다.

2Slides 서버를 팀과 공유할 수 있나요?

예.

로 추가하면 저장소에 커밋할 공유 이 작성됩니다. 팀원은 처음 사용할 때 승인하라는 안내를 받습니다. 개인용 전체 프로젝트 설정에는 를 쓰세요.

핵심 정리

Claude Code가 사고하고, 2Slides MCP 서버가 파일을 만듭니다. 한 번 연결하면(로컬은 stdio, 원격은 Streamable HTTP) "덱 하나 만들어 줘"가 터미널에서 한 문장이 됩니다.

Claude Code에서 작업하신다면, 이것이 아이디어(또는 저장소의 파일)에서 완성된 편집 가능한 PowerPoint까지 가는 가장 빠른 길입니다. 슬라이드를 에이전트에 연결하는 더 넓은 관점은 MCP가 프레젠테이션 워크플로를 어떻게 바꾸고 있는지와 PowerPoint MCP 서버 생태계 지도를 참고하세요. CLI 대신 데스크톱 앱을 사용하시나요? Claude MCP로 프레젠테이션을 생성하는 방법을 보세요.

2slides.com/api?tab=mcp에서 키와 설정을 받아 터미널에서 1분 안에 첫 덱을 생성해 보세요.

출처:

• Claude Code — Connect to tools via MCP (official docs)
• 2Slides API & MCP server