通过一个远程 MCP 服务将 AI 工具连接到易企办，使用 OAuth 登录，并调用您的账号有权使用的功能。
易企办提供统一的模型上下文协议（MCP）服务。一个连接即可使用业务操作、应用构建、组织管理和服务门户管理功能，无需再为每类功能分别配置服务。
连接信息
建议的连接名称：易企办
连接类型：基于 HTTPS 的远程 MCP 服务
认证方式：OAuth
可使用的功能
统一服务包含以下功能领域。实际可执行的操作取决于您的易企办权限，以及 AI 工具所支持的工具。
业务操作（Operations）：处理业务记录、文件、工作流待办、智能体和 Webhook。
应用构建（App Builder）：构建和管理应用、工作区、应用资源、应用包和门户。
组织管理（Admin）：管理用户、部门、群组、地点和职位。
服务门户（Service Portal）：管理服务门户用户、群组及相关访问设置。
这些功能属于同一个连接，无需为每个功能领域单独添加 MCP 连接。
开始前请确认
您的 AI 工具支持基于 HTTPS 的远程 MCP 服务和 OAuth 认证。
您的 AI 工具或所在组织允许添加远程 MCP 连接。
您拥有易企办账号，并有权访问计划使用的组织、应用和功能。
如需额外的产品权限，请联系易企办管理员。
连接 MCP 不会自动授予额外的易企办权限。
添加易企办连接
打开 AI 工具中的 MCP、连接器、集成或开发者设置。具体名称因 AI 工具而异。
选择添加远程 MCP 服务。
将连接名称设为易企办。
将服务地址设为 https://api.yeeoffice.cn/v1/mcp。
如果需要选择认证方式，请选择 OAuth。
在浏览器中完成易企办登录和授权，使用您计划开展工作的账号。
返回 AI 工具，确认连接可用。如有需要，刷新工具列表或开始新对话。
不要在 MCP 配置中粘贴访问令牌、API Key、密码、Cookie 或授权请求头。认证由 OAuth 流程完成。
如果您的 AI 工具已提供易企办集成，请先使用该集成的连接流程并查看其设置说明，避免重复添加手动连接。
验证连接
先发出一个只读请求：显示我当前连接的是哪个易企办账号。
确认返回的是您计划使用的账号，然后尝试与角色相关的请求，例如：显示我的待办工作流任务。如果您有相应的工作区访问权限，也可以尝试：列出我的易企办工作区。
某项操作返回“无权访问”，并不一定表示连接失败；该操作可能需要您的账号尚未获得的权限。
更新现有连接
如果您此前分别配置了应用构建、业务操作、组织管理或服务门户的 MCP 连接，请迁移到统一连接。旧配置使用的地址分别以 /mcp/app-builder、/mcp/operations、/mcp/admin 和 /mcp/service-portal 结尾。
使用 https://api.yeeoffice.cn/v1/mcp 添加统一连接，并完成 OAuth 登录。
确认连接的账号，并测试与您的工作相关的只读请求。
更新明确引用旧连接的 AI 助手或已保存配置，刷新其可用工具。
确认统一连接可以完成预期任务后，在该 AI 工具中移除或停用多余的旧连接。
如果集成由组织统一管理，请与管理员协调配置更新。
权限与安全使用
通过统一服务使用功能时，原有的易企办权限仍然适用：
业务操作需要访问相关记录、应用和工作流操作的权限。
应用结构、设置和资源创建需要相应的应用管理员权限。编辑者或访问者权限并不等同于应用管理员权限。
组织管理和服务门户管理仍有各自的权限要求。
创建、修改、删除、安装、升级、提交或调整访问权限前，请核对目标和拟执行的变更。操作完成后，请让 AI 工具展示执行结果。
配置变更成功并不自动证明应用、工作流或门户能够正常运行。必要时，请在易企办中测试受影响的功能。
问题排查
认证失败或连接过期：重新连接统一服务并完成 OAuth 登录，确认使用的是有效的易企办账号。
连接到了错误的账号：通过 AI 工具断开连接或退出登录，再使用目标账号重新连接；继续操作前核对当前身份。
已连接，但未显示工具：确认统一服务地址，刷新工具列表或开始新对话。如有需要，重新添加连接并完成 OAuth 登录，同时检查 AI 工具对远程 MCP 的支持情况和组织设置。
某项操作被拒绝：请易企办管理员检查目标应用或资源所需的权限。再添加一个 MCP 连接不会授予这些权限。
已保存的 AI 助手仍引用旧连接：将其连接切换至统一服务，并刷新可用工具。
AI 工具不支持 OAuth：请使用支持 HTTPS 远程 MCP 和 OAuth 的 AI 工具。不要通过在配置中粘贴凭据来代替 OAuth。
下一步
从与您角色相关的只读任务开始。确认账号和权限后，即可通过同一个连接，按权限使用业务操作、应用构建或管理功能。