豆包接入
豆包(字节跳动)通过「自定义连接器」支持 MCP 协议。它的配置方式是表单填写,不是粘贴 JSON。
| 项 | 值 |
|---|---|
| 配置文件路径 | 无独立配置文件,配置保存在豆包桌面客户端内(自定义连接器表单) |
| 客户端要求 | 仅桌面客户端可用,网页版不支持 |
配置步骤
- 打开豆包桌面客户端 → 左侧「插件 · 技能 · 伙伴」
- 插件页右上角「+ 添加」→「新建自定义连接器」
- 按下表填写:
| 字段 | 填写内容 |
|---|---|
| 服务器名称 | 盯价哨兵 |
| 传输类型 | HTTP |
| 服务器 URL | https://priceminder.online/mcp_server |
| 自定义 Headers | 名称 Authorization,值 Bearer 您的MCP_KEY |
三个容易填错的地方
Bearer后面必须有一个空格,再跟你的 Key,写成Bearer abc-123。漏空格会被判成无效凭证。Bearer是英文单词,不要写成中文全角字符。- 地址要写到
/mcp_server这一段。只填域名(不带路径)大多数客户端会连不上;也不要写成priceminder.online/mcp,那个路径会 301 跳转导致请求失败。
- 保存后首页会出现「盯价哨兵」插件卡片,点开能看到 22 个工具,点右下角「在对话中试用」验证
为什么推荐用 Headers 传 Key
把 Key 放进 URL(...?key=xxx)同样能用,但 Key 会完整出现在访问日志、浏览器历史和截图里。放进请求头只随请求体传输,不会落到日志的 URL 字段,泄露面小得多。两种方式服务端都支持,新配置建议一律用 Headers。
备选:把 Key 放进 URL
如果你的豆包版本没有「自定义 Headers」这一栏,可以把 Key 拼进地址:
| 字段 | 填写内容 |
|---|---|
| 服务器 URL | https://priceminder.online/mcp_server?key=您的MCP_KEY |
| 自定义 Headers | 留空 |
这种写法能立即使用,但请勿把带 Key 的完整地址截图发到公开渠道。
验证
配置完成后,在豆包对话中输入:
- "我的监控列表" → 应返回监控商品数据
- "有没有新的降价预警" → 应返回预警记录
能返回真实数据,说明 Key 已通过校验、连接器工作正常。
常见问题
- 401 Unauthorized:
Authorization的值缺了Bearer前缀,或空格缺失;也可能是 Key 已过期,可在面板的 MCP 中心重新生成 - 工具不显示:确认连接器处于启用状态;部分版本需要关掉插件再重新打开才刷新工具列表
- 网页版找不到入口:自定义连接器只在桌面客户端提供,网页版没有这个入口
- 地址填错:必须是
priceminder.online域名下的/mcp_server路径;priceminder.online/mcp会 301 跳转,POST 请求会失败 - 换了新 Key 后连不上:回到连接器设置里改
Authorization的值即可,不需要删除重建