核心用法
dingtalk-docs 是一个企业级文档自动化技能，通过 MCP（Model Context Protocol）协议桥接钉钉文档 API。用户需先安装 mcporter CLI 工具并配置 DINGTALK_MCP_DOCS_URL 凭证，即可通过命令行完成以下操作：
- 文档搜索：
list_accessible_documents支持关键词检索用户有权限的全部文档 - 目录管理：
get_my_docs_root_dentry_uuid获取个人文档空间根目录，配合create_dentry_under_node创建文件夹、表格、PPT 等多种类型节点 - 文档创建与编辑：
create_doc_under_node创建在线文档，write_content_to_document支持 Markdown 格式的覆盖写入或续写 - 内容读取：
get_document_content_by_url通过 URL 获取文档 Markdown 内容
所有 API 调用统一使用 --args JSON 参数传递，支持 Shell 变量和管道组合实现复杂工作流。
显著优点
1. 官方生态集成：直接对接钉钉 MCP 广场服务，数据安全性与企业合规性有保障
2. 格式友好：原生支持 Markdown 输入输出，便于与 Git、静态站点生成器等工具链整合
3. 类型丰富：支持文档、表格、多维表、脑图、白板等 10 余种钉钉文档类型
4. 权限继承：严格遵循钉钉原有权限体系，仅操作当前用户授权范围内的文档
潜在缺点与局限性
- 外部依赖重：必须安装 npm/bun 全局包
mcporter，增加环境维护成本 - 凭证管理复杂：Streamable HTTP URL 含明文令牌，需自行解决安全存储（推荐
mcporter config持久化） - 无实时同步：基于请求-响应模式，不具备 WebSocket 实时协作能力
- 企业账号限制：部分错误（如 52600007）可能与钉钉企业策略相关，个人开发者调试受限
适合人群
- 需要批量处理钉钉文档的 DevOps/SRE 工程师
- 构建企业知识库自动化工作流的技术团队
- 已将钉钉作为协作平台，希望实现文档 CI/CD 集成的组织
常规风险
| 风险类别 | 说明 |
|---------|------|
| 凭证泄露 | URL 令牌等同于密码，误提交至代码仓库或日志可导致未授权访问 |
| 数据误删 | `updateType=0` 覆盖写入无确认机制，生产环境需先行备份 |
| 权限扩大 | 若使用高层级账号配置凭证，可能无意中操作超出预期的文档范围 |
| 供应链风险 | `mcporter` 为第三方 CLI 工具，需确认发布源可信度 |
建议首次使用在隔离测试文档中验证，确认行为符合预期后再接入生产数据。