MCP Tasks 사용법, 클로드 코드가 기다리지 않고 일하는 법

MCP Tasks는 오래 걸리는 작업을 클로드 코드에 연결해 둔 외부 서비스에 맡기고, 클로드는 결과를 기다리지 않고 다음 일을 진행하게 해 주는 기능입니다. 조건, 켜는 법, 진행 상황 확인, 클로드 코드를 껐다 켜도 이어지는 범위까지 공식 문서 기준으로 정리했습니다.

2026년 10월 기준 공개 베타(정식 출시 전 시험 공개)입니다. 이름과 동작은 바뀔 수 있으니 쓰기 전에 공식 문서(code.claude.com/docs/en/mcp)의 MCP tasks 항목을 함께 확인합니다.

MCP Tasks란

외부 서비스를 클로드 코드에 연결하는 표준 방식이 MCP(Model Context Protocol)입니다. MCP Tasks는 그 MCP에 붙은 확장으로, 보고서 내보내기나 빌드처럼 오래 걸리는 작업(task)을 MCP 서버가 직접 맡아 돌리는 방식입니다. 이름에 MCP가 붙은 이유입니다.

예를 들어 전체 테스트를 MCP Tasks를 지원하는 테스트 서비스에 맡기면, 서버가 작업을 받았다는 응답을 주는 즉시 클로드의 도구 호출이 끝납니다. 클로드는 결과를 기다리지 않고 바로 다음 일을 합니다. 작업이 끝나면 대화 기록에 완료 줄이 뜨고 클로드가 결과를 받습니다.

원래 클로드 코드는 MCP 도구 호출이 2분 넘게 걸리면 자동으로 백그라운드로 보내는 기능이 따로 있습니다. 하지만 이쪽은 클로드 코드를 종료하면 사라지는 단순 백그라운드 호출입니다. MCP Tasks는 서버가 작업을 직접 들고 있어서 다릅니다.

쓰려면 필요한 조건

아래를 모두 만족해야 호출이 task가 됩니다.

• 터미널용 클로드 코드 2.1.304 버전 이상. 터미널 CLI, Agent SDK, GitHub Actions에서 쓸 수 있고, VS Code 확장과 데스크톱 앱에는 아직 없습니다.
• 연결한 MCP 서버가 tasks 확장을 지원해야 합니다. HTTP 서버, stdio 서버, claude.ai 커넥터 모두 가능하지만 프로토콜 버전 2026-07-28로 연결돼야 합니다.
• 기능 플래그를 받아오는 세션이어야 합니다. 아마존 베드록 같은 외부 제공자나 텔레메트리를 끈 세션은 해당하지 않습니다.
• 호출이 메인 대화에서 나와야 합니다. 서브에이전트가 부르는 호출은 task가 되지 않습니다.
• 한 번만 실행하는 claude -p "프롬프트" 방식에서는 MCP Tasks가 동작하지 않습니다. 대화형 세션에서 씁니다.

버전은 터미널에서 확인합니다.

claude --version

어떻게 동작하는지 보는 예시

테스트 서비스를 직접 만든 사례로 흐름을 따라가 봅니다. 주문 데이터 300만 줄을 계산하는 테스트 105개를 돌려 주는 서비스를 만들고, 이 서비스를 MCP로 클로드 코드에 연결했다고 가정합니다.

1. 클로드 코드에 "전체 테스트를 돌려 줘"라고 요청합니다.
2. 클로드는 "이 서비스에 맡겨 두었다"고 바로 답합니다.
3. 그 사이 다른 요청, 예를 들어 README 수정을 이어서 시켜도 끝납니다.
4. 입력창 아래에 1 MCP task처럼 진행 중인 작업 수가 표시됩니다.
5. 테스트가 끝나면 MCP task ... completed. 줄이 뜨고, 클로드가 idle(대기) 상태였다면 사용자가 묻지 않아도 결과를 보고합니다. 105개가 모두 통과했다는 식입니다.

속도를 비교한 공식 수치는 없습니다. 이득은 빨라지는 것보다 기다리는 시간에 다른 일을 할 수 있다는 점입니다.

어디에 쓰면 좋은가

프로그램을 고칠 때마다 기존 기능이 깨지지 않았는지 전체 테스트를 다시 돌립니다. 이것을 회귀 테스트라고 하고, 길게는 몇십 분씩 걸립니다. 이런 테스트나 대용량 보고서 내보내기, 빌드처럼 오래 걸리는 작업을 맡겨 두고 그동안 다른 작업을 하면 시간을 아낄 수 있습니다.

써 보는 순서

1단계. 클로드 코드 버전을 확인합니다. 위 claude --version을 입력합니다. 확인: 2.1.304 이상이 나옵니다. 낮으면 claude update로 올립니다.

2단계. tasks를 지원하는 MCP 서버를 클로드 코드에 연결합니다. 원격 서버라면 터미널에서 아래 형식으로 추가합니다. 서버가 tasks 확장을 지원하는지는 그 서버의 문서에서 확인합니다.

claude mcp add --transport http 서버이름 서버주소

확인: claude mcp list에서 그 서버 상태가 연결됨으로 나옵니다. 클로드 코드 안에서는 /mcp로 연결 상태를 보고 로그인도 할 수 있습니다.

3단계. 오래 걸리는 작업을 요청합니다. 확인: 클로드가 "서버에 맡겼다"고 답하고 바로 다음 요청을 받을 수 있습니다.

4단계. 진행 상황을 확인합니다. 입력창에 아래를 입력합니다.

/tasks

확인: 실행 중인 작업 목록과 서버가 알려 준 최근 진행 상황이 보입니다. 입력창 아래 줄에는 1 MCP task처럼 개수가 표시됩니다.

5단계. 끝난 작업의 결과를 받습니다. 완료 줄은 대화 기록에 뜨지만 결과는 클로드에게 전달됩니다. 확인: 클로드에게 결과를 물으면 답해 줍니다. 클로드가 쉬고 있을 때 끝났다면 알아서 결과를 처리하기 시작합니다.

6단계. (선택) 작업을 멈춥니다. /tasks에서 작업을 고르고 x를 누르거나 클로드에게 취소를 부탁합니다. 확인: 클로드 코드가 서버에 취소를 요청합니다. 서버가 이미 진행한 작업은 끝까지 갈 수도 있습니다. Esc는 백그라운드 task를 멈추지 않습니다.

클로드 코드를 껐다 켜면

작업이 어디서 도는지에 따라 달라집니다.

• 원격 서버의 task는 클로드 코드를 종료해도 계속 돌아갑니다.
• 클로드 코드가 직접 띄우는 stdio 서버의 프로세스는 클로드 코드를 끄면 함께 멈춥니다. 서버 문서에 작업이 프로세스보다 오래 간다고 적혀 있지 않다면, 끝날 때까지 기다리거나 /tasks에서 먼저 멈춥니다.
• 다시 이어서 열 때는 터미널에서 아래 명령을 씁니다. 서버가 다시 연결되면 클로드 코드가 task를 다시 따라가고, 그사이 끝났다면 결과를 받습니다. 서버 이름과 연결 설정은 바꾸지 않아야 합니다.

claude --continue

• /clear나 /resume으로 다른 대화로 옮겨도 결과는 현재 대화로 들어옵니다. 새 세션을 열거나 --fork-session을 쓰면 task를 따라가지 않으니, 시작한 세션을 이어서 엽니다.

기다리게 만들고 싶을 때

기본값은 기다리지 않는 것입니다. 결과가 나올 때까지 클로드가 기다리게 하려면 settings.json의 env 항목에 하나를 설정합니다. 둘 중 하나입니다.

• CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND를 1로: task 결과를 기다립니다.
• CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS를 0으로: 모든 MCP 도구 호출을 끝날 때까지 기다립니다.

{
  "env": {
    "CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS": "0"
  }
}

기다리는 동안 Esc를 누르면 호출이 끝나고 서버에 취소가 요청됩니다.

막힐 때

• task가 안 되고 일반 호출처럼 동작하면: 위 조건을 하나씩 확인합니다. 데스크톱 앱이나 VS Code 확장이면 터미널에서 씁니다. 서버가 tasks를 지원하지 않으면 일반 도구 호출로 처리됩니다.
• /tasks 항목에 "reconnecting…"이 계속 보이면: /mcp에서 서버를 다시 연결합니다.
• "needs a sign-in" 메시지가 보이면: /mcp에서 로그인합니다.
• "outcome unknown" 이 나오면: 서버가 작업 ID를 거부했다는 뜻입니다. 같은 요청을 다시 보내면 일이 중복될 수 있으니 서버 쪽 상태를 먼저 확인합니다.

서버를 만드는 사람에게

서버가 task를 돌려주려면 요청의 _meta에 tasks 확장 지원 표시가 있을 때만 resultType: "task" 응답을 보내야 합니다. 응답에는 taskId, status(working, input_required, completed, failed, cancelled 중 하나) 등이 들어갑니다. 클로드 코드는 tasks/get으로 상태를 확인하므로 결과도 그 응답에 담아야 합니다. 세부 규칙은 공식 문서의 For server authors 항목과 MCP tasks 확장 설명을 따릅니다.