Cline MCP 원격 서버: Sume 호스팅 MCP 추가하기

Cline에 Sume 호스팅 MCP 서버를 추가하려면 Cline MCP 설정의 mcpServers 아래에 "type": "streamableHttp", "url": "https://mcp.sume.com/mcp", 그리고 Sume API 키를 담은 Authorization: Bearer 헤더로 sume 항목을 넣으세요. type이 없는 항목을 Cline은 레거시 SSE 트랜스포트로 처리하므로 type은 반드시 명시하세요.

Cline 쪽 내용은 MCP 페이지와 Auto Approve와 YOLO 모드 페이지에서, Sume 쪽 내용은 MCP 빠른 시작, OAuth와 API 키, MCP 도구와 게이트, Job과 결과 (영문)에서 가져왔으며, 모두 2026-09-27에 확인했습니다. Sume는 Cline 확장 프로그램을 배포하지 않습니다. Cline이 Sume 원격 MCP 서버에 직접 연결합니다. Sume 기초 페이지는 호스팅 MCP가 여전히 동작하지만 현재 주 경로는 아니라고 설명합니다. VS Code 내장 MCP 지원은 VS Code 원격 MCP 서버를 참고하세요.

Cline에서 원격 서버는 어디에 추가하나요?

Cline은 서버를 MCP 설정 파일에 보관하며, 어떤 방법으로 편집하든 결국 같은 mcpServers 항목을 고치게 됩니다.

• IDE 확장 프로그램: Cline 패널에서 MCP Servers 아이콘을 클릭하고, Configure 탭을 연 뒤, Configure MCP Servers를 클릭해 MCP 설정 JSON을 엽니다.
• Remote Servers 탭: Server Name, 전체 Server URL, Transport Type을 입력하는 양식이며, Transport Type은 Streamable HTTP가 권장이고 SSE는 레거시입니다. Cline 페이지에는 이 양식의 헤더 필드가 나와 있지 않으므로, Sume 헤더는 나중에 JSON에서 추가하세요.
• Cline CLI: ~/.cline/mcp.json을 편집하거나 cline mcp를 실행하세요. 마법사가 서버 이름, 트랜스포트 유형, 원격 서버의 URL과 헤더를 묻습니다.
• cline config mcp --json은 마법사 없이 설정된 서버 목록을 보여 줍니다.

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

Sume 빠른 시작 문서는 streamable HTTP 클라이언트를 요구하며, Cline에서는 streamableHttp 타입이 여기에 해당합니다. Sume 문서는 인터랙티브 클라이언트에는 OAuth를 권장하고 API 키 원격 MCP는 기존 사용자와 자동화를 위해 유지합니다. Cline MCP 페이지에는 OAuth 로그인 설명이 없고, 원격 서버 예제는 headers로 토큰을 보내므로 Sume API 키 경로와 맞습니다. Sume는 키를 Authorization: Bearer나 x-api-key로 받으며, API 키 세션에는 쓰기·유료 도구를 포함한 전체 호스팅 도구 세트가 보입니다.

<SUME_API_KEY>를 실제 키로 바꾸세요. Cline 보안 기본 수칙은 시크릿을 환경 변수에 저장하라고 하지만, Cline 페이지는 env를 로컬 서버에서만 보여 주므로 키는 Cline 설정 파일에 들어갑니다. 이 파일은 어떤 저장소에도 넣지 말고, 키가 로그나 채팅 기록에 노출되면 교체하세요.

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

Cline이 묻지 않고 실행해도 되는 Sume 도구는 무엇인가요?

읽기만 하는 도구뿐입니다. Cline은 Auto Approve를 도구 호출마다 판단합니다. Use MCP servers 설정은 MCP 도구와 리소스를 다루며, Cline이 권장하는 기본값은 특별한 이유가 생기기 전까지 MCP를 꺼 두는 것입니다. YOLO 모드는 MCP 도구를 포함해 모든 것을 자동 승인하며, Cline은 이 모드를 위험하다고 설명합니다. Cline 보안 기본 수칙은 autoApprove를 안전한 도구로 제한하고, 승인하기 전에 도구 호출을 검토하라고 합니다.

유료 호출 전에는 Cline이 dry_run=true나 generation_admission_preview로 먼저 미리 보게 하세요. max_spend_usd는 값을 보낸 경우에만 호출의 상한이 됩니다.

Sume 호출이 타임아웃되면 어떻게 하나요?

Cline MCP 설정에서 요청 타임아웃을 지정할 수 있으며, Cline 문제 해결 표는 타임아웃 오류가 나면 MCP 타임아웃을 늘리라고 안내합니다. 타임아웃은 jobs_wait에 맞춰 잡으세요. jobs_wait는 호출 한 번을 최대 55초, 기본 50초 동안 열어 둡니다. wait_slice_expired를 받으면 에이전트는 같은 id로 jobs_wait를 다시 호출해야 하며, 유료 create는 절대 다시 제출하면 안 됩니다. 나머지 대기 계약은 긴 영상 Job의 MCP 도구 호출 타임아웃에서 다룹니다.

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

Cline 빠른 시작은 도구가 나타나는지 확인하고 도구 호출 하나를 테스트하는 단계로 끝납니다. Cline에게 엔드포인트, 인증 출처, 안전 설정을 확인해 주는 mcp_health를 호출하게 한 뒤, 세션에 보이는 모든 도구를 확인하도록 tools_list를 호출하게 하세요. 인증 오류가 나면 API 키, 토큰, 필수 헤더를 다시 확인하라고 Cline 문서는 안내합니다. Sume MCP 도구 목록은 도구를 읽기, 쓰기, 유료로 나눠 정리합니다.