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

# Connect to Claude

> Set up the Ryze connector in Claude and verify it works

This connects Ryze to Claude so you can list accounts, pull reports, and make changes from chat. It takes about 30 seconds.

<Note>
  Use **Claude Desktop** for the most reliable connection. The web version (claude.ai) works too, but it can time out on slower connections — if something stalls, switch to Desktop.
</Note>

## Step 1 — Generate your connection key

In your Ryze dashboard, open the **Ryze MCP (Claude Connector)** section at [app.get-ryze.ai/integrations](https://app.get-ryze.ai/integrations). Under **Connection keys**, name the key (e.g. "Claude Desktop"), click **Generate Key**, and copy it.

<Frame>
  <img src="https://mintcdn.com/ryzeai/ihef_5lqYEXNFkmE/images/connection-key.png?fit=max&auto=format&n=ihef_5lqYEXNFkmE&q=85&s=bb2b252c62d14478fbf2afcbfb0c79d5" alt="Generate a connection key in the Ryze dashboard" width="1600" height="886" data-path="images/connection-key.png" />
</Frame>

## Step 2 — Add the connector in Claude

<Steps>
  <Step title="Open Settings">
    Click your account menu (bottom-left) and choose **Settings**.

    <Frame>
      <img src="https://mintcdn.com/ryzeai/ihef_5lqYEXNFkmE/images/claude-open-settings.png?fit=max&auto=format&n=ihef_5lqYEXNFkmE&q=85&s=668db8eeb7a5ddf944eedbbc79272e97" alt="Open Settings from the Claude account menu" width="1600" height="886" data-path="images/claude-open-settings.png" />
    </Frame>
  </Step>

  <Step title="Go to Connectors → Customize">
    Open **Connectors**. They now live under **Customize** — click that link.

    <Frame>
      <img src="https://mintcdn.com/ryzeai/ihef_5lqYEXNFkmE/images/claude-connectors-moved.png?fit=max&auto=format&n=ihef_5lqYEXNFkmE&q=85&s=0012d97a3b657081ecbe9543bcf21889" alt="Connectors have moved to Customize" width="1600" height="886" data-path="images/claude-connectors-moved.png" />
    </Frame>
  </Step>

  <Step title="Add a custom connector">
    In **Customize → Connectors**, click the **+** to add one.

    <Frame>
      <img src="https://mintcdn.com/ryzeai/ihef_5lqYEXNFkmE/images/claude-add-connector.png?fit=max&auto=format&n=ihef_5lqYEXNFkmE&q=85&s=bd2605aef85d2aefea6c61da16339a38" alt="Add a custom connector with the plus button" width="1600" height="886" data-path="images/claude-add-connector.png" />
    </Frame>
  </Step>

  <Step title="Enter the details">
    Name it **Ryze AI** and paste the URL `https://mcp.get-ryze.ai/mcp/unified/`. Expand **Advanced settings** and paste your **connection key** into the **OAuth Client ID** field, then click **Add**.

    <Frame>
      <img src="https://mintcdn.com/ryzeai/ihef_5lqYEXNFkmE/images/claude-connector-dialog.png?fit=max&auto=format&n=ihef_5lqYEXNFkmE&q=85&s=91134b7a836cc2186220b3fefd68f15f" alt="Add custom connector dialog with URL and OAuth Client ID field" width="1600" height="886" data-path="images/claude-connector-dialog.png" />
    </Frame>
  </Step>
</Steps>

## Step 3 — Verify it works

Open **Customize → Connectors** and select **Ryze AI**. A connected connector shows the Ryze URL and a long list of available tools.

<Frame>
  <img src="https://mintcdn.com/ryzeai/ihef_5lqYEXNFkmE/images/connector-connected.png?fit=max&auto=format&n=ihef_5lqYEXNFkmE&q=85&s=c45f79537f285c610f737d8b7bdb3cfd" alt="Ryze AI connector connected in Claude with its tools listed" width="1600" height="876" data-path="images/connector-connected.png" />
</Frame>

You can also test it in chat — ask Claude:

> list my ad accounts

If it returns your accounts, you're done. If it stalls, see the [FAQ](/connect/faq).
