클로드 코드 MCP 작업을 /tasks에서 멈추고 결과를 기다리게 하는 환경변수 설정법

클로드 코드 v2.1.304부터 MCP 작업(MCP tasks)을 퍼블릭 베타로 쓸 수 있다. 보고서 내보내기나 빌드처럼 오래 걸리는 일을 MCP 서버가 직접 맡아 돌린다. 서버가 일을 받으면 도구 호출은 바로 끝나고 클로드는 다음 일로 넘어간다. 그동안 하단에 1 MCP task 같은 개수가 뜨고, 일이 끝나면 대화에 이런 줄이 찍힌다.

MCP task <server task id> (<server>/<tool>) completed.

결과는 대화창에 나오지 않고 클로드에게 바로 넘어가므로, 보여 달라고 하면 된다. 클로드가 쉬던 중이었다면 알아서 이어 처리한다.

1. 멈추기. /tasks에서 작업을 골라 x를 누르거나 클로드에게 멈추라고 한다. Esc는 듣지 않는다. 서버 연결이 끊겼다면 /mcp에서 다시 연결하고 멈춰야 서버에 취소 요청이 간다. 취소해도 서버가 이미 해 둔 일은 남을 수 있다.

2. 결과를 기다리게 하기. settings.json의 env에 아래처럼 넣으면 클로드가 모든 MCP 도구 호출이 끝날 때까지 기다린다.

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

작업 결과만 그 자리에서 기다리게 하려면 대신 CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND를 "1"로 둔다. 이때도 2분을 넘긴 호출은 일반 백그라운드 호출로 넘어가고, 세션을 끝내면 함께 사라진다. CLAUDE_CODE_DISABLE_BACKGROUND_TASKS를 1로 두는 것만으로는 MCP 작업을 기다리지 않는다.

1. 나중에 결과 받기. 원격 서버의 작업은 클로드 코드를 꺼도 계속 돈다. 작업을 시작한 세션을 claude --resume으로 다시 열면 클로드 코드가 작업을 다시 따라가고, 그사이 끝났다면 결과도 받는다. 새 세션이나 --fork-session으로 연 세션은 따라가지 않는다. stdio 서버는 클로드 코드를 끄면 프로세스도 같이 끝나니 끄기 전에 작업을 마치거나 /tasks에서 멈춘다.

MCP 작업은 터미널 CLI와 Agent SDK, GitHub Actions에서만 생긴다. VS Code 확장·데스크톱 앱, Amazon Bedrock 같은 서드파티 제공자, 서브에이전트가 부른 호출, 한 번 돌고 끝나는 claude -p 실행에서는 생기지 않는다. 서버도 작업을 지원하고 프로토콜 2026-07-28로 연결돼 있어야 한다.