概要
What is 钉钉MCP Server?
钉钉MCP Server是一个基于Model Context Protocol（MCP）的服务器，它将钉钉开放平台的多项API封装为MCP工具，使AI助手能够通过自然语言调用钉钉功能。该服务器面向需要使用AI操作钉钉通讯录、部门、机器人消息、待办、日程、签到、工作通知、应用管理、服务窗等场景的开发者和企业。
How to use 钉钉MCP Server?
通过配置MCP客户端（如Claude Desktop）的mcpServers，添加名为dingtalk-mcp的服务器，使用npx -y dingtalk-mcp@latest命令运行，并设置环境变量DINGTALK_Client_ID和DINGTALK_Client_Secret。通过ACTIVE_PROFILES环境变量激活所需的功能模块（如dingtalk-contacts,dingtalk-calendar），设置为ALL则激活全部服务。其他可选变量包括ROBOT_CODE、ROBOT_ACCESS_TOKEN和DINGTALK_AGENT_ID。
Key features of 钉钉MCP Server
- 提供钉钉通讯录与部门管理工具
- 支持机器人发送消息和DING通知
- 管理钉钉待办事项（读写权限）
- 操作钉钉日程、签到、工作通知
- 集成钉钉企业文化荣誉管理
- 覆盖钉钉应用管理与服务窗接口
Use cases of 钉钉MCP Server
- 通过AI助手快速查询企业内部员工通讯录
- 自动向钉钉群发送定时消息或DING提醒
- 创建和跟踪团队待办任务
- 管理员工日程并查看签到情况
- 发送工作通知到指定人员或部门
FAQ from 钉钉MCP Server
如何获取钉钉Client ID和Client Secret？
需要先在钉钉开放平台注册成为开发者，创建应用后从应用详情页的“凭证与基础信息”中获取Client ID和Client Secret，并根据启用的MCP服务添加相应的API权限。
如何获取机器人Code用于发送消息？
参考钉钉官方文档“创建机器人”，在应用中配置机器人后获得机器人Code，再通过环境变量ROBOT_CODE设置即可。
环境变量ACTIVE_PROFILES如何配置？
该变量用于激活指定的MCP服务，多个服务用逗号分隔，例如dingtalk-contacts,dingtalk-calendar；设置为ALL则激活全部已列出的服务。默认激活通讯录和机器人发送消息两个模块。
有哪些依赖或运行环境要求？
需要Node.js环境，通过npx运行；无需本地安装，但需要外网访问钉钉开放平台的API。钉钉Client ID和Client Secret必须提前获取。
支持哪些传输和认证方式？
使用钉钉OAuth 2.0的Client ID和Client Secret进行认证，通过环境变量传入；服务器与MCP客户端之间采用标准的stdio传输协议。
