TL;DR Desde la v2.1.212, una llamada MCP de la conversación principal que pasa de dos minutos deja de bloquear: Claude Code la manda a segundo plano, verás
1 MCP tasken la status line y el resultado vuelve como notificación al terminar. Tú sigues trabajando. Lo único que no puedes hacer es cerrar la sesión, porque la tarea no sobrevive. Para verla o pararla,/tasks.
Hasta la v2.1.212, una llamada lenta a un servidor MCP se quedaba con el turno hasta que respondía. Ahora hay un desenganche automático: a los dos minutos, Claude Code registra esa llamada como una tarea de fondo, le asigna un id y te devuelve el prompt. La llamada sigue viva contra el servidor, y cuando termina el resultado entra en la conversación como notificación.
No lo activas tú y no hay que pedirlo. Es lo que hace que aparezca un contador en la status line que probablemente no habías visto nunca.
Cómo se ve
En la status line, junto a los agentes y al resto de indicadores:
-- INSERT -- ▶▶ auto mode on · ← 6 agents · PR #1823 · 1 MCP task
Y el detalle, en el panel de /tasks:
Background
MCP tasks (1)
❯ ⧗ claude.ai Atlassian/getJiraIssue · k3pbkgiv · working
↑/↓ to select · x to stop · Esc to close
Servidor, herramienta, id de tarea y estado. Ese k3pbkgiv es el identificador que Claude usa para pararla si se lo pides.
Qué hacer
1. Nada, y ese es el punto
Sigue con lo tuyo. Claude recibe el aviso en el momento en que la llamada se va al fondo, con un mensaje que es literalmente este:
MCP tool "..." is still running after 120s. It was moved to the background as
task k3pbkgiv and keeps running; you'll receive a notification with the result
when it completes. You can keep working in the meantime.
Cuando la llamada termina, el resultado llega como notificación de tarea y Claude lo retoma. Si el resultado es un adjunto grande (una imagen, un blob), no se cuela entero en el contexto: se guarda en disco y la notificación te deja la referencia.
2. Verla o pararla: /tasks
/tasks
Alias /bashes. El panel se titula Background y ahora tiene sección propia de MCP tasks, entre Monitors y Cloud agents. Seleccionas con las flechas y la paras con x.
3. El límite que sí duele: no sobrevive a la sesión
Si cierras la sesión, la tarea muere y el resultado se pierde. No es como una sesión cloud ni como una Routine: esto vive dentro de tu proceso. Si has lanzado algo largo contra Jira, Notion o tu base de datos, la sesión se queda abierta hasta que vuelva.
Tampoco te salta el límite de tiempo por estar en segundo plano. Siguen aplicando el tope de reloj del servidor (su timeout o MCP_TOOL_TIMEOUT) y el corte por inactividad de CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT.
4. Cambiar el umbral, o apagarlo
Los dos minutos se tocan con una variable de entorno, en milisegundos:
# Que espere cinco minutos antes de mandarla al fondo
export CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS=300000
# Que no lo haga nunca (vuelve a bloquear el turno)
export CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS=0
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1 también lo apaga, pero se lleva por delante el resto de tareas en segundo plano.
5. Lo que nunca se va al fondo
| Caso | Por qué |
|---|---|
| Llamadas desde subagentes | Solo se desengancha la conversación principal |
| Servidores de IDE | Excluidos por diseño (sse-ide, ws-ide) |
Modo no interactivo (-p) |
Salvo que pongas CLAUDE_AUTO_BACKGROUND_TASKS=1, porque un one-shot puede terminar antes de que llegue el resultado |
| Llamada esperando un diálogo de elicitation | El servidor está bloqueado en tu respuesta, no lento |
Referencia
| Detalle | Valor |
|---|---|
| Umbral por defecto | 120.000 ms (dos minutos) |
| Variable para ajustarlo | CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS (ms, 0 lo desactiva) |
| Apagado global | CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1 |
| Dónde verla | /tasks (alias /bashes), sección MCP tasks |
| Cómo pararla | x sobre la tarea seleccionada |
| Estados | working, completed, failed, cancelada por el servidor |
| Persistencia | Muere al salir de la sesión |
| Versión mínima | Claude Code v2.1.212 |
Este contador entra en el mismo panel donde ya confluye todo lo que tienes corriendo en paralelo, y es la fuente que llega sin que la pidas. Si estás montando servidores MCP ahora, empieza por la configuración, y si tienes muchos conectados, así evitas que se coman el contexto.
Documentación oficial: Automatic backgrounding of long tool calls