Penpot MCP

Penpot MCP es la integración oficial que conecta un cliente de inteligencia artificial con archivos de diseño de Penpot. Expone capacidades para consultar datos, transformar elementos y crear contenido mediante la API del plugin. El alcance incluye operaciones de lectura y escritura: un agente conectado puede intervenir en el archivo, por lo que la conexión forma parte del flujo de edición y no es únicamente un visor.

La documentación distingue una modalidad remota alojada y otra local. La primera simplifica la conexión para trabajar sobre diseños; la segunda incorpora componentes que se ejecutan en el equipo y puede ofrecer acceso a archivos locales. Elegir la modalidad adecuada evita seguir instrucciones de desarrollo cuando solo se necesita consultar o modificar un diseño en Penpot.

Trasladar decisiones entre un archivo de diseño y un agente puede exigir describir manualmente componentes, estilos y estructura. La integración permite que el cliente consulte el contexto del archivo y actúe mediante las herramientas de Penpot. Esto resulta útil cuando el encargo necesita información concreta del diseño en lugar de una captura aislada acompañada de explicaciones incompletas.

También abre recorridos de mantenimiento, como revisar o aplicar tokens de diseño. El objetivo debe seguir siendo explícito: tener acceso al archivo no indica por sí solo qué cambios convienen. Una petición delimitada permite contrastar el estado previo con el resultado y conservar las decisiones existentes que no forman parte del encargo.

El cliente MCP envía solicitudes al servidor y este se comunica con el plugin de Penpot. El plugin conecta el contexto del archivo con las operaciones del agente mediante WebSocket. La API permite ejecutar acciones sobre el diseño, de manera que una consulta y una modificación no son equivalentes en sus consecuencias.

En local deben estar disponibles el servidor MCP y el servidor que proporciona el plugin. Después se abre el archivo en Penpot y se conecta el plugin. La referencia insiste en mantener su interfaz abierta. Si el navegador suspende o descarga la pestaña, las tareas pueden dejar de ejecutarse hasta recuperar la conexión; ese comportamiento debe revisarse antes de interpretar una interrupción como un problema del diseño.

Ejemplo de KIRELEN: un equipo quiere revisar la coherencia de los tokens de una pantalla existente. Conecta un archivo de ensayo y pide al agente describir la estructura antes de editar. A partir de esa lectura, delimita qué propiedades deben comprobarse y solicita una propuesta de cambio que conserve los componentes y decisiones ajenos al encargo.

Después de aplicar una intervención pequeña, revisa el archivo visualmente y comprueba que los elementos afectados conservan su función. Si la tarea se interrumpe, verifica el estado de la pestaña y del plugin antes de repetir operaciones. Este recorrido evita confundir un problema de conexión con una instrucción que todavía no se ha ejecutado.

El ejemplo es una propuesta de uso, no una prueba realizada sobre un archivo real de cliente. La integración facilita operaciones sobre el diseño, mientras la evaluación visual y la aceptación de las decisiones siguen correspondiendo al equipo.

La implementación oficial y el centro de ayuda de Penpot se revisaron el 2026-10-26. El perfil enlaza la carpeta MCP dentro del repositorio del producto; los lenguajes y la actividad de la ficha corresponden al repositorio completo. La preparación local y la modalidad remota se describen por separado. No se ejecutó el paquete ni se modificaron archivos de diseño durante esta revisión.