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 类型：

配置文件路径：无独立配置文件，配置保存在 Cherry Studio 应用内（设置 → MCP Servers）。

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

WorkBuddy（腾讯，国内常用）

打开 WorkBuddy → 左侧边栏「专家 · 技能 · 连接器」→「连接器」标签 → 右上角「自定义连接器」→「配置 MCP」，把下面这段 JSON 粘进去：

配置文件路径：用户级 ~/.workbuddy/mcp.json（跨项目生效）；项目级 <项目根目录>/.workbuddy/mcp.json（仅该项目生效）。

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

保存后回到「MCP 服务」列表，点该条目右侧的「信任」（首次连接必须手动信任，否则不会加载工具），状态变为「已连接」并列出 22 个工具即成功。

说明

WorkBuddy 同时支持 http（流式）、sse、stdio 三种传输，盯价哨兵用 http。 个别版本对 type 取值较严格：若保存后提示不识别，先改成 "type": "streamableHttp"；仍不行就把 type 整行删掉——只要保留 url 字段，客户端会自动按 HTTP 推断。

豆包（字节，国内常用）

豆包的自定义连接器是表单填写，不是粘贴 JSON：

打开豆包客户端 → 左侧「插件 · 技能 · 伙伴」→ 插件页右上角「+ 添加」→「新建自定义连接器」，按下表填写：

配置文件路径：无独立配置文件，配置保存在豆包桌面客户端内（自定义连接器表单）。

字段	填写内容
服务器名称	盯价哨兵
传输类型	HTTP
服务器 URL	https://priceminder.online/mcp_server
自定义 Headers	Authorization = Bearer 您的MCP_KEY

Bearer 后面有一个空格，漏掉会被判为无效凭证。详细步骤见 豆包接入。

保存后首页会出现「盯价哨兵」插件卡片，点开能看到工具列表，点右下角「在对话中试用」验证。

注意

豆包的自定义连接器仅在桌面客户端可用（网页版不支持），且必须与你的电脑处于同一网络环境；盯价哨兵是公网 HTTPS 服务，无需本地装包。

Claude Desktop

编辑 Claude Desktop 配置文件（Settings → Developer → Edit Config），添加：

配置文件路径：Windows %APPDATA%\Claude\claude_desktop_config.json；macOS ~/Library/Application Support/Claude/claude_desktop_config.json。

{
  "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：

配置文件路径：项目级 .cursor/mcp.json（项目根目录）；用户级 ~/.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。

配置文件路径：~/.codeium/windsurf/mcp_config.json。

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

步骤 4：验证连接

配置完成后，在 AI 客户端中尝试以下对话来验证连接是否成功：

「帮我查看当前有多少个监控商品」

「最近有哪些商品降价了？」

「显示我的 Shopee 监控概览」

验证成功的标志

AI 客户端能正确返回您的监控数据，而非报错或返回空结果。如果连接失败，请检查 MCP URL 是否完整复制、Key 是否有效。

常见问题

MCP Key 泄露了怎么办？

在面板设置页面点击「重新生成 Key」按钮，旧 Key 会立即失效。然后在 AI 客户端中更新 MCP URL 即可。

可以在多个 AI 客户端中同时使用吗？

可以。同一个 MCP URL 可以在 Cherry Studio、Claude Desktop、Cursor 等多个客户端中配置，互不干扰。

AI 客户端连接失败？

请确认：

1. 客户端支持 Streamable HTTP（不是 SSE 或 stdio）
2. URL 完整包含 ?key=xxx 参数
3. 网络可以访问 priceminder.online（连接地址的域名是 priceminder.online，不是 mcp.priceminder.online）

不想继续使用了怎么关闭？

在 AI 客户端中删除该 MCP Server 配置即可。如需彻底注销，点击「重新生成 Key」后再不保存新 Key，旧连接将全部失效。

详细使用文档

更完整的 MCP 使用指南、工具参数说明和最佳实践，请查看 MCP Tools 工具总览 和各客户端的详细配置文档。