Roo Code MCP 서버: streamable-http로 Sume 추가

Roo Code에 MCP 서버를 추가하려면 전역 mcp_settings.json이나 프로젝트의 .roo/mcp.json에서 mcpServers 아래에 넣으세요. 로컬 서버에는 command를 쓰고, 원격 Streamable HTTP 서버에는 "type": "streamable-http"와 서버의 url(여기서는 https://mcp.sume.com/mcp)이 필요하며, 자격 증명은 headers에 넣습니다. Sume라면 Sume API 키를 담은 Authorization: Bearer 헤더를 넣습니다.

Roo Code 쪽 내용은 Roo Code에서 MCP 사용하기 페이지에서, Sume 쪽 내용은 MCP 빠른 시작, OAuth와 API 키, MCP 도구와 게이트, Job과 결과 (영문)에서 가져왔으며, 모두 2026-09-27에 확인했습니다. Sume에는 Roo Code 전용 커넥터가 없으며, 이 방식은 일반적인 원격 MCP 연결입니다. Sume 기초 페이지는 호스팅 MCP가 여전히 동작하지만 현재 주 연동 경로는 아니라고 설명합니다. 별개의 확장 프로그램인 Cline은 type을 streamableHttp로 씁니다. Cline MCP 원격 서버를 참고하세요.

Sume 항목은 어느 파일에 넣어야 하나요?

Roo Code는 MCP 서버를 두 단계로 관리합니다. 전역 mcp_settings.json은 모든 워크스페이스에 적용됩니다. 프로젝트의 .roo/mcp.json은 프로젝트 루트에 있으며, 커밋하면 팀과 서버를 공유할 수 있고, 이름이 같은 전역 서버보다 우선합니다. 두 파일 모두 Roo Code 창의 MCP 설정 화면에서 열 수 있습니다. 맨 아래로 스크롤해 Edit Global MCP나 Edit Project MCP를 선택하세요. .roo/mcp.json이 없으면 Roo가 만들어 줍니다.

Sume 항목에는 시크릿이 들어가므로 전역 파일에 넣으세요. Sume 문서는 키를 절대 커밋하지 말라고 합니다. Roo는 ${env:VARIABLE_NAME} 치환을 로컬 서버의 args에 대해서만 설명하므로, 헤더에는 키 자체를 넣게 됩니다.

Sume 항목은 어떻게 생겼나요?

Roo 페이지는 원격 서버용 headers는 설명하지만 OAuth 로그인은 설명하지 않으므로, 이 설정은 Sume API 키를 씁니다. <SUME_API_KEY>를 Sume 대시보드에서 발급한 키로 바꾸거나, 대신 x-api-key 헤더로 보내세요. type은 필수입니다. URL 기반 항목에서 이를 빼면 바로 오류가 나는데, Roo가 URL만으로는 트랜스포트를 추론할 수 없기 때문입니다.

{
  "mcpServers": {
    "sume": {
      "type": "streamable-http",
      "url": "https://mcp.sume.com/mcp",
      "headers": { "Authorization": "Bearer <SUME_API_KEY>" },
      "alwaysAllow": ["mcp_health", "tools_list", "tools_schema", "jobs_wait"],
      "disabled": false
    }
  }
}

Roo가 자동으로 승인할 Sume 도구는 무엇인가요?

읽기만 하는 도구뿐입니다. API 키 세션에는 쓰기·유료 도구를 포함한 전체 호스팅 도구 세트가 보이므로, Roo의 승인 프롬프트가 유료 호출 전의 확인 절차가 됩니다. Roo의 MCP 자동 승인은 도구 단위로 동작하며 기본적으로 꺼져 있습니다. 전역 “Use MCP servers” 자동 승인 옵션을 켠 다음, 서버 설정에서 도구 옆의 Always allow를 체크하거나 alwaysAllow에 도구를 나열하세요. 전역 옵션이 꺼져 있으면 어떤 MCP 도구도 자동 승인되지 않습니다.

generate_video, generate_image, tts_create 같은 유료 도구는 alwaysAllow에서 빼 두세요. 그러면 Roo가 호출마다 제안하고 여러분의 승인을 기다립니다. 유료 호출 전에는 제출하지 않고 접수 여부와 비용을 미리 보여 주는 dry_run=true로 먼저 실행해 달라고 Roo에게 요청하세요. 모든 유료 호출에는 idempotency_key도 필요합니다.

Roo Code의 60초 타임아웃으로 충분한가요?

네, 대기 한 번에는 충분합니다. Roo의 서버별 timeout은 1초부터 3600초까지이며 기본값은 60초입니다. 각 서버 설정 상자의 Network Timeout 드롭다운으로도 설정할 수 있습니다. Sume의 jobs_wait는 호출 한 번을 최대 55초, 기본 50초 동안 열어 둡니다. 이보다 오래 걸리는 렌더는 여러 번에 나눠 기다립니다. wait_slice_expired를 받으면 Roo는 같은 id로 jobs_wait를 다시 호출해야 하며, 유료 create는 절대 다시 제출하면 안 됩니다. 이 패턴은 긴 영상 Job의 MCP 도구 호출 타임아웃에 있습니다.

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

Roo에게 엔드포인트, 인증 출처, 안전 설정을 확인해 주는 mcp_health를 호출하게 한 뒤, 세션에 보이는 모든 도구를 나열하는 tools_list를 호출하게 하세요. 권한 오류가 나면 Roo 문제 해결 목록은 mcp_settings.json이나 .roo/mcp.json의 자격 증명을 다시 확인하라고 안내합니다. 로그나 채팅 기록에 키가 나타난 적이 있다면 교체하세요. Sume MCP 도구 목록은 도구를 읽기, 쓰기, 유료로 나눠 정리합니다.