QoderWake와 2Slides 연동 가이드: AI 직원을 위한 MCP (2026)

핵심 요약 (60자 이내): qoderwake waker list --json로 Waker ID를 확인한 후 qoderwake mcp add --waker-id ag_xxx --name 2slides --transport http --http-url https://2slides.com/api/mcp --header "Authorization=Bearer YOUR_2SLIDES_API_KEY"를 실행하세요. 해당 Waker는 DingTalk, Feishu 또는 예약된 일정에 따라 2Slides 템플릿을 검색하고 편집 가능한 .pptx 파일을 즉시 생성할 수 있습니다.

Alibaba의 Qoder 팀이 개발한 QoderWake는 "업무 현장의 자율형 AI 직원"을 표방합니다. 각 디지털 직원은 Waker라고 불립니다. Waker는 메신저 메시지, 스케줄, 훅(hook) 이벤트 또는 API 호출에 의해 트리거되어 스스로 업무를 수행합니다. QoderWake는 macOS 13+, Linux, Windows 10+ 환경을 지원하며, 127.0.0.1:19820에서 로컬 웹 콘솔을 제공하고 CLI와 DingTalk, Feishu 연동을 지원합니다.

MCP 서버와 스킬은 Waker별로 할당됩니다. 이 가이드에서는 특정 Waker(예: "보고서 작성 어시스턴트")에게 2Slides 프레젠테이션 엔진 권한을 부여하는 방법을 설명합니다. 본 내용은 2026년 9월 30일 운영 환경에서 테스트를 마친 공식 QoderWake CLI 레퍼런스와 2Slides 엔드포인트를 기준으로 작성되었습니다.

Waker에게 2Slides 권한을 부여해야 하는 이유

Waker는 반복 업무에 최적화되어 있습니다. "이번 주 수치를 슬라이드 데크로 변환"하는 작업은 Waker에게 가장 적합한 업무입니다.
2Slides는 실제 파일을 생성합니다. 템플릿 기반의 편집 가능한 PowerPoint(Fast PPT, 슬라이드당 10 크레딧) 또는 AI 내레이션 옵션이 포함된 이미지 디자인 슬라이드(Nano Banana, 1K/2K 해상도 기준 슬라이드당 100 크레딧)를 제작할 수 있습니다.
Waker별 스코프 설정을 통해 슬라이드 제작이 필요한 Waker에게만 도구와 API 키를 할당할 수 있어 보안에 유리합니다.

사전 준비 사항

QoderWake 설치 및 로그인: macOS 또는 Linux의 경우, CLI 레퍼런스에서 제공하는 한 줄 설치 명령어를 사용하세요.

curl -fsSL https://qoder-ide.oss-ap-southeast-1.aliyuncs.com/qoderwake/install.sh | bash
qoderwake login
qoderwake start      # daemon on 127.0.0.1:19820

Windows 및 macOS 설치 패키지는 QoderWake 웹사이트에서 다운로드할 수 있습니다. 셸에서 qoderwake를 찾을 수 없는 경우 ~/.qoderwake/bin/qoderwake를 사용하십시오.

2Slides API 키: 2slides.com/api에서 발급받으세요.(sk-2slides-...). 신규 계정에는 500 크레딧이 무료로 제공되며, 이는 Fast PPT 50페이지를 생성할 수 있는 분량입니다.
Node.js: stdio 방식을 사용하는 경우에만 기기에 설치되어 있어야 합니다.

1단계: Waker ID 확인

qoderwake waker list --json

Waker ID는 ag_로 시작합니다. 데크를 생성할 Waker의 ID를 복사하세요. 아래 예시에서는 ag_xxx를 사용합니다.

방법 1: HTTP 기반 호스팅 MCP (권장)

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --description "2Slides presentation generator" \
  --transport http \
  --http-url https://2slides.com/api/mcp \
  --header "Authorization=Bearer YOUR_2SLIDES_API_KEY"

따옴표 사용 주의: CLI 구문은 --header KEY=VALUE 형식을 따르며 반복 사용이 가능합니다. 위 예시의 Bearer YOUR_2SLIDES_API_KEY 값에는 공백이 포함되어 있으므로, 전체 KEY=VALUE 쌍을 큰따옴표로 감싸야 합니다. 따옴표가 없으면 셸이 이를 두 개의 인자로 분리하여 헤더가 Bearer로만 전달될 수 있습니다.

=와 공백 파싱 문제를 완전히 피하고 싶다면, 동일한 옵션의 JSON 형태인 --headers <json>를 사용하세요.

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --transport http \
  --http-url https://2slides.com/api/mcp \
  --headers '{"Authorization":"Bearer YOUR_2SLIDES_API_KEY"}'

Windows PowerShell에서는 작은따옴표도 작동하지만, 여러 셸 환경에서 JSON 따옴표 처리는 까다로울 수 있습니다. 이 경우 방법 2의 파일 기반 임포트가 더 안전한 선택입니다.

헤더 미전달 시 해결책: 도구 새로고침 시 헤더가 전달되지 않아 401 오류나 Authentication required가 발생하는 경우, 헤더 설정을 건너뛸 수 있습니다. 2Slides는 API 키를 URL 쿼리 파라미터로도 수용하며, 이 방식에 대한 엔드 투 엔드 테스트를 완료했습니다.

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --transport http \
  --http-url "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"

해당 URL은 비밀번호처럼 취급하십시오. 작업 내역이나 스크린샷에 노출되지 않도록 주의하고, 유출된 경우 2slides.com/api에서 키를 즉시 교체(rotate)하십시오.

2Slides는 OAuth가 아닌 일반 API 키를 사용하므로 모든 --oauth-* 플래그는 해제 상태로 두십시오.

방법 2: MCP JSON 임포트

qoderwake mcp add 명령에 --json <json> 또는 --json-file <path> 옵션을 사용하여 MCP JSON을 직접 임포트할 수 있습니다. 아래 내용을 2slides-mcp.json 파일로 저장하세요.

{
  "mcpServers": {
    "2slides": {
      "type": "streamable-http",
      "url": "https://2slides.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_2SLIDES_API_KEY"
      }
    }
  }
}

qoderwake mcp add --waker-id ag_xxx --json-file 2slides-mcp.json

CLI 레퍼런스에는 임포터가 수용하는 구체적인 JSON 형식이 명시되어 있지 않지만, 위 블록은 범용적인 mcpServers 형식입니다. 임포트가 거부될 경우 문서화가 잘 되어 있는 방법 1의 플래그 방식을 사용하십시오. 파일에는 API 키가 포함되어 있으므로 작업 후 삭제하거나 Git 저장소에 포함되지 않도록 주의하십시오.

방법 3: 로컬 stdio 서버

Waker가 실행 중인 기기에서 오픈 소스 2slides-mcp 패키지를 실행하려면 다음과 같이 실행하세요.

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --transport stdio \
  --command npx \
  --args "-y,2slides-mcp@latest" \
  --env '{"API_KEY":"YOUR_2SLIDES_API_KEY"}'

--args는 CLI 레퍼런스의 공식 파일 시스템 예시와 동일하게 쉼표로 구분된 목록을 받습니다. --env는 JSON 형식을 받습니다. 이 방식은 Waker가 실행되는 머신에 Node.js가 설치되어 있어야 하며, QoderWake는 기본적으로 기기 상주형(device-resident)으로 동작합니다.

연결 확인

qoderwake mcp list --waker-id ag_xxx                      # 2slides should be listed
qoderwake mcp refresh-tools --waker-id ag_xxx --mcp-id <mid>
qoderwake mcp get --waker-id ag_xxx --mcp-id <mid>        # inspect the entry

mcp list 결과에서 <mid>를 확인하세요. 그 다음 Waker에게 읽기 전용 테스트를 요청합니다. QoderWake의 가이드라인에 따라 새로운 커넥터는 읽기 전용 호출로 먼저 검증하는 것이 좋습니다.

List the tools you have from 2slides, then search for a "minimal" theme and show me the themeId.

themes_search 호출은 무료이므로 테스트 비용이 발생하지 않습니다. 커넥터가 오작동하는 경우, 삭제하지 않고 qoderwake mcp toggle --waker-id ag_xxx --mcp-id <mid> --enabled false 명령으로 비활성화할 수 있습니다.

방법 4: 2Slides 스킬 업로드

QoderWake 스킬은 변경 사항을 비교(diff)하고 롤백할 수 있는 Git 버전 관리 기반의 기능 팩입니다. "SKILL.md 파일이 포함된 마크다운 파일 또는 아카이브"를 업로드하여 설치합니다. 공식 2Slides 스킬은 github.com/2slides/slides-generation-2slides-skills에서 확인할 수 있습니다. SKILL.md 파일이 아카이브의 루트에 위치하도록 압축하십시오.

git clone https://github.com/2slides/slides-generation-2slides-skills
cd slides-generation-2slides-skills
zip -r ../2slides-skill.zip SKILL.md scripts references
cd ..
qoderwake skill upload 2slides-skill.zip --waker-id ag_xxx

이 방식은 저장소 내의 오래된 .skill 번들은 제외합니다. 스킬의 Python 스크립트(Python 3 및 requests)는 환경 변수 SLIDES_2SLIDES_API_KEY에서 키를 읽어옵니다.

보안 규칙. QoderWake 문서에 따르면 "작업(task), 메모리, 지식 베이스, 역할 파일 또는 스크린샷에 비밀번호, 토큰, 쿠키를 절대 넣지 마십시오"라고 명시되어 있습니다. 인증 정보는 보호된 필드나 환경 변수에 보관해야 합니다. 따라서 API 키를 작업 프롬프트에 붙여넣거나 Waker에게 이를 "기억"하라고 지시해서는 안 됩니다. QoderWake는 스킬 스크립트에 환경 변수를 전달하는 방법을 별도로 문서화하지 않았으므로, 다음과 같은 분리 운영을 권장합니다.

실제 API 호출에는 **MCP 커넥터(방법 1)**를 사용하십시오. 키는 헤더에 안전하게 보관됩니다.
스킬은 Waker가 실행되는 환경에 SLIDES_2SLIDES_API_KEY 변수가 이미 설정된 경우에만 사용하십시오. scripts/search_themes.py --query minimal --limit 1를 실행하는 테스트 작업을 통해 설정 여부를 확인할 수 있습니다.

첫 번째 슬라이드 데크 생성하기

Read sales_week39.csv in the project, summarize the key movements,
and build an 8-slide weekly sales review with 2slides. Search for a
clean business theme first, then generate the PowerPoint and send
me the download link.

Waker는 themes_search를 호출한 뒤 slides_generate를 실행하고 downloadUrl를 반환해야 합니다. 자체 프로덕션 테스트 결과, 3페이지 분량의 Fast PPT 데크가 반환되는 데 약 22초가 소요되었습니다. 다운로드 링크는 1시간 후에 만료됩니다. QoderWake 문서에 따르면 파일 전달은 "채널 기능에 따라 다르며, 반환된 링크나 작업 아티팩트(artifact)를 사용"해야 합니다. 따라서 Waker가 즉시 링크를 게시하도록 하거나, .pptx 파일을 워크스페이스로 다운로드하도록 설정하십시오. 이후 qoderwake session artifacts --session-id sess_xxx 명령으로 세션에서 파일을 가져올 수 있습니다.

AI 직원을 위한 활용 사례

DingTalk 또는 Feishu 연동. Waker를 DingTalk이나 Feishu 채널에 연결하면, 팀원이 "@보고서 어시스턴트, 4분기 채용 계획에 대해 6슬라이드 분량의 업데이트 자료 만들어줘"라고 메시지를 보낼 수 있습니다. Waker는 컨텍스트를 수집하고 2Slides를 호출한 뒤 다운로드 링크를 회신합니다.

주간 데크 자동 생성. CLI 레퍼런스 문서에 명시된 예약 자동화 기능을 활용할 수 있습니다.

qoderwake automation create schedule --waker-id ag_xxx \
  --name "Weekly Sales Deck" \
  --schedule-type cron --cron "0 9 * * 1" \
  --timezone Asia/Shanghai \
  --prompt "Build this week's 8-slide sales review from the latest CSV with 2slides and post the download link"
qoderwake automation run-now --waker-id ag_xxx --automation-id tr_xxx   # test once

자동 실행을 시작하기 전에 run-now로 한 번 실행해 보고 qoderwake automation detail로 결과를 확인하십시오.

2Slides MCP 도구 목록

도구	기능	크레딧
`themes_search`	1,500개 이상의 테마 중 적합한 `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`	비동기 작업 상태 확인 (20~30초 간격 권장)	무료

확인된 사항 vs 미확인 사항 (2026년 9월 30일 기준)

항목	상태
`waker list`, `mcp add` 플래그 (`--transport`, `--http-url`, `--header`, `--headers`, `--json`, `--command`, `--args`, `--env`), `skill upload`	QoderWake CLI 레퍼런스에서 확인됨
MCP 및 스킬은 Waker별로 설정; 보안 정보는 작업이나 메모리에 포함 금지	QoderWake 문서에서 확인됨
2Slides 엔드포인트, Bearer 인증, 7개 도구 작동 여부	2Slides 자체 테스트 완료
`mcp add --json`가 수용하는 정확한 JSON 형태	문서화되지 않음; `mcpServers` 형식이 최선으로 보임
`--header`가 `=`를 포함한 값을 분리하는 방식	문서화되지 않음; 전체 쌍을 따옴표로 묶거나 `--headers` JSON 사용 권장
스킬 스크립트에 환경 변수를 전달하는 방법	문서화되지 않음

문제 해결

"daemon unreachable" 오류. qoderwake status를 실행하십시오. 데몬이 실행 중이 아니면 qoderwake start를, 포트가 이미 사용 중이면 qoderwake start --port auto를 실행하십시오.
QoderWake 자체 401 오류. qoderwake whoami를 실행하고, 필요한 경우 qoderwake login를 다시 수행하십시오.
2Slides 401 오류. 헤더에 API 키가 누락되었을 가능성이 큽니다. 따옴표를 사용한 --header 형식이나 --headers JSON 형식으로 다시 추가하십시오.
도구가 보이지 않음. qoderwake mcp refresh-tools를 실행하고, mcp toggle ... --enabled true 명령으로 커넥터가 활성화되어 있는지 확인하십시오.
stdio 실패. Waker의 장치에 Node.js가 설치되어 있는지, --args가 쉼표로 구분되어 있는지 확인하십시오.
실행 중 오류 발생. qoderwake log --level error --limit 100 또는 qoderwake trace list --status failed 명령으로 로그를 확인하십시오.
링크 만료. downloadUrl는 1시간 동안만 유효합니다. Waker가 파일을 작업 아티팩트로 저장하도록 설정하십시오.

자주 묻는 질문 (FAQ)

QoderWake는 커스텀 MCP 서버를 지원하나요?

네, 지원합니다. 각 Waker는 qoderwake mcp add --waker-id <id> 명령이나 콘솔의 Custom MCP Connectors 화면을 통해 stdio, HTTP 또는 SSE 방식으로 여러 MCP 서버를 마운트할 수 있습니다.

Waker에 2Slides를 추가하는 정확한 명령은 무엇인가요?

qoderwake mcp add --waker-id ag_xxx --name 2slides --transport http --http-url https://2slides.com/api/mcp --header "Authorization=Bearer YOUR_2SLIDES_API_KEY"입니다. 값에 공백이 포함되어 있으므로 헤더 쌍 전체를 따옴표로 묶어야 합니다.

QoderWake의 어디에 2Slides API 키를 저장해야 하나요?

MCP 커넥터의 헤더(--header 또는 --headers)나 stdio 방식의 경우 --env에 저장하십시오. 작업, 메모리, 지식 베이스 또는 역할 파일에는 절대 넣지 마십시오. QoderWake 문서는 이를 명시적으로 금지하고 있습니다.

Waker가 PowerPoint 파일을 DingTalk이나 Feishu로 보낼 수 있나요?

Waker는 항상 2Slides 다운로드 링크로 응답할 수 있습니다. 파일 자체가 첨부 파일로 전송되는지 여부는 해당 채널의 기능에 따라 다릅니다. QoderWake 문서는 반환된 링크나 작업 아티팩트를 사용할 것을 권장합니다. 링크는 1시간 후에 만료됩니다.

Waker가 매주 자동으로 슬라이드 데크를 만들 수 있나요?

네, 가능합니다. qoderwake automation create schedule 명령과 cron 표현식을 사용하여 예약된 자동화 작업을 생성하십시오. 무인 실행을 시작하기 전에 automation run-now로 먼저 테스트해 보시기 바랍니다.

비용은 얼마인가요?

2Slides 신규 계정에는 500 크레딧이 무료로 제공됩니다. Fast PPT는 페이지당 10 크레딧이 소요되므로, 매주 8슬라이드 분량의 데크를 생성하면 80 크레딧이 사용됩니다. 테마 검색, 작업 상태 확인 및 다운로드는 무료입니다.

핵심 요약

단 한 번의 qoderwake mcp add 명령으로 Waker를 실제 슬라이드 데크를 제작하는 AI 직원으로 변신시킬 수 있습니다. MCP 헤더에 키를 보관하고, DingTalk, Feishu 또는 cron 스케줄을 통해 실행하여 한 시간 이내에 .pptx를 확보하세요.

API 키와 설정 정보는 2slides.com/api?tab=mcp에서 확인하실 수 있습니다.

참고 자료: