MCP Server 配置指南
什么是 MCP Server？
概述
MCP（Model Context Protocol）是一种标准协议，让 AI 助手（如 Claude、ChatGPT 等）能直接调用盯价哨兵的数据。配置完成后，您可以在 AI 客户端中用自然语言查询竞品价格趋势、监控状态和预警信息，无需手动打开面板。配置过程约 2 分钟。
视频教程
视频说明
视频展示了从获取 MCP Key、复制连接地址到在 AI 客户端中添加 MCP Server 并验证连接的完整流程。建议先看视频，再按下方图文步骤操作。
步骤 1：获取您的 MCP Key
每个用户拥有独立的 MCP Key，用于身份认证。在盯价哨兵面板的 设置页面 点击「生成 MCP Key」按钮即可生成。Key 生成后请妥善保管，不要分享给他人。
获取方式
登录 盯价哨兵面板 → 进入「设置」页面 → 在 MCP Server 配置区域点击「生成 MCP Key」。
如果 Key 泄露或需要更换，可以点击「重新生成 Key」，旧 Key 会立即失效。
步骤 2：复制 MCP 连接地址
生成 Key 后，面板会显示完整的 MCP 连接地址，格式如下：
https://priceminder.online/mcp_server?key=您的MCP_KEY注意
请将完整地址（包含 ?key=xxx 参数）复制并妥善保存。地址已包含您的 Key，无需额外填写。
步骤 3：在 AI 客户端中添加 MCP Server
根据您使用的 AI 客户端，选择对应的配置方式。
Cherry Studio
打开 Cherry Studio → 设置 → MCP Servers → 添加服务器，选择 Streamable HTTP 类型：
{
"name": "shopee-sentinel",
"type": "streamable-http",
"url": "https://priceminder.online/mcp_server?key=您的MCP_KEY"
}Claude Desktop
编辑 Claude Desktop 配置文件（Settings → Developer → Edit Config），添加：
{
"mcpServers": {
"shopee-sentinel": {
"type": "streamable-http",
"url": "https://priceminder.online/mcp_server?key=您的MCP_KEY"
}
}
}Cursor
打开 Cursor → Settings → MCP → Add new MCP server，选择 HTTP 类型，填入步骤 2 的完整 URL。或在项目根目录创建 .cursor/mcp.json：
{
"mcpServers": {
"shopee-sentinel": {
"type": "streamable-http",
"url": "https://priceminder.online/mcp_server?key=您的MCP_KEY"
}
}
}Windsurf
打开 Windsurf → Cascade → Settings → MCP → Add MCP Server，粘贴步骤 2 的完整 URL。
{
"mcpServers": {
"shopee-sentinel": {
"url": "https://priceminder.online/mcp_server?key=您的MCP_KEY"
}
}
}步骤 4：验证连接
配置完成后，在 AI 客户端中尝试以下对话来验证连接是否成功：
「帮我查看当前有多少个监控商品」
「最近有哪些商品降价了？」
「显示我的 Shopee 监控概览」
验证成功的标志
AI 客户端能正确返回您的监控数据，而非报错或返回空结果。如果连接失败，请检查 MCP URL 是否完整复制、Key 是否有效。
可用工具（Tools）
连接成功后，AI 客户端可以调用以下工具：
| 工具名称 | 说明 |
|---|---|
list_monitors | 列出当前用户的所有监控商品 |
get_monitor_detail | 获取某个监控商品的详细信息和价格走势 |
get_price_history | 查询指定商品的历史价格记录 |
get_alerts | 获取降价预警记录 |
get_price_summary | 获取价格统计摘要（最低价、最高价、均价等） |
search_products | 搜索监控列表中的商品 |
完整的工具参数说明和调用示例，请参阅 MCP Tools 工具总览。
常见问题
MCP Key 泄露了怎么办？
在面板设置页面点击「重新生成 Key」按钮，旧 Key 会立即失效。然后在 AI 客户端中更新 MCP URL 即可。
可以在多个 AI 客户端中同时使用吗？
可以。同一个 MCP URL 可以在 Cherry Studio、Claude Desktop、Cursor 等多个客户端中配置，互不干扰。
AI 客户端连接失败？
请确认：
- 客户端支持 Streamable HTTP 类型（不是 SSE 或 stdio）
- URL 完整包含
?key=xxx参数 - 网络可以访问
mcp.priceminder.online
不想继续使用了怎么关闭？
在 AI 客户端中删除该 MCP Server 配置即可。如需彻底注销，点击「重新生成 Key」后再不保存新 Key，旧连接将全部失效。
详细使用文档
更完整的 MCP 使用指南、工具参数说明和最佳实践，请查看 MCP Tools 工具总览 和各客户端的详细配置文档。