# Connect your AI tool

Source: https://docs.novelos.studio/write-with-ai/connect/ (updated 2026-11-09). Part of the NovelOS Studio 1.5.1 docs.

**Before you start:** [How the Skills and the MCP server work](https://docs.novelos.studio/write-with-ai/how-it-works.md)

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.](https://docs.novelos.studio/assets/screens/mcp-overview.webp)

## 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:

```sh
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](https://docs.novelos.studio/guides/ai-tools/connect.md#2-add-novelos-to-claude-code-or-your-tool) 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:

- **Claude Code**: start it by typing `claude` in the terminal, then type `/mcp`. `novelos` should be in the list.
- **Codex**: run `codex mcp list` in the terminal. `novelos` should be there.

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.](https://docs.novelos.studio/assets/screens/mcp-activity.webp)

## If it doesn't connect

- Is NovelOS open, and does the switch say **On**? The server only runs while the app does.
- Did you change the port, or press **Regenerate token**? Then copy the setup again and replace the old one in your tool.
- Does the tool see no books, or fewer than you expected? Check **Books AI tools can see** under **Permissions**.

More in [Connect Claude Code, Codex, Cursor or Claude Desktop](https://docs.novelos.studio/guides/ai-tools/connect.md).

**Next:** [Install the NovelOS Studio Skills](https://docs.novelos.studio/write-with-ai/install-skills.md)
