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: Open a New Chat and Access Search and Tools

1. Click New chat in the top left corner
2. In the chat interface, look for “Search and tools”
3. Click on it to open the tools panel

Step 3: Add the Connector

1. Click “Add connectors”
2. Search for “Crypto.com” in the search bar
3. Click the + button next to the Crypto.com connector to add it

Step 4: Enable the Connector

When you start a conversation with Claude:

1. Make sure the Crypto.com connector is turned on in your chat
2. You can toggle it on/off as needed for different conversations

Step 5: 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 Search and tools 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 find the Crypto.com connector

Problem: The Crypto.com connector doesn’t appear in the connector search.

Solutions:

1. Verify your subscription

   • Check if you have Claude Pro active
   • Ensure payment is up to date
   • Free tier may have limited connector 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 searching for the connector again

Claude doesn’t use the connector

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 connectors

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

   • Open “Search and tools” in the chat interface
   • Find Crypto.com connector
   • Make sure it is turned ON for your conversation
   • If OFF, turn it on and try again

4. Mention the connector explicitly

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

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