2slides

2slides MCP 서버

2slides.com 도구를 MCP 클라이언트에 노출합니다: PowerPoint 덱과 맞춤 디자인 슬라이드를 생성하고, AI 음성 내레이션을 추가하며, 완성된 파일을 다운로드 링크로 받아볼 수 있습니다.

API 키 받기

연결하기 전에 2slides.com/api에서 API 키를 받으세요.

연결

2slides는 호스팅된 Streamable HTTP MCP 엔드포인트를 운영하며, 이 stdio 패키지도 제공합니다. 둘 다 동일한 계정과 동일한 크레딧으로 동일한 7가지 도구를 노출합니다.

	Streamable HTTP	stdio (이 패키지)
설정	명령 하나, 설치할 것 없음	Node.js 18+ 필요, npx가 패키지를 가져옴
업데이트	서버 측, 항상 최신	사용자 머신에서 다시 다운로드
실행 환경	원격 지원 MCP 클라이언트	로컬 프로세스를 실행할 수 있는 모든 클라이언트

옵션 1 — Streamable HTTP (권장)

Anthropic의 MCP 문서는 HTTP를 "원격 MCP 서버 연결에 권장되는 옵션"이라고 부르며, 2slides는 로컬 파일이나 프로세스가 없는 호스팅 서비스이므로 여기서 시작하세요.

Claude Code

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

claude mcp list로 확인하세요 — 서버가 ✔ Connected를 보고해야 합니다.

프로젝트 구성 (.mcp.json, 팀과 공유)

{
  "mcpServers": {
    "2slides": {
      "type": "http",
      "url": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"
    }
  }
}

Claude Desktop / claude.ai: claude.ai/customize/connectors에서 동일한 URL로 사용자 지정 커넥터로 추가하세요.

옵션 2 — stdio (로컬 프로세스)

클라이언트가 로컬 프로세스만 실행할 수 있거나, 머신이 2slides.com에 직접 연결할 수 없거나, 서버를 직접 고정하고 패치하려는 경우에 사용하세요.

Claude Code

claude mcp add 2slides -e API_KEY=YOUR_2SLIDES_API_KEY -- npx -y 2slides-mcp@latest

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json 편집 (Windows에서는 %APPDATA%\Claude\claude_desktop_config.json):

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

-y 플래그는 npx가 프롬프트 없이 패키지를 설치할 수 있게 합니다. 이후 Claude Desktop을 완전히 재시작하세요. 채팅에서 도구 패널을 열면 아래 도구들이 보일 것입니다.

사용 가능한 도구

---

slides_generate (POST /api/v1/slides/generate)

사전 제작된 테마(Fast PPT)를 사용하여 PowerPoint 프레젠테이션을 생성합니다. themes_search를 먼저 사용하여 themeId를 찾으세요.

• 인자:
  • userInput (문자열, 필수) — 프레젠테이션 내용
  • themeId (문자열, 필수) — themes_search의 테마 ID
  • responseLanguage (문자열, 선택, 기본값: Auto) — 출력 언어; 지원 값: Auto, English, Spanish, Arabic, Portuguese, Indonesian, Japanese, Russian, Hindi, French, German, Greek, Vietnamese, Turkish, Thai, Polish, Italian, Korean, Simplified Chinese, Traditional Chinese
  • mode (선택, 기본값: sync) — sync는 downloadUrl를 즉시 반환; async는 jobs_get로 폴링할 jobId를 반환
• 크레딧: 페이지당 1
• 예시:

  {
    "themeId": "st-1756528793701-fcg5fblt2",
    "userInput": "Generate a 5-slide intro to machine learning",
    "responseLanguage": "English",
    "mode": "sync"
  }
  

---

themes_search (GET /api/v1/themes/search)

slides_generate와 함께 사용할 사전 제작된 테마를 검색합니다.

• 인자:
  • query (문자열, 필수) — 검색 키워드 (예: business, minimal, dark)
  • limit (숫자, 선택, 기본값: 10, 범위: 1–100)
• 반환: id, name, description, previewUrl, tags가 포함된 테마 배열
• 크레딧: 무료
• 예시:

  { "query": "business", "limit": 5 }
  

---

jobs_get (GET /api/v1/jobs/{jobId})

작업 상태를 폴링하고 준비되면 결과를 가져옵니다.

• 인자:
  • jobId (문자열, 필수)
• 반환: jobId, status (pending / processing / success / failed), message, downloadUrl (성공 시), slidePageCount, createdAt, updatedAt, duration (ms), jobUrl (Nano Banana 작업 전용)
• 크레딧: 무료
• 참고: status가 success 또는 failed가 될 때까지 20초마다 폴링하세요.
• 예시:

  { "jobId": "D8h9VYDGdTlZ6wWSEoctF" }
  

---

slides_create_like_this (POST /api/v1/slides/create-like-this)

참조 이미지의 스타일과 일치하는 슬라이드(Nano Banana)를 생성합니다.

• 인자:
  • userInput (문자열, 필수) — 프레젠테이션 내용
  • referenceImageUrl (문자열, 필수) — 스타일 참조 이미지의 URL
  • responseLanguage (문자열, 선택, 기본값: Auto)
  • aspectRatio (문자열, 선택, 기본값: 16:9) — 유효한 값: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
  • resolution (문자열, 선택, 기본값: 2K) — 1K, 2K, 4K
  • page (숫자, 선택, 기본값: 0) — 0 = 자동 감지, 1–100 = 정확한 페이지 수
  • contentDetail (문자열, 선택, 기본값: standard) — concise 또는 standard
  • mode (문자열, 선택, 기본값: async) — async는 jobId를 반환; sync는 downloadUrl를 즉시 반환
• 크레딧: 페이지당 100 (1K/2K) 또는 페이지당 200 (4K)
• 예시:

  {
    "userInput": "Create a presentation about AI trends",
    "referenceImageUrl": "https://example.com/style-reference.jpg",
    "aspectRatio": "16:9",
    "resolution": "2K",
    "page": 5,
    "contentDetail": "standard",
    "mode": "async"
  }
  

---

slides_create_pdf_slides (POST /api/v1/slides/create-pdf-slides)

참조 이미지 없이 텍스트 내용에서 맞춤 디자인 슬라이드(Nano Banana)를 생성합니다.

• 인자:
  • userInput (문자열, 필수) — 프레젠테이션 내용
  • designStyle (문자열, 선택) — 시각적 스타일에 대한 자유 텍스트 설명; 기본 스타일을 위해 비워 두세요
  • responseLanguage (문자열, 선택, 기본값: Auto)
  • aspectRatio (문자열, 선택, 기본값: 16:9) — 유효한 값: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
  • resolution (문자열, 선택, 기본값: 2K) — 1K, 2K, 4K
  • page (숫자, 선택, 기본값: 0) — 0 = 자동 감지, 1–100 = 정확한 페이지 수
  • contentDetail (문자열, 선택, 기본값: standard) — concise 또는 standard
  • mode (문자열, 선택, 기본값: async) — async는 jobId를 반환; sync는 downloadUrl를 즉시 반환
• 크레딧: 페이지당 100 (1K/2K) 또는 페이지당 200 (4K)
• 예시:

  {
    "userInput": "Quarterly business review for Q3 2025",
    "designStyle": "modern, dark background, bold typography",
    "aspectRatio": "16:9",
    "resolution": "2K",
    "page": 8,
    "mode": "async"
  }
  

---

slides_generate_narration (POST /api/v1/slides/generate-narration)

완료된 Nano Banana 작업에 AI 음성 내레이션을 추가합니다 (slides_create_like_this 또는 slides_create_pdf_slides만 지원; Fast PPT는 지원되지 않음). 항상 비동기 — jobs_get로 결과를 폴링하세요.

• 인자 (단일 화자, mode: "single" 기본값):

  • jobId (문자열, 필수) — 완료된 Nano Banana 작업의 UUID
  • mode (문자열, 선택, 기본값: single) — single 또는 multi
  • speakerName (문자열, 선택) — 내레이터 이름
  • voice (문자열, 선택) — 30개 음성 중 하나 (아래 목록 참조)
  • contentMode (문자열, 선택, 기본값: standard) — concise 또는 standard
  • includeIntro (불리언, 선택, 기본값: true)

• 인자 (두 화자, mode: "multi"):

  • jobId (문자열, 필수)
  • mode (문자열, 필수) — multi
  • speaker1Name (문자열, 필수)
  • speaker2Name (문자열, 필수)
  • speaker1Voice (문자열, 선택) — 화자 1의 음성
  • speaker2Voice (문자열, 선택) — 화자 2의 음성
  • contentMode (문자열, 선택, 기본값: standard) — concise 또는 standard

• 지원 음성 (30개): Puck, Aoede, Charon, Kore, Fenrir, Zephyr, Leda, Orus, Callirrhoe, Autonoe, Enceladus, Iapetus, Umbriel, Algieba, Despina, Erinome, Algenib, Rasalgethi, Laomedeia, Achernar, Alnilam, Schedar, Gacrux, Pulcherrima, Achird, Zubenelgenubi, Vindemiatrix, Sadachbia, Sadaltager, Sulafat

• 크레딧: 페이지당 210 (텍스트 10 + 오디오 200)

• 예시:

  {
    "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "mode": "multi",
    "speaker1Name": "Alice",
    "speaker2Name": "Bob",
    "speaker1Voice": "Aoede",
    "speaker2Voice": "Puck",
    "contentMode": "standard"
  }
  

---

slides_download_slides_pages_voices (POST /api/v1/slides/download-slides-pages-voices)

슬라이드 페이지와 오디오 내레이션을 ZIP 파일로 내보냅니다. 작업이 완료되고 내레이션이 생성되어 있어야 합니다.

• 인자:
  • jobId (문자열, 필수) — 내레이션이 완료된 작업의 UUID
• 반환: downloadUrl (1시간 후 만료), fileName, expiresIn (3600초)
• ZIP 내용:

  pages/
    page_01.png, page_02.png, …
  voices/
    page_01.wav, page_02.wav, …
  transcript.txt
  

• 크레딧: 무료
• 예시:

  { "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" }
  

---

일반적인 워크플로우

Fast PPT (테마 기반 PowerPoint):

1. themes_search → themeId 가져오기
2. slides_generate (동기) → downloadUrl 직접 가져오기

Nano Banana (맞춤 디자인 슬라이드):

1. slides_create_like_this 또는 slides_create_pdf_slides (비동기) → jobId 가져오기
2. jobs_get (20초마다 폴링) → status: "success"일 때 downloadUrl 가져오기

내레이션이 있는 Nano Banana:

1. slides_create_like_this 또는 slides_create_pdf_slides → jobId 가져오기
2. jobs_get → 슬라이드 완료 대기
3. slides_generate_narration → 내레이션 jobId 가져오기
4. jobs_get → 내레이션 완료 대기
5. slides_download_slides_pages_voices → ZIP 다운로드 링크 가져오기

---

문제 해결 (Claude Desktop)

• 도구가 Claude에 표시되지 않으면 구성 경로가 절대 경로인지 확인하고 앱을 다시 시작하세요.
• Claude MCP 로그 확인:

tail -n 50 -f ~/Library/Logs/Claude/mcp*.log

• stdio MCP 서버의 경우 stdout에 로그를 남기지 마세요. 이 서버는 오류만 stderr에 기록합니다.

참고 자료

• MCP 서버 구축 (공식 문서): https://modelcontextprotocol.io/docs/develop/build-server
• 2slides API 문서: https://2slides.com/api
• 2slides: https://2slides.com
• 2slides 템플릿: https://2slides.com/templates