
钉钉 MCP 服务器

2025.04.21
1
JavaScript钉钉集成企业内部通讯交流协作
钉钉 MCP 服务器是一个实现 Model Context Protocol (MCP) 的服务,使 Claude 能够与钉钉工作空间进行交互。它提供了搜索钉钉用户、获取用户详细信息以及向钉钉用户发送私信等功能,适用于需要与钉钉工作空间集成的场景。
View on GitHub
Overview
基本能力
产品定位
钉钉 MCP 服务器是一个实现 Model Context Protocol (MCP) 的服务,使 Claude 能够与钉钉工作空间进行交互。
核心功能
- 搜索钉钉用户 (
dingtalk_search_users
) - 支持关键词搜索用户
- 可选精确匹配
-
返回匹配的用户列表及其基本信息
-
获取用户详细信息 (
dingtalk_get_user_info
) - 根据用户 ID 获取详细信息
-
包括姓名、工号、部门、入职时间、联系方式等
-
发送私信 (
dingtalk_send_message
) - 向指定用户发送消息
- 返回消息发送确认
适用场景
- 需要与钉钉工作空间集成的应用
- 自动化办公流程
- 企业内部通讯工具集成
工具列表
dingtalk_search_users
: 搜索钉钉用户dingtalk_get_user_info
: 获取用户详细信息dingtalk_send_message
: 向钉钉用户发送私信
常见问题解答
- 权限错误: 检查应用是否已正确配置所需权限、是否已正确安装到企业、应用凭证是否正确配置、是否已获得必要的访问权限
使用教程
使用依赖
- 创建钉钉应用
- 访问钉钉开发者后台
- 点击"创建应用"
- 选择"企业内部应用"
-
填写应用信息并创建
-
配置应用权限
userinfo
: 获取用户信息message
: 发送消息-
user
: 获取用户列表 -
获取应用凭证
- 保存应用的 AppKey 和 AppSecret
安装教程
npx 方式
{
"mcpServers": {
"dingtalk": {
"command": "npx",
"args": [
"-y",
"@darrenyao/server-dingtalk"
],
"env": {
"DINGTALK_APP_KEY": "your_app_key",
"DINGTALK_APP_SECRET": "your_app_secret"
}
}
}
}
docker 方式
{
"mcpServers": {
"dingtalk": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"DINGTALK_APP_KEY",
"-e",
"DINGTALK_APP_SECRET",
"mcp/dingtalk"
],
"env": {
"DINGTALK_APP_KEY": "your_app_key",
"DINGTALK_APP_SECRET": "your_app_secret"
}
}
}
}
调试方式
- 确保环境变量
DINGTALK_APP_KEY
和DINGTALK_APP_SECRET
已正确设置 - 检查应用权限配置
- 验证应用是否已安装到企业
- 确认应用凭证是否正确
构建
Docker 构建:
docker build -t mcp/dingtalk -f Dockerfile .