38 lines
1.8 KiB
Markdown
38 lines
1.8 KiB
Markdown
# MCP 连接器（本包附带的配置与说明）
|
||
|
||
本目录**只放配置模板与使用说明，不含任何凭据**。
|
||
|
||
| 文件 | 用途 |
|
||
| --- | --- |
|
||
| `mcp.servers.example.json` | 推荐的 MCP 服务器定义（地址、超时、`${VAR}` 占位符），供迁移或参考 |
|
||
| `connectors-recommended.md` | 推荐清单：优先级、用途、启用方式、暂不建议项 |
|
||
|
||
## 在 WorkBuddy 中启用（推荐路径）
|
||
|
||
这些连接器**已经内置**在 WorkBuddy 里——`connectors/default/mcp.json` 中存在对应的
|
||
`connector:*` 条目，默认 `disabled: true`。正确做法：
|
||
|
||
1. 打开【连接器】面板，搜索连接器名称（如"腾讯文档"）；
|
||
2. 点击启用，按提示在浏览器完成 OAuth 授权；
|
||
3. 授权后回到会话即可调用其工具。
|
||
|
||
> ⚠️ **不要手改 `~/.workbuddy/mcp.json` 里的令牌字段**。OAuth 类连接器的凭据由宿主下发，
|
||
> 手写常导致 `no_token` / 假 502。排错见 Skill `tencent-docs-mcp`。
|
||
|
||
## 在 DSH（DeepSeek Harness）中启用
|
||
|
||
DSH 不读取 WorkBuddy 的连接器面板。若要迁移，把 `mcp.servers.example.json` 中需要条目的
|
||
`mcpServers` 合并进 DSH 的 MCP 配置，并按需去掉 `disabled` 字段；带 `${VAR}` 的项先设置环境变量。
|
||
|
||
## 凭据与环境变量
|
||
|
||
- **不放令牌**：本目录任何文件都不得写入 access token、API key、Cookie。
|
||
- `tencent-map` 需要 `TENCENT_MAP_KEY`（腾讯位置服务控制台申请）。
|
||
- 其余 OAuth 连接器由面板授权，无需手工填写。
|
||
|
||
## 与 Skill 的配合
|
||
|
||
- 腾讯文档 → Skill `skills/tencent-docs-mcp`
|
||
- 腾讯问卷 → Skill `skills/tencent-survey`
|
||
- 主体工作流（策划书、预算、通知、纪要、新闻稿、总结、PPT 大纲）→ Skill `skills/su-planning-office`
|