Acceso para agentes
Dejá que los agentes trabajen sobre el plano con operaciones explícitas y revisables.
AfterPencil expone el mismo modelo semántico que usa la interfaz mediante una API del navegador y un servidor MCP protegido con OAuth.
await window.afterpencil.summary()await window.afterpencil.planImage()01
Un plano es más útil que una captura
Un agente puede hacer clic en una interfaz, pero los píxeles no explican qué línea es un muro, qué abertura le pertenece o qué operación mantiene válido el modelo. AfterPencil expone comandos nombrados y resúmenes estructurados para que un agente razone sobre el proyecto que cambia.
La interfaz y los caminos para agentes convergen en las mismas operaciones del modelo. No hay un formato oculto de automatización y las comprobaciones, el historial y las salidas derivadas pueden responder de forma normal.
02
Trabajá con el proyecto ya abierto en el navegador
La API `window.afterpencil` ofrece a un agente supervisado resúmenes, datos del plano, cantidades, catálogo, imágenes y comandos de edición. Puede elegir nivel o vista, agregar elementos comunes, aplicar operaciones y esperar a que la interfaz termine de dibujar el resultado.
Este camino sirve cuando persona y agente trabajan juntos en la misma sesión. El editor visible sigue siendo la superficie de revisión, y el `llms.txt` público con guías breves describe los métodos disponibles.
03
Conectá herramientas externas mediante MCP
El servidor MCP remoto atiende agentes que no tienen navegador. OAuth pide que la persona elija un espacio y apruebe permisos. El token resultante llega solamente a los proyectos y acciones permitidos tanto por ese consentimiento como por el rol dentro del espacio.
MCP puede listar y crear proyectos, leer resúmenes y cantidades, aplicar comandos y guardar mediante la API con control de versiones. No recibe una conexión irrestricta a la base ni acceso a archivos de otra persona.
04
Leé, actuá y verificá
Un flujo útil empieza leyendo el estado relevante, aplica un cambio pequeño y explícito, y después comprueba el modelo y la salida visual. Los comandos devuelven lo creado o un error estructurado. Las imágenes de la planta técnica y el 3D permiten verificar algo más que una respuesta HTTP exitosa.
Ese circuito importa para la confianza. Un agente no debería afirmar que agrandó un ambiente solamente porque corrió un comando; debe inspeccionar dimensiones, avisos y vistas resultantes, y presentar el cambio para el criterio humano.
05
El acceso sigue siendo una decisión del producto
El acceso del navegador existe dentro de la sesión que abrió la persona. MCP usa OAuth, elección de espacio y permisos acotados. Las claves pertenecen a un espacio y los webhooks están firmados. Salir de un plan o desconectar una integración no debe ampliar acceso en silencio.
Plus y Pro incluyen integraciones con agentes porque sirven a flujos profesionales repetibles. Plan y permisos son cosas separadas: pagar el acceso nunca anula el rol de lector ni el límite de un proyecto.
06
La automatización no se convierte en autoridad profesional
Los agentes pueden acelerar trabajo explícito, explorar alternativas y resumir salidas. No certifican normativa, seguridad estructural, constructibilidad ni un precio final. Esas conclusiones necesitan las personas, fuentes y revisiones responsables.
El vocabulario de comandos es deliberadamente más angosto que ejecutar código arbitrario. Cuando una capacidad no está disponible, el agente debe decirlo o usar la API documentada, no manipular estado interno.
07
Elegí el acceso que coincide con la tarea
Usá la API de la página cuando quieras observar y revisar el trabajo dentro del editor abierto. Usá MCP cuando un agente externo necesite acceso autorizado sin navegador. Usá REST, OpenAPI, claves y webhooks cuando una integración tenga un flujo estable entre sistemas.
Empezá con el resumen legible por máquinas del sitio, seguí con las guías del editor para el navegador o conectate al endpoint MCP con OAuth. Las páginas de marketing explican el límite; las referencias técnicas canónicas describen métodos y esquemas exactos.
08
Construí integraciones sobre nombres estables
Comandos, eventos y campos usan identificadores estables en inglés aunque la interfaz humana esté en español. Así agentes e integraciones tienen un solo vocabulario técnico y las explicaciones visibles permanecen localizadas. Los cambios se documentan junto con la implementación.
AfterPencil está pensado para que los asistentes lo comprendan y los agentes autorizados puedan operarlo. Son promesas distintas: HTML estático claro y `llms.txt` ayudan a entender; APIs explícitas permiten actuar.
09
Un cambio asistido concreto
Imaginá que una persona pide ensanchar la abertura del patio e informar qué cambió. El agente primero lee el nivel y la abertura elegidos, comprueba el largo disponible del muro y aplica el comando documentado para modificarla o reemplazarla. Después vuelve a leer las dimensiones, pide imágenes de planta y 3D, y revisa si el proyecto marca un conflicto. La respuesta puede enlazar el resultado visible en vez de afirmar un éxito que nadie verificó.
La misma disciplina sirve para automatizaciones mayores. Dividí el pedido en operaciones del modelo, conservá un paso de historial comprensible cuando corresponda y devolvé errores estructurados cuando una restricción no se pueda cumplir. La revisión humana no es un clic ceremonial al final: es donde la intención de diseño, el conocimiento local y la responsabilidad profesional se encuentran con el proyecto cambiado. Las APIs informan mejor esa revisión; no la vuelven opcional.
AfterPencil
Referencias técnicas
Referencia del editor para agentes
El punto de entrada legible por máquinas y el circuito de verificación recomendado.
API JavaScript de la página
Métodos expuestos mediante window.afterpencil en el editor abierto.
Herramientas MCP
Cómo se conectan los agentes externos y usan los comandos disponibles.
OpenAPI
El contrato REST para integraciones autorizadas.
Endpoint MCP
El endpoint MCP remoto protegido con OAuth.