Un diagrama es uno de esos artefactos que deberían actualizarse solos. La arquitectura cambia con cada merge, la página de documentación va una release por detrás y, al final, alguien abre una herramienta de dibujo para arreglarlo a mano. LetDraw tiene una API y un servidor MCP para que un script o un agente de IA haga ese trabajo en su lugar, y lo siga haciendo cada vez que cambie la fuente.
Si ya generas diagramas a partir de un archivo de Compose o de una especificación, el siguiente paso es dejar de pulsar el botón tú mismo. Un token de API personal convierte esa misma generación en una llamada que cualquier máquina puede hacer: un paso de build, un job nocturno o un asistente que lee tu petición y dibuja el resultado. El token solo lleva los permisos que tú le concedes, así que la automatización mantiene el mínimo privilegio por defecto.
Tokens de API personales y alcances
Creas un token en la configuración de Desarrollador, le das un nombre y eliges sus alcances. Esa es toda la configuración. El nombre sirve para distinguir los tokens más adelante; llama a uno "script de CI" y a otro como el asistente que lo vaya a usar, y al revocar un token cortas exactamente a un llamador y a nada más.
Los alcances son la forma en que un token mantiene el mínimo privilegio. En lugar de una única clave todopoderosa, cada token recibe solo las capacidades que su trabajo necesita:
- Leer diagramas para un job que solo obtiene el estado actual de un dibujo
- Crear y editar diagramas para automatizaciones que producen o actualizan lienzos
- Exportar a Mermaid o D2 para un pipeline de documentación que necesita un archivo para hacer commit
- Generar a partir de una indicación para la vía de IA, donde una petición se convierte en un diagrama
Un token, un trabajo, un nombre que puedes revocar. Esa es la diferencia entre una automatización en la que confías y una clave que te da miedo entregar.
Genera diagramas desde CI o cron
La REST API es un endpoint HTTP normal. Te autenticas con un token bearer, envías un cuerpo JSON y recibes un diagrama. Esta es la vía de generar a partir de una indicación, el tipo de llamada que pondrías en un paso de build para que la arquitectura se dibuje a partir de una especificación en cada push:
# $LD_TOKEN holds a token with the "generate" and "export" scopes # 1) prompt to diagram (uses the AI key stored on your account) curl https://api.letdraw.com/api-v1/documents/generate \ -H "Authorization: Bearer $LD_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "prompt": "web -> api -> postgres, redis cache on api", "name": "Architecture" }' # 2) export it as text to commit next to the code (format=mermaid or d2) curl "https://api.letdraw.com/api-v1/documents/$DOC_ID/export?format=mermaid" \ -H "Authorization: Bearer $LD_TOKEN"
Pon eso detrás de un cron job y el diagrama obsoleto de la documentación simplemente deja de existir. El job se ejecuta, el diagrama se regenera a partir de lo que diga hoy la entrada, y el dibujo que abren tus compañeros es el que coincide con la realidad. La primera llamada devuelve el nuevo documento con su id; la llamada de exportación lo convierte en texto mermaid o d2 que puedes hacer commit junto al código.
Un pipeline que se mantiene al día
La forma es la misma tanto si el disparador es un merge como si es una programación: algo cambia, el pipeline llama a la API y el diagrama se reconstruye. Nadie se acuerda de volver a exportar nada, porque no hay nada que recordar.
Conéctala a un asistente de IA con MCP
Las mismas capacidades se exponen a través del Model Context Protocol, así que un asistente de IA puede dibujar y editar diagramas por ti en plena conversación. Registras LetDraw como servidor MCP una vez, le das un token, y el asistente obtiene las herramientas que permiten sus alcances: puede crear un lienzo, editar lo que hay, exportar a Mermaid o D2, o generar un diagrama a partir de una descripción que escribes en lenguaje natural.
{
"mcpServers": {
"letdraw": {
"url": "https://api.letdraw.com/mcp",
"headers": {
"Authorization": "Bearer $LD_TOKEN"
}
}
}
}
Como el asistente solo tiene el token que le diste, su alcance se limita a los alcances de ese token. Dale a un asistente de borradores crear y editar más generar, y podrá construir y revisar diagramas todo el día; dale a un asistente revisor solo lectura y exportación, y podrá mirar y producir un archivo pero nunca cambiar tu lienzo. Ponle al token el nombre del cliente que lo tiene, y si alguna vez quieres cortarle el acceso, revocas un token y ese asistente lo pierde en la siguiente llamada.
Revoca, rota, repite
Todos los tokens se pueden revocar desde la misma página de configuración de Desarrollador donde los creaste. Eso es lo que hace cómodo entregar tokens a scripts y asistentes: nada de lo que concedes es permanente y nada está enredado con lo demás. Una variable de CI filtrada, un cliente que dejaste de usar, un alcance que concediste con demasiada generosidad; en cada caso, la solución es revocar ese token y crear uno nuevo con los alcances que realmente querías.
En conjunto, es una superficie pequeña con una regla clara. Las máquinas y los asistentes obtienen diagramas igual que tú, mediante tokens con nombre que solo llevan los permisos que su trabajo necesita, y puedes retirar cualquiera de ellos en el momento que quieras. El diagrama deja de ser algo que mantienes y pasa a ser algo que produce tu pipeline.