# Install in Claude Code

Install the Foldspace plugin in Claude Code, sign in, verify the MCP server, and let the agent wire Foldspace into your app.

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.
  

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):

   ```sh
   claude plugin marketplace add foldspace-ai/plugins
   ```

2. **Install the plugin that matches your project** from the [Pick your plugin](#pick-your-plugin) choice above:

   
     
**Codebase (you own the code)**

       ```sh
       claude plugin install foldspace-codebase-plugin@foldspace-plugins
       ```
     
     
**Remote (you can't edit the code)**

       ```sh
       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:

   ```text
   /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:

```sh
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 →**](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Foldspace&connectorUrl=https%3A%2F%2Fapi.foldspace.ai%2Fmcp)

## Next steps

- New to the SDK? See [Setup](/start/install/) for the manual wiring the plugin automates.
- Using a different editor (Cursor, Windsurf, VS Code)? See [Vibe coding](/guides/vibe-coding/).
- Browse the plugins on [GitHub](https://github.com/foldspace-ai/plugins).