discord-automation

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Discord Automation via Rube MCP

通过Rube MCP实现Discord自动化

Automate Discord operations through Composio's Discord/Discordbot toolkits via Rube MCP.

通过Composio的Discord/Discordbot工具包，借助Rube MCP自动化Discord操作。

Prerequisites

前提条件

Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
Active Discord connection via
```
RUBE_MANAGE_CONNECTIONS
```
with toolkits
```
discord
```
and
```
discordbot
```
Always call
```
RUBE_SEARCH_TOOLS
```
first to get current tool schemas

必须已连接Rube MCP（需具备RUBE_SEARCH_TOOLS权限）
通过
```
RUBE_MANAGE_CONNECTIONS
```
激活Discord连接，需包含工具包
```
discord
```
和
```
discordbot
```
请始终先调用
```
RUBE_SEARCH_TOOLS
```
以获取最新的工具架构

Setup

设置步骤

Get Rube MCP: Add

https://rube.app/mcp

as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

Verify Rube MCP is available by confirming
```
RUBE_SEARCH_TOOLS
```
responds
Call
```
RUBE_MANAGE_CONNECTIONS
```
with toolkit
```
discordbot
```
(bot operations) or
```
discord
```
(user operations)
If connection is not ACTIVE, follow the returned auth link to complete Discord auth
Confirm connection status shows ACTIVE before running any workflows

获取Rube MCP：在客户端配置中添加

https://rube.app/mcp

作为MCP服务器。无需API密钥 — 只需添加端点即可使用。

通过确认
```
RUBE_SEARCH_TOOLS
```
能正常响应，验证Rube MCP是否可用
调用
```
RUBE_MANAGE_CONNECTIONS
```
，选择工具包
```
discordbot
```
（机器人操作）或
```
discord
```
（用户操作）
如果连接状态未显示为ACTIVE，请按照返回的授权链接完成Discord授权
在运行任何工作流之前，确认连接状态为ACTIVE

Core Workflows

核心工作流

1. Send Messages

1. 发送消息

When to use: User wants to send messages to channels or DMs

Tool sequence:

```
DISCORD_LIST_MY_GUILDS
```
- List guilds the bot belongs to [Prerequisite]
```
DISCORDBOT_LIST_GUILD_CHANNELS
```
- List channels in a guild [Prerequisite]
```
DISCORDBOT_CREATE_MESSAGE
```
- Send a message [Required]
```
DISCORDBOT_UPDATE_MESSAGE
```
- Edit a sent message [Optional]

Key parameters:

```
channel_id
```
: Channel snowflake ID
```
content
```
: Message text (max 2000 characters)
```
embeds
```
: Array of embed objects for rich content
```
guild_id
```
: Guild ID for channel listing

Pitfalls:

Bot must have SEND_MESSAGES permission in the channel
High-frequency sends can hit per-route rate limits; respect Retry-After headers
Only messages sent by the same bot can be edited

适用场景：用户需要向频道或私信发送消息

工具序列:

```
DISCORD_LIST_MY_GUILDS
```
- 列出机器人所属的服务器 [前提步骤]
```
DISCORDBOT_LIST_GUILD_CHANNELS
```
- 列出服务器中的频道 [前提步骤]
```
DISCORDBOT_CREATE_MESSAGE
```
- 发送消息 [必需步骤]
```
DISCORDBOT_UPDATE_MESSAGE
```
- 编辑已发送的消息 [可选步骤]

关键参数:

```
channel_id
```
: 频道雪花ID
```
content
```
: 消息文本（最多2000字符）
```
embeds
```
: 富内容嵌入对象数组
```
guild_id
```
: 用于频道列表的服务器ID

注意事项:

机器人必须在目标频道拥有SEND_MESSAGES权限
高频发送消息可能触发路由级速率限制；请遵守Retry-After响应头
仅能编辑同一机器人发送的消息

2. Send Direct Messages

2. 发送私信

When to use: User wants to DM a Discord user

Tool sequence:

```
DISCORDBOT_CREATE_DM
```
- Create or get DM channel [Required]
```
DISCORDBOT_CREATE_MESSAGE
```
- Send message to DM channel [Required]

Key parameters:

```
recipient_id
```
: User snowflake ID for DM
```
channel_id
```
: DM channel ID from CREATE_DM

Pitfalls:

Cannot DM users who have DMs disabled or have blocked the bot
CREATE_DM returns existing channel if one already exists

适用场景：用户需要给Discord用户发送私信

工具序列:

```
DISCORDBOT_CREATE_DM
```
- 创建或获取私信频道 [必需步骤]
```
DISCORDBOT_CREATE_MESSAGE
```
- 向私信频道发送消息 [必需步骤]

关键参数:

```
recipient_id
```
: 接收私信的用户雪花ID
```
channel_id
```
: 来自CREATE_DM的私信频道ID

注意事项:

无法向已禁用私信或屏蔽机器人的用户发送私信
如果已存在私信频道，CREATE_DM将返回该现有频道

3. Manage Roles

3. 管理角色

When to use: User wants to create, assign, or remove roles

Tool sequence:

```
DISCORDBOT_CREATE_GUILD_ROLE
```
- Create a new role [Optional]
```
DISCORDBOT_ADD_GUILD_MEMBER_ROLE
```
- Assign role to member [Optional]
```
DISCORDBOT_DELETE_GUILD_ROLE
```
- Delete a role [Optional]
```
DISCORDBOT_GET_GUILD_MEMBER
```
- Get member details [Optional]
```
DISCORDBOT_UPDATE_GUILD_MEMBER
```
- Update member (roles, nick, etc.) [Optional]

Key parameters:

```
guild_id
```
: Guild snowflake ID
```
user_id
```
: User snowflake ID
```
role_id
```
: Role snowflake ID
```
name
```
: Role name
```
permissions
```
: Bitwise permission value
```
color
```
: RGB color integer

Pitfalls:

Role assignment requires MANAGE_ROLES permission
Target role must be lower in hierarchy than bot's highest role
DELETE permanently removes the role from all members

适用场景：用户需要创建、分配或删除角色

工具序列:

```
DISCORDBOT_CREATE_GUILD_ROLE
```
- 创建新角色 [可选步骤]
```
DISCORDBOT_ADD_GUILD_MEMBER_ROLE
```
- 为成员分配角色 [可选步骤]
```
DISCORDBOT_DELETE_GUILD_ROLE
```
- 删除角色 [可选步骤]
```
DISCORDBOT_GET_GUILD_MEMBER
```
- 获取成员详情 [可选步骤]
```
DISCORDBOT_UPDATE_GUILD_MEMBER
```
- 更新成员信息（角色、昵称等） [可选步骤]

关键参数:

```
guild_id
```
: 服务器雪花ID
```
user_id
```
: 用户雪花ID
```
role_id
```
: 角色雪花ID
```
name
```
: 角色名称
```
permissions
```
: 权限位的整数值
```
color
```
: RGB颜色的整数值

注意事项:

分配角色需要拥有MANAGE_ROLES权限
目标角色的层级必须低于机器人的最高角色
删除操作会永久移除所有成员的该角色

4. Manage Webhooks

4. 管理Webhook

When to use: User wants to create or use webhooks for external integrations

Tool sequence:

DISCORDBOT_GET_GUILD_WEBHOOKS

DISCORDBOT_LIST_CHANNEL_WEBHOOKS

- List webhooks [Optional]

```
DISCORDBOT_CREATE_WEBHOOK
```
- Create a new webhook [Optional]
```
DISCORDBOT_EXECUTE_WEBHOOK
```
- Send message via webhook [Optional]
```
DISCORDBOT_UPDATE_WEBHOOK
```
- Update webhook settings [Optional]

Key parameters:

```
webhook_id
```
: Webhook ID
```
webhook_token
```
: Webhook secret token
```
channel_id
```
: Channel for webhook creation
```
name
```
: Webhook name
```
content
```
/
```
embeds
```
: Message content for execution

Pitfalls:

Webhook tokens are secrets; handle securely
Webhooks can post with custom username and avatar per message
MANAGE_WEBHOOKS permission required for creation

适用场景：用户需要创建或使用Webhook进行外部集成

工具序列:

DISCORDBOT_GET_GUILD_WEBHOOKS

DISCORDBOT_LIST_CHANNEL_WEBHOOKS

- 列出Webhook [可选步骤]

```
DISCORDBOT_CREATE_WEBHOOK
```
- 创建新的Webhook [可选步骤]
```
DISCORDBOT_EXECUTE_WEBHOOK
```
- 通过Webhook发送消息 [可选步骤]
```
DISCORDBOT_UPDATE_WEBHOOK
```
- 更新Webhook设置 [可选步骤]

关键参数:

```
webhook_id
```
: Webhook ID
```
webhook_token
```
: Webhook的密钥令牌
```
channel_id
```
: 创建Webhook的频道ID
```
name
```
: Webhook名称
```
content
```
/
```
embeds
```
: 执行时的消息内容

注意事项:

Webhook令牌是敏感信息；请安全处理
Webhook可在每条消息中使用自定义用户名和头像
创建Webhook需要拥有MANAGE_WEBHOOKS权限

5. Manage Reactions

5. 管理消息反应

When to use: User wants to view or manage message reactions

Tool sequence:

DISCORDBOT_LIST_MESSAGE_REACTIONS_BY_EMOJI

- List users who reacted [Optional]

```
DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS
```
- Remove all reactions [Optional]

DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS_BY_EMOJI

- Remove specific emoji reactions [Optional]

```
DISCORDBOT_DELETE_USER_MESSAGE_REACTION
```
- Remove specific user's reaction [Optional]

Key parameters:

```
channel_id
```
: Channel ID
```
message_id
```
: Message snowflake ID
```
emoji_name
```
: URL-encoded emoji or
```
name:id
```
for custom emojis
```
user_id
```
: User ID for specific reaction removal

Pitfalls:

Unicode emojis must be URL-encoded (e.g., '%F0%9F%91%8D' for thumbs up)
Custom emojis use
```
name:id
```
format
DELETE_ALL requires MANAGE_MESSAGES permission

适用场景：用户需要查看或管理消息的反应

工具序列:

```
DISCORDBOT_LIST_MESSAGE_REACTIONS_BY_EMOJI
```
- 列出添加了某表情反应的用户 [可选步骤]
```
DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS
```
- 移除所有反应 [可选步骤]
```
DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS_BY_EMOJI
```
- 移除特定表情的所有反应 [可选步骤]
```
DISCORDBOT_DELETE_USER_MESSAGE_REACTION
```
- 移除特定用户的反应 [可选步骤]

关键参数:

```
channel_id
```
: 频道ID
```
message_id
```
: 消息雪花ID
```
emoji_name
```
: URL编码的表情符号，或自定义表情的
```
name:id
```
格式
```
user_id
```
: 要移除其反应的用户ID

注意事项:

Unicode表情必须进行URL编码（例如，点赞表情'%F0%9F%91%8D'）
自定义表情使用
```
name:id
```
格式
移除所有反应需要拥有MANAGE_MESSAGES权限

Common Patterns

通用模式

Snowflake IDs

雪花ID

Discord uses snowflake IDs (64-bit integers as strings) for all entities:

Guilds, channels, users, roles, messages, webhooks

Discord为所有实体使用雪花ID（以字符串形式表示的64位整数）：

服务器、频道、用户、角色、消息、Webhook

Permission Bitfields

权限位字段

Permissions are combined using bitwise OR:

SEND_MESSAGES = 0x800
MANAGE_ROLES = 0x10000000
MANAGE_MESSAGES = 0x2000
ADMINISTRATOR = 0x8

权限通过按位或运算组合：

SEND_MESSAGES = 0x800
MANAGE_ROLES = 0x10000000
MANAGE_MESSAGES = 0x2000
ADMINISTRATOR = 0x8

Pagination

分页

Most list endpoints support
```
limit
```
,
```
before
```
,
```
after
```
parameters
Messages: max 100 per request
Reactions: max 100 per request, use
```
after
```
for pagination

大多数列表端点支持
```
limit
```
、
```
before
```
、
```
after
```
参数
消息：每次请求最多100条
反应：每次请求最多100条，使用
```
after
```
参数进行分页

Known Pitfalls

已知注意事项

Bot vs User Tokens:

```
discordbot
```
toolkit uses bot tokens;
```
discord
```
uses user OAuth
Bot operations are preferred for automation

Rate Limits:

Discord enforces per-route rate limits
Respect
```
Retry-After
```
headers on 429 responses

机器人令牌 vs 用户令牌:

```
discordbot
```
工具包使用机器人令牌；
```
discord
```
工具包使用用户OAuth令牌
自动化操作优先使用机器人令牌

速率限制:

Discord对每个路由实施速率限制
收到429响应时，请遵守
```
Retry-After
```
响应头

Quick Reference

快速参考

Task	Tool Slug	Key Params
List guilds	DISCORD_LIST_MY_GUILDS	(none)
List channels	DISCORDBOT_LIST_GUILD_CHANNELS	guild_id
Send message	DISCORDBOT_CREATE_MESSAGE	channel_id, content
Edit message	DISCORDBOT_UPDATE_MESSAGE	channel_id, message_id
Get messages	DISCORDBOT_LIST_MESSAGES	channel_id, limit
Create DM	DISCORDBOT_CREATE_DM	recipient_id
Create role	DISCORDBOT_CREATE_GUILD_ROLE	guild_id, name
Assign role	DISCORDBOT_ADD_GUILD_MEMBER_ROLE	guild_id, user_id, role_id
Delete role	DISCORDBOT_DELETE_GUILD_ROLE	guild_id, role_id
Get member	DISCORDBOT_GET_GUILD_MEMBER	guild_id, user_id
Update member	DISCORDBOT_UPDATE_GUILD_MEMBER	guild_id, user_id
Get guild	DISCORDBOT_GET_GUILD	guild_id
Create webhook	DISCORDBOT_CREATE_WEBHOOK	channel_id, name
Execute webhook	DISCORDBOT_EXECUTE_WEBHOOK	webhook_id, webhook_token
List webhooks	DISCORDBOT_GET_GUILD_WEBHOOKS	guild_id
Get reactions	DISCORDBOT_LIST_MESSAGE_REACTIONS_BY_EMOJI	channel_id, message_id, emoji_name
Clear reactions	DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS	channel_id, message_id
Test auth	DISCORDBOT_TEST_AUTH	(none)
Get channel	DISCORDBOT_GET_CHANNEL	channel_id

任务	工具标识	关键参数
列出服务器	DISCORD_LIST_MY_GUILDS	无
列出频道	DISCORDBOT_LIST_GUILD_CHANNELS	guild_id
发送消息	DISCORDBOT_CREATE_MESSAGE	channel_id, content
编辑消息	DISCORDBOT_UPDATE_MESSAGE	channel_id, message_id
获取消息	DISCORDBOT_LIST_MESSAGES	channel_id, limit
创建私信	DISCORDBOT_CREATE_DM	recipient_id
创建角色	DISCORDBOT_CREATE_GUILD_ROLE	guild_id, name
分配角色	DISCORDBOT_ADD_GUILD_MEMBER_ROLE	guild_id, user_id, role_id
删除角色	DISCORDBOT_DELETE_GUILD_ROLE	guild_id, role_id
获取成员信息	DISCORDBOT_GET_GUILD_MEMBER	guild_id, user_id
更新成员信息	DISCORDBOT_UPDATE_GUILD_MEMBER	guild_id, user_id
获取服务器信息	DISCORDBOT_GET_GUILD	guild_id
创建Webhook	DISCORDBOT_CREATE_WEBHOOK	channel_id, name
执行Webhook	DISCORDBOT_EXECUTE_WEBHOOK	webhook_id, webhook_token
列出Webhook	DISCORDBOT_GET_GUILD_WEBHOOKS	guild_id
获取反应列表	DISCORDBOT_LIST_MESSAGE_REACTIONS_BY_EMOJI	channel_id, message_id, emoji_name
清除所有反应	DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS	channel_id, message_id
测试授权	DISCORDBOT_TEST_AUTH	无
获取频道信息	DISCORDBOT_GET_CHANNEL	channel_id