Claude Setup Guide

Step-by-step instructions to add the Crypto.com Market Data MCP server to Claude

Claude Setup

This guide will walk you through adding the Crypto.com Market Data MCP server to Claude. Choose the setup method that matches your usage:

• Claude Web (claude.ai) - For browser-based usage
• Claude Desktop App - For the desktop application with configuration file
• Claude Code - For command line users

Both methods take about 5 minutes to complete.

Claude Web Setup

This section covers setup for the Claude web interface at claude.ai.

Step-by-Step Instructions

Step 1: Open Claude Web

1. Open your web browser
2. Go to claude.ai
3. Sign in to your Claude account if you’re not already logged in

Step 2: Access Settings

1. Look for the menu icon (three horizontal lines) or your profile picture in the top right corner
2. Click on it to open the menu
3. Select Settings from the dropdown menu

Step 3: Navigate to Integrations

1. In the Settings menu, look for “Connectors” in the sidebar
2. Click on the connectors section
3. You should see options to add new integrations or connectors

Step 4: Add New Integration

1. Click the “Add custom connector” button
2. You should see a form asking for integration details

Step 5: Enter Server Details

Fill in the following information exactly as shown:

Name:

Crypto.com Market Data

Remote MCP URL:

https://mcp.crypto.com/market-data/mcp

Click “Add” to proceed

Step 6: Configure Permissions (Optional)

Claude may ask for permission to access external data.

1. Click “Connect” on the new connector
2. Click “Configure”
3. Select “Allow unsupervised”

Step 7: Refresh Your Browser

For the changes to take effect:

1. Refresh the page (F5 or Ctrl+R on Windows, Cmd+R on Mac)
2. Or close and reopen the claude.ai tab
3. Wait a few seconds for the page to fully load

Step 8: Verify It’s Working

Let’s test if the integration is working:

1. Start a new conversation by clicking “New chat” or the ”+” button
2. Type this question: “What’s the current price of Bitcoin?”
3. Press Enter and wait for the response

What to expect:

• ✅ Claude should give you the current, real-time price
• ✅ You might see a small indicator showing it’s using external data
• ✅ The response should include today’s date and recent market data

Troubleshooting

The Integrations option doesn’t appear

Possible reasons:

• You’re using a free account (may need Claude Pro)
• The feature isn’t available in your region yet
• Your browser is blocking the feature
• The feature is still in beta/limited rollout

Solutions:

1. Upgrade to Claude Pro

   • Go to Settings > Subscription
   • Click “Upgrade to Pro”
   • Complete the subscription process ($20/month)

2. Check browser compatibility

   • Try Chrome, Firefox, Safari, or Edge
   • Disable browser extensions temporarily
   • Clear browser cache and cookies
   • Try incognito/private mode

3. Contact Anthropic Support

   • Ask about MCP availability in your region
   • Request beta access if applicable

Can’t add the integration

Problem: The “Add Integration” button doesn’t work or is grayed out.

Solutions:

1. Verify your subscription

   • Check if you have Claude Pro active
   • Ensure payment is up to date
   • Free tier may have limited integration access

2. Try a different browser

   • Chrome and Edge usually have best compatibility
   • Update your browser to the latest version
   • Disable ad blockers or privacy extensions

3. Clear browser data

   • Clear cache: Settings > Privacy > Clear browsing data
   • Clear cookies for claude.ai
   • Sign out and sign back in
   • Try adding the integration again

Claude doesn’t use the integration

Problem: You ask about crypto prices but get old data or “I don’t have access to real-time data” responses.

Solutions:

1. Start a new conversation

   • Click “New chat” or the ”+” button
   • Try your question in the fresh conversation
   • Old conversations may not use new integrations

2. Be explicit in your question

   • Instead of: “Tell me about Bitcoin”
   • Try: “What’s the current real-time price of Bitcoin right now?”
   • Use phrases like:
     • “current price”
     • “latest data”
     • “real-time information”
     • “today’s market data”

3. Check if connector is enabled

   • Go to Settings > Connectors
   • Find Crypto.com Market Data
   • Make sure toggle is ON
   • If OFF, turn it on and refresh

4. Verify the URL is correct

   • Settings > Connectors > Crypto.com Market Data
   • URL should match exactly (compare with Step 5)
   • No extra spaces or characters
   • Fix any typos and save

5. Mention the integration explicitly

   • Try: “Using the Crypto.com integration, what’s the current price of Bitcoin?”
   • This explicitly tells Claude to use the integration

Error messages

Error: “Unable to connect to external server”

Solutions:

• Check your internet connection
• Verify the URL is exactly correct
• Wait a few minutes and try again
• The server might be temporarily busy
• Refresh your browser

Error: “Integration not authorized”

Solutions:

• Remove the integration completely
• Add it again from scratch
• Make sure you’re signed in to Claude
• Check if your Pro subscription is active

Error: “Rate limit exceeded”

Solutions:

• You may have made too many requests
• Wait 5-10 minutes before trying again
• Reduce the frequency of your queries
• This is a temporary limitation

Understanding Integration Indicators

When Claude uses the MCP integration, you might see:

• 🔌 A small icon or badge indicating external data
• 📊 A note saying “Using Crypto.com Market Data”
• 🕐 A timestamp showing when data was fetched
• 🔗 A link or reference to the data source

These indicators confirm the integration is working.

Claude Desktop Setup

This section covers setup for the Claude Desktop application using a configuration file.

Step 1: Locate the Configuration File

The Claude Desktop configuration file is located in different places depending on your operating system:

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Linux:

~/.config/Claude/claude_desktop_config.json

Step 2: Open the Configuration File

1. Locate the file using the path above for your operating system
2. Right-click on claude_desktop_config.json
3. Select “Open with” and choose a text editor
4. If the file doesn’t exist, create a new file with this exact name

Step 3: Add the MCP Server Configuration

Copy and paste the following JSON configuration into your file:

If the file is empty or new:

{
"mcpServers": {
  "crypto-market-data": {
    "type": "http",
    "url": "https://mcp.crypto.com/market-data/mcp"
  }
}
}

If the file already has content:

Look for the "mcpServers" section. If it exists, add the crypto-market-data configuration inside it:

{
"mcpServers": {
  "existing-server": {
    "type": "http",
    "url": "https://example.com/other-server"
  },
  "crypto-market-data": {
    "type": "http",
    "url": "https://mcp.crypto.com/market-data/mcp"
  }
}
}

Step 4: Save the File

1. Save the file (Ctrl+S on Windows/Linux, Cmd+S on macOS)
2. Close the text editor
3. Make sure the file is saved in the correct location

Step 5: Restart Claude Desktop

1. Quit Claude Desktop completely (not just close the window)
   • macOS: Right-click the Claude icon in the Dock > Quit
   • Windows: Right-click the Claude icon in the system tray > Exit
   • Linux: Use your system’s method to quit the application
2. Wait a few seconds
3. Reopen Claude Desktop

Step 6: Verify It’s Working

1. Open Claude Desktop
2. Start a new conversation
3. Type: “What’s the current price of Bitcoin?”
4. Press Enter and wait for the response

What to expect:

• ✅ Claude should give you the current, real-time price
• ✅ You might see a small indicator showing it’s using the MCP server
• ✅ The response should include today’s date and recent market data

Troubleshooting Desktop Setup

Configuration file not found:

• Create the file manually in the correct location
• Make sure the directory exists (create it if needed)
• Use the exact filename: claude_desktop_config.json

JSON syntax errors:

• Use a JSON validator to check your file
• Make sure all brackets match
• Check for missing or extra commas
• Ensure you’re using double quotes

Claude doesn’t use the MCP server:

• Verify the configuration is saved correctly
• Make sure you fully quit and restarted Claude
• Check the file location is correct for your OS
• Try asking explicitly: “Using the crypto market data, what’s the price of Bitcoin?”

Connection errors:

• Verify the URL is exactly: https://mcp.crypto.com/market-data/mcp
• Check your internet connection
• Make sure the "type" is set to "http"
• Try restarting Claude Desktop again

Claude Code Setup

This section covers setup for Claude Code, Anthropic’s code editor/IDE.

Step 1: Open Your Terminal

1. Open your terminal or command prompt
2. Navigate to your project directory (optional, but recommended)

Step 2: Add the MCP Server

Run the following command in your terminal:

claude mcp add --transport http -s user crypto-market-data https://mcp.crypto.com/market-data/mcp

Command breakdown:

• claude mcp add - Adds a new MCP server
• --transport http - Specifies HTTP transport (for remote servers)
• -s user - Makes it available in all your projects (user scope)
• crypto-market-data - The name for this MCP server
• https://mcp.crypto.com/market-data/mcp - The server URL

claude mcp add --transport http crypto-market-data https://mcp.crypto.com/market-data/mcp

Step 3: Verify Installation

After running the command, you should see a confirmation message. The MCP server is now configured!

Step 4: Test It Out

1. Open Claude Code
2. Start a new chat or open an existing project
3. Ask: “What’s the current price of Bitcoin?”
4. Wait for the response

What to expect:

• ✅ Claude should give you the current, real-time price
• ✅ You might see an indicator showing it’s using the MCP server
• ✅ The response should include today’s date and recent market data

Managing MCP Servers in Claude Code

List all configured MCP servers:

claude mcp list

Remove an MCP server:

claude mcp remove crypto-market-data

View MCP server details:

claude mcp show crypto-market-data

Troubleshooting Claude Code Setup

Command not found:

• Make sure Claude Code is properly installed
• Verify the claude command is in your PATH
• Try restarting your terminal

Server not responding:

• Check your internet connection
• Verify the URL is correct: https://mcp.crypto.com/market-data/mcp
• Try removing and re-adding the server

Claude doesn’t use the MCP server:

• Make sure you’re in the right scope (user vs project)
• Try explicitly asking: “Using the crypto market data, what’s the price of Bitcoin?”
• Restart Claude Code

What’s Next?

Now that you’ve set up the integration, explore what you can do:

• Example Prompts - 30+ example questions to try
• Features - Learn about all available data
• Troubleshooting - Solutions to common problems
• FAQ - Frequently asked questions

Need More Help?

If you’re still having issues:

1. Check the Troubleshooting Guide
2. Read the FAQ
3. Try the Claude Desktop Setup instead
4. Contact Anthropic support for Claude-specific issues