2slides

공식

세계 최초이자 가장 쉽고 저렴한 PPT, 슬라이드, 프레젠테이션 AI 생성 MCP 서버입니다.

GitHub
30

2slides MCP(으)로 무엇을 할 수 있나요?

  • 검색 프레젠테이션 테마 — themes_search를 사용하여 키워드(예: "비즈니스", "미니멀")로 테마를 찾고 슬라이드 생성을 위한 themeId를 가져옵니다.
  • 테마가 적용된 PowerPoint 슬라이드 생성 — slides_generate에 콘텐츠와 themeId를 제공하면 다운로드 가능한 .pptx 파일이 생성됩니다.
  • 참조 이미지와 일치하는 슬라이드 만들기 — slides_create_like_this에 참조 이미지 URL과 콘텐츠를 제공하면 이미지의 시각적 스타일을 반영한 슬라이드가 생성됩니다.
  • 텍스트로 맞춤 디자인 슬라이드 만들기 — slides_create_pdf_slides에 자유 형식의 designStyle을 사용하여 참조 이미지 없이 슬라이드를 생성합니다.
  • 슬라이드에 AI 음성 내레이션 추가 — slides_generate_narration을 사용하여 완료된 Nano Banana 슬라이드 작업에 단일 또는 이중 화자 내레이션을 첨부합니다.
  • 슬라이드 및 오디오를 ZIP으로 내보내기 — slides_download_pages_voices를 사용하여 개별 슬라이드 이미지, 페이지별 오디오 파일 및 내레이션 작업의 대본을 다운로드합니다.

문서

2slides MCP 서버

2slides

MCP 클라이언트(예: Claude Desktop)에 2slides.com 도구를 노출합니다.

API 키 받기

이 MCP 서버를 사용하기 전에 2slides.com/api에서 API 키를 발급받아야 합니다.

Claude Desktop에서 구성하기

~/Library/Application Support/Claude/claude_desktop_config.json을(를) 편집하고 다음을 추가하세요:

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

그런 다음 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은(는) jobId을(를) 반환하여 jobs_get로 폴링합니다
  • 크레딧: 페이지당 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 작업(slides_create_like_this 또는 slides_create_pdf_slides만 해당; Fast PPT는 지원되지 않음)에 AI 음성 내레이션을 추가합니다. 항상 비동기식 — 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_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_pages_voices → ZIP 다운로드 링크 가져오기

문제 해결 (Claude Desktop)

  • 도구가 Claude에 나타나지 않으면 구성 경로가 절대 경로인지 확인하고 앱을 다시 시작하세요.
  • Claude MCP 로그 확인:
tail -n 50 -f ~/Library/Logs/Claude/mcp*.log
  • stdio MCP 서버의 경우 stdout에 로깅하지 마세요. 이 서버는 오류만 stderr에 기록합니다.

참고 자료