Back to Details

slack-usage

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Slack Usage Best Practices

Slack使用最佳实践

Critical Search Rule

关键搜索规则

ALWAYS use 
mcp__slack__slack_search_messages
first for message searches. Only use 
mcp__slack__slack_get_channel_history
when explicitly asked for recent channel history.
Search is more efficient and finds messages across all channels. Channel history only shows recent messages in one channel.
**始终优先使用
mcp__slack__slack_search_messages
**进行消息搜索。只有当明确要求获取近期频道历史记录时，才使用
mcp__slack__slack_get_channel_history
。
搜索效率更高，能跨所有频道查找消息。频道历史记录仅显示单个频道中的近期消息。

Slack API Best Practices

Slack API最佳实践

Rate Limiting

速率限制

Slack APIs have rate limits (typically 1 request per second for most methods). When making multiple requests:
  • Space out bulk operations
  • Handle rate limit errors gracefully
  • Cache results when possible
Slack API存在速率限制（大多数方法通常为每秒1次请求）。发起多个请求时：
  • 分散批量操作的执行时间
  • 优雅处理速率限制错误
  • 尽可能缓存结果

Channel Types

频道类型

  • Public channels - Visible to all workspace members
  • Private channels - Invite-only, prefix with lock icon
  • DMs - Direct messages between users
  • Group DMs - Multi-person direct conversations
  • 公开频道 - 对所有工作区成员可见
  • 私有频道 - 仅邀请可加入，前缀带有锁定图标
  • DM（直接消息） - 用户之间的一对一私信
  • 群组DM - 多人直接对话

Message Formatting

消息格式

Format mentions and links properly:
  • User mention: 
    <@USER_ID>
  • Channel link: 
    <#CHANNEL_ID>
  • URL with text: 
    <https://example.com|link text>
  • Bold: 
    *text*
  • Code: backticks for inline, triple backticks for blocks
正确格式化提及和链接：
  • 用户提及：
    <@USER_ID>
  • 频道链接：
    <#CHANNEL_ID>
  • 带文本的URL：
    <https://example.com|链接文本>
  • 粗体：
    *文本*
  • 代码：单行使用反引号，代码块使用三个反引号

Threading Best Practices

线程回复最佳实践

  • Use threads for discussions to keep channels clean
  • Reply in thread when responding to specific messages
  • Use "Also send to channel" sparingly (only for important updates)
  • Thread replies don't trigger channel notifications by default
  • 使用线程进行讨论，保持频道整洁
  • 回复特定消息时使用线程回复
  • 谨慎使用“同时发送到频道”（仅用于重要更新）
  • 线程回复默认不会触发频道通知

Bot vs User Tokens

Bot令牌与用户令牌

  • Bot tokens (xoxb-): Actions appear as the bot, limited to channels bot is in
  • User tokens (xoxp-): Actions appear as user, access to all user's channels
  • Search typically requires user token for full workspace access
  • Posting messages works with either token type
  • Bot令牌（xoxb-）：操作以Bot身份显示，仅能访问Bot已加入的频道
  • 用户令牌（xoxp-）：操作以用户身份显示，可访问用户的所有频道
  • 搜索通常需要用户令牌以获取完整工作区访问权限
  • 发送消息两种令牌类型均可使用

Common Workflows

常见工作流

Finding past discussions:
  1. Search with relevant keywords
  2. Filter by channel, user, or date if needed
  3. Get thread replies for full context
Monitoring channels:
  1. Get channel history for recent activity
  2. Note message timestamps for threading
  3. React or reply as appropriate
查找过往讨论：
  1. 使用相关关键词进行搜索
  2. 如有需要，按频道、用户或日期筛选
  3. 获取线程回复以了解完整上下文
监控频道：
  1. 获取频道历史记录查看近期活动
  2. 记录消息时间戳以便进行线程回复
  3. 按需添加React表情或回复消息

MCP Limitations

MCP限制

This MCP provides read and write access to Slack. Consider:
  • Rate limits apply to all operations
  • Some admin operations not available
  • File uploads have size limits
该MCP提供Slack的读写访问权限。请注意：
  • 所有操作均受速率限制约束
  • 部分管理员操作无法执行
  • 文件上传存在大小限制