Add to Claude

Claude Desktop

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

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 and install it first.

Setup

1. Get an API key

Contact ben@dialogue-ai.co to request access. You’ll receive a key that looks like dlg_xxxxxxxxxxxx.

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:

1{
2  "mcpServers": {
3    "dialogue": {
4      "command": "npx",
5      "args": [
6        "mcp-remote@latest",
7        "https://mcp.dialogue-ai.co/mcp",
8        "--header",
9        "Authorization: Bearer YOUR_API_KEY"
10      ]
11    }
12  }

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 the corpus: https://example.com”