# 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`