Skip to content

fix(penpot-uiux-design): update setup for current Penpot MCP Server#1823

Closed
ar27111994 wants to merge 3 commits into
github:stagedfrom
ar27111994:fix/penpot-mcp-server-setup
Closed

fix(penpot-uiux-design): update setup for current Penpot MCP Server#1823
ar27111994 wants to merge 3 commits into
github:stagedfrom
ar27111994:fix/penpot-mcp-server-setup

Conversation

@ar27111994
Copy link
Copy Markdown

Fix: Update penpot-uiux-design for current Penpot MCP Server

The penpot-uiux-design skill's setup instructions are now outdated following the official Penpot MCP Server's 2025 updates. This PR makes three targeted fixes.

Changes

1. Quick Start: replace git clone with npx @penpot/mcp@stable + Remote MCP

The old setup cloned the repo and ran npm run bootstrap. The official distribution method is now npx @penpot/mcp@stable. More importantly, Penpot now offers a Remote MCP (hosted) option that most users should prefer — no local server needed, just a key from Penpot → Integrations. This is prominently documented at help.penpot.app/mcp but was missing from the skill entirely.

2. VS Code endpoint: /sse/mcp; add Claude Code config

The correct local endpoint is http://localhost:4401/mcp, not /sse. The /sse endpoint has changed. This PR also adds a Claude Code (mcpServers) config block since Claude Code is a major consumer of agent skills and wasn't covered.

3. Troubleshooting: add two Remote MCP rows

Adds entries for expired/invalid MCP key (common with the token-based Remote auth) and for the known limitation that import_image requires local MCP even when using the remote server.

Verification

All changes verified against the official documentation at https://help.penpot.app/mcp/ (fetched May 2026).

A more comprehensive Penpot MCP skill (with full JS API reference, design system workflow recipes, design-to-code workflows, and token-aware prompting patterns) is maintained at ar27111994/penpot-mcp for users who need the extended version.

Copilot AI review requested due to automatic review settings May 24, 2026 18:45
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot wasn't able to review any files in this pull request.

@github-actions github-actions Bot added the targets-main PR targets main instead of staged label May 24, 2026
Copy link
Copy Markdown
Contributor

@github-actions github-actions Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ This PR targets main, but PRs should target staged.

The main branch is auto-published from staged and should not receive direct PRs.
Please close this PR and re-open it against the staged branch.

You can change the base branch using the Edit button at the top of this PR,
or run: gh pr edit 1823 --base staged

@github-actions
Copy link
Copy Markdown
Contributor

🔴 Contributor Reputation Check: HIGH risk

Check Risk
Profile HIGH
Credential audit NONE

Maintainers: please review this contributor before merging.
See the workflow run for full details.
Automated check powered by AGT.

@github-actions github-actions Bot added the needs-review:HIGH Contributor reputation check flagged HIGH risk label May 24, 2026
@ar27111994 ar27111994 changed the base branch from main to staged May 24, 2026 18:46
@github-actions github-actions Bot added branched-main PR appears to include plugin files materialized from main and removed targets-main PR targets main instead of staged labels May 24, 2026
@github-actions
Copy link
Copy Markdown
Contributor

🔴 Contributor Reputation Check: HIGH risk

Check Risk
Profile HIGH
Credential audit NONE

Maintainers: please review this contributor before merging.
See the workflow run for full details.
Automated check powered by AGT.

@ar27111994 ar27111994 closed this May 24, 2026
@ar27111994 ar27111994 deleted the fix/penpot-mcp-server-setup branch May 24, 2026 18:49
@ar27111994 ar27111994 restored the fix/penpot-mcp-server-setup branch May 24, 2026 18:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

branched-main PR appears to include plugin files materialized from main needs-review:HIGH Contributor reputation check flagged HIGH risk

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants