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

# Connect & Setup

> Connect any MCP client to the Juicer MCP Server — endpoint, authentication, and per-client setup for Claude, Cursor, VS Code, and more.

Connect any MCP client to Juicer with **just the server URL**. Most clients handle authorization for you through a browser sign-in; if yours doesn't, pass an API key as a bearer token instead.

## Endpoint and transport

```text theme={null}
Endpoint:   https://api.juicer.io/mcp
Transport:  Streamable HTTP (stateless)
```

## Authentication

The server accepts two ways to authenticate. Pick whichever your client supports.

### OAuth 2.1 (recommended)

Connect with only the URL. The first time your client reaches the server it opens a browser, you sign in to Juicer and click **Authorize**, and the client receives a token automatically — there's nothing to copy or paste.

Behind the scenes, approving creates a named API key scoped to your account. You can review or revoke it anytime from the [API dashboard](https://www.juicer.io/dashboard-api).

<Note>
  Authorizing grants a client access to your feeds and team. Only authorize
  clients you trust, and revoke any you no longer use from the
  [API dashboard](https://www.juicer.io/dashboard-api).
</Note>

### API key (bearer token)

If your client doesn't support OAuth, or you're scripting against the server, pass a `jcr_` API key directly as a bearer token and skip the browser flow:

```text theme={null}
Authorization: Bearer jcr_your_api_key_here
```

Generate a key from the [API dashboard](https://www.juicer.io/dashboard-api) or the device-authorization flow (see [Authentication](/authentication)). Treat it like a password — never commit it to source control.

## Connect

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={null}
    claude mcp add --transport http juicer https://api.juicer.io/mcp
    ```

    The first call opens your browser to authorize. Approve, and you're connected.

    To skip OAuth and use an API key:

    ```bash theme={null}
    claude mcp add --transport http juicer https://api.juicer.io/mcp \
      --header "Authorization: Bearer jcr_your_api_key_here"
    ```
  </Tab>

  <Tab title="Claude Desktop">
    Open **Settings → Connectors → Add custom connector**, then enter:

    * **Name:** `Juicer`
    * **URL:** `https://api.juicer.io/mcp`

    Save, then click **Connect** — a browser opens for you to sign in and authorize.
  </Tab>

  <Tab title="Cursor">
    Open the command palette (`Cmd/Ctrl+Shift+P`) → **Open MCP settings**, and add to `mcp.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "Juicer": {
          "url": "https://api.juicer.io/mcp"
        }
      }
    }
    ```

    Cursor opens a browser to authorize the first time the server is used.
  </Tab>

  <Tab title="VS Code">
    Create `.vscode/mcp.json`:

    ```json theme={null}
    {
      "servers": {
        "juicer": {
          "type": "http",
          "url": "https://api.juicer.io/mcp"
        }
      }
    }
    ```
  </Tab>
</Tabs>

<Warning>
  Restart your MCP client after adding the server or changing your key so the
  new configuration takes effect.
</Warning>

## Next steps

<CardGroup cols={2}>
  <Card title="Tool Catalog" icon="wrench" href="/mcp-tools">
    The 33 tools you can now call, grouped by domain.
  </Card>

  <Card title="Overview" icon="circle-info" href="/mcp-server">
    How the server works and how it relates to the REST API.
  </Card>
</CardGroup>