From c6a69a688166cc2753a8e9d38232e7f7393d684f Mon Sep 17 00:00:00 2001 From: Stephen Haney Date: Sun, 8 Nov 2026 22:43:03 -0800 Subject: [PATCH 1/3] Add a Cursor manifest to the remote Paper plugin, for Grok Bot and cloud agents Grok Bot runs in the cloud and only attaches public HTTPS MCP servers with OAuth, so the local paper-desktop plugin can't reach it. The remote plugin now ships a .cursor-plugin manifest pointing at mcp.paper.design. Both plugins' descriptions steer Cursor IDE users to Paper Desktop, which stays the recommended local path. Co-authored-by: Cursor --- .cursor-plugin/marketplace.json | 9 +++++++-- README.md | 9 +++++++++ plugins/paper-desktop/.cursor-plugin/plugin.json | 6 +++--- plugins/paper/.cursor-plugin/plugin.json | 16 ++++++++++++++++ plugins/paper/README.md | 4 ++-- plugins/paper/mcp.cursor.json | 7 +++++++ 6 files changed, 44 insertions(+), 7 deletions(-) create mode 100644 plugins/paper/.cursor-plugin/plugin.json create mode 100644 plugins/paper/mcp.cursor.json diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json index ffea8f0..bcf9723 100644 --- a/.cursor-plugin/marketplace.json +++ b/.cursor-plugin/marketplace.json @@ -6,13 +6,18 @@ }, "metadata": { "description": "Paper connects your teams, agents, code, and data on a single design space built on web standards.", - "version": "0.1.0" + "version": "0.2.0" }, "plugins": [ { "name": "paper-desktop", "source": "./plugins/paper-desktop", - "description": "Connect to Paper Desktop using its MCP server." + "description": "For the Cursor IDE with Paper Desktop installed: connect to the running app's local MCP server." + }, + { + "name": "paper", + "source": "./plugins/paper", + "description": "For Grok Bot, cloud agents, and Cursor without Paper Desktop: connect to Paper's hosted MCP server." } ] } diff --git a/README.md b/README.md index f915c8f..ad07a9b 100644 --- a/README.md +++ b/README.md @@ -13,6 +13,11 @@ The `paper` plugin connects to Paper's hosted MCP server (`https://mcp.paper.des ## Cursor +Two plugins, pick by where the agent runs: + +- **Paper Desktop** (`paper-desktop`): for the Cursor IDE with Paper Desktop installed. Talks to the running app over a local MCP server; fastest and most reliable, and it works on the file you have open. +- **Paper (remote)** (`paper`): for Grok Bot, cloud agents, and Cursor without Paper Desktop. Connects to `https://mcp.paper.design` and signs in with your Paper account. + ```sh /add-plugin paper-desktop ``` @@ -20,6 +25,10 @@ The `paper` plugin connects to Paper's hosted MCP server (`https://mcp.paper.des - [View on Cursor Marketplace](https://cursor.com/marketplace/paper) - [Read more about installing Cursor plugins](https://cursor.com/docs/plugins#installing-plugins) +## Grok Bot + +Grok Bot runs in the cloud, so only the remote plugin applies. Install **Paper (remote)** from Connect Apps, or tell your bot: "Add this MCP server: https://mcp.paper.design". + ## Claude Code **Add the custom marketplace** diff --git a/plugins/paper-desktop/.cursor-plugin/plugin.json b/plugins/paper-desktop/.cursor-plugin/plugin.json index b6a5aed..695b4eb 100644 --- a/plugins/paper-desktop/.cursor-plugin/plugin.json +++ b/plugins/paper-desktop/.cursor-plugin/plugin.json @@ -1,8 +1,8 @@ { "name": "paper-desktop", - "displayName": "Paper", - "version": "0.2.2", - "description": "Design on a canvas that Cursor can read and write to — built on web standards.", + "displayName": "Paper Desktop", + "version": "0.2.3", + "description": "Design on a canvas that Cursor can read and write to — built on web standards. Connects to Paper Desktop running on this machine: the fastest, most reliable way to use Paper from the Cursor IDE. Running in the cloud or without the desktop app? Use the Paper (remote) plugin.", "author": { "name": "Paper", "email": "team@paper.design" diff --git a/plugins/paper/.cursor-plugin/plugin.json b/plugins/paper/.cursor-plugin/plugin.json new file mode 100644 index 0000000..effb549 --- /dev/null +++ b/plugins/paper/.cursor-plugin/plugin.json @@ -0,0 +1,16 @@ +{ + "name": "paper", + "displayName": "Paper (remote)", + "version": "1.0.0", + "description": "Paper's hosted MCP server, for Grok Bot, cloud agents, and Cursor without Paper Desktop. If you have Paper Desktop installed, use the Paper Desktop plugin instead: it is faster and works on the file you have open.", + "author": { + "name": "Paper", + "email": "team@paper.design" + }, + "homepage": "https://paper.design", + "repository": "https://github.com/paper-design/agent-plugins", + "license": "MIT", + "keywords": ["cursor", "grok-bot", "plugin", "mcp", "design", "remote"], + "logo": "./assets/logo.png", + "mcpServers": "./mcp.cursor.json" +} diff --git a/plugins/paper/README.md b/plugins/paper/README.md index 1ae6010..7758a25 100644 --- a/plugins/paper/README.md +++ b/plugins/paper/README.md @@ -13,8 +13,8 @@ No desktop install is required: everything runs through the remote server. **Install** -- From the Plugin Directory: search for "Paper" in ChatGPT Plugins and install it, then sign in with your Paper account when prompted. -- Manually, before it is listed: in ChatGPT go to Plugins, select the plus button, then Add custom MCP server. Use `https://mcp.paper.design` as the server URL with OAuth authentication. +- ChatGPT / Codex: search for "Paper" in the Plugin Directory and install it, then sign in with your Paper account when prompted. Before it is listed: Plugins, the plus button, Add custom MCP server, URL `https://mcp.paper.design`, OAuth authentication. +- Cursor / Grok Bot: install **Paper (remote)** from the Cursor Marketplace or Connect Apps. In the Cursor IDE with Paper Desktop installed, prefer the **Paper Desktop** plugin instead; it is faster and acts on the file you have open. **Package layout** diff --git a/plugins/paper/mcp.cursor.json b/plugins/paper/mcp.cursor.json new file mode 100644 index 0000000..44b66ea --- /dev/null +++ b/plugins/paper/mcp.cursor.json @@ -0,0 +1,7 @@ +{ + "mcpServers": { + "paper": { + "url": "https://mcp.paper.design" + } + } +} From 2c84c56cdbc8af69081e28d5b83aa5587b3c936e Mon Sep 17 00:00:00 2001 From: Stephen Haney Date: Tue, 10 Nov 2026 00:02:13 -0800 Subject: [PATCH 2/3] Cursor: use the app icon for paper-desktop, matching the remote plugin The flat SVG mark was showing in Cursor where the app icon used to; the icon people saw before was the publisher logo on our marketplace profile, not anything in this repo. Co-authored-by: Cursor --- plugins/paper-desktop/.cursor-plugin/plugin.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugins/paper-desktop/.cursor-plugin/plugin.json b/plugins/paper-desktop/.cursor-plugin/plugin.json index 695b4eb..3ab04db 100644 --- a/plugins/paper-desktop/.cursor-plugin/plugin.json +++ b/plugins/paper-desktop/.cursor-plugin/plugin.json @@ -9,6 +9,6 @@ }, "license": "MIT", "keywords": ["cursor", "plugin", "mcp"], - "logo": "./assets/logo.svg", + "logo": "./assets/logo@1024w.png", "mcpServers": "./mcp.cursor.json" } From 927d657ea27b0afed890d63f28081b1fea11af09 Mon Sep 17 00:00:00 2001 From: Stephen Haney Date: Tue, 10 Nov 2026 08:17:20 -0800 Subject: [PATCH 3/3] Cursor display names: Paper Desktop (local) and Paper (remote) Co-authored-by: Cursor --- README.md | 4 ++-- plugins/paper-desktop/.cursor-plugin/plugin.json | 2 +- plugins/paper/.cursor-plugin/plugin.json | 2 +- plugins/paper/README.md | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index ad07a9b..b5a5f9f 100644 --- a/README.md +++ b/README.md @@ -16,7 +16,7 @@ The `paper` plugin connects to Paper's hosted MCP server (`https://mcp.paper.des Two plugins, pick by where the agent runs: - **Paper Desktop** (`paper-desktop`): for the Cursor IDE with Paper Desktop installed. Talks to the running app over a local MCP server; fastest and most reliable, and it works on the file you have open. -- **Paper (remote)** (`paper`): for Grok Bot, cloud agents, and Cursor without Paper Desktop. Connects to `https://mcp.paper.design` and signs in with your Paper account. +- **Paper** (`paper`): for Grok Bot, cloud agents, and Cursor without Paper Desktop. Connects to `https://mcp.paper.design` and signs in with your Paper account. ```sh /add-plugin paper-desktop @@ -27,7 +27,7 @@ Two plugins, pick by where the agent runs: ## Grok Bot -Grok Bot runs in the cloud, so only the remote plugin applies. Install **Paper (remote)** from Connect Apps, or tell your bot: "Add this MCP server: https://mcp.paper.design". +Grok Bot runs in the cloud, so only the remote plugin applies. Install **Paper** from Connect Apps, or tell your bot: "Add this MCP server: https://mcp.paper.design". ## Claude Code diff --git a/plugins/paper-desktop/.cursor-plugin/plugin.json b/plugins/paper-desktop/.cursor-plugin/plugin.json index 3ab04db..67840ee 100644 --- a/plugins/paper-desktop/.cursor-plugin/plugin.json +++ b/plugins/paper-desktop/.cursor-plugin/plugin.json @@ -2,7 +2,7 @@ "name": "paper-desktop", "displayName": "Paper Desktop", "version": "0.2.3", - "description": "Design on a canvas that Cursor can read and write to — built on web standards. Connects to Paper Desktop running on this machine: the fastest, most reliable way to use Paper from the Cursor IDE. Running in the cloud or without the desktop app? Use the Paper (remote) plugin.", + "description": "Design on a canvas that Cursor can read and write to — built on web standards. Connects to Paper Desktop running on this machine: the fastest, most reliable way to use Paper from the Cursor IDE. Running in the cloud or without the desktop app? Use the Paper plugin.", "author": { "name": "Paper", "email": "team@paper.design" diff --git a/plugins/paper/.cursor-plugin/plugin.json b/plugins/paper/.cursor-plugin/plugin.json index effb549..b7d775b 100644 --- a/plugins/paper/.cursor-plugin/plugin.json +++ b/plugins/paper/.cursor-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "paper", - "displayName": "Paper (remote)", + "displayName": "Paper", "version": "1.0.0", "description": "Paper's hosted MCP server, for Grok Bot, cloud agents, and Cursor without Paper Desktop. If you have Paper Desktop installed, use the Paper Desktop plugin instead: it is faster and works on the file you have open.", "author": { diff --git a/plugins/paper/README.md b/plugins/paper/README.md index 7758a25..87bff16 100644 --- a/plugins/paper/README.md +++ b/plugins/paper/README.md @@ -14,7 +14,7 @@ No desktop install is required: everything runs through the remote server. **Install** - ChatGPT / Codex: search for "Paper" in the Plugin Directory and install it, then sign in with your Paper account when prompted. Before it is listed: Plugins, the plus button, Add custom MCP server, URL `https://mcp.paper.design`, OAuth authentication. -- Cursor / Grok Bot: install **Paper (remote)** from the Cursor Marketplace or Connect Apps. In the Cursor IDE with Paper Desktop installed, prefer the **Paper Desktop** plugin instead; it is faster and acts on the file you have open. +- Cursor / Grok Bot: install **Paper** from the Cursor Marketplace or Connect Apps. In the Cursor IDE with Paper Desktop installed, prefer the **Paper Desktop** plugin instead; it is faster and acts on the file you have open. **Package layout**