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

# Connect your client

> Connect the Brew MCP server to Claude, ChatGPT, Cursor, VS Code, Windsurf, and any MCP client — sign in with OAuth, no API key required.

Every client connects to the **same clean endpoint**:

```
https://brew.new/api/mcp
```

Brew is its own **OAuth 2.1 connector**, so the first-party flow needs **no key to copy**: add the URL, **sign in with Brew**, and **pick a brand**. The issued token is scoped to that brand and revocable anytime in **Settings → API**.

<Tip>Wiring up a headless / CI setup, or a client with no OAuth UI? Send a brand-scoped key as `Authorization: Bearer brew_…` instead — see [the API-key alternative](#alternative-connect-with-an-api-key) below.</Tip>

Pick your agent:

<Tabs>
  <Tab title="Claude Desktop" icon="https://cdn.brandfetch.io/claude.com/icon?c=1idKqMnbT404MBn9xPc">
    <Steps>
      <Step title="Add a custom connector">
        Open **Settings → Connectors**, click **Add custom connector**, and paste the connection URL:

        ```
        https://brew.new/api/mcp
        ```
      </Step>

      <Step title="Connect">
        Click **Connect**, sign in with Brew, and pick a brand.
      </Step>
    </Steps>

    <Note>Works with Claude Desktop and claude.ai.</Note>
  </Tab>

  <Tab title="ChatGPT" icon="https://cdn.brandfetch.io/openai.com/icon?c=1idKqMnbT404MBn9xPc">
    <Steps>
      <Step title="Add a custom connector">
        Open **Settings → Connectors**, click **Add custom connector**, and paste the connection URL:

        ```
        https://brew.new/api/mcp
        ```
      </Step>

      <Step title="Connect">
        Connect, sign in with Brew, and pick a brand.
      </Step>
    </Steps>

    <Note>Custom connectors require a ChatGPT plan with connector support.</Note>
  </Tab>

  <Tab title="Claude Code" icon="https://cdn.brandfetch.io/claude.com/icon?c=1idKqMnbT404MBn9xPc">
    <Steps>
      <Step title="Add the server">
        Run this in your terminal:

        ```bash theme={null}
        claude mcp add --transport http brew "https://brew.new/api/mcp"
        ```
      </Step>

      <Step title="Sign in">
        Claude opens your browser to sign in with Brew and pick a brand.
      </Step>

      <Step title="Verify">
        Start a session and run `/mcp` to confirm Brew is connected.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Cursor" icon="https://cdn.brandfetch.io/cursor.com/icon?c=1idKqMnbT404MBn9xPc">
    <Steps>
      <Step title="Open your MCP config">
        `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (this project).
      </Step>

      <Step title="Add the brew server">
        ```json theme={null}
        {
          "mcpServers": {
            "brew": {
              "url": "https://brew.new/api/mcp"
            }
          }
        }
        ```
      </Step>

      <Step title="Sign in">
        Cursor opens your browser to sign in with Brew — then check **Settings → MCP** for a green dot.
      </Step>
    </Steps>
  </Tab>

  <Tab title="OpenCode" icon="https://cdn.brandfetch.io/opencode.ai/icon?c=1idKqMnbT404MBn9xPc">
    <Steps>
      <Step title="Open your config">
        `~/.config/opencode/opencode.json`.
      </Step>

      <Step title="Add the brew server">
        ```json theme={null}
        {
          "mcp": {
            "brew": {
              "type": "remote",
              "url": "https://brew.new/api/mcp",
              "enabled": true
            }
          }
        }
        ```
      </Step>

      <Step title="Sign in">
        OpenCode connects to the remote server; sign in with Brew when prompted.
      </Step>
    </Steps>
  </Tab>

  <Tab title="VS Code" icon="https://cdn.brandfetch.io/code.visualstudio.com/icon?c=1idKqMnbT404MBn9xPc">
    <Steps>
      <Step title="Create .vscode/mcp.json">
        ```json theme={null}
        {
          "servers": {
            "brew": {
              "type": "http",
              "url": "https://brew.new/api/mcp"
            }
          }
        }
        ```
      </Step>

      <Step title="Start & sign in">
        Click **Start** in the `mcp.json` gutter and sign in with Brew when prompted. Brew appears in the agent-mode tools picker.
      </Step>
    </Steps>

    <Note>Requires GitHub Copilot **agent mode**.</Note>
  </Tab>

  <Tab title="OpenAI Codex" icon="https://cdn.brandfetch.io/openai.com/icon?c=1idKqMnbT404MBn9xPc">
    <Steps>
      <Step title="Add the brew server">
        Open `~/.codex/config.toml` and add:

        ```toml theme={null}
        [mcp_servers.brew]
        url = "https://brew.new/api/mcp"
        ```
      </Step>

      <Step title="Sign in">
        Run `codex` and sign in with Brew when prompted.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Manus" icon="https://cdn.brandfetch.io/manus.im/icon?c=1idKqMnbT404MBn9xPc">
    <Steps>
      <Step title="Add a custom MCP server">
        Open **Manus → Settings → MCP / Connectors** and add a custom MCP server with the connection URL:

        ```
        https://brew.new/api/mcp
        ```
      </Step>

      <Step title="Connect">
        Sign in with Brew and pick a brand.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Windsurf" icon="https://cdn.brandfetch.io/windsurf.com/icon?c=1idKqMnbT404MBn9xPc">
    <Steps>
      <Step title="Open the raw config">
        **Settings → Cascade → MCP Servers → View raw config** (`~/.codeium/windsurf/mcp_config.json`).
      </Step>

      <Step title="Add the brew server">
        Windsurf uses `serverUrl` (not `url`):

        ```json theme={null}
        {
          "mcpServers": {
            "brew": {
              "serverUrl": "https://brew.new/api/mcp"
            }
          }
        }
        ```
      </Step>

      <Step title="Refresh & sign in">
        Click **Refresh** in the MCP panel and sign in with Brew when prompted.
      </Step>
    </Steps>

    <Note>Remote servers use the `serverUrl` key (everyone else uses `url`).</Note>
  </Tab>

  <Tab title="Cline" icon="https://cdn.brandfetch.io/cline.bot/icon?c=1idKqMnbT404MBn9xPc">
    <Steps>
      <Step title="Open MCP settings">
        Cline → **MCP Servers → Configure MCP Servers**.
      </Step>

      <Step title="Add the brew server">
        ```json theme={null}
        {
          "mcpServers": {
            "brew": {
              "url": "https://brew.new/api/mcp",
              "disabled": false
            }
          }
        }
        ```
      </Step>

      <Step title="Sign in">
        Save; Cline connects to the remote server and signs in with Brew.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Goose" icon="https://cdn.brandfetch.io/block.xyz/icon?c=1idKqMnbT404MBn9xPc">
    <Steps>
      <Step title="Run the configurator">
        ```bash theme={null}
        goose configure
        #  → Add Extension → Remote Extension (Streamable HTTP)
        #  name:     brew
        #  endpoint: https://brew.new/api/mcp
        ```
      </Step>

      <Step title="Sign in">
        Name it `brew`, paste the connection URL, then sign in with Brew.
      </Step>
    </Steps>

    <Note>Restart Goose after editing the config.</Note>
  </Tab>

  <Tab title="Any client" icon="https://cdn.brandfetch.io/modelcontextprotocol.io/icon?c=1idKqMnbT404MBn9xPc">
    <Steps>
      <Step title="Add the canonical block">
        Add Brew to your client's `mcpServers` map with the bare URL:

        ```json theme={null}
        {
          "mcpServers": {
            "brew": {
              "url": "https://brew.new/api/mcp"
            }
          }
        }
        ```
      </Step>

      <Step title="Sign in">
        Reload or restart the client, then sign in with Brew (OAuth) on first connect and pick your brand. If your client can't do the OAuth handshake, add an `Authorization: Bearer <brew key>` header instead (see below).
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Alternative: connect with an API key

If your client has no OAuth connector UI — or you're wiring up a headless / CI setup — authenticate with a **brand-scoped API key** instead. Create one at **Settings → API** and send it as a bearer header. The key carries the org + brand, so the URL stays the same:

```json theme={null}
{
  "mcpServers": {
    "brew": {
      "url": "https://brew.new/api/mcp",
      "headers": { "Authorization": "Bearer brew_YOUR_API_KEY" }
    }
  }
}
```

Claude Desktop's connector UI has no header field, so a key uses the `mcp-remote` bridge — **Settings → Developer → Edit Config**, paste this, then fully quit and reopen Claude:

```json theme={null}
{
  "mcpServers": {
    "brew": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://brew.new/api/mcp",
        "--header",
        "Authorization:Bearer ${BREW_API_KEY}"
      ],
      "env": { "BREW_API_KEY": "brew_YOUR_API_KEY" }
    }
  }
}
```

<Note>Write `Authorization:Bearer …` with no space after the colon — an `mcp-remote` arg quirk; it sends the correct header on the wire.</Note>

## Verify your connection

Once connected, ask your agent to call **`get_brew_capabilities`** — it returns the tool catalog, credit costs, and the guided workflows. Or smoke-test the endpoint directly with a key:

```bash theme={null}
curl -sN https://brew.new/api/mcp \
  -H "Authorization: Bearer brew_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

Next: the [quickstart](/api-reference/mcp/quickstart) create → send → analyze loop, the full [tool catalog](/api-reference/mcp/tools), and the guided [workflows](/api-reference/mcp/workflows).

## Need Help?

Our team is ready to support you at every step of your journey with Brew. Choose the option that works best for you:

<Tabs>
  <Tab title="Self-Service Tools">
    <CardGroup cols="2">
      <Card title="Search Documentation" icon="magnifying-glass" color="#c44925">
        Type in the "Ask any question" search bar at the top left to instantly find relevant documentation pages.
      </Card>

      <Card title="ChatGPT/Claude Integration" icon="robot" color="#c44925">
        Click "Open in ChatGPT" at the top right of any page to analyze documentation with ChatGPT or Claude for deeper insights.
      </Card>
    </CardGroup>
  </Tab>

  <Tab title="Talk to Our Team">
    <CardGroup cols="2">
      <Card title="Schedule a Call" icon="calendar" color="#c44925" href="https://calendar.google.com/calendar/u/0/appointments/schedules/AcZssZ1iYoRUG1J792XQpbuQLjSRRDupr7MwraFK-HQRCtTYdBmrQi8nZu2qXfzKQigb8gbKJK3KN3-R">
        Book time with our founders for personalized guidance on strategy, best practices, or complex implementation questions.
      </Card>

      <Card title="Call Us Directly" icon="phone" color="#c44925">
        Need immediate assistance? Reach us at **+1-(332)-203-2145** for urgent issues or time-sensitive questions.
      </Card>

      <Card title="Slack Channel" icon="slack" color="#c44925">
        Our preferred support channel. You'll receive an invite after signup for direct founder support and fast responses.
      </Card>

      <Card title="Email Support" icon="envelope" color="#c44925" href="mailto:support@brew.new">
        Contact us at **[support@brew.new](mailto:support@brew.new)** for detailed inquiries or if you prefer not to use Slack.
      </Card>
    </CardGroup>
  </Tab>
</Tabs>