> For the complete documentation index, see [llms.txt](https://docs.gradient.works/kb/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gradient.works/kb/mcp/setup_claude.md).

# Setup: Claude (Desktop, Web, or CLI)

## Claude Desktop or Web — Personal

1. Go to **Customize > Connectors**.
2. Click the **+** button and choose **Add custom connector**.

<figure><img src="/files/vMouozSQndY4N8UYKhAB" alt=""><figcaption></figcaption></figure>

3. Fill in the connector details:
   * **Name:** Gradient Works
   * **Remote URL:** `https://agents.gradient.works/mcp`

<figure><img src="/files/qMRzmDPmpjAGWpQmyFRr" alt=""><figcaption></figcaption></figure>

4. When prompted, sign into Claude, then sign into Gradient Works with your Gradient Works credentials.

<figure><img src="/files/lsadUxzXNDW9AcpiljnP" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/TT7cTlgSSLWu6rEDbMIf" alt=""><figcaption></figcaption></figure>

5. Select your account and permission settings as needed.

<figure><img src="/files/xAUq9BPrB0JrKYl3m7kJ" alt=""><figcaption></figcaption></figure>

6. Click **Connect Now** to return to Claude.

<figure><img src="/files/Dm3KpZ1Zv3zgIBWWnhAB" alt=""><figcaption></figcaption></figure>

***

## Claude Desktop or Web — Team

Organization admins must add the connector at the org level before individual users can connect.

### Admin: add the connector for your organization

1. Go to **Organization Settings > Connectors**.
2. Click **Add > Custom > Web**.

<figure><img src="/files/ygnO6ySB3sXtzB99mEXk" alt=""><figcaption></figcaption></figure>

3. Fill in the connector details:
   * **Name:** Gradient Works
   * **URL:** `https://agents.gradient.works/mcp`

<figure><img src="/files/tfiuMgIYZ4g3mPBLYwkx" alt=""><figcaption></figcaption></figure>

4. Save the connector.

### Users: connect to the org connector

1. Go to **Customizer > Connectors**.
2. Find **Gradient Works** under Not Connected and click **Connect**.

<figure><img src="/files/eLnWioXiVDrspXh5Rbaf" alt=""><figcaption></figcaption></figure>

3. When prompted, sign into Claude, then sign into Gradient Works with your Gradient Works credentials.

<figure><img src="/files/lsadUxzXNDW9AcpiljnP" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/TT7cTlgSSLWu6rEDbMIf" alt=""><figcaption></figcaption></figure>

4. Select your account and permission settings as needed.

<figure><img src="/files/xAUq9BPrB0JrKYl3m7kJ" alt=""><figcaption></figcaption></figure>

5. Click **Connect Now** to return to Claude.

<figure><img src="/files/Dm3KpZ1Zv3zgIBWWnhAB" alt=""><figcaption></figcaption></figure>

***

## Claude Code CLI

1. Run the following command in your terminal:

```bash
claude mcp add --transport http gradient-works https://agents.gradient.works/mcp
```

2. When prompted, sign into Gradient Works with your Gradient Works credentials.
3. Select your account and permission settings as needed.
4. Click **Connect Now** to return to the CLI.