# Remote MCP (Recommended)

## Quick Start

Remote MCP is the easiest way to connect. CryptoQuant hosts the MCP server, and your AI client connects to it directly via URL.

> **Which method should I use?**
>
> * **Connector** — Recommended for most users. Simply connect and start asking questions in Claude.ai or Claude Desktop.
> * **Config Setting** — For developers who want to integrate CryptoQuant MCP into their own workflows or tools.

### Using Connector 

— [Claude.ai](http://claude.ai) and Claude Desktop

1. In Claude, click **"Add connectors"**

2. Select **"Add custom connector"**

   ![Add custom connector](https://3443265903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwY9jt5nY3DeH5c1WCCsW%2Fuploads%2F2SKdQxheLIHJjQg63ofD%2Fimage%20\(7\).png?alt=media\&token=690f1930-d6dd-4dd2-a71a-0ead0c5b0236)

3. Enter the following:
   * **Name**: `CryptoQuant`
   * **Remote MCP Server URL**: `https://mcp.cryptoquant.com/mcp`

4. Click **"Add"**

5. Click **"Connect"**

   ![Connect connector](https://3443265903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwY9jt5nY3DeH5c1WCCsW%2Fuploads%2FBLw0TMctjCcMgbAOMaeB%2Fimage%20\(8\).png?alt=media\&token=fef3cc02-9b29-4c75-830b-24391bc0f565)

6. Choose either **API Key** or **Keyless** authentication

   ![Authentication options](https://3443265903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwY9jt5nY3DeH5c1WCCsW%2Fuploads%2F41IAwD74R6gsZqvh7tjw%2Fimage%20\(9\).png?alt=media\&token=a197d5dd-c7b0-4d2d-9130-d0bc8e3e625c)

   > ⚠️ **Keyless mode uses a shared rate limit pool.** This means limits may be reached more quickly due to usage from other users. For a dedicated rate limit, use your [own API Key](https://cryptoquant.com/settings/api).

7. You're ready to go!

### Using Config Setting

— Claude Desktop/Claude Code/Cursor

> ⚠️ **Prerequisites**: Node.js v18 or higher must be installed. [Download from nodejs.org](https://nodejs.org/en/download)

Add the following to your MCP configuration file:

#### **Claude Desktop (claude\_desktop\_config.json)**

path for Mac : `~/Library/Application Support/Claude/claude_desktop_config.json`

path for Windows : `%APPDATA%\\Claude\\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "CryptoQuant": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.cryptoquant.com/mcp"
      ]
    }
  }
}
```

#### **Cursor (mcp.json)**

path `.cursor/mcp.json`

```json
{
  "mcpServers": {
    "CryptoQuant": {
      "url": "https://mcp.cryptoquant.com/mcp"
    }
  }
}
```

#### **Claude Code**

```bash
claude mcp add --transport http CryptoQuant https://mcp.cryptoquant.com/mcp
```

After saving, restart the app.

#### Authentication

Complete the authentication flow the same way as the Connector setup above.

## Troubleshooting

#### Remote MCP Connection Issues

1. Verify the server URL is correct: `https://mcp.cryptoquant.com/mcp`
2. Check your internet connection
3. For desktop clients using config setting, verify Node.js v18+ is installed
4. Try refreshing the connector or removing and re-adding it

#### API Key Issues

1. Verify the API key is valid [on the settings page](https://cryptoquant.com/settings/api)
2. If using environment variables, verify they are set correctly