IntelliJ GitHub Copilot MCP 설정: Sume 추가하기

IntelliJ IDEA의 GitHub Copilot에 MCP 서버를 추가하려면 Copilot Chat을 Agent 모드로 열고, 채팅 창 아래쪽의 도구 아이콘(Configure your MCP server)을 클릭한 뒤 Add MCP Tools를 클릭하고, mcp.json의 servers 아래에 서버를 정의하세요. 원격 서버에는 url을 넣고, 토큰이 필요하면 requestInit.headers도 넣습니다. Sume 호스팅 MCP 서버라면 url은 https://mcp.sume.com/mcp이고, 헤더는 Sume API 키를 담은 Authorization: Bearer입니다.

GitHub 쪽 내용은 MCP 서버로 GitHub Copilot Chat 확장하기에서, Sume 쪽 내용은 MCP OAuth와 API 키, MCP 빠른 시작, MCP 도구와 게이트, 인증에서 가져왔으며, 모두 2026-09-28에 확인했습니다. Sume에는 Copilot이나 JetBrains 전용 연동이 없습니다. Copilot은 다른 원격 MCP 서버와 똑같이 Sume 원격 MCP 서버에 연결하며, Sume 기초 페이지는 호스팅 MCP가 여전히 동작하지만 현재 주 경로는 아니라고 설명합니다. VS Code의 Copilot은 VS Code 원격 MCP 서버에서 다룹니다.

Sume를 쓰려면 mcp.json에 무엇을 넣나요?

GitHub의 원격 서버 예시와 같은 형태의 항목입니다. servers 객체, 이름, url, 그리고 requestInit 아래의 헤더로 이뤄집니다. JetBrains IDE는 원격 서버와 로컬 서버를 모두 지원하며, Sume 서버는 Sume 빠른 시작 문서가 지정하는 Streamable HTTP 엔드포인트에 있는 원격 서버입니다. Sume는 키를 Authorization: Bearer나 x-api-key로 받습니다.

키는 적은 그대로 파일에 저장되므로 mcp.json을 비공개로 두고, 로그나 채팅 기록에 키가 노출되면 교체하세요. 그다음 Copilot Chat의 도구 아이콘을 클릭해 Sume 도구를 확인하고, Copilot에게 엔드포인트, 인증 출처, 안전 설정을 확인해 주는 mcp_health를 호출해 달라고 하세요.

{
  "servers": {
    "sume": {
      "url": "https://mcp.sume.com/mcp",
      "requestInit": {
        "headers": {
          "Authorization": "Bearer <YOUR_SUME_API_KEY>"
        }
      }
    }
  }
}

IntelliJ의 Copilot에 내 MCP 서버가 왜 보이지 않나요?

먼저 모드를 확인하세요. GitHub 안내는 Agent 모드의 Copilot Chat에서 MCP 서버를 설정하도록 합니다. 그다음 정책을 확인하세요. 조직과 엔터프라이즈는 MCP servers in Copilot 정책으로 MCP를 켜거나 끄는데, 이 정책은 기본적으로 비활성화되어 있고, 정책을 설정한 조직이나 엔터프라이즈에서 Copilot Business 또는 Copilot Enterprise를 받은 사용자에게만 적용됩니다.

IntelliJ의 Copilot은 OAuth로 Sume에 로그인할 수 있나요?

GitHub 문서에는 그 방법이 나오지 않습니다. JetBrains 안내에는 토큰 헤더를 쓰는 원격 예시만 있고, 같은 페이지에 나오는 OAuth 로그인, 즉 CodeLens에서 Auth를 누르는 방식은 Visual Studio용으로 쓰여 있습니다. Sume는 원격 MCP 클라이언트에 OAuth를 제공하며 동의 단계에서 Write를 켜기 전까지는 읽기 전용이지만, 이 글은 문서에 나온 헤더 방식을 씁니다.

API 키 세션에는 유료 도구를 포함한 Sume의 전체 호스팅 도구 세트가 보이고, 지출은 키가 속한 워크스페이스로 잡힙니다. Sume 안전 규칙은 에이전트에게 먼저 읽기 전용 명령을 주고, 유료 생성 전에는 명시적인 확인을 받으라고 하므로, 유료 호출 전에는 반드시 여러분에게 확인하라고 Copilot에게 지시하세요. 유료 호출마다 idempotency_key가 필요하고, dry_run=true는 Job을 제출하지 않고 접수 여부와 비용을 미리 보여 주며, max_spend_usd는 값을 보낸 경우에만 호출의 상한이 됩니다.

Job은 대기 한 번보다 오래 걸릴 수 있습니다. Sume의 jobs_wait는 최대 55초 동안 붙잡아 두며, wait_slice_expired를 받으면 Copilot은 같은 id로 다시 호출해야 하고, 유료 create는 절대 다시 제출하면 안 됩니다.

PyCharm, Android Studio 등 다른 JetBrains IDE에서도 이렇게 하면 되나요?

네, GitHub는 Copilot과 호환된다고 밝힌 모든 IDE에 JetBrains 안내 하나와 mcp.json 형식 하나를 제시합니다. IntelliJ IDEA(Ultimate, Community, Educational), Android Studio, CLion, DataGrip, GoLand, PhpStorm, PyCharm, Rider, RubyMine, RustRover, WebStorm 등이 여기에 해당합니다.

JetBrains AI Assistant는 자체 MCP 설정이 있는 별개의 어시스턴트이고, Android Studio의 Gemini 에이전트에도 자체 설정이 있습니다. Android Studio MCP 서버를 참고하세요.