Connect your AI tool

Before you start: How the Skills and the MCP server work

You do this once per computer. It takes a few minutes, most of them spent finding the terminal.

1. Switch on the server

  1. In NovelOS, open Settings › MCP.
  2. Switch on Allow AI tools to connect. The line under it reads Starting…, then On with the server address.
  3. The first time, NovelOS explains what protects you (Connected tools can change your writing). Click I understand.
Settings, MCP, Set up: choose your tool and copy the setup.

2. Copy the setup for your tool

On the Set up tab, under Choose your tool, pick Claude Code, Codex, Cursor or Claude Desktop. NovelOS shows the exact setup with your server address and access token already filled in. Click Copy.

Don't retype it. The token is long and the setup has to match it exactly.

3. Paste it where it goes

Claude Code wants it run in a terminal. On a Mac, open Terminal (it's in Applications › Utilities, or press ⌘ Space and type "Terminal"). Paste the setup and press Enter. It looks like this, with your own token:

claude mcp add --transport http --scope user novelos http://127.0.0.1:47321/mcp \
  --header "Authorization: Bearer <your-token>"

On Windows, the backslash at the end of the first line means "carry on" only to Mac and Linux terminals. In PowerShell, paste it into a text editor first, delete the backslash and the line break so it's one line, then run that.

--scope user means every Claude Code session on this computer can reach NovelOS, whichever folder you start it in.

Codex, Cursor and Claude Desktop want it pasted into a settings file. The box tells you which one; the connect guide has the details for each. Claude Desktop also needs Node.js installed.

4. Restart the tool and check

Close the tool and open it again so it picks up NovelOS. Then check:

Then ask a plain question:

Which of my NovelOS books can you see?

The tool should call the book list and name your books. Back in NovelOS, the Activity tab now shows the tool's first session, with a "List books" line in it under Everything.

Settings, MCP, Activity: a Claude Code session with its 17 changes listed, Undo on each line and Undo session at the top.

If it doesn't connect

More in Connect Claude Code, Codex, Cursor or Claude Desktop.

Next: Install the NovelOS Studio Skills

Checked against NovelOS Studio 1.5.1 · Updated · View as Markdown