GitHub Copilot 코딩 에이전트에 Sume MCP 추가하기

GitHub Copilot 코딩 에이전트에 MCP 서버를 연결하려면 저장소 관리자가 저장소의 Settings > Copilot > MCP servers에 JSON을 추가합니다. 이 에이전트는 현재 OAuth를 쓰는 원격 서버를 지원하지 않고, 설정된 도구를 묻지 않고 실행합니다. 그래서 Sume 호스팅 MCP 항목은 "type": "http", "url": "https://mcp.sume.com/mcp", COPILOT_MCP_ 시크릿에서 읽어 headers에 넣는 Sume API 키, 그리고 무인으로 실행해도 되는 도구만 적은 tools 목록으로 구성합니다.

GitHub는 이제 이 에이전트를 Copilot 클라우드 에이전트(Copilot cloud agent)라고 부르며, 변경 로그에 따르면 이전 이름은 Copilot 코딩 에이전트(Copilot coding agent)입니다. GitHub 쪽 내용은 저장소용 MCP 서버 설정하기, 시크릿과 변수 설정하기, Copilot 클라우드 에이전트 소개에서, Sume 쪽 내용은 MCP OAuth와 API 키와 MCP 도구와 게이트에서 가져왔으며, 모두 2026-09-27에 확인했습니다. Sume에는 GitHub 전용 연동이 없으며, Sume 기초 페이지는 호스팅 MCP가 여전히 동작하지만 현재 주 경로는 아니라고 설명합니다. VS Code의 Copilot Chat은 다른 클라이언트이며, VS Code 원격 MCP 서버에서 다룹니다.

Copilot 클라우드 에이전트용 MCP 서버는 어디에 추가하나요?

GitHub의 저장소에서 저장소 관리자로 다음을 진행하세요.

• Settings를 클릭하세요. 사이드바의 Code, planning, and automation 아래에서 Copilot을 클릭한 다음 MCP servers를 클릭하세요.
• MCP configuration 섹션에 JSON을 붙여 넣으세요. JSON에는 서버 이름을 키로 하는 mcpServers 객체가 있어야 합니다.
• Save MCP configuration을 클릭하세요. GitHub가 구문을 검증합니다.

에이전트는 Sume에 어떻게 인증하나요?

헤더에 넣은 API 키로 인증합니다. GitHub 문서에 따르면 Copilot 클라우드 에이전트와 Copilot 코드 리뷰는 현재 OAuth를 활용하는 원격 MCP 서버를 지원하지 않으므로, Sume의 OAuth 로그인은 쓸 수 없습니다. 대신 Sume 호스팅 MCP는 API 키를 Authorization: Bearer나 x-api-key로 받습니다. Sume 문서가 OAuth를 쓰지 않는 자동화를 위해 유지하는 경로입니다. "type": "http"는 에이전트가 받는 type 값 네 가지 중 하나이며, 나머지는 local, stdio, sse입니다.

키는 예를 들어 COPILOT_MCP_SUME_API_KEY라는 이름의 Agents 시크릿으로 저장하세요. Settings를 열고 Security 섹션의 Secrets and variables, Agents를 차례로 선택한 뒤, Secrets 탭에서 New repository secret을 클릭합니다. 이름이 COPILOT_MCP_로 시작하는 Agents 시크릿과 변수만 MCP 설정에 전달됩니다. 이 값은 에이전트 환경이 아니라 MCP 서버에서만 쓸 수 있으며, 시크릿 값은 세션 로그에서 마스킹됩니다. headers에서는 이 시크릿을 다음과 같이 참조합니다.

{
  "mcpServers": {
    "sume": {
      "type": "http",
      "url": "https://mcp.sume.com/mcp",
      "headers": { "x-api-key": "$COPILOT_MCP_SUME_API_KEY" },
      "tools": [
        "mcp_health",
        "tools_list",
        "tools_schema",
        "catalog_list",
        "jobs_status",
        "jobs_wait",
        "jobs_result"
      ]
    }
  }
}

tools 목록에는 어떤 Sume 도구를 허용해야 하나요?

tools 키는 필수입니다. 에이전트는 도구를 자율적으로 사용하며 먼저 승인을 요청하지 않으므로, GitHub는 특정 읽기 전용 도구만 허용 목록에 넣으라고 강력히 권장합니다. *는 모든 도구를 켭니다. API 키 세션에는 유료 도구를 포함한 Sume의 전체 호스팅 도구 세트가 보이므로, 에이전트가 유료 Job을 시작할 수 있는지 자체를 이 목록이 결정합니다.

같은 설정은 Copilot 코드 리뷰에도 적용되는데, 코드 리뷰는 readOnlyHint를 true로 설정한 도구만 사용합니다. 현재 Sume 서버는 읽기 도구에 이 값을 설정하고 쓰기·유료 도구에는 false를 설정하므로, 리뷰에서는 Sume의 읽기 도구만 쓸 수 있습니다. 리뷰에서 MCP 도구를 모두 빼려면 Settings > Copilot > Code review에서 Allow Copilot to use MCP tools when reviewing pull requests를 끄세요.

에이전트가 미디어를 생성해도 된다면 무엇이 달라지나요?

유료 도구는 *가 아니라 이름으로 하나씩 나열하세요. 유료 호출마다 idempotency_key가 필요하고, dry_run=true는 접수 여부와 비용을 미리 보여 주며, max_spend_usd는 호출에 이 값이 들어 있을 때만 상한이 됩니다. 이 인수들은 에이전트가 작성하므로, 여러분의 설정으로 강제할 수 있는 한도가 아닙니다.

대기는 슬라이스 단위로 이뤄집니다. jobs_wait는 호출 한 번을 최대 55초까지 붙잡으며, 더 오래 걸리는 Job이라면 에이전트는 다시 제출하지 않고 같은 id로 다시 기다립니다. 클라우드 에이전트 세션은 하나당 최대 실행 시간이 59분으로 엄격히 정해져 있습니다.

Copilot에 Sume가 보이는지 어떻게 확인하나요?

• 저장소에 이슈를 만들고 Copilot에게 할당하세요.
• Copilot이 만든 풀 리퀘스트를 열고, Copilot started work 이벤트가 나타날 때까지 기다린 뒤 View session을 클릭하세요.
• 로그 뷰어 오른쪽 위의 줄임표 버튼을 클릭하고 Copilot을 선택한 다음, Start MCP Servers 단계를 펼치세요. 서버가 시작되면 로그 맨 아래에 도구가 나열됩니다.
• Copilot 클라우드 에이전트와 코드 리뷰는 MCP 도구만 쓰며, 리소스나 프롬프트는 쓰지 않습니다. Sume MCP 도구 목록은 모든 호스팅 도구를 읽기, 쓰기, 유료로 나눠 정리합니다.