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

# Connect Claude

> Add the Reechee MCP server to Claude - log in with OAuth, or use an API key.

The server is at `https://mcp.reechee.io/mcp` (Streamable HTTP). Three ways to connect:
log in with your Reechee account (**OAuth Connect**, no key), send an
`Authorization: Bearer rch_live_…` header (**API key**), or use it anonymously for the 3
free tools.

## Connect with your Reechee account (OAuth)

The easiest way in Claude Desktop and claude.ai - no key to paste. Add a custom connector
pointed at the **`/mcp/auth`** URL and Claude runs the login flow for you:

1. **Settings → Connectors → Add custom connector**.

2. Paste the URL:

   ```
   https://mcp.reechee.io/mcp/auth
   ```

3. Claude opens a browser to Reechee. Log in (if you aren't already) and approve the
   **"Connect to Reechee"** screen.

That's it - Claude holds the connection and the tools appear. What you get follows your
team's **current plan**: a free team gets the 3 free tools tied to your account, a paid
team gets the full read + action set (**twelve** tools - **fifteen** if you allow an
optional credit budget on the consent screen). Disconnect any time from the same
Connectors settings; it revokes the connection immediately.

<Note>
  Use the bare `https://mcp.reechee.io/mcp` (no `/auth`) only if you want **anonymous**
  access - it answers without asking you to log in, so Claude won't offer the Connect
  flow. The `/mcp/auth` URL is what triggers the browser login.
</Note>

<Note>
  Credit-spending tools (unlock contact, unlock committee, generate report) are **not**
  available over OAuth - they stay [API-key only](/guides/authentication#api-key). Connect
  with a key if your agent needs them.
</Note>

## Claude Code

Claude Code connects with a header, not the browser flow. Add it with one command:

```bash theme={null}
claude mcp add --transport http reechee https://mcp.reechee.io/mcp
```

With an API key, pass the header:

```bash theme={null}
claude mcp add --transport http reechee https://mcp.reechee.io/mcp \
  --header "Authorization: Bearer rch_live_YOUR_KEY"
```

Or commit it to a project's `.mcp.json` (env-var expansion works, so the key stays out
of the file):

```json theme={null}
{
  "mcpServers": {
    "reechee": {
      "type": "http",
      "url": "https://mcp.reechee.io/mcp",
      "headers": { "Authorization": "Bearer ${REECHEE_API_KEY}" }
    }
  }
}
```

For anonymous access, drop the `headers` block. Check the connection with `/mcp`.

<Warning>
  If a key is set but rejected, Claude Code reports the server as **failed** (it does not
  fall back to a login prompt). Double-check the key if the connection won't come up.
</Warning>

## Claude Desktop

**Log in (recommended)** - use OAuth Connect above: **Settings → Connectors → Add custom
connector**, paste `https://mcp.reechee.io/mcp/auth`, and approve. No config file.

**Anonymous** - same connector UI, but paste the bare `https://mcp.reechee.io/mcp` (no
`/auth`) for the 3 free tools without logging in.

**With a static API key** - the custom-connector UI does the browser OAuth flow, not a
static bearer header, so to pin a specific key route it through the `mcp-remote` bridge
(needs Node/`npx`). Edit `claude_desktop_config.json`:

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

```json theme={null}
{
  "mcpServers": {
    "reechee": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://mcp.reechee.io/mcp",
        "--header", "Authorization: Bearer rch_live_YOUR_KEY"
      ]
    }
  }
}
```

Restart Claude Desktop after saving. (`mcp-remote` is a community bridge, not an Anthropic
package.)

## Try it

Ask:

> What are people unhappy about with Zendesk lately?

Claude resolves the product and reads its pain points. Once connected (or keyed), try
*"list my newest opportunities"* - see the [full toolset](/mcp/overview).