Tablero de tareas para Claude Code: configuración real en dos minutos con MCP

Para darle a Claude Code un tablero de tareas, ejecuta un comando, claude mcp add --transport http weft https://letsweft.com/api/mcp, e inicia sesión en Weft en el navegador la primera vez que Claude Code se conecte. No hay clave que copiar ni nada que pegar en un archivo de configuración. Después, un bloque corto en CLAUDE.md hace que Claude Code reclame una tarea antes de tocar el código, informe mientras trabaja y deje un recibo al terminar.

Weft lo hacemos nosotros. Los datos sobre otros productos salen de sus páginas oficiales, revisadas el 27 de octubre de 2026.

¿Qué le da un tablero a Claude Code que no le dé el terminal?

Claude Code conoce el repositorio que tiene delante, pero no quién más está trabajando ni qué tarea había empezado una sesión que se colgó. Un tablero guarda ese estado fuera de cualquier sesión, así que una persona, una segunda ventana de Claude Code y un chat de ChatGPT ven lo mismo.

No lo necesitas para cada repositorio. Una persona, una sesión corta y una lista de TODO suelen bastar. El tablero empieza a compensar cuando el trabajo abarca varias sesiones o varios agentes, o cuando una persona tiene que revisar los resultados antes de darlos por buenos.

¿Cómo conecto Claude Code a Weft en dos minutos?

1. Crea una cuenta gratuita en letsweft.com. Un tablero nuevo empieza con cuatro columnas: Backlog, Todo, Doing y Done.
2. En tu terminal, ejecuta claude mcp add --transport http weft https://letsweft.com/api/mcp. Claude Code guarda el servidor para el proyecto actual; añade --scope user si lo quieres en todos los proyectos (consulta la documentación de MCP de Claude Code de Anthropic).
3. Arranca claude. La primera vez que se use Weft, se abre una ventana del navegador para OAuth. Si no se abre, escribe /mcp, elige weft y autentícate desde ahí.
4. En la pantalla de consentimiento de Weft, elige qué puede hacer esta conexión: completo, escritura (todo menos las tres herramientas destructivas) o lectura. Puedes cambiarlo después en Ajustes → Clientes de IA conectados.
5. De vuelta en Claude Code, pregunta: «¿Qué hay en mi tablero?»

El endpoint habla MCP sobre Streamable HTTP y expone 32 herramientas. Weft emite tokens de actualización, así que el cliente renueva la sesión por sí solo. Si usas un cliente que no puede hacer OAuth, también sirve un token de acceso personal, pero Claude Code no lo necesita. La página de configuración completa está en letsweft.com/claude-code.

¿Cómo compruebo que funciona sin dejar que cambie nada?

Haz que el primer prompt sea de solo lectura. Así sabrás que las herramientas están cargadas y que el inicio de sesión llegó al espacio de trabajo correcto, sin que nada se mueva en el tablero:

Enumera mi tablero de Weft: columnas, qué hay en Doing y qué está esperando por mí.
No cambies nada.

Claude Code debería llamar a get_board_state o a get_my_work. Las dos son herramientas de solo lectura. Si quieres un margen de seguridad mientras te acostumbras, pon la conexión en lectura en la pantalla de consentimiento: las llamadas de escritura se rechazan, y las llamadas rechazadas no cuentan para tu cuota mensual.

Un coste, con honestidad: las 32 definiciones de herramientas ocupan unos 18.000 tokens del contexto de Claude Code.

¿Cómo es una tarea reclamada?

Pon una tarea pequeña y real en Todo, por ejemplo «arreglar el test de fechas inestable», y pídele a Claude Code que la coja. Una buena ejecución va así:

1. get_my_work devuelve lo que ya es de este cliente, lo que está esperando por ti y si hay hueco para empezar algo.
2. start_task reclama la tarea, la mueve a Doing y devuelve un runId y un leaseToken. La respuesta también le dice al agente que renueve cada 300 segundos.
3. Claude Code trabaja en el repositorio como siempre. Cada pocos minutos llama a report_progress, que renueva la concesión.
4. Si se topa con una decisión que solo puedes tomar tú, llama a request_input con opciones. Claude Code muestra la pregunta con sus tarjetas de opciones nativas; la respuesta vuelve por submit_answer.
5. complete_task cierra la ejecución con un resultado, artefactos como el hash del commit y la salida de los tests, y lo que no hizo.

Por defecto, una tarea completada va directa a Done. En cambio, se para en tu Bandeja de entrada cuando la tarea necesita revisión o falla una comprobación de verificación. Ahí eliges Aceptar, Rehacer, Más tarde o Descartar. Si el agente pasó un nextStep, como «fusionar la PR #12», Aceptar aprueba exactamente ese paso y vuelve al agente para que lo ejecute.

El ciclo completo, con cada rechazo y cada campo, está en la guía del ciclo de reclamación.

¿Qué pongo en CLAUDE.md?

Las descripciones de las herramientas ya llevan estas reglas; unas líneas en CLAUDE.md las convierten en costumbre del repositorio. Pega y ajusta:

## Tablero de tareas de Weft

Weft (servidor MCP "weft") es el tablero compartido de este repositorio. Otros
clientes de IA y personas también lo leen, así que mantenlo fiel a la realidad.

- Al empezar una sesión, llama a get_my_work. Trabaja en lo que devuelva;
  no elijas tareas de memoria.
- Antes de cambiar cualquier archivo para una tarea, llama a start_task con su id.
  Guarda el runId y el leaseToken que devuelve.
  - already_claimed: la tiene otro. No dupliques; elige otra.
  - attention_queue_full: no reintentes. Haz lo que sugiera la respuesta
    (terminar o aclarar el trabajo existente).
- Mientras trabajas, llama a report_progress con runId y leaseToken más o menos
  cada 5 minutos, y en cada punto de control real (tests en verde, PR abierta).
- Llama a request_input solo para decisiones que debe tomar la persona: cualquier
  cosa irreversible (producción, dinero, publicar, borrar datos) o una bifurcación
  real sin una opción por defecto sensata. Da opciones. Nunca pidas permiso para seguir.
- Al terminar, llama a complete_task con:
  - outcome: una o dos frases sobre qué cambió
  - artifacts: hash del commit, URL de la PR, comando de tests y su resultado
  - notDone: lo que te saltaste o dejaste para más tarde
  - unknowns: lo que no pudiste verificar
  - nextStep: el paso que darías si la persona acepta
- Si paras sin terminar, dilo y deja la tarea en Doing.

Los artefactos convierten un «hecho» en algo que puedes comprobar. La llamada nunca falla por falta de pruebas, porque perder trabajo terminado es peor que registrarlo sin verificar.

¿Qué pasa cuando una sesión de Claude Code muere a mitad de una tarea?

Nadie tiene que limpiar detrás. La reclamación es una concesión, no una marca. start_task concede 20 minutos, y cada report_progress los renueva. Una sesión que se cuelga, pierde la red o se cierra no puede informar, así que el silencio es la señal.

• Tras 20 minutos sin señal de vida, la ejecución se marca como caducada, el token de la concesión se borra y la tarea vuelve a quedar sin asignar.
• Cada 10 minutos pasa un barrido, y la tarea también se libera al instante cuando otro cliente intenta reclamarla.
• Una ejecución que espera tu respuesta mantiene su reclamación durante 60 minutos. Después, la concesión cae, pero la pregunta sigue abierta en tu Bandeja de entrada.
• Las reclamaciones las decide la base de datos, así que dos ventanas de Claude Code que compiten por la misma tarea no pueden ganar las dos. La que pierde recibe already_claimed con el id y el título de la tarea.

Cómo usar varios agentes a la vez se explica en varios agentes de IA en un mismo tablero.

¿Puedo ver el mismo tablero desde ChatGPT o el móvil?

Sí. Es un solo tablero detrás de un solo endpoint. Weft es una app publicada en ChatGPT en todos los planes, incluido Free (configuración), así que puedes preguntarle a ChatGPT qué terminó Claude Code durante la noche. Cursor se instala con un clic (configuración) y Codex usa una entrada de configuración más codex mcp login weft (configuración). En claude.ai y Claude Desktop, Weft se añade como conector personalizado.

Weft también tiene apps para iOS y Android. Cuando una tarea llega a tu cola, el móvil recibe una notificación push, como mucho una por espacio de trabajo cada 10 minutos, así que una pregunta de Claude Code te encuentra aunque no estés en el escritorio. Cada cliente OAuth es su propio actor, y el tablero muestra el nombre con el que se registró.

Para repasar lo que hizo un agente, consulta ¿qué hizo mi agente de IA?

¿Qué puede fallar y cómo lo arreglo?

Sin sesión iniciada

Si Claude Code dice que weft necesita autenticación, escribe /mcp, selecciona weft y autentícate. Si desconectaste el cliente en Ajustes → Clientes de IA conectados de Weft, sus tokens antiguos se rechazan en la siguiente llamada, así que vuelve a iniciar sesión de la misma forma.

No aparecen las herramientas de Weft

Ejecuta claude mcp list y comprueba que weft está ahí con la URL https://letsweft.com/api/mcp. El servidor es por proyecto salvo que lo añadieras con --scope user, así que puede que otra carpeta no lo tenga.

already_claimed

Es una respuesta, no un error. Otro cliente tiene una concesión activa sobre esa tarea. El agente debería elegir otro trabajo. Si sabes que la otra sesión está muerta, espera: la concesión caduca en menos de 20 minutos y la tarea queda libre.

attention_queue_full

Hay demasiado trabajo terminado o bloqueado esperando por ti: 5 elementos en un espacio de trabajo de una persona o 10 en uno de equipo, o 45 minutos de revisión estimada, lo que llegue antes. Las preguntas también cuentan. start_task se niega hasta que despejes parte de la Bandeja de entrada. La respuesta enumera lo que el agente todavía puede hacer (report_progress, get_my_work, get_board_state, search), para que termine u ordene en lugar de empezar más cosas.

Las llamadas se cortan en el plan Free

Free incluye 200 llamadas de IA al mes, y las primeras 48 horas después del registro no cuentan. Una sesión larga con una señal de vida cada cinco minutos va gastando llamadas de forma constante. Pro elimina el tope; consulta los precios.

¿Cómo se compara con un TODO.md, GitHub Issues o Hypertask?

Los datos de GitHub enlazan a su documentación y a su página de precios; los de Hypertask, a su documentación. Para una tabla más amplia, consulta gestores de tareas MCP comparados.

Un TODO.md es la respuesta correcta para un desarrollador en un repositorio: versionado con el código, sin cuenta y sin autenticación. Se rompe cuando dos sesiones lo editan, o cuando quieres responder a una pregunta desde el móvil.

GitHub Issues es el sitio natural cuando tu trabajo ya son incidencias y pull requests y todo el equipo vive en GitHub. Weft no tiene integración con GitHub, así que los enlaces a commits y PR viajan como artefactos en el recibo, no por sincronización.

Hypertask es mejor elección si quieres una CLI para hooks y CI, una API REST, agentes como cuentas de servicio con identidad propia, funciones de IA integradas, registro de tiempo o una app pensada para el teclado. Weft no tiene CLI, ni API pública, ni registro de tiempo. Donde Weft se diferencia es en que la reclamación, la señal de vida y la pregunta a la persona son herramientas MCP que Claude Code llama directamente, el inicio de sesión es OAuth con renovación, y el mismo tablero está en ChatGPT y en las dos tiendas de apps móviles. Más en nuestra comparación con Hypertask.

¿Necesito una clave de API para Claude Code?

No. Claude Code inicia sesión con OAuth en el navegador, y Weft emite tokens de actualización para que el cliente renueve la sesión por sí solo. Para los clientes que no pueden hacer OAuth existen tokens de acceso personales, pero Claude Code no los necesita.

¿Marcará Claude Code mis tareas como Done sin mí?

Por defecto, sí: complete_task mueve la tarea a Done con su recibo. Una tarea que necesita revisión, o cuya comprobación de verificación falla, se para en cambio en tu Bandeja de entrada para Aceptar, Rehacer, Más tarde o Descartar.

¿Puedo impedir que Claude Code borre cosas?

Pon la conexión en escritura en la pantalla de consentimiento, o después en Ajustes → Clientes de IA conectados. Escritura permite todo menos las tres herramientas destructivas (trash_task, archive_done_tasks, complete_sprint). Lectura solo permite las 11 herramientas de solo lectura. En ningún caso pueden los agentes borrar tareas definitivamente; la papelera las guarda 30 días, y restaurar desde la papelera es una función de Pro.

¿Cobra Weft por la IA además de Claude?

No. Weft no tiene créditos de IA: el razonamiento ocurre en Claude Code con tu propio plan de Claude. Weft cuenta llamadas a herramientas: 200 al mes en Free, ilimitadas en Pro por 7,87 € por asiento al mes o 66,55 € al año, IVA incluido. Consulta los precios.

¿Y si ya tengo las tareas en Linear, Jira, Notion o Trello?

La importación es gratis en todos los planes: exportaciones CSV de Linear, Jira o Notion, o un tablero de Trello en JSON. Claude Code también puede crear muchas tareas de una vez con bulk_create_tasks.

¿Funciona Weft con otros agentes de programación además de Claude Code?

Sí. Hay 33 páginas de configuración de clientes, entre ellas Cursor, Codex y ChatGPT. Todos llegan al mismo tablero por el mismo endpoint.