VS Code 원격 MCP 서버: mcp.json에 Sume MCP 추가

VS Code에서 Sume 호스팅 MCP 서버를 쓰려면 .vscode/mcp.json이나 사용자 mcp.json의 servers 아래에 "type": "http"와 "url": "https://mcp.sume.com/mcp"를 담은 sume 항목을 추가하고 서버를 시작하세요. Sume 문서는 인터랙티브 클라이언트에 OAuth를 권장하며, Sume 동의 페이지는 Read를 부여하고 Write는 직접 켜지 않는 한 꺼 둡니다.

VS Code 관련 내용은 MCP 서버 추가와 관리, MCP 설정 레퍼런스, MCP 개발자 가이드에서, Sume 관련 내용은 MCP 빠른 시작, OAuth와 API 키, MCP 도구와 게이트에서 가져왔으며, 모두 2026-09-27에 확인했습니다. Sume에는 VS Code 전용 연동이 없습니다. VS Code는 다른 원격 서버와 똑같이 Sume 호스팅 MCP 서버에 연결합니다. Sume 기초 페이지는 호스팅 MCP가 여전히 동작하지만 현재 주 경로는 아니라고 설명합니다.

서버 항목은 어디에 넣나요?

VS Code 문서는 MCP 서버를 직접 설정할 수 있는 곳으로 세 군데를 제시합니다. 워크스페이스의 .vscode/mcp.json은 최상위 servers 객체에 서버를 정의합니다. 프로젝트 루트의 .mcp.json은 최상위 mcpServers 객체를 쓰며, 호환되는 여러 도구에서 동작합니다. MCP: Open User Configuration으로 여는 사용자 프로필 mcp.json에 넣은 서버는 모든 워크스페이스에서 쓸 수 있습니다. Command Palette의 MCP: Add Server도 같은 선택 과정을 안내합니다.

"type": "http" 서버라면 VS Code는 먼저 HTTP Stream 트랜스포트를 시도하고, HTTP가 지원되지 않으면 SSE로 돌아갑니다. Sume 빠른 시작 문서는 streamable HTTP 클라이언트를 요구합니다. 이 항목에는 비밀 값이 없으므로 소스 관리에 넣어도 되며, VS Code도 팀과 서버를 공유하려면 그렇게 하라고 권합니다.

{
  "servers": {
    "sume": {
      "type": "http",
      "url": "https://mcp.sume.com/mcp"
    }
  }
}

로그인은 어떻게 동작하나요?

VS Code는 OAuth 2.1과 2.0 표준으로 인증이 필요한 MCP 서버를 지원하며, 인증 상태를 Accounts 메뉴에 보여 줍니다. Sume 문서는 VS Code를 지목하지 않고 원격 HTTP MCP 클라이언트 전반을 기준으로 호스팅 플로를 설명합니다. 클라이언트가 MCP 엔드포인트에서 Sume의 protected-resource 메타데이터를 찾아 https://mcp.sume.com/oauth/authorize로 보내면, 이 주소는 mcp.sume.com의 동의 페이지로 이어집니다. 동의 화면에서 Read는 켜진 채 고정되고 Write 토글은 기본적으로 꺼져 있습니다. 각 단계는 Sume MCP OAuth 플로에서 다룹니다. 서버에 오류가 표시되면 MCP: List Servers에서 Show Output을 선택해 로그를 여세요.

Write가 꺼져 있으면 세션은 mcp:read입니다. jobs_list, catalog_list 같은 읽기 도구는 동작하지만, jobs_cancel, generate_image 같은 쓰기·유료 도구는 insufficient_scope를 반환합니다. Write를 켜면 mcp:write도 부여됩니다. mcp:paid 스코프는 없습니다.

OAuth 대신 Sume API 키를 쓸 수 있나요?

Sume는 호스팅 MCP에서 API 키도 받지만, 문서는 인터랙티브 클라이언트를 OAuth로 안내합니다. 빠른 시작 문서는 OAuth 커넥터 플로를 권장하고, OAuth 페이지는 우회 목적으로 호스팅 OAuth 클라이언트용 API 키를 발급하지 말라고 합니다. API 키 원격 MCP는 기존 사용자와 자동화를 위해 계속 쓸 수 있으며, API 키 세션에는 쓰기·유료 도구가 보입니다. 기존 키로 연결한다면 키를 파일에 넣지 마세요. VS Code 문서는 API 키를 하드코딩하지 말고 입력 변수를 쓰라고 합니다. VS Code는 서버를 처음 시작할 때 ${input:…} 값을 물어보고 안전하게 저장하며, password: true는 입력하는 내용을 숨깁니다.

한 가지 절충점이 있습니다. VS Code는 ${input:…} 변수처럼 대화형 입력이 필요한 서버를 Agent Host 세션으로 전달하지 않습니다. 키가 로그나 채팅 기록에 노출되면 교체하세요.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "sume-api-key",
      "description": "Sume API key",
      "password": true
    }
  ],
  "servers": {
    "sume": {
      "type": "http",
      "url": "https://mcp.sume.com/mcp",
      "headers": { "Authorization": "Bearer ${input:sume-api-key}" }
    }
  }
}

채팅이 호출할 수 있는 도구는 어떻게 제어하나요?

채팅에 어떤 도구가 보이고 언제 확인을 요청할지는 VS Code가 정하고, 호출이 무엇을 할 수 있는지는 Sume가 정합니다. Sume의 모든 쓰기·유료 도구에는 idempotency_key가 필요하고, dry_run=true는 Job을 제출하지 않고 접수 여부와 비용을 미리 보여 주며, max_spend_usd는 값을 넘긴 경우에만 호출의 상한이 됩니다.

채팅에게 무엇부터 호출하게 해야 하나요?

mcp_health부터 시작하세요. 엔드포인트, 인증 출처, 안전 설정을 확인해 줍니다. 그다음 tools_list로 세션에 보이는 모든 도구를 확인하고, 비용을 쓰기 전에 tools_schema로 도구 하나의 계약을 확인하세요.

어디에서 연결하든 호스팅 MCP는 노트북의 파일을 읽을 수 없습니다. 스틸 이미지와 클립용 유료 도구는 generate_image와 generate_video이며, payload.model을 생략하면 sume/auto로 라우팅됩니다.