> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usequotable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Desktop and claude.ai

> Connect Claude on the web, desktop or mobile to Quotable with a custom connector and OAuth sign-in, or with an API key in a request header or a local bridge.

Claude connects to Quotable as a custom connector. You add the server URL once, sign in to Quotable, and choose what Claude may read. The connector then works in claude.ai, Claude Desktop and Claude mobile.

| Option | Works in | Needs |
| - | - | - |
| [Custom connector with OAuth](#option-1-custom-connector-with-oauth) (recommended) | claude.ai, Claude Desktop, Claude mobile | The owner or an integration admin of your Quotable workspace to approve it |
| [Custom connector with a request header](#option-2-custom-connector-with-a-request-header) | claude.ai, Claude Desktop, Claude mobile | The **Request headers** section in Claude's connector dialog (beta, not on every account) |
| [Local bridge](#option-3-local-bridge-in-claude-desktop) | Claude Desktop only | Node.js on your computer |

## Option 1: Custom connector with OAuth

**1. Add a custom connector**

On a Free, Pro or Max plan, go to **Customize → Connectors** and click **Add custom connector**. On Team and Enterprise plans an Owner adds it from **Organization settings → Connectors** (**Add**, then **Custom**), and each member then connects from **Customize → Connectors**.

**2. Enter the server**

Name it `Quotable` and set the URL to `https://app.usequotable.com/api/mcp`. If Claude asks for **Authentication**, choose **Sign in now**. For **OAuth client**, keep **Use Claude's published identity** (or **Register automatically**); Quotable supports both. Leave the client ID and secret empty.

**3. Connect and sign in**

Click **Add**, then **Connect**. A Quotable page opens. Sign in if asked, check that it says Claude will send you back to `claude.ai`, pick the workspace, the data and the brands Claude may read, and click **Allow access**.

**4. Turn it on in a chat**

In a chat, open the **+** menu, then **Connectors**, and turn Quotable on.

On Team and Enterprise plans, each member signs in with their own Quotable account, so each person reads only what they approved. Only the owner and integration admins of a Quotable workspace can approve a connection; other members see a message asking them to ask one of them.

To disconnect, remove the connector in Claude, or click **Disconnect** under **Connected apps** in Quotable's **Settings → MCP**. See [Authentication](https://docs.usequotable.com/mcp-server/authentication.md#sign-in-with-oauth) for how long a connection lasts.

## Option 2: Custom connector with a request header

Claude can store a fixed API key and send it as a header on every request to the server. Claude lists this as a beta that's available to a limited set of organizations. If you don't see **Request headers** when you add a custom connector, your account doesn't have it yet.

**1. Create a dedicated key**

In Quotable, go to **Settings → API keys** and create a key just for Claude. See [Authentication](https://docs.usequotable.com/mcp-server/authentication.md).

**2. Add a custom connector**

In Claude, go to **Customize → Connectors** and click **Add custom connector**. On Team and Enterprise plans an Owner adds it from **Organization settings → Connectors** (**Add**, then **Custom**).

**3. Enter the server**

Name it `Quotable` and set the URL to `https://app.usequotable.com/api/mcp`. For **Authentication**, choose **No sign-in**.

**4. Add the header**

Open **Request headers**, choose `authorization`, and enter the value with the `Bearer ` prefix and a space:

```text theme={"system"}
Bearer quotable_live_…
```

Claude sends the value exactly as you type it. Without `Bearer `, Quotable answers `401`.

**5. Save and enable**

Click **Add**. In a chat, open the **+** menu, then **Connectors**, and turn Quotable on.

> [!WARNING]
>
> On Team and Enterprise plans, a request header is shared by everyone in the Claude organization who uses the connector. Every member uses Quotable with the same key, including starting agent runs, so give the key only the brands you're happy for all of them to use. Claude doesn't let you change the header later: to rotate the key, remove the connector and add it again.

## Option 3: Local bridge in Claude Desktop

Claude Desktop can start local MCP servers from a configuration file. [`mcp-remote`](https://www.npmjs.com/package/mcp-remote), an open-source bridge, runs on your computer and forwards Claude Desktop's requests to Quotable with your header. Quotable doesn't maintain `mcp-remote`.

**1. Install Node.js**

Install the LTS version of [Node.js](https://nodejs.org), which provides `npx`.

**2. Open the configuration file**

In Claude Desktop, open **Settings → Developer** and click **Edit Config**. The file lives at:

* macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
* Windows: `%APPDATA%\Claude\claude_desktop_config.json`

**3. Add Quotable**

Add a `quotable` entry under `mcpServers`:

```json claude_desktop_config.json theme={"system"}
{
  "mcpServers": {
    "quotable": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.usequotable.com/api/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer quotable_live_…"
      }
    }
  }
}
```

Keep `Authorization:${AUTH_HEADER}` without spaces. Claude Desktop on Windows doesn't escape spaces inside `args`, so the space after `Bearer` lives in the environment variable instead.

**4. Restart Claude Desktop**

Quit Claude Desktop completely and open it again. Quotable appears under **Connectors** in the **+** menu of the chat box, with its tools.

> [!NOTE]
>
> This configuration stores the key in plain text in your user profile. Use a dedicated key, and revoke it in Quotable if the computer is lost.

If the bridge opens a browser to sign in, the key didn't reach Quotable and the server asked the bridge to sign in instead. Check the `AUTH_HEADER` value, including the `Bearer ` prefix, or use option 1. Claude Desktop writes connection logs to `~/Library/Logs/Claude` on macOS and `%APPDATA%\Claude\logs` on Windows.

## Try it

```text theme={"system"}
Use Quotable to list my brands, then tell me which competitors had the highest share of voice for my main brand last week.
```

## Next steps

> [card] [Example prompts](https://docs.usequotable.com/mcp-server/example-prompts.md)
>
> Ready-to-use questions for your workspace.

> [card] [Workflows](https://docs.usequotable.com/mcp-server/workflows.md)
>
> Pair Quotable with your other connectors.

> [card] [Troubleshooting](https://docs.usequotable.com/mcp-server/troubleshooting.md)
>
> Fix connection and key errors.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.