[태그:] Agent Mode

  • GitHub Copilot Agent Mode + MCP 전면 확대: VS Code 한국 개발자 셋업 체크리스트 6단계

    GitHub Copilot Agent Mode + MCP 전면 확대: VS Code 한국 개발자 셋업 체크리스트 6단계

    GitHub Copilot이 지난 2년간 “자동완성 툴”이었다면, 2026년 4월 Copilot은 “에이전트”가 됐다. GitHub는 Microsoft 창립 50주년을 맞춰 VS Code 안정 채널(stable) 전체 유저에게 Agent Mode + MCP(Model Context Protocol) 지원을 점진적으로 풀었다. 이미 2025년 2월부터 Insiders 채널에 선공개된 기능이지만, 이제는 일반 유저의 VS Code 업데이트만으로 바로 쓸 수 있다는 의미다.

    문제는 한국 개발자 대부분이 “Agent Mode 아이콘은 봤는데 실제로 어떻게 셋업하는지 모른다”는 점이다. 이 글은 뉴스가 아니라 셋업 체크리스트다. VS Code를 쓰는 한국 개발자가 오늘 30분 안에 Copilot Agent Mode를 에이전트 수준으로 올려놓을 수 있도록, 설치 순서와 초기 MCP 서버 구성을 단계별로 정리했다.

    체크 0. 지금 버전이 Agent Mode를 지원하나

    먼저 본인 VS Code가 stable 채널에서 Agent Mode 롤아웃에 포함됐는지 확인한다. VS Code를 열고 Cmd/Ctrl+Shift+P“About”을 치면 버전이 나온다. 2026년 3월 이후 stable 빌드라면 일단 업데이트 대상이다. 그다음 Copilot Chat 사이드바를 열고 상단 모드 드롭다운에 “Ask / Edit / Agent” 세 가지가 보이면 활성화된 상태다.

    만약 Agent 옵션이 안 보인다면 두 가지를 확인한다. 첫째, GitHub Copilot 구독 티어 — 개인 Free/Pro, Business, Enterprise 모두 지원하지만 조직 관리자가 Agent Mode를 막아놨을 수 있다. 둘째, VS Code Insiders로 잠깐 전환해 써보는 방법. Insiders는 롤아웃 순서 관계없이 최신 기능을 먼저 받는다.

    체크 1. Agent Mode 첫 실행

    Copilot Chat을 열고 상단 드롭다운을 Agent로 바꾼다. 처음 쓰는 순간 확 달라지는 건 “Copilot이 내 파일을 직접 편집하고 터미널 명령을 제안한다”는 점이다. Ask 모드는 설명, Edit 모드는 수정안 제안, Agent 모드는 “목표만 주면 직접 수정·실행까지 시도”하는 층위다.

    첫 실행 때 권장하는 워밍업 프롬프트: “이 저장소 구조를 요약해주고, README가 없으면 프로젝트 목적을 추론해서 짧게 만들어줘.” Agent가 파일을 탐색하고, README.md를 제안하고, 승인 버튼을 누를 때까지 대기한다. 이 승인 단계가 중요하다 — Agent Mode는 기본적으로 “편집 전 사용자 승인”이 켜져 있다. 처음엔 꺼두지 말고, 어떤 변경이 제안되는지 한두 번 읽어본 뒤에 판단하자.

    체크 2. MCP 서버 연결이 왜 핵심인가

    MCP는 AI 에이전트가 외부 리소스(DB, 파일 시스템, API, 회사 내부 툴)에 접근하는 표준 프로토콜이다. Claude와 Cursor가 먼저 도입했고, GitHub도 이번에 정식 지원에 합류했다. Agent Mode 단독으로는 “내 저장소 편집”까지만 되지만, MCP를 붙이면 “Slack 메시지 보내기, Jira 이슈 갱신, PostgreSQL 스키마 조회” 같은 작업까지 에이전트가 직접 할 수 있다.

    한국 개발자가 가장 먼저 붙일 만한 MCP 서버 3개는 filesystem, github, postgres다. 첫째는 로컬 파일 탐색, 둘째는 GitHub 이슈/PR 조작, 셋째는 개발 DB 쿼리. 이 세 개만 연결해도 “이 함수에서 이슈 #123 관련 코드 찾아서 수정하고 PR 올려”가 한 번의 프롬프트로 돌아간다.

    체크 3. MCP 서버 설정 파일 만들기

    VS Code 좌측 Copilot 패널 하단의 “Configure MCP Servers”를 클릭하면 settings.jsonmcp.servers 블록이 생성된다. 예시:

    {
      "mcp.servers": {
        "filesystem": {
          "command": "npx",
          "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/projects"]
        },
        "github": {
          "command": "npx",
          "args": ["-y", "@modelcontextprotocol/server-github"],
          "env": { "GITHUB_TOKEN": "ghp_..." }
        }
      }
    }

    설정을 저장하면 Copilot Chat 상단에 새 “툴” 아이콘이 뜨고, Agent 모드가 이 MCP 서버의 기능을 자동 감지한다. GitHub 토큰은 Fine-grained PAT로 생성해 필요한 저장소에만 권한을 제한하자. 전체 권한 토큰은 Agent가 의도치 않게 다른 레포를 건드릴 위험이 있다.

    체크 4. 로컬 샌드박스로 MCP 실행하기 (macOS/Linux)

    4월 릴리즈의 조용한 업데이트 중 하나가 MCP 샌드박스 실행이다. macOS와 Linux에서 로컬 MCP 서버를 파일/네트워크 접근이 제한된 샌드박스 안에서 돌릴 수 있다. 특히 filesystem 서버를 로컬 전체 권한으로 돌리는 게 불안하다면, settings.json에 "sandbox": true 플래그를 추가해 격리 실행을 켠다. 한국 개발자가 사내 규정상 전체 파일시스템 접근을 금지당한 경우에도 이 옵션으로 우회가 가능하다.

    체크 5. Autopilot 공개 프리뷰

    4월 릴리즈 노트에는 또 하나의 기능이 조용히 들어있다: Autopilot. 완전 자율 에이전트 세션으로, 승인 단계 없이 목표만 주면 멈추지 않고 여러 단계를 수행한다. 현재 public preview 상태고, 프로덕션 코드에는 아직 추천하지 않는다. 실험 저장소나 사이드 프로젝트에서 “10분간 자율 실행” 수준으로 써보고, 체감이 잡힌 뒤 점진적으로 권한을 확장하는 게 안전하다.

    체크 6. VS Code 바깥으로 확장

    4월 업데이트에서 빠뜨리면 손해인 사실 하나. VS Code에서 구성한 MCP 서버가 이제 Copilot CLIClaude 에이전트 세션에서도 그대로 동작한다. 즉 한 번 설정하면 터미널, VS Code, 다른 AI 에이전트까지 일관되게 같은 툴 셋을 쓴다. JetBrains·Eclipse·Xcode용 Agent Mode + MCP도 public preview에 진입했으니, 멀티 IDE 환경인 한국 팀은 이 타이밍이 최적 도입 시점이다.

    그래서 한국 개발자에게 뭐가 달라지나

    체감 변화는 세 가지다. 첫째, 자동완성에 의존하던 워크플로우가 “의도 기반 위임”으로 이동한다. 둘째, Cursor와 Claude Code를 병행 쓰던 개발자는 Copilot 하나로 통합할 수 있는 명분이 생겼다. 셋째, 회사에서 허가된 MCP 서버만 쓰도록 통제가 가능해졌기 때문에, 보안 부서가 AI 에이전트 도입을 반대하던 장벽이 낮아진다.

    다만 주의할 점도 분명하다. Agent 모드는 파일 편집·터미널 실행 권한을 가진다. 프로덕션 저장소나 민감 레포에서는 반드시 “승인 단계 필수”로 설정하고, Autopilot은 사이드 프로젝트에서만 쓰자. 에이전트가 내 의도와 다르게 파일을 지우거나 커밋을 만드는 실수는 여전히 발생한다.

    지금 바로 할 수 있는 것

    • VS Code 업데이트 후 Copilot Chat에서 Agent 드롭다운 존재 여부 확인. 없으면 Insiders로 전환.
    • MCP 서버 2개 연결 — filesystem + github을 먼저 붙인다. 10분이면 끝난다.
    • 샘플 워크플로우 돌려보기 — “이슈 #NN 관련 함수 찾아 수정하고 PR 초안 만들어줘”를 실험 레포에서 한 번 실행해본다.

    관련 글

    출처