钉钉机器人集成OpenAPI MCP Server

前提条件

• 已在阿里云百炼导入OpenAPI MCP Server。

• 在阿里云百炼应用中添加OpenAPI MCP Server，并且调试完成。

创建钉钉应用

这里将以创建一个企业内部应用为例。

1. 访问钉钉开放平台，在应用开发页面，选择钉钉应用，在页面右上角点击创建应用。若您已有可用的应用，可跳过本步骤。

2. 授予应用发送卡片消息权限。

   在应用左侧菜单选择权限管理，在搜索框分别输入Card.Streaming.Write和Card.Instance.Write，并在操作列点击申请权限。

3. 获取应用Client ID和Client Secret。

   在应用左侧菜单选择凭证与基础信息，在该页面中可以查看应用的Client ID和Client Secret。

创建钉钉消息卡片

钉钉机器人通过卡片消息支持流式返回结果，您需要创建卡片模板供消息发送使用。

1. 访问卡片平台，点击新建模板，填入模板信息。

   配置项	说明
   卡片类型	选择消息卡片。
   卡片模板场景	选择AI卡片。
   关联应用	选择上一步创建的钉钉应用。
   从模板创建	无需选择预设模板。

   在模板名称中填写mcp-template，然后单击创建。

2. 在模拟编辑页面，无需修改任何配置，保存并发布模板，点击返回。

3. 获取模板ID。

   在卡片平台左侧导航栏选择模板管理 > 模板列表，找到目标模板卡片（如 mcp-template），在卡片底部即可查看并复制模板 ID。

将阿里云百炼应用发布至钉钉

当阿里云百炼应用发布后，您可以继续将应用发布至钉钉。

1. 单击应用顶部的发布渠道页签，单击钉钉机器人。

   说明

   若您首次使用钉钉机器人，请先完成授权。

2. 根据配置向导选择API KEY，并填入钉钉模板ID、钉钉Client ID和钉钉Client Secret。

3. 待钉钉渠道创建完成后，您可以查看钉钉机器人的回调地址，该回调地址为钉钉机器人消息接收地址。

配置钉钉机器人

1. 访问钉钉应用列表。找到刚才创建的应用，点击应用名称进入详情页面。

2. 在应用左侧菜单选择添加应用能力，单击添加机器人。

3. 打开机器人配置开关，填入机器人的相关信息。

   关键配置项	说明
   消息接收模式	请选择HTTP模式。
   消息接收地址	从百炼发布渠道获取的回调地址。

发布钉钉应用

应用配置完成后，如果需要将应用供企业内其他用户使用，需发布一个版本。请在应用左侧菜单选择版本管理与发布，然后在右上角点击创建新版本。在版本详情页，输入应用版本号和版本描述信息，并选择合适的应用可见范围。完成上述步骤后，完成后点击保存，并在弹窗中点击直接发布。

测试机器人

您可以创建群聊或在已有群聊中添加机器人，并与机器人对话，查看效果。

1. 在钉钉群管理中添加机器人​。

   进入钉钉群群设置页面，点击机器人，在机器人管理页面，点击添加机器人。

2. 在钉钉群中@机器人进行互动。

   例如，发送指令在香港部署一台 dify后，机器人返回部署完成报告，包含实例信息（实例名称 dify-deployment-instance、实例类型 ecs.c9i.xlarge、系统盘 40 GB cloud_essd、可用区 cn-hongkong-b、操作系统 CentOS 7.9 64位、公网IP与私网IP等）以及网络与安全组配置（VPC、VSwitch、安全组，开放端口 HTTP(80)、HTTPS(443)、SSH(22)）。