Claude Code, 오래 걸리는 MCP 작업을 서버에 맡기고 계속 일한다 — 'MCP tasks' 공개 베타
Claude Code 공식 문서에 'MCP tasks' 안내가 올라왔어요. 빌드 · 보고서 내보내기처럼 긴 일을 MCP 서버가 따로 돌리는 동안 Claude는 다른 일을 하고, 원격 서버 작업은 Claude Code를 꺼도 계속 돌아가요. 터미널 CLI v2.1.304 이상에서 공개 베타예요.
- MCP task는 MCP 서버(외부 도구를 Claude에 잇는 연결 프로그램)가 직접 돌리는 긴 작업이에요. 서버가 일을 받으면 Claude의 도구 호출은 바로 돌아오고, Claude는 다른 일을 계속해요. 일이 끝나면 대화 기록에 표시되고 Claude가 결과를 받아요.
- 원격 서버의 작업은 Claude Code를 종료해도 계속 돌아가고, 같은 세션을 다시 열면(claude --resume 등) 이어서 따라가요. 작업 중 서버가 질문 창(elicitation)을 띄워 사람에게 입력을 받을 수도 있어요. 멈출 땐 /tasks에서 골라 x를 눌러요.
- 공식 문서 기준 공개 베타 · Claude Code v2.1.304 이상 · 터미널 CLI · Agent SDK · GitHub Actions에서만 돼요. VS Code 확장 · 데스크톱 앱, 서브에이전트의 호출, 한 번 실행(claude -p)은 해당되지 않고, 서버도 tasks를 지원해야 해요.
빌드 · 데이터 내보내기처럼 몇 분 넘게 걸리는 일을 MCP 서버로 감싸 두면, 기다리는 동안 Claude Code에 다른 일을 시킬 수 있어요. 서버 쪽 구현 방법은 문서의 'MCP tasks for server authors'에 있어요.
지금 쓰는 MCP 서버(연결 도구)가 tasks를 지원하는지부터 확인해 보세요. 서버가 지원해야만 켜져요.
영상 변환 · 대량 이미지 처리처럼 오래 걸리는 일을 MCP 서버에 맡기는 흐름을 만들 때 써 보면 좋을 것 같아요. 다만 아직 공개 베타이고 터미널 CLI 중심이라, 서버가 지원하는지 먼저 확인해 보세요.
Claude Code 공식 문서(MCP 안내)에 MCP tasks 항목이 생겼어요. 문서에는 "MCP tasks는 Claude Code CLI에서 공개 베타이고 Claude Code v2.1.304 이상이 필요하다"고 적혀 있어요. v2.1.304는 npm에 10월 19일(UTC) 올라온 판이에요.
무엇이 달라지나
MCP(Model Context Protocol · AI에 외부 도구를 잇는 표준)에서 MCP task는 서버가 직접 돌리는 긴 작업이에요. 문서는 보고서 내보내기 · 빌드를 예로 들어요.
- 기다리지 않음: 서버가 일을 받으면 Claude의 도구 호출이 바로 돌아오고, Claude는 다른 일을 계속해요. 끝나면 대화 기록에
MCP task <server task id> (<server>/<tool>) completed.같은 줄이 뜨고 Claude가 결과를 받아요. Claude가 쉬고 있으면 알아서 결과를 이어 처리해요. - 진행 표시: 아래쪽에
1 MCP task같은 수가 보이고, Claude Code가 서버에 상태를 물어보며 따라가요. - 꺼도 계속: 원격 서버의 작업은 Claude Code를 종료해도 계속 돌아요. 같은 세션을 대화형으로 다시 열면(
claude --resume·claude --continue·/resume) 다시 따라가고, 그사이 끝났으면 결과도 받아요. 새 세션이나--fork-session은 따라가지 않아요. - 시간 제한: 기본값으로 백그라운드 작업엔 Claude Code 쪽 시간 제한이 없어요.
- 중간 질문: 작업 중 서버가 질문 창(elicitation · 서버가 사람에게 입력을 받는 창)을 띄울 수 있어요. 거절하거나 Esc를 눌러도 서버에 대한 답으로 처리되고, 계속할지는 서버가 정해요.
- 멈추기:
/tasks에서 작업을 고르고x를 누르거나 Claude에게 부탁해요. Esc로는 백그라운드 작업이 멈추지 않고, 취소를 보내도 서버가 일을 끝낼 수는 있어요.
되는 곳 · 안 되는 곳
문서에 적힌 조건이 모두 맞아야 도구 호출이 MCP task가 돼요.
- 서버가 tasks를 지원하고, HTTP · stdio · claude.ai 커넥터 서버로 프로토콜 판 2026-07-28로 연결돼 있어야 해요.
- v2.1.304 이상의 터미널 CLI · Agent SDK · GitHub Actions에서 켜져 있어요. VS Code 확장 · 데스크톱 앱엔 MCP tasks가 없어요.
- Amazon Bedrock 같은 다른 회사 제공 경로에서는 안 돼요(기능 플래그를 받아 오는 세션이어야 해서).
- 메인 대화의 호출만 해당되고, 서브에이전트의 호출은 아니에요. 한 번 실행하는
claude -p "<prompt>"도 해당되지 않아요. - 대화형이 아닌 세션에서 작업이 입력을 요청하면, Claude Code는 서버에 그 작업을 취소해 달라고 요청해요.
- stdio 서버(내 PC에서 돌리는 서버)는 Claude Code를 끄면 프로세스도 멈춰요. 서버 문서에 '프로세스가 끝나도 일이 계속된다'고 없으면, 작업을 끝내거나
/tasks에서 멈춘 뒤 끄라고 문서는 권해요.
바탕이 된 MCP 사양
MCP 공식 블로그의 7월 28일 글(2026-07-28 사양)에서 Tasks는 실험 기능에서 빠져 io.modelcontextprotocol/tasks 확장이 됐어요. 블로그는 Tasks를 'AWS가 기여한 첫 공식 MCP 확장 가운데 하나'로 소개했어요. Tasks 안내 문서에 따르면 서버는 결과 대신 작업 번호(taskId)를 돌려주고, 클라이언트는 tasks/get으로 상태를 물어봐요. 상태는 working · input_required · completed · failed · cancelled예요.
