# 接入 WorkBuddy

WorkBuddy 的 MCP 或连接器设置可通过远程 HTTP 与浏览器 OAuth 连接 Sanctris。

## 配置步骤

1. 打开 MCP 服务管理或自定义连接器设置，具体菜单随版本变化。
2. 添加名为 Sanctris 的 HTTP MCP 服务，地址为 `https://app.sanctris.com/mcp`。
3. 如果使用 JSON 编辑器，将以下条目合并到已有配置，不要覆盖其他服务：

```json
{
  "mcpServers": {
    "sanctris": {
      "type": "http",
      "url": "https://app.sanctris.com/mcp"
    }
  }
}
```

4. 保存并连接，在 Sanctris 浏览器授权页登录。如提示返回 WorkBuddy，允许打开对应客户端。
5. 刷新工具列表并开启新对话，先查询待办。

无需在配置中加入 Authorization header、密码或静态令牌。若当前版本不能为 HTTP 服务发起 OAuth，应升级或更换兼容客户端，不要分享凭据。

## 写操作与排查

在浏览器批准后系统自动执行，无需回到 WorkBuddy 通知。WorkBuddy 可使用 execute_approved_operation 查询原始 operation_id 的结果，不要新建请求。

手机号字段要求文本时，应提交 JSON 字符串。MCP 协议可以保留字符串，不会固有地把所有看起来像数字的字符串转为数字。

## 兼容状态

已完成真实 WorkBuddy 远程 OAuth、收集表创建及批准后填写提交验证。服务升级移除旧工具名后，需要刷新客户端工具列表。

[WorkBuddy 官方连接器说明](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Connector)。