36 lines
2.2 KiB
Markdown
36 lines
2.2 KiB
Markdown
# 钉钉审批 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、审批引用或连接器诊断数据。
|