> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.dialogue-ai.co/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.dialogue-ai.co/_mcp/server.

# Claude Desktop

> Connect to the corpus via Claude Desktop.

Claude Desktop connects to the MCP server via a local bridge called `mcp-remote`. This requires Node.js on your machine.

> **Note**
>
> Before starting, check you have Node.js installed. Open Terminal and run `node --version`. If you see a version number (e.g. `v20.0.0`), you're good. If not, download it from [nodejs.org](https://nodejs.org) and install it first.

## Setup

### 1. Get your API key

Contact [ben@dialogue-ai.co](mailto:ben@dialogue-ai.co) to receive your API key.

### 2. Open the Claude Desktop config file

**On macOS:**

1. Open **Finder**
2. Press **Cmd + Shift + G**
3. Paste this path and press Enter: `~/Library/Application Support/Claude/`
4. Open `claude_desktop_config.json` in any text editor (TextEdit works)

**On Windows:**

1. Press **Win + R**, type `%APPDATA%\Claude\` and press Enter
2. Open `claude_desktop_config.json` in Notepad

If the file doesn't exist yet, create it as a new empty file with that exact name.

### 3. Add the Dialogue server

Find the `"mcpServers"` section in the file and add the `"dialogue"` entry inside it:

```json
{
  "mcpServers": {
    "dialogue": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://mcp.dialogue-ai.co/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
```

Replace `YOUR_API_KEY` with your Dialogue API key. Save the file.

### 4. Fully restart Claude Desktop

This step is important — closing the window is not enough.

* **macOS**: Press **Cmd + Q** to quit, then reopen Claude Desktop
* **Windows**: Right-click the Claude icon in the taskbar → **Quit**, then reopen

### 5. Verify it's working

Look for the **hammer icon** at the bottom of the chat input box. Click it — you should see Dialogue listed.

Or ask Claude:

> "Use the get_corpus_overview tool."

Claude should return live statistics from the corpus.

**If it doesn't appear**, check the logs for errors:

* **macOS**: `~/Library/Logs/Claude/mcp-server-dialogue.log`
* **Windows**: `%APPDATA%\Claude\logs\mcp-server-dialogue.log`

---

## Example prompts

> "What are UK consumers most worried about when it comes to life insurance?"

> "Give me the highest-liked quotes from people in the pre-retirement life stage."

> "Fetch this page and compare the copy against what real consumers say: [https://example.com](https://example.com)"