# Setup: Claude Desktop/Web

***

## 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gradient.works/kb/mcp/setup_claude.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
