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

빠른 답변 (60단어 이내): OpenClaw는

~/.openclaw/openclaw.json

의

mcp.servers

키 아래에 2Slides MCP 서버를 추가해 실제 PowerPoint 파일을 생성할 수 있습니다. 2slides.com/api에서 키를 발급받은 뒤, stdio 서버(

command: "npx"

,

args: ["2slides-mcp"]

,

env.API_KEY

)나 원격 서버(

url

+

transport: "streamable-http"

)를 추가하고, OpenClaw 에이전트에게 덱을 만들어 달라고 요청하세요.

OpenClaw는 오픈소스 AI 에이전트 프레임워크이며, 완전한 Model Context Protocol(MCP) 클라이언트입니다. 2Slides MCP 서버를 연결하면 어떤 OpenClaw 에이전트든 브리프 — 또는 읽을 수 있는 문서 — 를 완성된 편집 가능한

로 바꾸는 능력을 갖게 됩니다.

이 가이드는 두 가지 전송 방식(로컬 stdio와 원격 Streamable HTTP)에 대한 정확한

스키마, CLI 단축 명령, MCP 도구가 에이전트 도구 프로필에 어떻게 노출되는지, 그리고 라이브 프로브로 모든 것을 검증하는 방법을 다룹니다.

OpenClaw에 2Slides 서버를 부여하는 이유는?

OpenClaw 에이전트는 추론하고, 계획하고, 파일을 읽습니다. 바이너리 슬라이드 파일을 렌더링하지는 않습니다. 그것은 전용 생성기의 일입니다. 2Slides를 붙이면:

• OpenClaw는 소스 자료에서 슬라이드 구조, 카피, 내러티브를 결정합니다.
• 2Slides MCP 서버는 실제 PowerPoint를 만듭니다. 테마 기반 Fast PPT이거나, 선택적 AI 음성 내레이션과 내보내기 가능한 에셋 번들을 갖춘 이미지 디자인 슬라이드입니다.

먼저 필요한 것

1. OpenClaw 설치 (
   openclaw
   가 PATH에 있어야 함).
2. 2Slides API 키, 2slides.com/api에서 발급.
3. Node.js, stdio 전송 방식용(
   npx 2slides-mcp
   ). HTTP 전송 방식은 로컬에 아무것도 필요하지 않습니다.

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

2Slides MCP 서버는 둘 다 지원합니다. OpenClaw에서는 어떤 필드를 설정하느냐로 둘을 구분하며,

필드는 없습니다.

방법 1: openclaw.json의 stdio

OpenClaw의 설정은

에 있습니다. MCP 서버는 최상위 키 아래, 이름으로 키가 매겨진 객체에 들어갑니다.

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

이게 전부입니다.

가 있다는 사실이 로컬 stdio 서버임을 표시합니다.

방법 2: openclaw.json의 Streamable HTTP

호스팅된 엔드포인트에는

과 정규 필드를 설정하세요.

{
  "mcp": {
    "servers": {
      "2slides": {
        "url": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY",
        "transport": "streamable-http"
      }
    }
  }
}

참고: OpenClaw의 정규 전송 값은

"streamable-http"

입니다(레거시

type: "http"

별칭도 허용되지만 정규화되어 사라집니다.

transport

를 쓰세요). 키를 URL이 아니라 헤더에 넣어야 한다면

?apikey=

쿼리 대신

"headers": { "Authorization": "Bearer YOUR_2SLIDES_API_KEY" }

를 사용하세요.

또는

openclaw mcp

CLI 사용

이들은 동일한

설정에 기록합니다.

# stdio
openclaw mcp add 2slides --command npx --arg 2slides-mcp --env API_KEY=YOUR_2SLIDES_API_KEY

# remote (set the full server object as JSON)
openclaw mcp set 2slides '{"url":"https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY","transport":"streamable-http"}'

연결 확인

OpenClaw는 전용 MCP 진단 명령을 제공합니다.

openclaw mcp status --verbose       # resolved transport/auth/timeouts (static, no connection)
openclaw mcp doctor 2slides --probe # static checks, then a live connection test
openclaw mcp probe 2slides --json   # connect live and list the exposed tools
openclaw mcp reload                 # drop cached in-process MCP runtimes

가 성공하면 2Slides 도구(, 등)를 나열해 에이전트가 이를 호출할 수 있음을 확인해 줍니다.

도구가 에이전트에 도달하는 방식

설정된 MCP 도구는 OpenClaw의

및

messaging

도구 프로필에 자동으로 노출됩니다. 참고 사항:

• minimal
  프로필은 MCP 도구를 숨깁니다. 보이지 않으면 프로필을 전환하세요.
• MCP 도구를 명시적으로 비활성화하려면
  tools.deny
  에
  "bundle-mcp"
  를 추가하세요.
• 일부 2Slides 도구만 노출하려면 서버별
  toolFilter.include
  /
  toolFilter.exclude
  (정확한 이름 또는
  *
  글롭)를 사용하세요.

{
  "mcp": {
    "servers": {
      "2slides": {
        "command": "npx",
        "args": ["2slides-mcp"],
        "env": { "API_KEY": "YOUR_2SLIDES_API_KEY" },
        "toolFilter": { "include": ["themes_search", "slides_generate", "jobs_get"] }
      }
    }
  }
}

서버를 정의해 두되 비활성 상태로 유지하려면

로 설정하세요.

첫 덱 생성하기

OpenClaw 에이전트에게 평범한 언어로 요청하세요.

Read PROJECT_BRIEF.md and generate an 8-slide overview deck.
Find a clean "minimal" theme from 2slides first, then create
the PowerPoint and give me the download link.

OpenClaw는

→ (Fast PPT)를 호출하고 을 반환합니다. 이미지로 디자인된 맞춤 슬라이드의 경우 를 사용하고 준비될 때까지 (약 20초마다) 을 폴링합니다.

2Slides MCP 도구 목록

흔한 실수와 문제 해결

• mcp.servers
  대신
  mcpServers
  를 사용함. OpenClaw 설정에서 키는
  mcp.servers
  입니다. (
  mcpServers
  는 OpenClaw를 서버로 실행하는 별개의 외부 클라이언트 개념입니다.)
• transport
  대신
  type
  을 작성함.
  type
  은 레거시 별칭이고, 정규 필드는
  transport: "streamable-http"
  입니다.
• 도구가 나타나지 않음.
  minimal
  프로필일 가능성이 높거나,
  tools.deny
  에
  bundle-mcp
  가 들어 있습니다.
  coding
  /
  messaging
  으로 전환하고
  openclaw mcp reload
  를 실행하세요.
• stdio 서버가 시작되지 않음. Node.js가 설치되어 있고
  env
  에
  API_KEY
  가 설정되어 있는지 확인하세요.
• 비동기 작업 폴링. 에이전트가 약 20초마다
  jobs_get
  을 폴링하게 두세요. Nano Banana와 내레이션 작업은 기본적으로 비동기입니다.

자주 묻는 질문

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

예. OpenClaw는 네이티브 MCP 클라이언트입니다.

의 키 아래에서, 또는 / 을 통해 서버를 추가하세요. stdio와 Streamable HTTP 전송 방식을 모두 지원합니다.

OpenClaw에서 MCP 서버의 설정 키는 무엇인가요?

입니다. 최상위 객체 안에 이름으로 키가 매겨진 객체입니다. 로컬 서버는 //를, 원격 서버는 + 를 사용합니다.

2Slides가 연결되었는지 어떻게 확인하나요?

노출된 도구를 나열하는 라이브 연결은

을, 정적 검사와 연결 테스트는 를 실행하세요.

실제 PowerPoint가 생성되나요?

예.

는 편집 가능한 를 반환합니다. Nano Banana 도구는 선택적 AI 내레이션과 내보내기 가능한 번들을 갖춘 이미지 디자인 덱을 반환합니다.

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

2slides.com/api?tab=mcp에서 받습니다. 키, 복사-붙여넣기용 설정, 그리고 Streamable HTTP 엔드포인트가 있습니다.

핵심 정리

openclaw.json

의

mcp.servers

항목 하나가 모든 OpenClaw 에이전트에게 슬라이드 생성기를 부여합니다. 로컬은 stdio, 원격은

transport: "streamable-http"

. 그다음

openclaw mcp probe

로 동작을 증명하세요.

더 넓은 맥락은 MCP가 프레젠테이션 워크플로를 어떻게 바꾸고 있는지와 PowerPoint MCP 서버 생태계 지도를 참고하세요. 에이전트를 비교하시나요? 같은 서버를 사용하는 Claude Code와 OpenAI Codex를 보세요.

2slides.com/api?tab=mcp에서 키와 설정을 받아 OpenClaw 에이전트에게 완성된 덱까지 가는 한 문장짜리 길을 열어 주세요.

출처:

• OpenClaw — MCP CLI docs
• 2Slides API & MCP server