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

> Add the Quotable MCP server to Claude Code with one command and sign in with OAuth, or send an API key header, for yourself or for your whole project.

Claude Code connects to remote MCP servers over HTTP. You can sign in to Quotable with OAuth, which needs no key, or send an API key in a header.

## Before you start

* Claude Code installed and signed in.
* For OAuth: the owner or an integration admin role in your Quotable workspace, to approve the connection.
* For an API key: a key from **Settings → API keys**. See [Authentication](https://docs.usequotable.com/mcp-server/authentication.md) for the scopes each tool needs.

## Add the server

> [tab] Sign in with OAuth
>
> Add the server without a header:
>
> ```bash theme={"system"}
> claude mcp add --transport http --scope user quotable https://app.usequotable.com/api/mcp
> ```
>
> Then start Claude Code, type `/mcp`, select **quotable** and choose **Authenticate**. Your browser opens a Quotable page: sign in if asked, check that it sends you back to `localhost`, pick the workspace, the data and the brands, and click **Allow access**. Claude Code stores the tokens and renews them on its own.
>
> Leave out `--scope user` to add the server to the current project only. The same setup works in a shared `.mcp.json` without a `headers` block; each teammate then signs in with their own Quotable account.

> [tab] API key, just for you
>
> Store the key in an environment variable, then add the server at user scope so it's available in every project:
>
> ```bash theme={"system"}
> export QUOTABLE_API_KEY="quotable_live_…"
>
> claude mcp add --transport http --scope user quotable https://app.usequotable.com/api/mcp \
>   --header "Authorization: Bearer $QUOTABLE_API_KEY"
> ```
>
> Your shell expands `$QUOTABLE_API_KEY` when you run the command, and Claude Code saves the header in your user configuration (`~/.claude.json`). Leave out `--scope user` to add the server to the current project only; it's still stored privately in `~/.claude.json`.

> [tab] API key, for your team (.mcp.json)
>
> To share the setup through version control, add a `.mcp.json` file at the project root. Reference the key through an environment variable so it's never committed:
>
> ```json .mcp.json theme={"system"}
> {
>   "mcpServers": {
>     "quotable": {
>       "type": "http",
>       "url": "https://app.usequotable.com/api/mcp",
>       "headers": {
>         "Authorization": "Bearer ${QUOTABLE_API_KEY}"
>       }
>     }
>   }
> }
> ```
>
> Each teammate sets `QUOTABLE_API_KEY` to their own key before starting Claude Code. Claude Code asks each person to approve project-scoped servers the first time.

> [!WARNING]
>
> Don't paste a literal key into `.mcp.json`. Anyone who can read the repository could use it.

## Check the connection

Run `claude mcp get quotable` from your terminal, or type `/mcp` inside Claude Code. The server should show as connected with its tools, such as `list_projects`, `get_visibility` and `list_citations`. See [Tools](https://docs.usequotable.com/mcp-server/tools.md) for the full list.

If it shows **Needs authentication**, choose **Authenticate** in `/mcp` to sign in. If you added the server with a key and still see it, the `Authorization` header isn't reaching the server: check that the variable was set when you ran `claude mcp add`, or that it's set in the shell that started Claude Code. See [Troubleshooting](https://docs.usequotable.com/mcp-server/troubleshooting.md).

## Try it

```text theme={"system"}
Using Quotable, list my brands and show how the visibility score for the first one changed over the last 30 days.
```

Claude Code asks for permission the first time it calls each tool. Every Quotable tool reads data except `run_agent`, which starts an agent run and uses your workspace's credits. Approve it only for runs you asked for.

## Update or remove

To sign out of an OAuth connection, open `/mcp`, select **quotable** and clear its authentication, or click **Disconnect** under **Connected apps** in Quotable. To rotate a key, remove the server and add it again with the new key:

```bash theme={"system"}
claude mcp remove quotable
```

Without `--scope`, `remove` deletes the server from whichever scope it was added to. With `.mcp.json`, change the environment variable and restart Claude Code instead.

## 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)
>
> Combine Quotable with your other tools.

> [card] [Tools reference](https://docs.usequotable.com/mcp-server/tools.md)
>
> Inputs and outputs for each tool.


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