Get started

Vibe Coding

Wire Foldspace up from the AI coding tool you already use. The fastest path is the Foldspace plugin — your coding agent adds the agent, connects your authenticated users, and discovers your product’s actions for you. Or connect the MCP server directly to your editor to browse and implement AI Actions by hand.

Set up with your AI coding tool

Once you have your Agent Key, skip the manual wiring and let your AI coding tool do the integration:

Set up with your AI coding tool

Install the Foldspace plugin and your AI coding tool will integrate Foldspace for you: add the agent, connect your authenticated users, and discover your product's actions.

# Add the Foldspace marketplace (one time)
claude plugin marketplace add foldspace-ai/plugins

# Install the codebase plugin
claude plugin install foldspace-codebase-plugin@foldspace-plugins

Then run /mcp and pick foldspace to sign in — there's no API key to paste. Once you're signed in, ask the agent: "Integrate Foldspace into this app."

Full walkthrough, including the remote plugin and how to verify the MCP server: Install in Claude Code →

Install the Foldspace plugin from Cursor's plugin interface, then add your API key at your project root:

FOLDSPACE_API_KEY=xxxxxxxx

The plugin's MCP server loads the key from this file automatically. See the plugins repo for the exact steps.

Antigravity has no one-click install yet. Open Settings → Customizations → Add MCP+, or edit ~/.gemini/config/mcp_config.json, and add:

{
  "mcpServers": {
    "foldspace": {
      "url": "https://api.foldspace.ai/mcp"
    }
  }
}

Browse the plugins on GitHub →

Add Foldspace to Claude in one click

Using Claude on the web or desktop? Add Foldspace as a custom connector. The link pre-fills the name and URL, so all you do is confirm and authenticate:

One-click install

Add the Foldspace connector to Claude →

Connector URL: https://api.foldspace.ai/mcp

In Claude Code, add the same server from the terminal instead:

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

Using the Foldspace Model Context Protocol (MCP) servers

The Model Context Protocol (MCP) is a standard for giving AI models real-time, external context. Foldspace exposes two MCP servers — add either or both to your editor:

	Docs MCP	Product MCP
Endpoint	`https://docs.foldspace.ai/mcp`	`https://api.foldspace.ai/mcp`
Auth	Public (no key)	OAuth (sign in from your client)
Gives your assistant	Semantic search + read access to these docs (`search_docs`, `fetch_page`)	Access to your account’s AI Actions: list them, read schemas, generate handlers
Best for	Any developer — ask questions about Foldspace while you code	Building on your own Foldspace agent

Start with the Docs MCP — there’s nothing to configure but a URL. Add the Product MCP when you want your assistant to work with your own AI Actions.

Docs MCP server (public)

The Docs MCP is read-only and needs no API key. Point any MCP client at https://docs.foldspace.ai/mcp. It exposes two tools — search_docs (semantic search over the docs) and fetch_page (fetch a page as Markdown) — so you can ask your assistant things like “how do I configure JWT auth in Foldspace?” and it answers from the current docs.

Claude Code

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

Cursor — Settings → Tools & Integrations → New MCP Server:

{
  "mcpServers": {
    "foldspace-docs": { "url": "https://docs.foldspace.ai/mcp" }
  }
}

Windsurf — Cascade → hammer icon → Configure → View raw config:

{
  "mcpServers": {
    "foldspace-docs": { "serverUrl": "https://docs.foldspace.ai/mcp" }
  }
}

VS Code (GitHub Copilot) — in .vscode/mcp.json:

{
  "servers": {
    "foldspace-docs": { "type": "http", "url": "https://docs.foldspace.ai/mcp" }
  }
}

Product MCP server (your AI Actions)

The Product MCP exposes your Foldspace AI Actions as callable tools. Connecting your editor to it lets your AI assistant:

List all available AI Actions in your Foldspace account.
Get the detailed schema for any action, including its required parameters.
Generate boilerplate code for implementing an action handler in your application.

It’s a hosted HTTP server at https://api.foldspace.ai/mcp. There’s no API key to paste and nothing to install. The first time your client connects, Foldspace opens a browser window for you to sign in, and the client stores the resulting OAuth token itself.

Claude

Use the one-click connector link above, or in Claude Code:

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

Then run /mcp and pick foldspace to complete the OAuth sign-in.

Cursor

Settings → Tools & Integrations → New MCP Server:

{
  "mcpServers": {
    "foldspace": { "url": "https://api.foldspace.ai/mcp" }
  }
}

Cursor prompts you to authenticate the first time it connects.

Windsurf

Cascade → hammer icon → Configure → View raw config:

{
  "mcpServers": {
    "foldspace": { "serverUrl": "https://api.foldspace.ai/mcp" }
  }
}

Visual Studio Code (GitHub Copilot)

Open Settings, search for “MCP”, and make sure GitHub > Copilot > Chat: MCP is enabled. Then create .vscode/mcp.json at your workspace root:

{
  "servers": {
    "foldspace": { "type": "http", "url": "https://api.foldspace.ai/mcp" }
  }
}

Reload the window, then use # in the Copilot Chat panel to reference the Foldspace tools.

What you get after connecting

Once the connector is authorized, the Foldspace tools show up in your client. Here’s how it looks in Claude’s connector settings:

Connectors

Foldspace AI Disconnect

https://api.foldspace.ai/mcp

Tool permissions

Choose when Claude is allowed to use these tools.

Read-only tools 18 Needs approval

discover_actions

foldspace_overview

generate_action_handler

get_action

get_action_schema

get_action_version

get_agent

get_agent_install_snippet

Tools are grouped by what they touch, so you can let read-only calls run freely and keep approval on anything that writes.