# Tareas {#tasks}

> Consulta tareas de un servicio externo y elige una para trabajar con Clarvis.

Tasks conecta Clarvis con un gestor externo de incidencias. Puedes consultar sus elementos en un tablero y usar las herramientas de Clarvis para trabajar con ellos. Las tareas permanecen en el servicio externo; Clarvis no mantiene una segunda base de datos de tareas.

## Configura un proveedor de tareas {#configure-a-task-provider}

Tasks utiliza un servidor MCP con nombre que implemente `clarvis.tasks.v2`. Después de declararlo y conectarlo, añade el proveedor a `settings.json` en el ámbito global o del espacio de trabajo:

```json
{
  "tasks": {
    "provider": {
      "kind": "mcp",
      "server": "tracker:tasks",
      "protocol": "clarvis.tasks.v2"
    },
    "default_container": "engineering",
    "writes": "disabled"
  }
}
```

`default_container` es opcional. La escritura está desactivada por defecto. Establece `writes` en `enabled` solo después de revisar el servidor y los agentes con permisos `tasks.*`. Configurar el proveedor, instalar el plugin y activar el perfil son decisiones separadas.

## Consulta el proveedor desde Clarvis {#browse-the-provider-from-clarvis}

Abre `/tasks` para comprobar la conexión, alternar entre tablero y lista, filtrar por contenedor o texto, actualizar y leer los detalles. El tablero muestra por separado la etapa de Clarvis, el estado propio del servicio, la persona asignada y cualquier reserva activa de trabajo. No supone que todos los servicios usen el mismo flujo.

Los fallos de lectura, conflictos y resultados inciertos de cambios aparecen como estados explícitos, no como un tablero vacío. Al volver del trabajo del agente, la tarea se actualiza desde el servicio externo.

## Inspecciona una tarea o trabaja en ella {#inspect-a-task-or-work-on-it}

**Work on task** abre el selector habitual de Agent Profile e inicia una ejecución en el espacio actual, vinculada a esa tarea externa. Su descripción se trata como datos de trabajo no fiables: no puede cambiar el espacio, conceder herramientas, desactivar la seguridad ni seleccionar un proveedor.

Hay dos modos de acceso:

- `inspect` ofrece solo operaciones de lectura;
- `work` puede ofrecer escrituras si los ajustes, los permisos del agente y las capacidades anunciadas por el proveedor las permiten.

Abrir una tarea en modo de trabajo no la modifica. El agente debe llamar explícitamente a `start_task`. Terminar una ejecución de Clarvis nunca completa, reabre ni envía automáticamente la tarea externa.

## Cuándo se permiten cambios {#understand-the-write-gates}

Una herramienta de escritura solo está disponible si se cumplen las cuatro condiciones:

1. `tasks.writes` tiene el valor `enabled`;
2. la ejecución vinculada usa el modo `work`;
3. el agente seleccionado tiene el permiso `tasks.*` correspondiente;
4. el proveedor anuncia esa operación o transición.

Clarvis envía los cambios de uno en uno por ejecución e incluye un identificador para evitar peticiones duplicadas. Si un fallo de red deja el resultado incierto, vuelve a leer la tarea, informa de la incertidumbre y no repite automáticamente el cambio. Comprueba la tarea en el servicio externo antes de reintentarlo.

## Consulta también {#see-also}

- [Agentes](/es-ES/guide/agents)
- [Servidores MCP](/es-ES/guide/mcp-servers)
- [Extension Profiles](/es-ES/guide/extension-profiles)
- [Comandos](/es-ES/reference/commands)
- [Configuración](/es-ES/reference/configuration)

---

[HTML canónico](https://clarvis.dev/es-ES/guide/tasks)

[Índice de documentación](https://clarvis.dev/es-ES/llms.txt)