Skip to content

AI-native design editor. Open-source Figma alternative.

docs: update MCP setup and landing screenshot

Danila Poyarkove3d6056bf548
diff --git a/README.md b/README.md
index cb05394f8..98ea8cecd 100644
--- a/README.md
+++ b/README.md
@@ -159,12 +159,12 @@ Use Claude Code, Codex, or Gemini CLI directly in the chat panel. The agent conn
**Setup (Claude Code):**
-1. Install the ACP adapter: `npm i -g @agentclientprotocol/claude-agent-acp`
+1. Install the ACP adapter: `npm install -g @agentclientprotocol/claude-agent-acp`
2. Add MCP permission to `~/.claude/settings.json`:
```json
{
"permissions": {
- "allow": ["mcp__open-pencil"]
+ "allow": ["mcp__open-pencil__*"]
}
}
```
@@ -177,9 +177,12 @@ Connect Claude Code, Cursor, Windsurf, or any MCP client to inspect, modify, and
**Stdio** (Claude Code, Cursor, Windsurf):
```sh
-bun add -g @open-pencil/mcp
+npm install -g @open-pencil/mcp
+claude mcp add --scope user open-pencil -- openpencil-mcp
```
+For other MCP clients:
+
```json
{
"mcpServers": {
diff --git a/packages/docs/de/guide/features.md b/packages/docs/de/guide/features.md
index 939677efd..446fabc39 100644
--- a/packages/docs/de/guide/features.md
+++ b/packages/docs/de/guide/features.md
@@ -76,7 +76,7 @@ Siehe [KI-Chat](/programmable/ai-chat) für Einrichtung und Anbieter-Details.
Claude Code, Cursor, Windsurf oder jeden MCP-Client verbinden, um `.fig`-Dateien headless zu lesen und zu schreiben. 90+ Werkzeuge. Zwei Transporte: stdio und HTTP.
```sh
-bun add -g @open-pencil/mcp
+npm install -g @open-pencil/mcp
```
```json
diff --git a/packages/docs/de/programmable/mcp-server.md b/packages/docs/de/programmable/mcp-server.md
index d6d4fad71..8c0e0bdd8 100644
--- a/packages/docs/de/programmable/mcp-server.md
+++ b/packages/docs/de/programmable/mcp-server.md
@@ -7,7 +7,7 @@ Two transports: **stdio** for MCP clients, **HTTP** for everything else.
## Install
```sh
-bun add -g @open-pencil/mcp
+npm install -g @open-pencil/mcp
```
## Stdio (Claude Code, Cursor, etc.)
diff --git a/packages/docs/es/guide/features.md b/packages/docs/es/guide/features.md
index 22eccbe20..caa106921 100644
--- a/packages/docs/es/guide/features.md
+++ b/packages/docs/es/guide/features.md
@@ -76,7 +76,7 @@ Ver [Chat IA](/programmable/ai-chat) para configuración y detalles de proveedor
Conecta Claude Code, Cursor, Windsurf, o cualquier cliente MCP para leer y escribir archivos `.fig` de forma headless. 90+ herramientas. Dos transportes: stdio y HTTP.
```sh
-bun add -g @open-pencil/mcp
+npm install -g @open-pencil/mcp
```
```json
diff --git a/packages/docs/es/programmable/mcp-server.md b/packages/docs/es/programmable/mcp-server.md
index d6d4fad71..8c0e0bdd8 100644
--- a/packages/docs/es/programmable/mcp-server.md
+++ b/packages/docs/es/programmable/mcp-server.md
@@ -7,7 +7,7 @@ Two transports: **stdio** for MCP clients, **HTTP** for everything else.
## Install
```sh
-bun add -g @open-pencil/mcp
+npm install -g @open-pencil/mcp
```
## Stdio (Claude Code, Cursor, etc.)
diff --git a/packages/docs/fr/guide/features.md b/packages/docs/fr/guide/features.md
index 8cdfcc3e5..37bfddd0d 100644
--- a/packages/docs/fr/guide/features.md
+++ b/packages/docs/fr/guide/features.md
@@ -76,7 +76,7 @@ Voir [Chat IA](/programmable/ai-chat) pour la configuration et les détails des
Connectez Claude Code, Cursor, Windsurf ou tout client MCP pour lire et écrire des fichiers `.fig` en mode headless. 90+ outils. Deux transports : stdio et HTTP.
```sh
-bun add -g @open-pencil/mcp
+npm install -g @open-pencil/mcp
```
```json
diff --git a/packages/docs/fr/programmable/mcp-server.md b/packages/docs/fr/programmable/mcp-server.md
index d6d4fad71..8c0e0bdd8 100644
--- a/packages/docs/fr/programmable/mcp-server.md
+++ b/packages/docs/fr/programmable/mcp-server.md
@@ -7,7 +7,7 @@ Two transports: **stdio** for MCP clients, **HTTP** for everything else.
## Install
```sh
-bun add -g @open-pencil/mcp
+npm install -g @open-pencil/mcp
```
## Stdio (Claude Code, Cursor, etc.)
diff --git a/packages/docs/guide/features.md b/packages/docs/guide/features.md
index 48456e30c..38d490803 100644
--- a/packages/docs/guide/features.md
+++ b/packages/docs/guide/features.md
@@ -76,7 +76,7 @@ See [AI Chat](/programmable/ai-chat) for setup and provider details.
Connect Claude Code, Cursor, Windsurf, or any MCP client to read and write `.fig` files headlessly. 90+ tools. Two transports: stdio and HTTP.
```sh
-bun add -g @open-pencil/mcp
+npm install -g @open-pencil/mcp
```
```json
diff --git a/packages/docs/it/guide/features.md b/packages/docs/it/guide/features.md
index 6e1a363d4..206aa7e5f 100644
--- a/packages/docs/it/guide/features.md
+++ b/packages/docs/it/guide/features.md
@@ -76,7 +76,7 @@ Vedi [Chat AI](/programmable/ai-chat) per configurazione e dettagli sui provider
Connetti Claude Code, Cursor, Windsurf o qualsiasi client MCP per leggere e scrivere file `.fig` in modalità headless. 90+ strumenti. Due trasporti: stdio e HTTP.
```sh
-bun add -g @open-pencil/mcp
+npm install -g @open-pencil/mcp
```
```json
diff --git a/packages/docs/it/programmable/mcp-server.md b/packages/docs/it/programmable/mcp-server.md
index d6d4fad71..8c0e0bdd8 100644
--- a/packages/docs/it/programmable/mcp-server.md
+++ b/packages/docs/it/programmable/mcp-server.md
@@ -7,7 +7,7 @@ Two transports: **stdio** for MCP clients, **HTTP** for everything else.
## Install
```sh
-bun add -g @open-pencil/mcp
+npm install -g @open-pencil/mcp
```
## Stdio (Claude Code, Cursor, etc.)
diff --git a/packages/docs/pl/guide/features.md b/packages/docs/pl/guide/features.md
index 95f7257cd..b782abd4c 100644
--- a/packages/docs/pl/guide/features.md
+++ b/packages/docs/pl/guide/features.md
@@ -76,7 +76,7 @@ Zobacz [Czat AI](/programmable/ai-chat) dla konfiguracji i szczegółów dostawc
Podłącz Claude Code, Cursor, Windsurf lub dowolnego klienta MCP do odczytu i zapisu plików `.fig` headlessly. 90+ narzędzi. Dwa transporty: stdio i HTTP.
```sh
-bun add -g @open-pencil/mcp
+npm install -g @open-pencil/mcp
```
```json
diff --git a/packages/docs/pl/programmable/mcp-server.md b/packages/docs/pl/programmable/mcp-server.md
index d6d4fad71..8c0e0bdd8 100644
--- a/packages/docs/pl/programmable/mcp-server.md
+++ b/packages/docs/pl/programmable/mcp-server.md
@@ -7,7 +7,7 @@ Two transports: **stdio** for MCP clients, **HTTP** for everything else.
## Install
```sh
-bun add -g @open-pencil/mcp
+npm install -g @open-pencil/mcp
```
## Stdio (Claude Code, Cursor, etc.)
diff --git a/packages/docs/programmable/mcp-server.md b/packages/docs/programmable/mcp-server.md
index cbe70bc50..1123c05c7 100644
--- a/packages/docs/programmable/mcp-server.md
+++ b/packages/docs/programmable/mcp-server.md
@@ -7,12 +7,49 @@ Two transports: **stdio** for MCP clients, **HTTP** for browser extensions and s
## Install
```sh
-bun add -g @open-pencil/mcp
+npm install -g @open-pencil/mcp
```
## Stdio (Claude Code, Cursor, etc.)
-Add to your MCP config (e.g. `~/.claude/settings.json` or `.cursor/mcp.json`):
+The stdio server connects to the running OpenPencil app via WebSocket (port 7601). Make sure the desktop app is open with a document loaded.
+
+### Claude Code
+
+Install the MCP package and register it with Claude Code:
+
+```sh
+npm install -g @open-pencil/mcp
+claude mcp add --scope user open-pencil -- openpencil-mcp
+```
+
+Check the connection:
+
+```sh
+claude mcp list
+```
+
+Claude Code asks before using each MCP tool unless you allow the server's tools. To auto-approve OpenPencil tools only, add this to `~/.claude/settings.json`:
+
+```json
+{
+ "permissions": {
+ "allow": ["mcp__open-pencil__*"]
+ }
+}
+```
+
+This is narrower than `--permission-mode bypassPermissions`, which skips prompts for every tool. You can also approve tools interactively from Claude's prompt by choosing “Yes, and don't ask again”.
+
+Example prompt:
+
+```text
+Use the open-pencil MCP server to inspect the current page and create a small hero section on the canvas.
+```
+
+### Other MCP clients
+
+Add to your MCP config (for example `.cursor/mcp.json`):
```json
{
@@ -24,8 +61,6 @@ Add to your MCP config (e.g. `~/.claude/settings.json` or `.cursor/mcp.json`):
}
```
-The stdio server connects to the running OpenPencil app via WebSocket (port 7601). Make sure the app is open with a document loaded.
-
Or run from source without installing:
::: code-group
diff --git a/packages/docs/public/screenshot.png b/packages/docs/public/screenshot.png
index ccd14bcb4..dcbe2555c 100644
Binary files a/packages/docs/public/screenshot.png and b/packages/docs/public/screenshot.png differ
diff --git a/packages/docs/ru/guide/features.md b/packages/docs/ru/guide/features.md
index 9c3a407c8..3c06e1d69 100644
--- a/packages/docs/ru/guide/features.md
+++ b/packages/docs/ru/guide/features.md
@@ -76,7 +76,7 @@ CLI: `open-pencil export design.fig -f jsx --style tailwind`
Подключайте Claude Code, Cursor, Windsurf или любой MCP-клиент для чтения и записи файлов `.fig` в headless-режиме. 90+ инструментов. Два транспорта: stdio и HTTP.
```sh
-bun add -g @open-pencil/mcp
+npm install -g @open-pencil/mcp
```
```json
diff --git a/packages/docs/ru/programmable/mcp-server.md b/packages/docs/ru/programmable/mcp-server.md
index d6d4fad71..8c0e0bdd8 100644
--- a/packages/docs/ru/programmable/mcp-server.md
+++ b/packages/docs/ru/programmable/mcp-server.md
@@ -7,7 +7,7 @@ Two transports: **stdio** for MCP clients, **HTTP** for everything else.
## Install
```sh
-bun add -g @open-pencil/mcp
+npm install -g @open-pencil/mcp
```
## Stdio (Claude Code, Cursor, etc.)