> 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)

Connect the Gradient Works MCP server to Claude Desktop, Web, or CLI

## Set up with the Gradient Works plugin

The Gradient Works plugin configures the MCP and installs the included Gradient Works skills.

### Ask your agent to set it up

Paste the following text into your agent:

```
Can you help me set up Gradient Works by following this guide?
https://github.com/Gradient-Works/agent-plugins/blob/main/GETTING_STARTED.md
```

### Install it yourself

In Claude Code, run these commands:

```
/plugin marketplace add Gradient-Works/agent-plugins
/plugin install gradient-works@gradient-works-plugins
```

The MCP server comes with the plugin. Sign in when prompted. For Cowork, Claude Desktop, claude.ai, and additional setup details, see the [agent-plugins README](https://github.com/Gradient-Works/agent-plugins/blob/main/README.md).

## Set up the MCP directly

### Claude Desktop or Web — Personal

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

<figure><img src="https://2378295204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYXbv7c6RsZzQ00WCDTM%2Fuploads%2Fgit-blob-12e0885a97ce05b1e5c60d25e112283abf8d8d91%2Fmcp-claude-personal-connectors.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2378295204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYXbv7c6RsZzQ00WCDTM%2Fuploads%2Fgit-blob-866cfd9494b4251588b4e67564e477c13d10df8f%2Fmcp-claude-personal-add-connector.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2378295204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYXbv7c6RsZzQ00WCDTM%2Fuploads%2Fgit-blob-8fc9cb093d64189f4a3eb6488f5c96ac5dfa646b%2Fmcp-claude-sign-in.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2378295204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYXbv7c6RsZzQ00WCDTM%2Fuploads%2Fgit-blob-d821e3175cf46f7c55ef1750d0da00e262fe1789%2Fmcp-gw-sign-in.png?alt=media" alt=""><figcaption></figcaption></figure>

5. Select your account and permission settings as needed.

<figure><img src="https://2378295204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYXbv7c6RsZzQ00WCDTM%2Fuploads%2Fgit-blob-cb538956e4fcb5a80d2f44a82fa5bbe979f1f37c%2Fmcp-gw-account-permissions.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2378295204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYXbv7c6RsZzQ00WCDTM%2Fuploads%2Fgit-blob-ed542e471efcab8ecda2ae05f9ca33006d05389c%2Fmcp-gw-connect-now.png?alt=media" 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="https://2378295204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYXbv7c6RsZzQ00WCDTM%2Fuploads%2Fgit-blob-c633949b1fbbfd2c9bc4c6e1348c4c90a9215bd8%2Fmcp-claude-team-org-connectors.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2378295204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYXbv7c6RsZzQ00WCDTM%2Fuploads%2Fgit-blob-a648de878b64372bc237db3937b974bb6bd2150d%2Fmcp-claude-team-org-add-connector.png?alt=media" 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="https://2378295204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYXbv7c6RsZzQ00WCDTM%2Fuploads%2Fgit-blob-1ec014201f1035ca2b7170933500b00330b63e2a%2Fmcp-claude-team-user-not-connected.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2378295204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYXbv7c6RsZzQ00WCDTM%2Fuploads%2Fgit-blob-8fc9cb093d64189f4a3eb6488f5c96ac5dfa646b%2Fmcp-claude-sign-in.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2378295204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYXbv7c6RsZzQ00WCDTM%2Fuploads%2Fgit-blob-d821e3175cf46f7c55ef1750d0da00e262fe1789%2Fmcp-gw-sign-in.png?alt=media" alt=""><figcaption></figcaption></figure>

4. Select your account and permission settings as needed.

<figure><img src="https://2378295204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYXbv7c6RsZzQ00WCDTM%2Fuploads%2Fgit-blob-cb538956e4fcb5a80d2f44a82fa5bbe979f1f37c%2Fmcp-gw-account-permissions.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2378295204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYXbv7c6RsZzQ00WCDTM%2Fuploads%2Fgit-blob-ed542e471efcab8ecda2ae05f9ca33006d05389c%2Fmcp-gw-connect-now.png?alt=media" 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.