Setup guide

Connect in 30 seconds

novel-mcp is a remote MCP server — no local install. Paste one URL into any MCP Streamable HTTP client.

MCP config JSON{
  "mcpServers": {
    "novel-mcp": {
      "type": "http",
      "url": "https://novelmcp.top/mcp"
    }
  }
}

💡 Free · no API key · BYOK (your agent's own model). Detailed per-client guides: Cherry Studio, VS Code/Cursor, Cline, Claude Desktop.

7-step workflow (ask the AI support agent)

Call guide_usage and the AI support agent walks you through: 1 create project → 2 roadmap → 3 chapter cards → 4 write prose → 5 editorial review → 6 export KD → 7 import to kdwrite (Pocket Writer).

Agent mount · by client

Pick the laziest mount path for your client

The config is always the same: {"type":"http","url":"https://novelmcp.top/mcp"}. The only difference is where you paste it. Cherry Studio has no claude command, so it uses a config file instead of a CLI.

① Cherry Studio (most common) — edit the config file

Cherry Studio does not have a claude command, so claude mcp add won't work there. The fastest way is to edit its mcp.json directly:

Windows config pathC:\Users\%USERNAME%\AppData\Roaming\CherryStudio\mcp.json

Merge the snippet below into that file (don't delete your existing servers). Restart Cherry Studio after saving.

Cherry Studio config snippet{
  "mcpServers": {
    "novel-mcp": {
      "type": "http",
      "url": "https://novelmcp.top/mcp",
      "headers": {},
      "isActive": true
    }
  }
}

Verify: Settings → MCP Servers → novel-mcp enabled; type "help me write a novel" in chat and tools should trigger.

② Claude Code CLI (terminal with `claude` command)

If you use Claude Code or any client with a claude mcp subcommand, run this in your terminal. Not for Cherry Studio — Cherry Studio has no claude command.

Mount (project scope)claude mcp add --transport http novel-mcp https://novelmcp.top/mcp

Mount (user scope, all projects)claude mcp add --transport http novel-mcp --scope user https://novelmcp.top/mcp

Verify: claude mcp list; remove: claude mcp remove novel-mcp.

③ AutoMCP — automation for Cursor / VS Code / Claude Desktop

AutoMCP (lirantal/automcp) auto-detects Cursor / VS Code / Claude Desktop and writes project-level MCP config without overwriting or duplicating existing servers. For Cherry Studio, use method ①.

MCP config entry (AutoMCP / any client){
  "mcpServers": {
    "novel-mcp": {
      "type": "http",
      "url": "https://novelmcp.top/mcp"
    }
  }
}

④ Any client (Cursor / VS Code) — Python one-liner

Paste into your terminal to merge into .cursor/mcp.json (for VS Code use .vscode/mcp.json), without breaking existing config:

Python one-liner (merge)python - <<'PY'
import json, pathlib
p = pathlib.Path(".cursor/mcp.json")
d = json.loads(p.read_text()) if p.exists() else {}
d.setdefault("mcpServers", {})["novel-mcp"] = {"type": "http", "url": "https://novelmcp.top/mcp"}
p.write_text(json.dumps(d, ensure_ascii=False, indent=2))
print("novel-mcp written to", p)
PY