OpenClaw MCP 서버: Sume 이미지·영상 도구 추가하기

OpenClaw는 설정의 mcp.servers 아래에 저장한 MCP 서버에 연결해, 그 도구를 에이전트가 쓸 수 있게 합니다. 서버는 openclaw mcp add <name> --url <server-url> --transport streamable-http로 추가하거나, Control UI의 Settings → MCP에서 추가합니다. 이미지·영상·오디오 도구가 필요하면 같은 방법으로 openclaw mcp add sume --url https://mcp.sume.com/mcp --transport streamable-http --auth oauth를 실행해 Sume 호스팅 MCP 서버를 추가한 뒤 openclaw mcp login sume을 실행하거나, OAuth 대신 헤더로 Sume API 키를 보내세요. 도구는 필터링하고, requestTimeoutMs는 55,000보다 크게 설정하세요. Sume jobs_wait 호출 한 번이 55초 동안 대기할 수 있기 때문입니다.

OpenClaw 쪽 내용은 MCP 서버 연결하기, 저장된 MCP 서버 관리하기, 트랜스포트와 OAuth, 환경 변수와 시크릿 페이지에서, Sume 쪽 내용은 MCP OAuth와 API 키, MCP 도구와 게이트, Job과 결과 (영문)에서 가져왔으며, 모두 2026-09-27에 확인했습니다. 명령어와 플래그는 그날 OpenClaw 문서에 나온 그대로입니다. Sume에는 OpenClaw 전용 연동이 없으며, Sume 기초 페이지는 호스팅 MCP가 여전히 동작하지만 현재 주 경로는 아니라고 설명합니다.

OpenClaw에 Sume를 어떻게 추가하나요?

OpenClaw는 Streamable HTTP, SSE, stdio 서버에 연결합니다. Sume에는 transport: "streamable-http"를 설정하세요. 생략하면 OpenClaw는 SSE를 씁니다. 아래는 같은 서버를 OpenClaw 설정에 직접 적은 것으로, OAuth, 더 긴 요청 타임아웃, 그리고 유료 도구 하나(generate_image)만 들여보내는 도구 필터가 들어 있습니다.

{
  mcp: {
    servers: {
      sume: {
        url: "https://mcp.sume.com/mcp",
        transport: "streamable-http",
        auth: "oauth",
        requestTimeoutMs: 70000,
        toolFilter: {
          include: [
            "mcp_health",
            "tools_list",
            "jobs_wait",
            "jobs_result",
            "generate_image",
          ],
        },
      },
    },
  },
}

OpenClaw는 Sume에 OAuth와 API 키 중 무엇을 써야 하나요?

로그인할 사람이 있다면 OAuth입니다. OpenClaw의 OAuth는 MCP OAuth 플로를 알리는 HTTP 서버용이며, Sume 서버가 여기에 해당합니다. openclaw mcp login sume은 인가 URL을 출력하고, 브라우저에서 승인하면 OpenClaw가 보통 루프백 리다이렉트를 받아 자격 증명을 저장합니다. Sume 동의 페이지에서는 Read가 켜진 채 고정되고 Write는 기본적으로 꺼져 있으며, Write가 꺼져 있으면 유료 도구는 insufficient_scope를 반환합니다. --oauth-scope를 설정한다면, 현재 Sume 서버는 mcp:read와 mcp:write만 받습니다.

현재 Sume 액세스 토큰은 한 시간 동안 유효하고 리프레시 토큰은 발급되지 않으므로, OAuth 세션은 한 시간 뒤에 openclaw mcp login sume을 다시 실행해야 합니다. 무인으로 실행되는 에이전트라면, Sume는 자동화를 위해 API 키 원격 MCP를 유지합니다. auth를 빼고 키는 환경 변수에서 참조하세요. OpenClaw는 모든 설정 문자열에서 ${VAR_NAME}을 치환하며, 자격 증명을 설정 리터럴에 넣지 말라고 안내합니다. 예를 들어 headers: { "x-api-key": "${SUME_API_KEY}" }로 쓰고, 키는 환경 변수나 ~/.openclaw/.env에 둡니다. API 키 세션에는 유료 도구를 포함한 Sume의 전체 호스팅 도구 세트가 보입니다.

에이전트가 묻지 않고 비용을 쓰지 못하게 하려면 어떻게 하나요?

먼저 필터링하세요. toolFilter.include와 toolFilter.exclude(CLI에서는 --include와 --exclude)는 Sume 도구가 OpenClaw 도구가 되기 전에 간단한 * 글롭으로 걸러 냅니다. 에이전트가 유료 Job을 만들어야 하는 경우가 아니라면 generate_image와 generate_video는 빼 두세요. 두 도구 모두 호출마다 idempotency_key가 필요하고, dry_run=true는 비용을 미리 보여 주며, max_spend_usd는 값을 넘긴 경우에만 호출의 상한이 됩니다.

승인 모드는 Codex 기반 실행에 적용되며, 이 실행의 기본 전체 권한 설정에서는 확인을 묻지 않습니다. openclaw mcp configure sume --approval prompt는 모든 호출마다 묻고, auto는 각 도구의 안전 어노테이션을 따르며, approve는 호출별 승인을 건너뜁니다. 현재 Sume 서버는 읽기 도구에 readOnlyHint: true를, 쓰기·유료 도구에 false를 표시합니다.

요청 타임아웃은 왜 중요한가요?

Sume의 유료 도구는 Job으로 응답하고, 에이전트는 jobs_wait로 기다립니다. jobs_wait는 호출 한 번을 최대 55초(기본값 50초)까지 붙잡습니다. OpenClaw 문서는 requestTimeoutMs의 기본값을 밝히지 않으며, 예시에 나온 값은 20000과 30000인데 둘 중 어느 쪽이든 Sume 대기를 중간에 끊을 수 있습니다. wait_slice_expired를 받으면 에이전트는 같은 id로 jobs_wait를 다시 호출하고, 유료 create는 절대 다시 제출하지 않습니다. 나머지는 긴 영상 Job의 MCP 도구 호출 타임아웃에서 다룹니다.

연결은 어떻게 확인하나요?

• openclaw mcp doctor sume --probe는 저장된 정의를 확인한 다음, 실제 연결을 열어 서버가 알리는 도구를 보고합니다.
• openclaw mcp status --verbose는 연결하지 않고, 해석된 트랜스포트, 인증, 타임아웃, 필터를 출력합니다.
• 에이전트에게 엔드포인트, 인증 출처, 안전 설정을 확인해 주는 mcp_health를 호출해 달라고 하세요. 호스팅 MCP는 노트북의 파일을 읽을 수 없으므로 이미지 레퍼런스는 공개 HTTPS URL이어야 합니다.