将 Claude Desktop 通过 MCP 连接到 Dureach，意味着注册 OAuth 客户端、完成工作区同意、添加可流式传输的 HTTP 服务器，并运行首次有界搜索。预计用时约 20 分钟，写入范围还需额外的审批时间。
打开 Claude Desktop 前应准备什么？
选择工作区，确认智能体平台能力，并明确任务：仅研究访问需要 workspace:read、companies:read 与 trade:read；联系人查找增加 contacts:read。首次授权不要包含 leads:create、campaigns:create 与发送范围。指定一名所有者，在候选数据变更权威记录前负责复核。
如何注册并完成客户端同意？
- 为工作区注册 OAuth 客户端，并选择所需范围。
- 启动授权流程，以工作区成员身份在浏览器中完成同意。
- 将凭据保存在客户端受保护的凭据存储或服务器端密钥管理器中。不要将令牌粘贴到对话、共享文档、截图或工单中。
- 确认令牌受众为
/mcp资源，且工作区 ID 与目标工作区一致。
完整字段表格请参阅《通过 MCP 连接 AI 客户端》。
如何在 Claude Desktop 中添加服务器？
- 添加可流式传输 HTTP 的 MCP 服务器，URL 为
https://app.dureach.com/mcp。 - 选择 OAuth 身份验证并填写客户端注册值；当连接器要求发现地址时，使用 MCP 资源元数据 URL。
- 完成同意，确认工具列表包含
dureach.workspace.context、dureach.workspace.capabilities与已授权的读取工具。 - 先调用
dureach.workspace.context，检查返回的工作区 ID、角色与范围。
如何运行首次有界搜索？
使用 tools/list 查看此连接可用的工具。可用范围取决于已授予的权限和工作区访问资格。先授予读取权限；若缺少访问权限，请工作区管理员审核，不要申请宽泛权限。
哪些检查可以结束设置？
扩大访问范围前，请审核授权、策略变更和可用的活动记录。共享笔记中仅保留脱敏请求 ID 和操作元数据。项目结束或不再需要访问时移除连接；可能泄露的凭据应撤销并更换。
关于 Claude Desktop 设置有哪些常见问题？
设置需要多长时间？
注册与同意只需几分钟；写入范围需要所有者评审时，请预留额外时间。
工具列表为何为空？
使用 tools/list 查看此连接可用的工具。可用范围取决于已授予的权限和工作区访问资格。先授予读取权限；若缺少访问权限，请工作区管理员审核，不要申请宽泛权限。
一个连接器能否服务两个工作区？
不能。令牌绑定到同意时的工作区。每个工作区须分别注册并同意。
首日是否应给连接器发送范围？
不应。在读取行为、试运行与常设策略评审完成后再添加发送。
什么可以证明设置成功？
workspace.context 返回预期的工作区，capabilities 列出预期的工具，有界搜索返回可复核的行。
失败调用送到哪里复核？
保留 request_id、时间戳、工具名称与错误代码；切勿在共享笔记中将令牌与结果行保存在一起。