Install in Claude Code

Install the Foldspace plugin once and Claude Code does the integration for you: it adds the agent, connects your authenticated users, and discovers your product’s actions. The whole flow is a marketplace add, one install, a browser sign-in, and a prompt.

Pick your plugin

Foldspace ships two plugins. The only question that decides which you need is whether Claude can edit the site’s source code.

Codebase (you own the code)

Use foldspace-codebase-plugin when Claude Code can edit the site’s frontend. It wires the Foldspace SDK directly into your app: adds the loader, identifies your users, and scaffolds your actions in code. This is the common case.

Remote (you can't edit the code)

Use foldspace-remote-plugin when you can’t change the source, for example when prototyping against someone else’s live site. It builds a Chrome extension that injects Foldspace into the running page, and also starts Chrome DevTools MCP so the agent can inspect the live site.

Tip

Not sure? Pick Codebase. If Claude reports it can’t find or edit the frontend, switch to Remote.

Install

1. Add the Foldspace marketplace (one time per machine):

   claude plugin marketplace add foldspace-ai/plugins

2. Install the plugin that matches your project from the Pick your plugin choice above:

   Codebase (you own the code)

   claude plugin install foldspace-codebase-plugin@foldspace-plugins

   Remote (you can't edit the code)

   claude plugin install foldspace-remote-plugin@foldspace-plugins

3. Sign in. There’s no API key to paste. Run /mcp, pick foldspace, and Foldspace opens a browser window for you to sign in. Claude Code stores the resulting OAuth token itself and reuses it on later sessions.

4. Verify everything loaded. Inside Claude Code, run:

   /plugin   # confirms the Foldspace plugin is installed
   /mcp      # confirms the Foldspace MCP server is connected
   /agents   # confirms the plugin's agents are available

5. Run the integration. Ask the agent:

   Integrate Foldspace into this app.

   It adds the agent, identifies your users, and discovers your actions for you.

Add the hosted MCP server instead

The plugin is the full integration path. If you only want Claude to reach your Foldspace account’s actions (no plugin, no local server), point it at the hosted MCP endpoint:

claude mcp add --transport http foldspace https://api.foldspace.ai/mcp

Using Claude on the web or desktop, add the same server as a custom connector. This link pre-fills the name and URL:

Add the Foldspace connector to Claude →

Next steps

Keep going

• New to the SDK? See Setup for the manual wiring the plugin automates.
• Using a different editor (Cursor, Windsurf, VS Code)? See Vibe coding.
• Browse the plugins on GitHub.