Docs · Quickstart

Install once. Ship your first client front office.

SeldonFrame plugs into Claude Code as an MCP server. After install, you give it a client URL and Claude orchestrates workspace creation, block installs, branding, and customization — same flow whether you're in the Claude Code desktop app or the terminal.

Prerequisites

  • ✓Claude Code installed and authenticated
  • ✓Node.js 18 or newer (Node 20 recommended)

Running in Codespaces, WSL, or SSH remote?

  • ·Node version: Codespaces default images sometimes ship Node 16. SeldonFrame requires Node 18+. Run nvm install 20 && nvm use 20 if node --version shows v16 or v17.
  • ·Claude Code OAuth: the OAuth callback points at localhost, which your local browser can't reach when Claude Code runs in a remote VM. Use the API key path instead: export ANTHROPIC_API_KEY=sk-ant-...
  • ·Web-terminal paste: some browser-based terminals block Ctrl+V. Use Ctrl+Shift+V or right-click → Paste.
  • ·npm cache 404 after publish:if you ever query a package before it's published, npm caches the 404. After publishing, run npm cache clean --force if npm view still 404s.
1

Add SeldonFrame to Claude Code

The MCP server exposes SeldonFrame's primitive surface inside Claude Code. Pick whichever path is comfortable — both register the same MCP and produce the same result.

Option ARecommended

Claude Code desktop app

Open Claude Code (download from claude.ai/code if you don't have it), then type:

Add SeldonFrame to my tools

Claude Code reads this as a request to install an MCP server and runs the registration for you. No terminal required.

Option B

Terminal

If you prefer the command line, run:

claude mcp add seldonframe -- npx -y @seldonframe/mcp claude

Requires Node.js 18+ and Claude Code CLI installed. The first command registers the MCP; the second starts a session.

2

Describe your client

Paste this template into Claude Code (app or terminal — same prompt) and fill in your details:

Create a workspace for my client: - Business name: [your client business name] - Industry: [hvac, dental, legal, coaching, real-estate, salon, ...] - Location: [city, state] - Operating hours: [Mon-Sat 7am-7pm] - Team size: [number] - Services offered: [3-5 main ones] - Website: [client URL, optional] - Agency brand: [your agency name, logo, portal style]
3

Test, publish, and hand it off

Claude Code chains the right tool calls automatically: creates the workspace, installs an industry-matched vertical pack, configures booking availability, seeds the client's Soul from their website, and customizes the intake form. Run the agent evals, complete a test booking, publish the live URLs, and hand the client their branded portal. Build the first client workspace free; agency plans start at $99/mo and carry 0% GMV.

https://your-business.app.seldonframe.com ← public home https://your-business.app.seldonframe.com/book ← booking https://your-business.app.seldonframe.com/intake ← intake form https://app.seldonframe.com/switch-workspace?... ← admin dashboard

What's next