# AI connections (Claude Code, Codex, LM Studio and more)

> Let Claude Code, Codex, LM Studio or any other AI app on your Mac that supports MCP read your project, add cards and build HTML pages inside it.

Source: https://writermorph.com/help/ai-connections/

WriterMorph has no AI of its own. You can let an AI app on your Mac work in the project that is open in WriterMorph: **Claude Code**, **Codex**, **LM Studio** or any other AI app that supports MCP, whatever the brand. It works with the same cards you do: it can draft new cards, fill in their properties, write and revise text, reorganize the binder, build HTML pages as tabs, search the project and compile it.

AI Connections is part of WriterMorph for Mac. The iPad app does not include it.

The connection is **off by default** and nothing runs while WriterMorph is closed.

## Turn it on

1. Open **Settings** (⌘,) and choose **AI Connections**.
2. Switch on **Turn on AI Connections**.
3. Under **What AI apps may do**, leave **Allow changes** off if you only want the assistant to read. Turn it on to let it add and edit cards and tabs.
4. **Allow deleting** is a separate switch. Deleted cards and tabs go to the Trash.

A badge at the top of the pane shows the status: **Off**, **On · waiting for an app**, or **Connected:** with the names of the connected apps, such as Claude Code or LM Studio.

## Connect your AI app (one time)

WriterMorph works with any AI app on your Mac that can use an MCP server, whatever the brand. Pick yours below. Each one needs WriterMorph's address and your secret key; for Claude Code and Codex, WriterMorph puts both into a setup command for you, and for LM Studio into a one-click link.

### Claude Code (Anthropic) or Codex (OpenAI)

1. Install the app if it isn't on your Mac yet. It uses your own Claude or ChatGPT account.
2. In **Settings › AI Connections**, under **Connect an app (one time)**, choose **Claude Code** or **Codex** and click **Copy & Open Terminal**.
3. Click in the Terminal window, press ⌘V, then Return.
4. Type `claude` (or `codex`) and press Return. Then ask in plain words, for example: "List the tabs in my open WriterMorph project."

The row below the steps turns green and says the app is connected. To check in Terminal, run `claude mcp list` (or `codex mcp list`).

### LM Studio: local AI, nothing leaves your Mac

1. Install LM Studio (version 0.3.17 or later) and download a model that can use tools.
2. In **Settings › AI Connections**, under **Connect an app (one time)**, choose **LM Studio** and click **Add to LM Studio**. LM Studio opens with WriterMorph ready to add. If it asks, click **Install**.
3. Start a new chat, choose the model and ask in plain words.

To add WriterMorph by hand instead, open the **Program** tab in LM Studio's right-hand sidebar and choose **Install › Edit mcp.json**. Add WriterMorph with your own key, then save:

```json
{
  "mcpServers": {
    "writermorph": {
      "url": "http://127.0.0.1:47821/mcp",
      "headers": { "Authorization": "Bearer YOUR-KEY" }
    }
  }
}
```

If the file already lists other servers, add only the `"writermorph"` part inside `"mcpServers"`.

### Other AI apps, any brand

Any app that can connect to an MCP server over HTTP works, for example Msty Studio, Cherry Studio, Jan or Cline. In **Settings › AI Connections**, under **Connect an app (one time)**, choose **Other Apps**: WriterMorph shows its address and your key, each with a button to copy it. Then, in the app's MCP settings (sometimes called Tools or Connectors), add a server:

- **Type:** HTTP (Streamable HTTP)
- **Name:** writermorph
- **Address (URL):** `http://127.0.0.1:47821/mcp`
- **Header:** `Authorization`, with the value `Bearer YOUR-KEY`

If the app asks for JSON, click **Copy JSON**: it is the same entry as for LM Studio. Then choose a model that can use tools and ask in plain words.

### For example, Grok

Grok (xAI) connects the same way as any other app. There are three ways to use it:

- **Grok Build**, xAI's app for Terminal. Install it from [xAI's Grok Build page](https://docs.x.ai/build/overview) and sign in. Then run this command once in Terminal, with your own key in place of YOUR-KEY:
  ```
  grok mcp add --transport http writermorph http://127.0.0.1:47821/mcp --header "Authorization: Bearer YOUR-KEY"
  ```
  Type `grok`, press Return and ask in plain words.
- **Grok in a desktop chat app**, such as Msty Studio, Cherry Studio, Jan or Cline. Add your xAI API key in that app, then add WriterMorph as an MCP server, as described under [Other AI apps](#other-ai-apps-any-brand).
- **grok.com, the Grok apps and Grok Bot** run in xAI's cloud. They can't reach WriterMorph, because WriterMorph only accepts connections from your own Mac.

### Where to find your key

In **Settings › AI Connections**, click **Show Command**, then **Show Key**. Your key is the long text after `Bearer`. It works like a password: don't share it or post it online.

### If an app stops connecting

This usually happens after **Create New Key…**: the app still has the old key. Set it up again with the new key:

- **Claude Code:** in Terminal, run `claude mcp remove --scope user writermorph`. Then click **Copy & Open Terminal** again, press ⌘V, then Return.
- **Codex:** click **Copy & Open Terminal** again. The command replaces the old setup.
- **Grok Build:** run `grok mcp remove writermorph`, then the `grok mcp add` command above with the new key.
- **LM Studio and other apps:** replace the key in their settings.

AI apps connect when a session starts, so start a new session afterwards. In Claude Code you can also type `/mcp`, choose **writermorph** and then **Reconnect**.

### Disconnect an app

Under **Connected apps**, click **Disconnect…** next to the app. WriterMorph copies the remove command and opens Terminal: press ⌘V, then Return, then click **Done**. For LM Studio and other apps, remove the writermorph server in that app's MCP settings, then click **Remove from List**. To pause every app at once, turn off AI Connections instead.

## Active Services

While AI Connections or a Labs feature is on, a small **Active Services** indicator shows in the top bar and on the Home screen: a colored dot with the connected app, and how many Labs features are on.

Click it to open the **Active Services** window. There you can turn AI Connections on or off, change **Allow changes** and **Allow deleting**, see the connected apps and **What AI apps did** (the latest 40 actions since WriterMorph opened), and turn the Labs features on or off.

## Things to ask for

**Planning and properties**

- "Plan this premise as a three-act novel: acts, six scenes, the cast and places."
- "Fill in point of view, beat, tension and place for every scene in Act II."
- "Mark all four Chapter 5 sections as Draft and set each target to 900 words."
- "Give every scene a story date and time, and mark the flashbacks."
- "Turn the sections of this document into cards under Chapter 3."
- "Write a two-line summary for every card that has none."

**Pages inside the project**

- "Make a tabbed HTML page from this document and open it in a new tab."
- "Make a character dossier: the cast, who shares scenes with whom, a scene-by-scene chart and each arc."
- "Map my literature review: sources by theme and year, where each is cited, and anything I haven't cited."
- "Build a story bible with tabs for characters, places and chronology."
- "Turn Chapter 2 into a study page with flashcards and a self-quiz."
- "Make a results dashboard from Table 4.1."

**Databases, data tables and more**

- "Make a Sources database with Author, Year, URL and Status, and add the books in this list."
- "Give every character a Faction relation to the Factions database."
- "Put Mara's inventory in a data table: item, quantity and where she found it."
- "Attach the museum's web page to the Harbor card."
- "Move the Act III cards to the planner called Drafts."

To see and edit databases yourself, turn on **Settings › Labs › Databases**. See [Databases and data cards](https://writermorph.com/help/databases/).

## HTML pages

When you ask for a page, report or dashboard, the assistant creates a new **HTML tab** in the project. These pages:

- follow WriterMorph's light or dark setting,
- have zoom and full-width controls in their header,
- remember their inner tab and zoom,
- are saved inside the `.wmorph` project file, so they travel with it.

The HTML tab shows the source code beside the live page, and you can edit the source.

You can also ask for a [Live Page](https://writermorph.com/help/live-pages/) in the same style as WriterMorph's templates, such as a tracker for a book club or a dashboard for a grant application. WriterMorph gives the assistant a **Live Page Designer** skill: it starts from the closest of the 48 built-in templates, reads its source and builds a page with the same look and controls for what you asked.

## Safety

- The connection only accepts requests from your own Mac and needs a private key. **Create New Key…** under Security replaces the key; the old setup command stops working.
- Changes from the assistant can be undone with ⌘Z.
- **Recent activity** lists what the assistant did.
- What the assistant sends to its own service is covered by that provider's terms. WriterMorph itself sends nothing.

## Going back to before an AI edit

Before an assistant changes an HTML page, a note or a document, WriterMorph keeps a copy of how it was.

- For an HTML page, choose **File ▾ › Restore Before AI Edit ▸** in the tab's header and pick a version.
- For a note or a document, click the clock button in its header.

Restoring keeps a copy of the current content too, so you can change your mind again. Card changes in a planner are undone with **Edit › Undo**, as always.
