From 8b67cbf21d658b22250996138f57d264a415d41f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fatih=20Kadir=20Ak=C4=B1n?= Date: Fri, 23 Oct 2026 12:44:47 +0000 Subject: [PATCH 1/7] Lead the Claude Desktop guide with the Claude plugin marketplace The desktop extension spawns npx and fails when Claude Desktop can't find it. Recommend adding spacefast/plugins through Customize -> Plugins, keep the connector as a fallback, and document the extension's Node.js requirement and its spawn npx ENOENT failure. --- content/agents/claude-desktop.mdx | 51 +++++++++++++++++++++++-------- 1 file changed, 38 insertions(+), 13 deletions(-) diff --git a/content/agents/claude-desktop.mdx b/content/agents/claude-desktop.mdx index da3a9cb..bfc5dab 100644 --- a/content/agents/claude-desktop.mdx +++ b/content/agents/claude-desktop.mdx @@ -1,27 +1,34 @@ --- title: Claude Desktop -description: Install the Spacefast desktop extension for Claude Desktop, or paste the hosted MCP server into your config +description: Add the Spacefast plugin to Claude Desktop, or install the local desktop extension --- -The Spacefast desktop extension lets Claude Desktop publish files and read your Spaces directly. +Add Spacefast to Claude Desktop so it can publish files and read your Spaces. The plugin is the recommended way. The desktop extension runs the server on your computer instead. -## Install the extension +## Add the Spacefast plugin -Download `claude-desktop.mcpb` from the latest release of `github.com/spacefast/plugins` and open it. Claude Desktop installs it as a desktop extension. +The plugin carries the hosted Spacefast MCP server and the Spacefast skills. You add it once to your Claude account, so it works in the Chat and Cowork tabs, on claude.ai, and in Claude Code signed in with the same account. - - Grab `claude-desktop.mcpb` from the releases page. + + In Claude, open Customize → Plugins, then choose Add → Add marketplace → Add from a repository. - - Claude Desktop reads the manifest and offers to install the extension. + + Paste `spacefast/plugins` and add the marketplace. - - The extension has one setting, a Spacefast API key. Leave it empty to publish anonymously and claim the Space later. + + Select the Spacefast plugin, then choose Add. + + + Sign in to Spacefast and approve access when Claude asks. -Then ask for something small to prove the extension is live. +Plugins need a paid Claude plan. On a Team or Enterprise plan, an owner may limit which marketplaces you can add. See [Use plugins in Claude](https://support.claude.com/en/articles/13837440-use-plugins-in-claude). + +You can also add only the connector: on claude.ai, open Customize → Connectors, choose + → Add custom connector, name it Spacefast, and use `https://mcp.spacefast.com` as its URL. + +Then ask for something small to prove Spacefast is connected. Publish this folder to Spacefast and give me the live URL. @@ -31,6 +38,24 @@ Publish this folder to Spacefast and give me the live URL. List my Spacefast Spaces. +## Install the desktop extension + +The extension runs the Spacefast MCP server on your computer, so `publish` can read local files. It starts the server with `npx`, so it needs Node.js 20 or newer with `npx` installed where Claude Desktop can find it. + + + + Download `claude-desktop.mcpb` from the latest release of `github.com/spacefast/plugins`. + + + Claude Desktop reads the manifest and offers to install the extension. + + + The extension has one setting, a Spacefast API key. Leave it empty to publish anonymously and claim the Space later. + + + +If Claude Desktop shows "Server disconnected" or "Unable to connect to extension server", open `~/Library/Logs/Claude/mcp-server-Spacefast.log` on macOS. `spawn npx ENOENT` means Claude Desktop cannot find `npx`. This happens when Node.js comes from Homebrew, nvm, or another version manager. Use the plugin instead. + ## What the manifest declares The bundle is a manifest version `0.2` extension with a Node server. Its entry point is `server/index.js`, which is a thin spawner. It launches the Spacefast MCP server over stdio through `npx`, so the extension itself carries no server code. @@ -83,8 +108,8 @@ If you would rather connect to the hosted endpoint and sign in with OAuth, add t } ``` -The hosted server has no filesystem, so `publish` requires inline files. Connectors you add on claude.ai sync down to Desktop; the bundle is the desktop-only lane. +The hosted server has no filesystem, so `publish` requires inline files. Plugins and connectors you add to your Claude account sync down to Desktop; the bundle is the desktop-only lane. :::note -`sf setup agent --agent claude-desktop` writes nothing. Claude Desktop is not one of the clients the CLI knows how to configure. Use the extension or the config file above. +`sf setup agent --agent claude-desktop` writes nothing. Claude Desktop is not one of the clients the CLI knows how to configure. Use the plugin, the extension, or the config file above. ::: From 1ef86231d45d1a8c9edabf3e811b47fe776647a8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fatih=20Kadir=20Ak=C4=B1n?= Date: Fri, 23 Oct 2026 12:48:18 +0000 Subject: [PATCH 2/7] Fix Vale spelling alert and state the 20.3 Node minimum --- content/agents/claude-desktop.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/agents/claude-desktop.mdx b/content/agents/claude-desktop.mdx index bfc5dab..fe56d8e 100644 --- a/content/agents/claude-desktop.mdx +++ b/content/agents/claude-desktop.mdx @@ -40,7 +40,7 @@ List my Spacefast Spaces. ## Install the desktop extension -The extension runs the Spacefast MCP server on your computer, so `publish` can read local files. It starts the server with `npx`, so it needs Node.js 20 or newer with `npx` installed where Claude Desktop can find it. +The extension runs the Spacefast MCP server on your computer, so `publish` can read local files. It starts the server with `npx`, so it needs Node.js 20.3 or newer with `npx` installed where Claude Desktop can find it. @@ -54,7 +54,7 @@ The extension runs the Spacefast MCP server on your computer, so `publish` can r -If Claude Desktop shows "Server disconnected" or "Unable to connect to extension server", open `~/Library/Logs/Claude/mcp-server-Spacefast.log` on macOS. `spawn npx ENOENT` means Claude Desktop cannot find `npx`. This happens when Node.js comes from Homebrew, nvm, or another version manager. Use the plugin instead. +If Claude Desktop shows "Server disconnected" or "Unable to connect to extension server", open `~/Library/Logs/Claude/mcp-server-Spacefast.log` on macOS. `spawn npx ENOENT` means Claude Desktop cannot find `npx`. This happens when Node.js comes from Homebrew or a Node version manager. Use the plugin instead. ## What the manifest declares @@ -77,7 +77,7 @@ Because the server runs locally, it can read files. `publish` takes a path or th | Manifest version | `0.2` | | Server type | `node` | | Platforms | macOS, Windows, Linux | -| Node | 20 or newer | +| Node | 20.3 or newer | | License | MIT | | Tools declared | The nine Spacefast MCP tools | From 388a56d0ea5479871feb4763e2fc69253f0e51bd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fatih=20Kadir=20Ak=C4=B1n?= Date: Fri, 23 Oct 2026 12:48:28 +0000 Subject: [PATCH 3/7] Match the agents index card to the Claude Desktop guide --- content/agents/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/agents/index.mdx b/content/agents/index.mdx index cb220d0..5949268 100644 --- a/content/agents/index.mdx +++ b/content/agents/index.mdx @@ -93,7 +93,7 @@ The default connection method is `remote-proxy`, which points your client at `sf Plugin with an always-available rule, or a one-click deeplink. - A double-click desktop extension with an optional token field. + The Spacefast plugin from the Claude marketplace, or a local desktop extension. The stdio command, the hosted URL, and generic JSON config. From 50beff3725d52ac78f6855970890f140dab366e2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fatih=20Kadir=20Ak=C4=B1n?= Date: Fri, 23 Oct 2026 12:49:34 +0000 Subject: [PATCH 4/7] Quote the manifest's Node range and note the CLI minimum --- content/agents/claude-desktop.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/agents/claude-desktop.mdx b/content/agents/claude-desktop.mdx index fe56d8e..b21f602 100644 --- a/content/agents/claude-desktop.mdx +++ b/content/agents/claude-desktop.mdx @@ -77,7 +77,7 @@ Because the server runs locally, it can read files. `publish` takes a path or th | Manifest version | `0.2` | | Server type | `node` | | Platforms | macOS, Windows, Linux | -| Node | 20.3 or newer | +| Node | 20 or newer (the CLI it launches needs 20.3 or newer) | | License | MIT | | Tools declared | The nine Spacefast MCP tools | From 84a72aca3eda21aba29d167cbcbe2a109f38b34c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fatih=20Kadir=20Ak=C4=B1n?= Date: Fri, 23 Oct 2026 12:57:32 +0000 Subject: [PATCH 5/7] Note the owner requirement for the connector fallback --- content/agents/claude-desktop.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/agents/claude-desktop.mdx b/content/agents/claude-desktop.mdx index b21f602..a89c568 100644 --- a/content/agents/claude-desktop.mdx +++ b/content/agents/claude-desktop.mdx @@ -26,7 +26,7 @@ The plugin carries the hosted Spacefast MCP server and the Spacefast skills. You Plugins need a paid Claude plan. On a Team or Enterprise plan, an owner may limit which marketplaces you can add. See [Use plugins in Claude](https://support.claude.com/en/articles/13837440-use-plugins-in-claude). -You can also add only the connector: on claude.ai, open Customize → Connectors, choose + → Add custom connector, name it Spacefast, and use `https://mcp.spacefast.com` as its URL. +You can also add only the connector: on claude.ai, open Customize → Connectors, choose + → Add custom connector, name it Spacefast, and use `https://mcp.spacefast.com` as its URL. On a Team or Enterprise plan, an owner has to add the connector first. Then ask for something small to prove Spacefast is connected. From 528b06a6a630417f29e6c66725f5de6e87270bed Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fatih=20Kadir=20Ak=C4=B1n?= Date: Fri, 23 Oct 2026 12:59:01 +0000 Subject: [PATCH 6/7] Lead the Claude Desktop guide with the connector The plugin loads its skills but does not connect its Spacefast connector in chat yet, so the custom connector is the setup that works today. Keep the plugin as the second option, use a verification prompt that works without local files, and state that folder publishing by path needs the Linux sf build. --- content/agents/claude-desktop.mdx | 56 ++++++++++++++++++++----------- content/agents/index.mdx | 2 +- 2 files changed, 37 insertions(+), 21 deletions(-) diff --git a/content/agents/claude-desktop.mdx b/content/agents/claude-desktop.mdx index a89c568..5a24b48 100644 --- a/content/agents/claude-desktop.mdx +++ b/content/agents/claude-desktop.mdx @@ -1,46 +1,62 @@ --- title: Claude Desktop -description: Add the Spacefast plugin to Claude Desktop, or install the local desktop extension +description: Connect Claude Desktop to Spacefast with the hosted connector, the Spacefast plugin, or the local desktop extension --- -Add Spacefast to Claude Desktop so it can publish files and read your Spaces. The plugin is the recommended way. The desktop extension runs the server on your computer instead. +Add Spacefast to Claude Desktop so it can publish and read your Spaces. The connector is the recommended way. The desktop extension runs the server on your computer instead. -## Add the Spacefast plugin +## Add the Spacefast connector -The plugin carries the hosted Spacefast MCP server and the Spacefast skills. You add it once to your Claude account, so it works in the Chat and Cowork tabs, on claude.ai, and in Claude Code signed in with the same account. +The connector is the hosted Spacefast MCP server. You add it once to your Claude account, so it works in the desktop app, on claude.ai, and on your phone. - - In Claude, open Customize → Plugins, then choose Add → Add marketplace → Add from a repository. + + On claude.ai or in Claude Desktop, open Customize → Connectors, then choose + → Add custom connector. - - Paste `spacefast/plugins` and add the marketplace. + + Name it Spacefast and use `https://mcp.spacefast.com` as its URL. - - Select the Spacefast plugin, then choose Add. + + Choose Connect, then sign in to Spacefast and approve access. - - Sign in to Spacefast and approve access when Claude asks. + + Turn Spacefast on for the conversation you want to use it in. -Plugins need a paid Claude plan. On a Team or Enterprise plan, an owner may limit which marketplaces you can add. See [Use plugins in Claude](https://support.claude.com/en/articles/13837440-use-plugins-in-claude). - -You can also add only the connector: on claude.ai, open Customize → Connectors, choose + → Add custom connector, name it Spacefast, and use `https://mcp.spacefast.com` as its URL. On a Team or Enterprise plan, an owner has to add the connector first. +On a Team or Enterprise plan, an owner has to add the connector first. Then ask for something small to prove Spacefast is connected. - -Publish this folder to Spacefast and give me the live URL. + +Make a one-page site that says hello and publish it to Spacefast. Give me the link. List my Spacefast Spaces. +## Add the Spacefast plugin + +The plugin adds the Spacefast skills and the hosted connector to your Claude account, for the Chat and Cowork tabs and for Claude Code signed in with the same account. + + + + In Claude, open Customize → Plugins, then choose Add → Add marketplace → Add from a repository. + + + Paste `spacefast/plugins` and add the marketplace. + + + Select the Spacefast plugin, then choose Add. + + + +If Claude says the Spacefast connector isn't connected, add the connector as described above. Plugins need a paid Claude plan, and on a Team or Enterprise plan an owner may limit which marketplaces you can add. See [Use plugins in Claude](https://support.claude.com/en/articles/13837440-use-plugins-in-claude). + ## Install the desktop extension -The extension runs the Spacefast MCP server on your computer, so `publish` can read local files. It starts the server with `npx`, so it needs Node.js 20.3 or newer with `npx` installed where Claude Desktop can find it. +The extension runs the Spacefast MCP server on your computer. Publishing a local folder by path needs the native Linux `sf` build; on macOS and Windows, publish inline files or use the [CLI](/cli). It starts the server with `npx`, so it needs Node.js 20.3 or newer with `npx` installed where Claude Desktop can find it. @@ -54,7 +70,7 @@ The extension runs the Spacefast MCP server on your computer, so `publish` can r -If Claude Desktop shows "Server disconnected" or "Unable to connect to extension server", open `~/Library/Logs/Claude/mcp-server-Spacefast.log` on macOS. `spawn npx ENOENT` means Claude Desktop cannot find `npx`. This happens when Node.js comes from Homebrew or a Node version manager. Use the plugin instead. +If Claude Desktop shows "Server disconnected" or "Unable to connect to extension server", open `~/Library/Logs/Claude/mcp-server-Spacefast.log` on macOS. `spawn npx ENOENT` means Claude Desktop cannot find `npx`. This happens when Node.js comes from Homebrew or a Node version manager. Use the connector instead. ## What the manifest declares @@ -70,7 +86,7 @@ The bundle is a manifest version `0.2` extension with a Node server. Its entry p } ``` -Because the server runs locally, it can read files. `publish` takes a path or the current directory, not only inline files. +The server runs locally, but publishing a folder by path needs the native Linux `sf` build. On macOS and Windows, `publish` takes inline files; use the CLI for a local folder. | Fact | Value | |---|---| diff --git a/content/agents/index.mdx b/content/agents/index.mdx index 5949268..dfd1cbc 100644 --- a/content/agents/index.mdx +++ b/content/agents/index.mdx @@ -93,7 +93,7 @@ The default connection method is `remote-proxy`, which points your client at `sf Plugin with an always-available rule, or a one-click deeplink. - The Spacefast plugin from the Claude marketplace, or a local desktop extension. + The hosted connector, the Spacefast plugin, or a local desktop extension. The stdio command, the hosted URL, and generic JSON config. From 0c3a1c37d32de7a97131c8fc7a8a99ca1de5b373 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fatih=20Kadir=20Ak=C4=B1n?= Date: Fri, 23 Oct 2026 13:05:21 +0000 Subject: [PATCH 7/7] State that the extension publishes inline files on every system --- content/agents/claude-desktop.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/agents/claude-desktop.mdx b/content/agents/claude-desktop.mdx index 5a24b48..c1f3b93 100644 --- a/content/agents/claude-desktop.mdx +++ b/content/agents/claude-desktop.mdx @@ -56,7 +56,7 @@ If Claude says the Spacefast connector isn't connected, add the connector as des ## Install the desktop extension -The extension runs the Spacefast MCP server on your computer. Publishing a local folder by path needs the native Linux `sf` build; on macOS and Windows, publish inline files or use the [CLI](/cli). It starts the server with `npx`, so it needs Node.js 20.3 or newer with `npx` installed where Claude Desktop can find it. +The extension runs the Spacefast MCP server on your computer. It publishes inline files on every system; to publish a local folder, use the [CLI](/cli) (`sf publish `). It starts the server with `npx`, so it needs Node.js 20.3 or newer with `npx` installed where Claude Desktop can find it. @@ -86,7 +86,7 @@ The bundle is a manifest version `0.2` extension with a Node server. Its entry p } ``` -The server runs locally, but publishing a folder by path needs the native Linux `sf` build. On macOS and Windows, `publish` takes inline files; use the CLI for a local folder. +The server runs locally, but it starts through `npx`, so `publish` takes inline files on every system. Use the CLI for a local folder. | Fact | Value | |---|---|