Files
dingMCP/distribution/agent-install.template.md
T

2.2 KiB
Raw Blame History

钉钉审批 MCP 安装任务

用户把本文件或链接交给你,即授权你为当前用户连接或更新名为 dingtalk-approval 的 MCP。该授权不包含任何审批写操作。

版本:{{VERSION}}

默认安装

  1. 检查当前 Agent 是否支持远程 Streamable HTTP MCP 和 MCP 标准 OAuth 2.0。按能力判断,不要按 Agent 品牌判断。
  2. 若支持,按宿主官方方式新增或更新连接器:
    • 名称:dingtalk-approval
    • URL:{{GATEWAY_URL}}
    • 传输:Streamable HTTP
    • 认证:OAuth(允许宿主使用服务端发现元数据和动态客户端注册)
  3. 不要安装 Node.js、npm、本地 Bridge、DWS 或浏览器自动化;不要索取 AppKey、AppSecret、AuthoritySecret、CorpId、userId、员工号、Cookie、Token 或其他企业凭证。
  4. 让宿主发起标准 OAuth 登录,把宿主返回的授权页面交给用户本人确认。不得代替用户点击授权,也不得声称链接已通过其他消息通道发送。
  5. 连接成功后调用一次只读 approval_list_todos,参数为 source="all"、空搜索、limit=1。只有响应中的钉钉 OA 与薪福通来源都为 ok,才报告安装完成。不得在安装验证中执行任何审批写操作。
  6. 若宿主需要重启或重新加载才能识别新连接器,按其官方机制操作;不要因为等待加载而改装本地 Bridge。

服务端会通过 MCP instructions 和工具描述提供审批工作流。登录完成后的首次响应可能包含简短示例;向用户展示一次即可,不要自动执行示例。

兼容安装

只有在宿主明确不支持远程 Streamable HTTP MCP,或不能完成 MCP 标准 OAuth 时,才使用本地 STDIO Bridge:

{{COMPAT_INSTALL_URL}}

备用地址: {{COMPAT_INSTALL_MIRROR_URLS_MARKDOWN}}

不要先尝试兼容安装来“提高成功率”。远程连接失败时应先报告宿主给出的具体错误;只有确认属于能力缺失,才进入兼容路径。

完成后

只向用户说明连接器已就绪、登录状态,以及钉钉 OA/薪福通是否通过只读验证。不要展示内部 Token、用户 ID、审批引用或连接器诊断数据。