2026-09-27

Visual Studio MCP 서버: .mcp.json에 Sume 추가

.mcp.json 항목 하나로 Visual Studio의 Copilot 에이전트 모드에 Sume 호스팅 MCP 서버를 추가하고, CodeLens로 로그인한 뒤 도구 호출을 확인하세요.

읽는 시간 5분Sume

Visual Studio 2022 버전 17.14와 Visual Studio 2026에서는 GitHub Copilot 에이전트 모드가 MCP 서버의 도구를 쓸 수 있습니다. Sume 호스팅 MCP 서버를 추가하려면 %USERPROFILE%\.mcp.json처럼 Visual Studio가 읽는 .mcp.json 파일에 "servers": { "sume": { "url": "https://mcp.sume.com/mcp" } }를 넣고 저장한 뒤, 파일의 CodeLens(Authentication Required 또는 Manage Authentication)로 브라우저에서 Sume에 로그인하세요.

이 글은 Windows용 Visual Studio를 다룹니다. VS Code는 VS Code 원격 MCP 서버를 참고하세요. Visual Studio 쪽 내용은 Microsoft의 Visual Studio에서 MCP 서버 사용하기에서, Sume 쪽 내용은 MCP 빠른 시작, MCP OAuth와 API 키, MCP 도구와 게이트에서 가져왔으며, 모두 2026-09-27에 확인했습니다. Sume에는 Visual Studio 전용 연동이 없으며, Sume 기초 페이지는 호스팅 MCP가 여전히 동작하지만 현재 주 경로는 아니라고 설명합니다.

Visual Studio는 MCP 서버 설정을 어디에서 찾나요?

Visual Studio는 아래 파일에서 이 순서대로 MCP 서버 설정을 읽습니다. 위치에 따라 .mcp.json이 필요한 곳도 있고 mcp.json이 필요한 곳도 있습니다. 구문이 올바른 파일을 저장하면 Copilot 에이전트가 다시 시작되고, 설정된 서버를 다시 불러옵니다.

채팅에서 서버를 추가할 수도 있습니다. 채팅 창을 Agent 모드로 바꾸고 Tools를 선택한 뒤, 플러스(+) 버튼을 선택하고 Add custom MCP server를 고른 다음, Add MCP server 대화상자에 이름과 URL을 입력하세요.

Microsoft Visual Studio에서 MCP 서버 사용하기 기준, 2026-09-27 확인.
파일	Microsoft 문서 설명
`%USERPROFILE%\.mcp.json`	사용자 한 명의 전역 설정. 모든 Visual Studio 솔루션에서 로드됨
`<SOLUTIONDIR>\.vs\mcp.json`	Visual Studio 전용. 사용자 한 명, 솔루션 하나
`<SOLUTIONDIR>\.mcp.json`	소스 관리로 추적하는 설정에 적합
`<SOLUTIONDIR>\.vscode\mcp.json`	저장소 또는 솔루션 단위. 보통 소스 관리 대상이 아님
`<SOLUTIONDIR>\.cursor\mcp.json`	저장소 또는 솔루션 단위. 보통 소스 관리 대상이 아님

Sume 항목에는 무엇을 넣나요?

URL만 넣으면 되며, 형태는 Microsoft의 원격 서버 예시와 같습니다. 이 항목에는 비밀 값이 없으므로 팀에서 <SOLUTIONDIR>\.mcp.json을 소스 관리에 넣어도 됩니다. JSON 스키마가 적용되도록 Visual Studio에서 편집하세요.

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

Visual Studio에서 Sume에 어떻게 로그인하나요?

Visual Studio는 MCP 인가 명세에 따라, 어떤 OAuth 제공자를 쓰는 원격 서버든 인증을 지원합니다. 저장한 뒤 파일의 CodeLens에서 Authentication Required나 Manage Authentication을 선택하고, 브라우저 팝업에서 마무리하세요. CodeLens가 보이지 않으면 Tools > Options > Text Editor > CodeLens에서 켜세요.

Sume 쪽에서는 클라이언트가 MCP 엔드포인트에서 protected-resource 메타데이터를 찾아 사용자를 https://mcp.sume.com/oauth/authorize로 보냅니다. 동의는 mcp.sume.com에서 이뤄지며, Read는 켜진 채 고정되고 Write 토글은 기본적으로 꺼져 있습니다. 현재 Sume 서버는 동적 클라이언트 등록과 S256 방식의 PKCE를 알리고, 액세스 토큰은 리프레시 토큰 없이 한 시간 동안 유효하므로, 한 시간 뒤에는 다시 로그인한다고 생각해 두세요. 각 단계는 Sume MCP OAuth 플로에서 다룹니다.

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

Copilot은 Sume 도구를 호출하기 전에 확인을 요청하나요?

네. 새 서버의 도구는 기본적으로 꺼져 있으며, 원하는 도구를 직접 켜야 합니다. Copilot은 도구를 호출할 때 확인을 요청하고, Allow 드롭다운에서 그 도구를 현재 세션, 현재 솔루션, 또는 앞으로의 모든 호출에 대해 자동으로 승인하게 할 수 있습니다. 이 선택은 Tools > Options에서 초기화할 수 있습니다. 서버가 도구 목록 변경(tool-list-changed) 알림을 보내면, Visual Studio는 그 서버의 도구에 대해 이전에 내린 수락과 권한을 초기화합니다.

Sume의 유료 도구는 호출마다 확인하도록 두세요. 유료 호출마다 idempotency_key가 필요하고, dry_run=true는 Job을 제출하지 않고 접수 여부와 비용을 미리 보여 주며, max_spend_usd는 값을 넘긴 경우에만 호출의 상한이 됩니다.

무엇 때문에 서버가 연결되지 않을 수 있나요?

조직 허용 목록: GitHub를 통해 허용 목록이 설정되어 있으면 Visual Studio는 승인된 MCP 서버에만 연결하고, 그 밖의 서버에는 오류를 표시합니다.
에이전트 모드와 MCP에 대한 GitHub 정책: 관리자가 이 정책을 끄면 해당 구독의 사용자는 에이전트 모드를 쓰거나 MCP 서버에 연결할 수 없습니다.
바뀐 서버: Visual Studio 2026 버전 18.7부터는 서버의 설정이나 기능이 바뀌면 신뢰 대화상자가 다시 묻고, Reject를 선택하면 서버가 시작되지 않습니다.
연결되면 Copilot에게 엔드포인트, 인증 출처, 안전 설정을 확인해 주는 mcp_health를 호출한 다음 tools_list를 호출해 달라고 하세요. Sume MCP 도구 목록은 모든 호스팅 도구를 읽기, 쓰기, 유료로 나눠 정리합니다.

출처

연동 카테고리의 다른 글

Warp MCP 서버: 에이전트에 Sume 호스팅 MCP 추가
Warp의 Settings > Agents > MCP servers에 Sume 호스팅 MCP URL을 원격 MCP 서버로 추가하고, OAuth나 Bearer 헤더로 인증한 뒤 호출 승인을 설정하세요.
Windsurf MCP 서버: Devin Desktop에 Sume 추가
Windsurf는 이제 Devin Desktop입니다. API 키 헤더로 Sume 호스팅 MCP 서버를 Devin Local 에이전트나 레거시 Cascade 에이전트에 추가하세요.
Zapier AI 영상 자동화: Zap 두 개와 Sume 웹훅 하나
Zap 하나는 Custom Request로 Sume 영상 실행을 시작하고, 두 번째 Zap은 Catch Raw Hook으로 Sume의 서명된 웹훅을 받아 Code 단계에서 검증합니다.
Zed MCP 서버: context_servers에 Sume 추가
Zed의 context_servers에 원격 MCP 서버로 Sume 호스팅 MCP를 추가하고 OAuth나 API 키로 연결한 뒤, tool_permissions로 유료 도구는 먼저 묻게 하세요.

연동 글 전체 보기

작성자 Sume