WorkBuddy와 2Slides MCP 서버 연동 가이드 (2026년판)

핵심 요약 (60자 이내): WorkBuddy의 플러그인 → MCP 서버 → MCP 설정에서 env.API_KEY에 2Slides 키를 입력하고 npx -y 2slides-mcp@latest를 실행하는 mcpServers 항목을 추가하세요. 연결되면 초록색 체크 표시가 뜹니다. 이제 WeChat 등에서 WorkBuddy에게 슬라이드를 요청하면 .pptx 다운로드 링크를 받을 수 있습니다.

WorkBuddy는 CodeBuddy 팀이 개발한 Tencent의 데스크톱 AI 에이전트 워크스페이스입니다. 파일을 읽고, 컴퓨터에서 작업을 수행하며, WeChat, WeCom(企业微信), Feishu, DingTalk, QQ를 통해 명령을 받고 예약된 자동화를 실행합니다. 하지만 자체적인 프레젠테이션 엔진은 갖추고 있지 않습니다. 여기에 2Slides MCP 서버를 추가하면 WorkBuddy가 기획안, 보고서 또는 채팅 메시지를 편집 가능한 PowerPoint 파일로 변환할 수 있습니다. 결과물은 링크 형태로 즉시 제공됩니다.

이 가이드에서는 세 가지 설정 방법을 다룹니다. WorkBuddy 문서에서 가장 직접적으로 다루는 순서대로 정리했습니다.

로컬 stdio MCP 서버 (권장 방식, WorkBuddy MCP 가이드의 설정 규격과 일치)
원격 Streamable HTTP 엔드포인트 (Node.js 설치 불필요)
2Slides 에이전트 스킬 (MCP 서버 대신 스킬 패키지로 설치)

왜 WorkBuddy와 2Slides를 연동해야 할까요?

WorkBuddy는 계획 수립, 문서 읽기, 도구 간 협업에 능숙합니다. 하지만 디자인이 가미된 슬라이드 데크를 렌더링하는 것은 별개의 작업입니다. 2Slides를 연결하면 다음과 같은 워크플로우가 가능해집니다.

WorkBuddy가 파일, 노트 또는 채팅 요청을 바탕으로 개요와 슬라이드 내용을 작성합니다.
2Slides가 실제 데크를 생성합니다. 1,500개 이상의 템플릿을 활용한 테마 기반의 편집 가능한 .pptx(Fast PPT), 또는 AI 음성 내레이션이 포함된 이미지 디자인 슬라이드를 만듭니다.

WorkBuddy는 메시징 앱과 연동되고 예약된 작업을 실행할 수 있으므로, 데스크톱 앱을 열지 않고도 휴대폰으로 데크 생성을 요청하거나 매주 자동으로 생성된 결과물을 받아볼 수 있습니다.

사전 준비 사항

WorkBuddy 데스크톱 설치 및 로그인 (중국 내: workbuddy.cn, 글로벌: workbuddy.ai).
2slides.com/api에서 발급받은 2Slides API 키. 키는 sk-2slides-... 형식입니다. 신규 계정에는 500 무료 크레딧이 제공되며, 이는 페이지당 10 크레딧인 Fast PPT 기준 50페이지 분량입니다. 크레딧은 종량제 방식이며 만료되지 않습니다.
Node.js (방법 1 사용 시 필요, node -v로 버전 확인 가능). 방법 2는 로컬 설치가 필요 없으며, 방법 3은 requests 라이브러리가 포함된 Python 3가 필요합니다.

확인된 기능 vs 미공개 정보 (2026년 9월 30일 기준)

항목	상태
플러그인 → MCP 서버 → MCP 설정, `~/.workbuddy/mcp.json`(사용자) 및 `<project>/.workbuddy/mcp.json`(프로젝트) 파일을 통한 MCP 설정	WorkBuddy MCP 가이드에 명시됨
`command` / `args` / `env`를 포함한 stdio 항목, 초록색 = 연결됨, 빨간색 = 설정 오류	WorkBuddy MCP 가이드에 명시됨
`"type": "streamableHttp"` + `url`을 포함한 원격 항목	WorkBuddy 오픈 플랫폼 커넥터 문서 및 서드파티 설정 페이지에 표시됨 (일반 사용자 MCP 가이드에는 없음)
WorkBuddy 원격 항목의 헤더(`Authorization: Bearer ...`) 설정	서드파티 벤더 가이드에 표시됨 (WorkBuddy 자체 문서에는 없음)
스킬: 로컬 스킬 패키지 드래그 앤 드롭 또는 채팅창의 查找技能 / 创建技能 사용	WorkBuddy 스킬 가이드에 명시됨
가져온 스킬의 환경 변수 설정	문서화되지 않음 (아래 해결 방법 참고)
2Slides MCP 엔드포인트, URL 기반 인증, stdio 패키지	2026년 9월 30일 2Slides 라이브 테스트 완료

방법 1: 로컬 stdio 서버 (권장)

이 방법은 WorkBuddy MCP 가이드의 공식 예제 규격(command, args, env)과 일치하므로 가장 안정적인 옵션입니다.

1단계. MCP 에디터를 엽니다. 다음 경로 중 하나를 선택하세요.

사이드바 → 插件 (Plugins) → MCP 服务器 (MCP Server) (우측 상단) → 配置 MCP (Configure MCP)
连接器 (Connectors) → 自定义连接器 (Custom Connector) (우측 상단) → 配置 MCP (Configure MCP)

또는 모든 프로젝트에 적용하려면 ~/.workbuddy/mcp.json을, 특정 프로젝트에만 적용하려면 <project>/.workbuddy/mcp.json을 직접 편집하세요.

2단계. 아래 항목을 붙여넣습니다 (이미 서버가 있다면 mcpServers 내에 병합하세요).

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

3단계. 저장 후 상태를 확인합니다. 2slides 옆에 **초록색 ✓**가 표시되면 WorkBuddy가 서버를 시작하고 도구를 로드한 것입니다. **빨간색 ✗**가 뜨면 설정에 문제가 있는 것입니다(문제 해결 섹션 참고).

참고 사항:

환경 변수 이름은 반드시 API_KEY여야 합니다. 2slides-mcp npm 패키지가 이 이름을 인식합니다.
WorkBuddy 오픈 플랫폼 문서에는 stdio 항목에 "type": "stdio"를 추가하라고 되어 있습니다. 추가해도 무방하지만, 일반 사용자 가이드의 예제는 이 없이도 작동합니다.
서버가 사용자의 컴퓨터에서 실행되므로, WeChat이나 예약된 작업으로 들어오는 요청을 처리하려면 컴퓨터가 켜져 있고 WorkBuddy가 실행 중이어야 합니다.

방법 2: 원격 Streamable HTTP 엔드포인트

2Slides는 https://2slides.com/api/mcp에서 MCP 서버를 호스팅합니다. Bearer 헤더 또는 URL 파라미터로 키를 전달받습니다. 별도의 OAuth 과정이 없으므로 사용자가 직접 키를 전달해야 합니다.

WorkBuddy의 일반 사용자 MCP 가이드에는 stdio 예제만 나와 있습니다. 하지만 WorkBuddy 오픈 플랫폼 커넥터 문서에서는 원격 서버에 "type": "streamableHttp"를 사용하며, Wolters Kluwer 등 서드파티 가이드에서도 커넥터 → 커스텀 커넥터 → MCP 설정을 통해 동일한 값을 사용합니다. 아래 형식을 사용하세요.

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

URL에 키를 노출하고 싶지 않다면 헤더를 사용하세요.

{
  "mcpServers": {
    "2slides": {
      "type": "streamableHttp",
      "url": "https://2slides.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_2SLIDES_API_KEY"
      },
      "timeout": 60000
    }
  }
}

상태가 계속 빨간색인 경우: WorkBuddy는 Tencent CodeBuddy와 같은 계열이며, CodeBuddy CLI 문서에서는 원격 서버를 url + headers를 포함한 "type": "http"로 정의합니다. "streamableHttp"를 "http"로 변경해 보세요. 두 방법 모두 작동하지 않는다면 문서화된 규격을 따르는 방법 1로 돌아가세요.

보안 주의: ?apikey=가 포함된 URL은 API 키와 마찬가지로 비밀 정보입니다. 공유 채팅창이나 스크린샷에 노출하지 마시고, 해당 정보가 포함된 프로젝트 단위의 .workbuddy/mcp.json을 커밋하지 마세요. 유출된 경우 2slides.com/api에서 키를 삭제하고 새로 생성하세요.

방법 3: 2Slides 스킬 설치하기

WorkBuddy는 SKILL.md 기반의 스킬을 지원합니다. 공식 2Slides 스킬 (name: 2slides)은 2Slides REST API를 호출하는 Python 스크립트 번들입니다. 이 방법을 사용할 때는 MCP 서버가 필요하지 않습니다.

옵션 A: 패키지 업로드

GitHub에서 2slides/slides-generation-2slides-skills 접속 → Code → Download ZIP을 클릭합니다.
WorkBuddy의 스킬 페이지에서 **上传技能 (스킬 업로드(上传技能))**를 선택하고 ZIP 파일을 드래그하거나 **选择文件 (파일 선택(选择文件))**을 클릭합니다. WorkBuddy가 자동으로 임포트를 완료합니다.

저장소 내부에 있는 오래된 2slides.skill 번들이 아닌, 현재 저장소 전체를 압축한 ZIP 파일로 설치하십시오.

옵션 B: 채팅으로 요청

채팅창에 "查找技能：2Slides presentation generation"(스킬 찾기)이라고 입력하거나, GitHub 저장소 URL을 붙여넣고 WorkBuddy에게 스킬로 설치해 달라고 요청합니다.

키 설정. 스크립트는 API_KEY가 아닌 SLIDES_2SLIDES_API_KEY 환경 변수에서 키를 읽습니다. WorkBuddy에는 스킬별 환경 변수 설정 필드가 따로 없습니다. 실제적인 해결 방법은 셸 프로필(예: macOS의 ~/.zshrc에 export SLIDES_2SLIDES_API_KEY=YOUR_2SLIDES_API_KEY 추가)이나 Windows 사용자 환경 변수에 설정한 후 WorkBuddy를 재시작하는 것입니다. "Use the 2slides skill to search for a minimal theme."라고 입력하여 테스트해 보세요. search_themes.py가 실행되며 크레딧은 차감되지 않습니다.

MCP와 스킬 중 무엇을 선택해야 할까요? MCP는 WorkBuddy에 구조화된 도구와 상태 표시등을 제공합니다. 스킬은 Node.js가 필요 없으며 이미 스킬을 관리 중인 사용자에게 적합합니다. 둘 중 하나만 선택하면 되며, 두 가지 모두 설치할 필요는 없습니다. 더 자세한 비교는 프레젠테이션을 위한 에이전트 스킬 vs MCP 서버를 참조하세요.

작동 확인

새로운 WorkBuddy 작업을 시작하고 다음과 같이 요청하세요:

List the tools you have from the 2slides MCP server, then search
2slides themes for "business" and show me the top 3 theme IDs.

themes_search가 호출되고 테마 ID 목록이 표시되어야 합니다. 테마 검색은 무료이므로 이 확인 과정에서는 크레딧이 들지 않습니다.

첫 번째 데크 생성하기

Read the Q3 report in my Documents folder and turn it into a
10-slide English deck for management. Search 2slides for a clean
corporate theme first, generate it with Fast PPT, and give me the
download link.

WorkBuddy는 themes_search를 호출한 뒤 slides_generate를 실행하고, 생성된 .pptx 파일의 downloadUrl을 반환합니다. 2Slides 자체 테스트 결과, 3페이지 분량의 Fast PPT는 약 22초 만에 완료되었습니다. 10페이지 생성 시 100 크레딧이 소요됩니다.

다운로드 링크는 1시간 후에 만료됩니다. WorkBuddy에게 파일을 즉시 로컬 폴더에 저장하도록 요청하거나("download it to ~/Documents/Decks"), 즉시 파일을 여십시오.

WorkBuddy 활용에 최적화된 두 가지 워크플로우

1. WeChat 또는 WeCom에서 데크 요청하기

WorkBuddy는 WeChat, WeCom(企业微信), Feishu, DingTalk, QQ의 지시를 처리할 수 있습니다. 2Slides가 연동되면 휴대폰에서 다음과 같이 메시지를 보내보세요:

Make a 6-slide Chinese deck introducing our new membership plan,
use a minimal theme, send me the link.

WorkBuddy가 컴퓨터에서 작업을 실행하고 동일한 채팅창에 다운로드 링크를 회신합니다. 링크 유효 기간이 1시간이므로, 나중에도 파일을 확인할 수 있도록 "내 바탕화면에도 복사본을 저장해 줘"라는 문구를 추가하는 것이 좋습니다. 사용하는 채널이 파일 전송을 지원한다면 WorkBuddy에게 파일 자체를 보내달라고 요청할 수도 있습니다.

2. 자동화 작업을 통한 정기 데크 생성

WorkBuddy의 자동화 모듈은 일정에 따라 작업을 실행합니다. 주간 업무의 경우 다음과 같이 설정할 수 있습니다:

Every Monday at 9:00, read the latest file in ~/Reports/weekly,
create an 8-slide summary deck with 2slides (Fast PPT), save it to
~/Decks, and send me the link on WeCom.

WorkBuddy의 가격 페이지에 따르면 플랜별 자동화 작업 한도는 다음과 같습니다: 体验版(무료) 3개, 标准版(월 ¥99) 15개, 高级版(월 ¥199) 30개, 旗舰版(월 ¥999) 99개. WorkBuddy 크레딧과 2Slides 크레딧은 별개입니다. 생성되는 각 데크는 사용자의 API 키에서 2Slides 크레딧을 사용합니다(Fast PPT 페이지당 10 크레딧).

2Slides MCP 도구 목록

도구	기능	크레딧
`themes_search`	1,500개 이상의 템플릿 중 `themeId` 검색	무료
`slides_generate`	테마 기반의 편집 가능한 `.pptx` (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 음성 내레이션 (Fast PPT 제외)	페이지당 210
`slides_download_slides_pages_voices`	페이지 이미지, 오디오, 스크립트가 포함된 ZIP 파일	무료
`jobs_get`	비동기 작업 상태 확인 (20~30초 간격)	무료

Nano Banana 및 내레이션 작업은 비동기 방식으로 진행되며 보통 1~3분 정도 소요됩니다. WorkBuddy는 작업이 완료될 때까지 jobs_get을 통해 상태를 확인합니다.

문제 해결

stdio 항목에 빨간색 ✗ 표시가 뜹니다. Node.js가 설치되어 있는지(node -v), JSON 형식이 유효한지(마지막 쉼표 주의), env에 API_KEY가 포함되어 있는지 확인하세요. 첫 실행 시 npx가 패키지를 다운로드하므로 네트워크가 느리면 초록색 상태로 변하는 데 시간이 걸릴 수 있습니다.
원격(remote) 항목에 빨간색 ✗ 표시가 뜹니다. "type": "streamableHttp" 대신 "type": "http"를 시도해 보세요. URL이 쿼리 문자열을 포함하여 정확히 https://2slides.com/api/mcp인지 확인하십시오. 계속 실패하면 방법 1을 사용하세요.
401 / unauthorized 오류. 키가 잘못되었거나, 삭제되었거나, 잘못된 필드에 입력되었습니다. stdio 방식의 환경 변수는 API_KEY이며, 스킬 방식은 SLIDES_2SLIDES_API_KEY입니다.
크레딧 부족. 2slides.com/pricing에서 충전하세요. $5(2,000 크레딧)부터 시작합니다.
만료된 링크. downloadUrl은 1시간 동안만 유효합니다. WorkBuddy에게 다시 생성해 달라고 하거나, 앞으로는 파일을 로컬에 저장하도록 요청하세요.
Fast PPT 데크에 내레이션을 넣고 싶습니다. 내레이션은 Nano Banana 작업에서만 작동합니다. 먼저 slides_create_pdf_slides를 요청하세요.

자주 묻는 질문(FAQ)

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

네, 지원합니다. WorkBuddy의 'Plugins → MCP Server → Configure MCP' 메뉴에 MCP 에디터가 있으며, 'Connectors' 페이지에는 'Custom Connector' 항목이 마련되어 있습니다. 설정 파일은 사용자 수준의 ~/.workbuddy/mcp.json 또는 프로젝트 수준의 <project>/.workbuddy/mcp.json에 저장됩니다. 서버가 정상적으로 연결되면 녹색 체크 표시(✓)가 나타납니다.

2Slides를 위한 정확한 WorkBuddy MCP 설정값은 무엇인가요?

mcpServers 내에 "2slides": {"command": "npx", "args": ["-y", "2slides-mcp@latest"], "env": {"API_KEY": "YOUR_2SLIDES_API_KEY"}} 항목을 추가하는 방식을 권장합니다. 이 방식은 Node.js가 설치되어 있어야 합니다. 원격 서버 방식을 사용하려면 "type": "streamableHttp"와 "url": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY" 설정을 사용하십시오.

WeChat에서 WorkBuddy에게 PPT 제작을 요청할 수 있나요?

네, 가능합니다. WorkBuddy가 WeChat 또는 WeCom(기업용 위챗)에 연동되어 있고 2Slides가 연결된 상태라면, 채팅창에서 바로 요청을 보낼 수 있습니다. WorkBuddy가 사용자의 컴퓨터에서 슬라이드 데크를 생성한 후 다운로드 링크와 함께 응답합니다. 링크는 1시간 후에 만료되므로, 로컬 복사본도 함께 저장하도록 요청하는 것이 좋습니다.

MCP 대신 2Slides 스킬(Skill)을 사용할 수 있나요?

네, 가능합니다. GitHub에서 스킬 저장소 ZIP 파일을 다운로드하여 WorkBuddy의 'Upload Skill' 대화 상자에 드래그하거나, WorkBuddy에게 직접 찾아 설치하도록 요청하세요. 이 스킬은 환경 변수에서 SLIDES_2SLIDES_API_KEY를 읽어오며, requests 라이브러리가 설치된 Python 3 환경이 필요합니다.

비용은 얼마인가요?

WorkBuddy는 무료 플랜(월 500 WorkBuddy 크레딧, 자동화 작업 3개)과 월 ¥99부터 시작하는 유료 플랜을 제공합니다. 2Slides 비용은 별도로 청구됩니다. 신규 계정에는 500 무료 크레딧이 제공되며, Fast PPT는 페이지당 10 크레딧, 이미지 디자인 슬라이드는 페이지당 100 크레딧이 소요됩니다.

원격 설정(Remote config)은 WorkBuddy에서 공식적으로 지원하나요?

부분적으로 지원합니다. WorkBuddy의 오픈 플랫폼 커넥터 문서에는 원격 서버용으로 "type": "streamableHttp"가 명시되어 있지만, 일반 사용자용 MCP 가이드에는 stdio 방식만 설명되어 있습니다. 따라서 본 가이드에서는 stdio 방식을 우선 권장하며, 원격 연결이 필요한 경우에 한해 "type": "http"를 대안으로 제시합니다.

핵심 요약

mcpServers 설정에 npx -y 2slides-mcp@latest 한 줄만 추가하면 WorkBuddy를 WeChat, WeCom 또는 월요일 아침 스케줄러에서 호출할 수 있는 강력한 슬라이드 생성기로 변신시킬 수 있습니다. 연결 후 녹색 체크 표시(✓)를 확인하고, 1시간 후 링크가 만료되기 전에 파일을 저장하세요. Node.js 사용을 원치 않는다면 스킬(Skill) 방식을 추천합니다.

이 시리즈의 다른 에이전트 활용법도 확인해 보세요: 프레젠테이션을 위한 개인용 AI 에이전트 허브, QwenWork (千问办公), QoderWake, Manus, OpenClaw. 기타 MCP 클라이언트는 모든 AI 에이전트에서 2Slides MCP 서버 사용하기 가이드를 참조하십시오.

API 키 확인 및 설정값 복사는 2slides.com/api?tab=mcp에서 가능합니다.

참고 문헌: