meywd
October 10, 2025, 4:15pm
1
Hi, I have been trying to integrate claude code with penpot, I forked the opensource community mcp and let claude and co-pilot work on enhancing it, however I am facing some issues doing that, first is the cloudflare issue, which is why I am using the self-hosted version, which is fine, the other issue is failing to keep changes, mainly updates, it could be a problem in the code generated by the AI, but heavy testing have been done to try and find what is happening.
here are two reports, a short one and a long one, detailing the issues the AI faced, please help solve this issue mainly with updating objects.
Short Summary
# Penpot API Integration Issues - Executive Summary
**Project:** Penpot MCP Server Integration
**Repository:** https://github.com/meywd/penpot-mcp
**Date:** January 2025
**Full Report:** [PENPOT_API_ISSUES_REPORT.md](./PENPOT_API_ISSUES_REPORT.md)
---
## Overview
While building a comprehensive MCP server for Penpot, we encountered significant API issues that impact reliability and developer experience. This summary highlights the **5 most critical problems** that need immediate attention.
---
## 🔴 Critical Issue #1: API Changes Don't Persist
**Problem:** API returns `200 OK` with `"success": true`, but changes are not visible when fetching the file again.
**Impact:** **Cannot reliably verify if operations work.** Makes it impossible to build production-ready integrations.
show original
Full report
# Penpot API Integration Issues Report
**Project:** Penpot MCP Server
**Repository:** https://github.com/meywd/penpot-mcp
**Date:** January 2025
**Report Author:** Development Team
## Executive Summary
This report documents critical issues, undocumented behaviors, and gotchas encountered while building a comprehensive MCP (Model Context Protocol) server for Penpot's API. These findings are based on extensive testing, debugging, and integration work over multiple days of development.
## Table of Contents
1. [Transit+JSON Format Inconsistencies](#1-transitjson-format-inconsistencies)
2. [Caching and Data Persistence Issues](#2-caching-and-data-persistence-issues)
3. [Object Naming and Field Convention Chaos](#3-object-naming-and-field-convention-chaos)
4. [Text Object Special Cases (Undocumented)](#4-text-object-special-cases-undocumented)
5. [Type Mismatch Silent Failures](#5-type-mismatch-silent-failures)
6. [Session and Revision Management Complexity](#6-session-and-revision-management-complexity)
7. [Browser Interference with API Operations](#7-browser-interference-with-api-operations)
show original
Only three weeks ago, during Penpot Fest 2025 , we unveiled the official MCP Server for Penpot (Github repo and 6-min presentation ). Unlike other community efforts (kudos to them!), we decided to expose the Plugins API as a privileged way to interact with a Penpot design.
Today we want to share some promising uses cases and comment on what’s coming next, but also ask the tinkerers out there to stress test these uses cases or come up with new ones.
We already knew, thanks to your b…
An MCP server to enable AI agents to work with Penpot designs
I have been hacking on a community version today, and just found that there is an official one now. I post this link in case others happen on these posts about a MCP.
1 Like
meywd
November 1, 2025, 11:34pm
3
Thanks, didn’t know about it
