MCP
把常用 AI 工具连到 Duaer
在 Claude、Claude Code、ChatGPT、Cursor、VS Code 和 Codex 里接入 Duaer 的 MCP 服务端:地址、登录方式、每个工具的步骤、权限和常见问题。
开始之前
- 组织所有者或管理员在 Duaer 的设置 ›「MCP」里点「启用 MCP 访问」,见 打开 Duaer MCP 服务端。
- 连接地址:Duaer 云上是 https://www.duaer.com/mcp-server/http;自托管是你的 Duaer 地址加 /mcp-server/http。
- Claude 和 ChatGPT 从它们自己的云端连接,不是从你的电脑。自托管的 Duaer 必须能从公网用 HTTPS 访问;放在内网或 VPN 后面的,要按它们的文档放行对方的 IP。
两种登录方式
- OAuth(推荐):AI 工具第一次连接时会自动在 Duaer 注册自己,不用手动填客户端 ID 或密钥。随后会打开 Duaer 的授权页,你用自己的账号登录,勾选要给它的权限。之后令牌会自动续期。
- 访问令牌:在「MCP」的「连接详情」里生成访问令牌,作为 Authorization: Bearer <访问令牌> 请求头填进工具的配置。令牌只显示一次,相当于你本人的全部权限,不能按项勾选,请妥善保管。
- 无论哪种方式,AI 工具都不会拥有比你更多的权限:你看不到的资料、改不了的工作流程,它也碰不到。
Claude(网页版和桌面版)
- 打开 Customize › Connectors,点「+ Add」,选「Add custom connector」。
- 名称填 Duaer,服务器地址填 https://www.duaer.com/mcp-server/http,点 Continue。
- Authentication 选「Sign in when needed」或「Sign in now」;OAuth client 选「Register automatically」。
- 点 Add,再点 Connect,在 Duaer 授权页勾选权限。
- 在对话里点左下角的「+」›「Connectors」打开 Duaer。
Team 和 Enterprise 由所有者在 Organization settings › Connectors › Add › Custom › Web 添加,成员再到 Customize › Connectors 里各自点 Connect。免费版只能加一个自定义连接器。
更详细的 Claude 示例见 用 MCP 把 Claude 连到 Duaer。
Claude Code
在终端运行(加 --scope user 则对你的所有项目生效):
claude mcp add --transport http duaer https://www.duaer.com/mcp-server/http --scope user然后在 Claude Code 里输入 /mcp,或在终端运行 claude mcp login duaer,在浏览器里完成登录和授权。
用访问令牌:在命令后加 --header "Authorization: Bearer <访问令牌>"。
ChatGPT
- 在 ChatGPT 网页版打开 Plugins,点加号,选「Add custom MCP server」。
- 填名称,在 Connection 下的 Server URL 填 https://www.duaer.com/mcp-server/http。
- Authentication 选 OAuth。
- 阅读风险提示,点「I understand and want to continue」,再点「Create as a plugin」。
- 安装这个插件,在对话框里输入 @ 选择 Duaer,第一次使用时完成 Duaer 授权。
只能在网页版添加。能不能添加和使用自定义 MCP 服务器,由 ChatGPT 工作区的权限设置决定;如果看不到入口,请联系工作区管理员。
Cursor
在 ~/.cursor/mcp.json(所有项目)或项目里的 .cursor/mcp.json 加入:
{
"mcpServers": {
"duaer": {
"url": "https://www.duaer.com/mcp-server/http"
}
}
}保存后 Cursor 会提示登录,按提示在浏览器里完成 Duaer 授权。出了问题,在 Output 面板选「MCP Logs」查看。
用访问令牌:在 duaer 下加 "headers": { "Authorization": "Bearer ${env:DUAER_MCP_TOKEN}" },并设置环境变量 DUAER_MCP_TOKEN。
VS Code 和 GitHub Copilot
- 打开命令面板,运行「MCP: Add Server」。
- 选「HTTP (HTTP or Server-Sent Events)」,填入地址,ID 填 duaer。
- 给自己用就选 Global › Copilot Global,配置写进 ~/.copilot/mcp-config.json。
- 第一次使用时按提示登录 Duaer;在 Chat: Open Customizations › Tools 里可以开关 Duaer 的工具。
{
"mcpServers": {
"duaer": {
"type": "http",
"url": "https://www.duaer.com/mcp-server/http"
}
}
}如果你的 VS Code 没有出现登录提示,改用访问令牌:在 duaer 下加 "headers": { "Authorization": "Bearer ${DUAER_MCP_TOKEN}" },并设置环境变量 DUAER_MCP_TOKEN。
OpenAI Codex(命令行、IDE 插件和桌面应用)
三者共用 ~/.codex/config.toml。在终端运行:
codex mcp add duaer --url https://www.duaer.com/mcp-server/http
codex mcp login duaercodex mcp login 会打开浏览器完成 Duaer 授权。用访问令牌:在 config.toml 的 [mcp_servers.duaer] 下加 bearer_token_env_var = "DUAER_MCP_TOKEN",并设置这个环境变量。
授权页上的权限
- 工作流程:查找、查看、创建、修改、发布和运行工作流程。执行记录:查看运行结果。
- 知识库:`search_knowledge` 搜索资料,可以用 `fields` 只看带某些字段值的内容(例如 Jira 的状态);`answer_knowledge` 带出处回答问题。
- 流程:读取流程概览、流程发现、单个事项和指标。
- 员工助手(`assistant:use`):`list_assistants` 列出你能用的员工助手,`ask_assistant` 用某个助手的说明和知识来源回答问题,读的是你自己能看的资料,每次调用都记进这个助手的运行记录。默认不勾选,需要时手动勾上。见 员工助手。
- 你的 Duaer 卡片(`card:decide`)和员工端操作(`action:run`):列出并处理你的卡片(也可以今天先不动、收回,或者加上文件)、列出并运行员工端操作;处理卡片和运行操作都要你在 AI 工具里确认后才执行。默认不勾选。见 卡片和员工端操作。
- 另外还有智能体、技能、凭证、数据表、项目和文件夹、AI 偏好设置,以及在此实例安装社区节点。
只勾选要用的。授权过的工具会出现在「MCP」的 OAuth 客户端列表里,随时可以撤销;之后再连接时,上次勾选的会保持勾选。
给需要 Client ID 的 AI 平台注册客户端
Claude、ChatGPT、Cursor 这类 AI 工具会自己注册,不用这一步。有些 AI 平台要你填 Client ID 和 Client Secret,这时由组织所有者或管理员先在 Duaer 里注册一个客户端:
- 在 Duaer 打开「设置 › MCP」,在「已注册的客户端」里点「注册」。
- 填名称,以及 AI 平台给出的回调 URL(每行一个,要用 HTTPS)。
- 复制 Client ID、Client Secret、授权 URL 和 Token URL,填进 AI 平台。Client Secret 只显示这一次。
只有本组织的成员能通过这个客户端登录,别的组织的人会被拒绝。AI 平台可以用 Basic 头,也可以用表单字段传 Client Secret。Secret 泄露了就点「重新生成 Secret」,旧的立即失效;删除客户端后,通过它登录的人都会退出。
常见问题排查
- 提示「MCP access is disabled」:这个组织关闭了 MCP 访问,请所有者或管理员在「MCP」里打开。
- 工具列表里没有某个工具:授权时没有勾选对应权限(员工助手默认不勾选),断开后重新连接并勾选;知识库和员工助手的工具还需要 Duaer 开通知识库功能。
- 授权页提示回调地址不被允许:平台所有者设置了「允许的回调 URL」,需要把这个工具的回调地址加进去。Cursor 的是 https://www.cursor.com/agents/mcp/oauth/callback 和 http://localhost:8787/callback,其他工具见各自的文档。
- Claude 或 ChatGPT 连不上自托管的 Duaer:确认 Duaer 能从公网用 HTTPS 访问。
- `ask_assistant` 提示没有可用的助手:这个助手已停用、已删除,或者没有分享给你。
- `decide_card` 或 `run_action` 只给出员工端链接:这个 AI 工具不能弹出确认,或者卡片要选同事。到员工端处理。
- `answer_knowledge` 和 `ask_assistant` 每次调用都计入回答次数上限,并扣组织的积分;组织或你本人用到积分上限后会被拒绝。
常见问题
用 OAuth 还是访问令牌?
优先用 OAuth:可以按项勾选权限,令牌自动续期,也能在 Duaer 里随时撤销。访问令牌适合不支持 OAuth 的工具,它带着你本人的全部权限。
AI 工具能看到同事分享给我的员工助手吗?
能,只要授权时勾选了「员工助手」。它列出的就是你在员工端能用的助手,回答时也只读你自己能看的资料。
要在 Duaer 里手动注册客户端吗?
不用。这些工具第一次连接时会自动注册;只有平台所有者限制了回调地址时,才需要把工具的回调地址加进允许列表。
同组