API y agentes de IA (MCP)

Attos tiene una API para que un programa externo, o un agente de IA, pueda leer y actualizar tareas y proyectos con las mismas reglas que usa una persona desde la interfaz: mismos permisos, misma bitácora, mismas notificaciones.

Crear un token

Ve a Configuración → API y tokens → Nuevo token.
Ponle un nombre reconocible, por ejemplo “Agente de proyectos”.
Elige el permiso mínimo que necesita. Por ejemplo, para que pueda comentar, cambiar el estado y asignar tareas propias, basta con el permiso de crear y editar del módulo de tareas; solo dale permiso de administrar todo si de verdad necesita tocar tareas de cualquier persona.
Elige quién actúa con ese token: la persona de tu organización a cuyo nombre va a quedar firmado todo lo que el token escriba (comentarios, cambios de estado, archivos adjuntos). Sin un actor asignado, el token solo puede leer información; cualquier intento de escribir responde con un error de “sin actor”.
Copia el valor del token. Se muestra una sola vez; si lo pierdes, no hay forma de recuperarlo y tendrás que crear uno nuevo.

No puedes darle a un token un permiso que tú mismo no tengas.

Conectarlo como servidor MCP

Si usas un cliente compatible con MCP (Model Context Protocol), puedes conectar Attos como una herramienta más:

claude mcp add --transport http attos https://attos.org/api/mcp \
  --header "Authorization: Bearer attos_sk_..."

La primera llamada útil siempre es preguntar quién eres: te confirma a nombre de qué organización quedó conectado el token y qué puede hacer. La lista de herramientas disponibles se ajusta sola: si a tu token le falta un permiso, esa herramienta ni siquiera aparece.

La API por REST

Si prefieres integrarlo tú mismo, la base es https://attos.org/api/v1 y cada petición lleva el token en el encabezado Authorization: Bearer attos_sk_..., con el cuerpo en JSON.

Puedes, entre otras cosas:

Listar y filtrar tareas (por asignado, estado, proyecto o fecha).
Ver el detalle completo de una tarea: subtareas, dependencias, comentarios y bitácora de actividad.
Cambiar el estado, los puntos, las notas, el asignado o la fecha límite de una tarea.
Comentar una tarea, mencionando a alguien por su nombre completo.
Agregar o marcar subtareas.
Agregar o quitar dependencias entre tareas (“bloqueada por” / “bloquea a”).
Subir un archivo adjunto a una tarea.
Listar plantillas y proyectos, ver el detalle de un proyecto, y crear un proyecto nuevo a partir de una plantilla con las tareas ya repartidas entre tu equipo.

Ejemplo: crear un proyecto desde una plantilla

curl -X POST https://attos.org/api/v1/proyectos/desde-plantilla \
  -H "Authorization: Bearer attos_sk_..." -H "Content-Type: application/json" \
  -d '{
    "plantillaId": "<uuid-de-la-plantilla>",
    "cliente": "Constructora Ejemplo",
    "tipo": "recurrente",
    "portafolioId": "<uuid-del-portafolio>",
    "fecha0": "2026-08-24",
    "prioridad": "alta",
    "asignaciones": [
      { "puesto": "Ejecutivo de cuenta", "profileId": "<uuid-persona>" },
      { "puesto": "Diseño", "profileId": "<uuid-persona>" }
    ]
  }'

Attos reparte cada tarea de la plantilla según reglas en este orden: primero por sección, luego por si el título de la tarea es un hito, luego por coincidencia con el puesto indicado en las notas de la tarea, y al final por un encargado por omisión. Si ninguna regla aplica, la tarea queda sin asignar, igual que si la crearas desde la interfaz.

Este endpoint es idempotente por nombre de proyecto: si ya existe un proyecto con ese nombre en tu organización, Attos no lo duplica, te devuelve el proyecto que ya existía.

Herramientas MCP disponibles

Herramienta	Qué hace	Solo lectura
Ver quién soy	Confirma la organización y los permisos del token	sí
Listar tareas	Lista tareas con filtros (asignado, estado, proyecto, fecha)	sí
Ver tarea	Detalle completo de una tarea	sí
Comentar tarea	Agrega un comentario a una tarea	no
Actualizar tarea	Cambia estado, puntos, notas, asignado o fecha límite	no
Marcar subtarea	Marca o desmarca una subtarea como hecha	no
Agregar dependencia	Hace que una tarea dependa de otra	no
Quitar dependencia	Quita una dependencia entre tareas	no
Listar plantillas	Lista las plantillas de proyecto disponibles	sí
Listar proyectos	Lista proyectos con filtros (cliente, estado, portafolio)	sí
Ver proyecto	Detalle completo de un proyecto y sus tareas	sí
Crear proyecto desde plantilla	Da de alta un proyecto nuevo con sus tareas ya repartidas	no
Cambiar estado de proyecto	Pone un proyecto en espera del cliente, lo reanuda o lo cancela	no

También existen herramientas equivalentes para consultar el organigrama, el directorio del equipo, la base de conocimiento y las políticas de tu organización, siempre en modo de solo lectura.

Reglas importantes

Un token es una herramienta, no una persona. El permiso que puede usar lo pone el nivel del propio token, no el de quien lo creó ni el del actor que firma.
“Tarea propia” significa asignada al actor del token o creada por él. Con el permiso de editar, un token solo puede tocar esas tareas; con el de administrar, puede tocar cualquiera de la organización.
Reasignar una tarea la mueve de semana dentro del plan de batalla de la persona nueva. Una tarea que todavía no está agendada en ninguna semana no se puede reasignar por esta vía.
Las menciones se detectan por el nombre completo escrito en el texto del comentario, tal como aparece en Attos, no por un identificador.
Cada tarea admite hasta 30 dependencias combinadas (las que la bloquean más las que bloquea), y Attos no permite crear un ciclo de dependencias.

Límites de texto

Campo	Tope
Título de tarea	300 caracteres
Instrucciones o notas	20,000 caracteres
Comentario	10,000 caracteres
Título de subtarea	300 caracteres

Tenlo en cuenta

Si borras o pierdes un token, tienes que crear uno nuevo y volver a conectarlo donde lo estabas usando.
Un error de “sin actor” casi siempre significa que el token puede leer pero no tiene asignada una persona que firme lo que escribe. Corrígelo en Configuración → API.