Cómo inicia sesión un agente y propone cambios

Un agente que trabaja con tu hoja de ruta necesita tres cosas. Necesita una forma de entrar que no obligue a pegar un secreto. Necesita respuestas que pueda leer enteras. Y necesita poder probar un cambio antes de que se guarde nada. Así lo hace el servidor MCP de Cairn.

Entrar sin copiar un token

Cairn es su propio servidor de autorización para MCP. Un cliente que sigue el flujo de autorización de MCP se conecta con un solo comando que solo necesita un nombre y la dirección de tu Cairn. La guía de conexión de abajo muestra los comandos con la dirección correcta.

Si sigue el flujo, el cliente averigua cómo iniciar sesión, se registra y abre tu navegador. Entras con Google, y Cairn muestra lo que el agente pide, en frases sencillas, y tú permites o niegas. Los scripts y las tareas de integración continua que no pueden abrir un navegador pueden usar un token.

Probamos este flujo con el cliente oficial del SDK de MCP. Todavía no hemos probado todos los clientes, así que, si el tuyo no se conecta, cuéntanoslo.

El agente actúa como tú, con tu rol de ese momento. Si una persona administradora baja tu rol, la siguiente petición del agente ya tiene el rol más bajo. Si te quitan del espacio de trabajo, el agente se detiene. Un token de acceso dura una hora, y un token de renovación dura 30 días desde su último uso. La página de ajustes lista cada conexión, y revocar una la termina en la siguiente petición. El registro de actividad nombra al miembro y al cliente detrás de cada cambio.

Respuestas que un agente puede leer enteras

Un agente no puede usar una respuesta que tiene que guardar en un archivo. Por eso cada lectura del servidor responde con unos 20.000 caracteres como máximo, incluso en una hoja de ruta de 200 proyectos. Las listas largas llegan en páginas con un cursor. Cuando un resultado se corta, lo dice y nombra la llamada que devuelve el resto.

Probar un cambio antes de guardarlo

Las herramientas que escriben proyectos y programas aceptan un parámetro dryRun. Con él, el agente recibe la diferencia que haría el cambio y no se guarda nada. Lee la diferencia y luego repite la misma llamada sin el parámetro. Un cambio en bloque de más de 20 registros devuelve un plan hasta que se confirma.

Qué puede hacer un agente y qué no

Cuando escribimos esto, el servidor tiene 23 herramientas. Un agente puede leer proyectos, programas, cambios y el resumen de la hoja de ruta, buscar en ella, crear y actualizar proyectos y programas, archivarlos y gestionar enlaces para compartir. Nunca hace más que la persona que lo conectó: el agente de un lector solo puede leer. No puede borrar un proyecto, porque esa acción no tiene herramienta y está reservada a los administradores en la aplicación.

Conecta el tuyo

La guía de conexión tiene los comandos y los pasos para un token, y la lista de herramientas. Cairn está disponible en inglés y francés.