让 Cursor/Claude 直接“读懂”钉钉文档：mcp-dingtalk-doc 上手与实战

把钉钉文档接入 MCP ，让 AI 在对话里直接读取、解析、导出内容。

一、为什么你需要它？

很多团队的知识沉淀都在钉钉文档里：需求、方案、周报、事故复盘、流程规范……

但当你想让 AI 帮你“总结、提炼、改写、生成 PPT 大纲、做问答”，最大的问题往往是：

• 文档在钉钉里，AI 读不到
• 复制粘贴太麻烦，格式还容易丢
• 表格、代码块、图片等内容更难保真

mcp-dingtalk-doc 做的事情很直接：把“钉钉文档读取/解析”能力通过 MCP （ Model Context Protocol ） 暴露给 AI 客户端（如 Cursor ），让 AI 能在对话里自动调用工具获取文档内容。

二、mcp-dingtalk-doc 是什么？

mcp-dingtalk-doc 是一个 钉钉文档 MCP 服务器（ Node.js/TypeScript ），核心目标是：

• 让 AI 助手可以直接读取钉钉文档内容
• 支持自动登录与 Cookie 管理
• 输出可用的 HTML （适合进一步转换/存档/二次加工）

项目与安装入口：

• GitHub：hykfft/mcp-dingtalk-doc
• npm：mcp-dingtalk-doc

三、核心特性（你会用得上的点）

• 快速接入：npm 一键安装
• 自动 Cookie 管理（推荐）：减少手动抓 Cookie 的麻烦
• 支持解析并导出 HTML：适合交给 AI 做总结/改写，也适合做归档
• 对常见内容类型支持较好：段落富文本、表格（含合并单元格）、图片、代码块、文本样式等

四、它提供了哪些工具（ AI 能调用什么）？

在 MCP 侧，最常用的是这两个工具：

1 ） parse_document

完整解析钉钉文档，并生成 HTML 文件（适合“导出落地”）。

• 参数
  • url_or_node_id（必需）：钉钉文档 URL 或 NODE_ID
  • cookie（可选）：Cookie 字符串（不传则尝试使用环境变量/自动登录）
  • save_files（可选）：是否保存文件，默认 true
  • output_dir（可选）：输出目录

2 ） get_html

快速获取 HTML 内容（不保存文件，适合“即时提取给 AI”）。

• 参数
  • url_or_node_id（必需）
  • cookie（可选）

五、快速开始（两种 Cookie 方式）

思路很简单：先让 MCP 能拿到可用 Cookie，再把 MCP 接到 Cursor （或其它客户端），最后在对话里直接让 AI 读取文档。

方式 A：自动 Cookie 管理（推荐）

适合经常用、希望省事的同学：通过自动化方式登录并管理 Cookie （底层通常依赖浏览器自动化能力）。

你可以在项目 README 中按“自动 Cookie 管理”的流程完成初始化与登录。

方式 B：手动配置 Cookie

适合一次性/临时场景：

• 打开钉钉文档站点并登录：http://alidoc.dingtalk.com
• 按 F12 打开开发者工具，找到 Network 请求
• 从 Request Headers 里复制 Cookie
• 将 Cookie 作为参数传给工具，或写入环境变量（例如 DINGTALK_COOKIE）

六、在 Cursor 里怎么配置（关键一步）

Cursor 的 MCP 配置文件路径（项目 README 有说明）：

• Windows：%APPDATA%\\Cursor\\mcp.json
• macOS：~/Library/Application Support/Cursor/mcp.json
• Linux：~/.cursor/mcp.json

配置思路是：在 mcp.json 里新增一个 server ，启动 mcp-dingtalk-doc 这个 MCP 服务进程。

建议启动方式：

• 用 npx 启动（免全局安装）
• 或者 clone 项目后本地启动（便于跑 cookie 管理脚本）

不同客户端/版本的 MCP 配置字段名可能略有差异（例如 mcpServers / servers），你按你本机 mcp.json 的现有结构补进去即可。

七、实战：让 AI 总结钉钉文档（可直接复制给 AI 的提示词）

当 MCP 配置正确后，你可以在 Cursor 里这样说：

• “读取这篇钉钉文档并总结成三段：背景、关键结论、待办事项。”
• “把文档内容整理成会议纪要：议题、结论、责任人、截止时间。”
• “提取所有代码块并解释每段代码在做什么，给出风险点与优化建议。”
• “把表格转成结构化要点，并输出一个可执行的项目计划。”

（ AI 会自动调用 get_html / parse_document 去读取内容。）

八、已知限制与注意事项（建议你在文末加上）

• Cookie 会过期：需要定期更新（常见 730 天）
• 部分元素可能未完全支持：如列表、引用块等（以项目说明为准）
• 权限与合规：仅对你有权限的文档生效；不要把敏感 Cookie 明文发给不可信工具/服务

九、结语

如果你的团队“知识在钉钉文档里，AI 在外面”，那么 mcp-dingtalk-doc 属于那种装上就能立刻提升效率的工具：从“复制粘贴喂给 AI”，变成“对话里直接读文档、做总结、做沉淀”。

项目地址：

• GitHub：hykfft/mcp-dingtalk-doc
• npm：mcp-dingtalk-doc