MCP Server Configuration Guide

What is MCP Server?

Overview

MCP (Model Context Protocol) is a standard protocol that allows AI assistants (such as Claude, ChatGPT, etc.) to directly call PriceMinder data. Once configured, you can use natural language in your AI client to query competitor price trends, monitor status, and alert information — without manually opening any dashboard. Configuration takes approximately 2 minutes.

Video Tutorial

Video Overview

The video demonstrates the complete workflow: obtaining the MCP Key, copying the connection URL, adding the MCP Server in the AI client, and verifying the connection. Watch the video first, then follow the step-by-step instructions below.

Step 1: Get Your MCP Key

Each user has a unique MCP Key for authentication. Go to the Settings page in the PriceMinder dashboard and click "Generate MCP Key" to create one. After generating the Key, keep it safe and do not share it with others.

How to Obtain

Log in to the PriceMinder Dashboard → Go to the "Settings" page → Click "Generate MCP Key" in the MCP Server configuration area.

If your Key is leaked or needs to be replaced, click "Regenerate Key" — the old Key will be invalidated immediately.

Step 2: Copy the MCP Connection URL

After generating the Key, the dashboard will display the full MCP connection URL in the following format:

https://priceminder.online/mcp_server?key=YOUR_MCP_KEY

Warning

Please copy the complete URL (including the ?key=xxx parameter) and keep it safe. The URL already contains your Key — no additional configuration is needed.

Step 3: Add MCP Server in Your AI Client

Choose the appropriate configuration method based on the AI client you are using.

Cherry Studio

Open Cherry Studio → Settings → MCP Servers → Add Server, select Streamable HTTP type:

{
  "name": "shopee-sentinel",
  "type": "streamable-http",
  "url": "https://priceminder.online/mcp_server?key=YOUR_MCP_KEY"
}

Claude Desktop

Edit the Claude Desktop configuration file (Settings → Developer → Edit Config) and add:

{
  "mcpServers": {
    "shopee-sentinel": {
      "type": "streamable-http",
      "url": "https://priceminder.online/mcp_server?key=YOUR_MCP_KEY"
    }
  }
}

Cursor

Open Cursor → Settings → MCP → Add new MCP server, select HTTP type, and paste the full URL from Step 2. Alternatively, create .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "shopee-sentinel": {
      "type": "streamable-http",
      "url": "https://priceminder.online/mcp_server?key=YOUR_MCP_KEY"
    }
  }
}

Windsurf

Open Windsurf → Cascade → Settings → MCP → Add MCP Server and paste the full URL from Step 2.

{
  "mcpServers": {
    "shopee-sentinel": {
      "url": "https://priceminder.online/mcp_server?key=YOUR_MCP_KEY"
    }
  }
}

Step 4: Verify the Connection

After configuration, try the following conversations in your AI client to verify the connection:

"How many products am I currently monitoring"

"Which products have dropped in price recently?"

"Show me my Shopee monitoring overview"

Signs of a Successful Connection

The AI client correctly returns your monitoring data, rather than showing errors or returning empty results. If the connection fails, check whether the MCP URL was fully copied and the Key is valid.

Available Tools

After connecting, your AI client can call the following tools:

Tool Name	Description
list_monitors	List all monitored products for the current user
get_monitor_detail	Get detailed information and price trend for a specific monitored product
get_price_history	Query historical price records for a specific product
get_alerts	Get price drop alert records
get_price_summary	Get price statistics summary (lowest, highest, average, etc.)
search_products	Search for products in the monitoring list

For complete tool parameter documentation and usage examples, see MCP Tools Overview.

FAQ

What if my MCP Key is leaked?

Click "Regenerate Key" on the dashboard settings page. The old Key will be invalidated immediately. Then update the MCP URL in your AI client.

Can I use it in multiple AI clients simultaneously?

Yes. The same MCP URL can be configured in multiple clients such as Cherry Studio, Claude Desktop, and Cursor simultaneously without interference.

AI client connection fails?

Please verify:

1. The client supports Streamable HTTP type (not SSE or stdio)
2. The URL fully includes the ?key=xxx parameter
3. Your network can reach mcp.priceminder.online

How do I disable it?

Simply delete the MCP Server configuration from your AI client. To fully revoke access, click "Regenerate Key" and do not save the new Key anywhere — all old connections will be invalidated.

Further Documentation

For the complete MCP usage guide, tool parameter documentation, and best practices, see MCP Tools Overview and the detailed configuration docs for each client.