Installation

Prerequisites

Based Page requires Node.js 18+. Verify your version:

node --version

Claude Desktop

Add Based Page to your MCP configuration file:

macOS

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "based-page": {
      "command": "npx",
      "args": ["-y", "based-page"]
    }
  }
}

Windows

// %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "based-page": {
      "command": "npx",
      "args": ["-y", "based-page"]
    }
  }
}

After saving, restart Claude Desktop for the changes to take effect.

Cursor

Add Based Page to Cursor's MCP settings. Open Cursor Settings → MCP and add a new server:

{
  "mcpServers": {
    "based-page": {
      "command": "npx",
      "args": ["-y", "based-page"]
    }
  }
}

Alternatively, create a .cursor/mcp.json file in your project root with the same content.

Claude Code

The recommended setup is to add a .mcp.json to your project root. This makes Based Page available whenever you work in that directory, and committing the file means everyone on the team gets it automatically.

{
  "mcpServers": {
    "based-page": {
      "command": "npx",
      "args": ["-y", "based-page"]
    }
  }
}

This is especially useful if you want to deploy your own project directly — Claude Code can read your codebase and deploy it to based.page without leaving the editor.

Project vs Global scope

.mcp.json in a project root scopes Based Page to that project only. For universal access across all projects, add it to ~/.claude/.mcp.json instead.

Manual / Other MCP Clients

For any MCP-compatible client, run Based Page over stdio:

npx -y based-page

Verify Installation

Open a conversation and ask:

"What Based Page tools do you have available?"

You should see tools like deploy, login, list_templates, list_deploys, and others.

Troubleshooting

Issue	Fix
Tools don't appear	Restart the client after editing the config file
npx command fails	Ensure Node.js 18+ is installed and npx is on your PATH
Permission errors	Check that you have write access to the config file location

Next Step

Once installed, continue to Authentication to sign in.