让 AI 应用直接调用熊洞数据接口的开放协议，理解为「数据插头」即可。
运营 MCP 与服务 MCP 两份专属服务，附 Token 与可粘贴的 JSON 配置。
接入后问一句「你可以使用哪些工具？」即可确认是否生效。
01 · 开 始 之 前
先把这两个关键点吃透，下面所有步骤都会更顺畅。
mcptoken
不是 Bearer
熊洞平台使用自定义请求头 mcptoken 鉴权，不是互联网上多数 MCP 服务使用的 Authorization: Bearer 写法。把名称写错就会直接返回 401 未授权。
// 正确写法 mcptoken: <你的Token> // 错误写法（会导致 401） Authorization: Bearer <你的Token>
Token 与你的熊洞账号一一绑定，请勿在群聊、截图、公开代码仓库或文档中泄露。一旦发现泄露，请立即联系平台客服重置。
02 · 准 备 工 作
登录熊洞商家后台 → 进入「我的 MCP」页面 → 拿到 Token 与 JSON 配置，后续所有步骤都依赖这两样东西。
登录商家后台，在左侧菜单选择 我的 MCP。
在「基本信息」区域点击 Token 旁边的复制按钮。
在「MCP 服务配置」区域点击右上角的复制按钮，整段使用。
03 · 可 用 服 务
完成配置后即可调用以下服务。服务地址与 Token 在「我的 MCP」页面以实际展示为准。
04 · 通 用 配 置 模 板
下面的 JSON 已自动填好地址与 Token，建议直接整段复制使用，不要手工改写。占位符 <你的Token> 仅用于示意。
{ "mcpServers": { "recycle-stats": { "label": "运营MCP", "type": "http", "url": "https://mcp.bearhome.cn/mcp", "headers": { "mcptoken": "<你的Token>" }, "disabled": false }, "service-mcp": { "label": "服务MCP", "type": "http", "url": "https://mcp.bearhome.cn/fwmcp/mcp/sse", "headers": { "mcptoken": "<你的Token>" }, "disabled": false } } }
http / streamable-http / ssemcptokenfalse 表示启用05 · 接 入 指 南
先选你的客户端，下面每一步都标注了具体点击位置与操作截图描述。
前往千问办公官网下载并启动桌面客户端，使用你的阿里账号完成登录。
仅支持桌面端，网页版与手机端暂不支持自定义 MCP。
在左侧导航栏点击 扩展 → 选择 连接器。
页面右上角可以看到 + 添加 按钮。
若提示类型无法识别，可改用「手动填写配置」逐个添加，服务器类型选 Streamable HTTP。
导入完成后回到连接器列表，确认 recycle-stats 与 service-mcp 两项服务均已出现，且开关为开启状态。
如果状态异常，切换开关后等待 2~3 秒再试。
新建一个对话，向 AI 提问：
你现在可以使用哪些工具？帮我列一下。
如果 AI 能列出熊洞的工具，说明接入成功。可以继续尝试：帮我查一下本周的服务单完成情况。
在 WorkBuddy 左侧菜单中选择 专家 · 技能 · 连接器。
也可使用配置文件方式：编辑 ~/.workbuddy/mcp.json 后保存。两种方式任选其一。
切换到 连接器 标签页，点击 自定义连接器。
自定义连接器入口通常在页面右上角。
点击 配置 MCP 按钮，将第四节中的完整 JSON 粘贴进去，然后保存。
保存后返回连接器管理页面，在右上角 自定义连接器 入口中找到刚加入的服务，点击 「信任」。
忘记这一步将不会生效。WorkBuddy 默认要求显式信任，配置文件添加后也需要在界面点击「信任」才会启用。
新建对话并向 AI 提问：
你现在可以使用哪些工具？
在「专家 · 技能 · 连接器」的连接器状态栏中也能看到服务是否已连接。
豆包的自定义连接器一次只能填写一个服务地址，不支持整段 JSON 导入。有几个服务就需要新建几个连接器。
下载并启动豆包工作电脑版客户端，使用字节账号完成登录。
未登录时左侧菜单会被精简，会找不到入口。
在左侧菜单进入 技能 · 连接器 · 伙伴。
点击右上角 + 新建 → 选择 新建自定义连接器，在弹窗中依次填写：
熊洞运营MCPmcptoken，值填你的 Token针对 recycle-stats、service-mcp 等每个服务，重复第 3 步各建一个连接器。
首次保存后若提示「运行失败」，点击 重新启动 通常可恢复；若仍无效，删除该连接器后按步骤重建。
点击保存，然后进入 我的技能 → 连接器，确认所有刚建的连接器开关均已打开。然后新建对话测试：
我现在接了哪些 MCP？把工具清单列一下。
Cherry Studio、Cursor、Trae、Claude Desktop 等客户端同样支持自定义 MCP，配置逻辑一致。
type 为 streamable-http 或 streamableHttp，按其规则改写mcptoken06 · 验 证 接 入
任选其中一步即可确认。三步全部通过表示完全接入成功。
新建对话问：你现在可以使用哪些工具？
实测问：帮我查一下本周的服务单完成情况。
在连接器管理列表中确认开关为开启、信任状态已设置。
07 · 常 见 问 题
点击任意问题展开排查方案，覆盖 90% 的常见场景。
可能原因：未保存成功，或服务处于禁用状态。
处理：回到连接器列表确认开关为打开；WorkBuddy 需点击「信任」。
可能原因：配置未生效。
处理：重新进入连接器列表确认启用状态，必要时重启客户端。
可能原因：Token 错误或已失效；请求头名称写成了 Authorization。
处理：重新从「我的 MCP」页面复制 JSON 和 Token，确认请求头名称为 mcptoken。
可能原因：URL 复制不完整。
处理：重新完整复制服务地址，注意不要漏掉结尾路径。
可能原因：同一服务被添加了多次。
处理：删除多余项，只保留一个。
可能原因：客户端会话状态异常。
处理：点击「重新启动」；仍无效则删除该连接器后按步骤重建。
可能原因：Token 已刷新或账号权限变更。
处理：到「我的 MCP」页面点击「刷新」，重新复制后更新配置。
08 · 安 全 与 合 规
MCP 让你查询便捷，但 Token 与数据安全始终是你的责任。
请勿在群聊、截图、公开代码仓库或公共文档中暴露。泄露后请立即联系客服重置。
避免在公用电脑上保存配置文件或 Token。
平台可随时重置 Token，重置后原有配置立即失效，需按本文档重新配置。
通过 MCP 获取的数据仅限本人业务范围内使用，不得对外传播或用于其他用途。