Slack 用户 MCP 服务器
Slack API 的 MCP 服务器,使 Claude 能够以用户身份与 Slack 工作区进行交互。
工具
slack_list_channels
- 列出工作区中的公共频道
- 可选输入:
limit
(数字,默认值:100,最大值:200):返回的最大通道数cursor
(字符串):下一页的分页光标
- 返回:频道列表及其 ID 和信息
slack_post_message
- 向 Slack 频道发布新消息
- 必需输入:
channel_id
(string): 要发布到的频道的 IDtext
(字符串):要发布的消息文本
- 返回:消息发布确认和时间戳
slack_reply_to_thread
- 回复特定消息线程
- 必需输入:
channel_id
(字符串):包含线程的通道thread_ts
(字符串):父消息的时间戳text
(字符串):回复文本
- 返回:回复确认和时间戳
slack_add_reaction
- 在消息中添加表情符号反应
- 必需输入:
channel_id
(字符串):包含消息的频道timestamp
(字符串):需要响应的消息时间戳reaction
(字符串):不带冒号的表情符号名称
- 返回:反应确认
slack_get_channel_history
- 获取频道的最新消息
- 必需输入:
- 可选输入:
limit
(数字,默认值:10):要检索的消息数量
- 返回:消息及其内容和元数据的列表
slack_get_thread_replies
- 获取消息线程中的所有回复
- 必需输入:
channel_id
(字符串):包含线程的通道thread_ts
(字符串):父消息的时间戳
- 返回:回复列表及其内容和元数据
slack_get_users
- 获取具有基本个人资料信息的工作区用户列表
- 可选输入:
cursor
(字符串):下一页的分页光标limit
(数字,默认值:100,最大值:200):返回的最大用户数
- 返回:用户及其基本资料的列表
slack_get_user_profile
- 获取特定用户的详细个人资料信息
- 必需输入:
- 返回:详细的用户资料信息
设置
- 创建 Slack 应用程序:
- 配置用户令牌范围:导航到“OAuth 和权限”并添加以下范围:
channels:history
- 查看公共频道中的消息和其他内容channels:read
- 查看基本频道信息chat:write
- 以自己的身份发送消息reactions:write
- 在消息中添加表情符号反应users:read
- 查看用户及其基本信息
- 将应用程序安装到工作区:
- 点击“安装到工作区”并授权应用程序
- 保存以
xoxp-
开头的“用户 OAuth 令牌”
- 按照本指南获取您的团队 ID(以
T
开头)
与 Claude Desktop 一起使用
将以下内容添加到您的claude_desktop_config.json
中:
本地安装
首先安装并构建服务器:
git clone https://github.com/lars-hagen/slack-user-mcp.git
cd slack-user-mcp
npm install
npm run build
然后配置Claude桌面:
{
"mcpServers": {
"slack": {
"command": "npm",
"args": [
"run",
"--prefix",
"/path/to/slack-user-mcp",
"start"
],
"env": {
"SLACK_TOKEN": "xoxp-your-user-token",
"SLACK_TEAM_ID": "T01234567"
}
}
}
}
NPX
{
"mcpServers": {
"slack": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-slack-user"
],
"env": {
"SLACK_TOKEN": "xoxp-your-user-token",
"SLACK_TEAM_ID": "T01234567"
}
}
}
}
Docker
{
"mcpServers": {
"slack": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SLACK_TOKEN",
"-e",
"SLACK_TEAM_ID",
"mcp/slack-user"
],
"env": {
"SLACK_TOKEN": "xoxp-your-user-token",
"SLACK_TEAM_ID": "T01234567"
}
}
}
}
通过 Smithery 安装
要通过Smithery自动为 Claude Desktop 安装 Slack User Server:
npx -y @smithery/cli install @lars-hagen/slack-user-mcp2 --client claude
故障排除
如果遇到权限错误,请验证:
- 所有必需的范围都已添加到您的 Slack 应用中
- 该应用程序已正确安装到您的工作区
- 令牌和工作区 ID 已正确复制到您的配置中
- 该应用已添加到需要访问的频道
- 您使用的是用户 OAuth 令牌(以 xoxp- 开头),而不是机器人令牌
建造
Docker 构建:
docker build -t mcp/slack-user -f src/slack/Dockerfile .
执照
此 MCP 服务器采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件,但须遵守 MIT 许可证的条款和条件。更多详情,请参阅项目仓库中的 LICENSE 文件。