Сервер Slack MCP

MCP-сервер для API Slack, позволяющий Клоду взаимодействовать с рабочими пространствами Slack.

Инструменты

1. slack_list_channels

   • Перечислите общедоступные или предопределенные каналы в рабочей области

   • Дополнительные входные данные:

     • limit (число, по умолчанию: 100, макс: 200): максимальное количество каналов для возврата

     • cursor (строка): Курсор пагинации для следующей страницы

   • Возвращает: список каналов с их идентификаторами и информацией.

2. slack_post_message

   • Опубликовать новое сообщение на канале Slack

   • Требуемые входные данные:

     • channel_id (строка): идентификатор канала для публикации

     • text (строка): Текст сообщения для публикации.

   • Возвращает: подтверждение отправки сообщения и временную метку.

3. slack_reply_to_thread

   • Ответить на определенную ветку сообщений

   • Требуемые входные данные:

     • channel_id (string): Канал, содержащий поток

     • thread_ts (string): временная метка родительского сообщения

     • text (строка): Текст ответа

   • Возврат: подтверждение ответа и временная метка

4. slack_add_reaction

   • Добавить эмодзи-реакцию на сообщение

   • Требуемые входные данные:

     • channel_id (строка): Канал, содержащий сообщение

     • timestamp (строка): временная метка сообщения, на которую нужно отреагировать

     • reaction (строка): Имя эмодзи без двоеточий

   • Возврат: Подтверждение реакции

5. slack_get_channel_history

   • Получить последние сообщения из канала

   • Требуемые входные данные:

     • channel_id (строка): идентификатор канала

   • Дополнительные входные данные:

     • limit (число, по умолчанию: 10): количество сообщений для извлечения

   • Возвращает: список сообщений с их содержимым и метаданными.

6. slack_get_thread_replies

   • Получить все ответы в ветке сообщений

   • Требуемые входные данные:

     • channel_id (string): Канал, содержащий поток

     • thread_ts (string): временная метка родительского сообщения

   • Возвращает: список ответов с их содержанием и метаданными.

7. slack_get_users

   • Получить список пользователей рабочего пространства с базовой информацией профиля

   • Дополнительные входные данные:

     • cursor (строка): Курсор пагинации для следующей страницы

     • limit (число, по умолчанию: 100, макс.: 200): Максимальное количество пользователей для возврата

   • Возвращает: список пользователей с их основными профилями.

8. slack_get_user_profile

   • Получите подробную информацию о профиле конкретного пользователя

   • Требуемые входные данные:

     • user_id (строка): идентификатор пользователя

   • Возвращает: Подробную информацию о профиле пользователя

Related MCP server: Slack Search MCP Server

Настраивать

1. Создайте приложение Slack:

   • Посетите страницу приложений Slack

   • Нажмите «Создать новое приложение».

   • Выберите «С нуля»

   • Дайте название своему приложению и выберите рабочее пространство.

2. Настройте области действия токенов бота: перейдите в раздел «OAuth и разрешения» и добавьте следующие области действия:

   • channels:history — просмотр сообщений и другого контента в публичных каналах

   • channels:read - Просмотр основной информации о канале

   • chat:write - Отправка сообщений как приложение

   • reactions:write - Добавить эмодзи-реакции к сообщениям

   • users:read - Просмотр пользователей и их основной информации

   • users.profile:read - Просмотр подробных профилей пользователей

3. Установить приложение в Workspace:

   • Нажмите «Установить в Workspace» и авторизуйте приложение.

   • Сохраните «Токен OAuth пользователя бота», который начинается с xoxb-

4. Получите идентификатор своей команды (начинается с буквы T ), следуя этим инструкциям

Использование с Claude Desktop

Добавьте следующее в ваш claude_desktop_config.json :

НПХ

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-slack"
      ],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-bot-token",
        "SLACK_TEAM_ID": "T01234567",
        "SLACK_CHANNEL_IDS": "C01234567, C76543210"
      }
    }
  }
}

докер

{
  "mcpServers": {
    "slack": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SLACK_BOT_TOKEN",
        "-e",
        "SLACK_TEAM_ID",
        "-e",
        "SLACK_CHANNEL_IDS",
        "mcp/slack"
      ],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-bot-token",
        "SLACK_TEAM_ID": "T01234567",
        "SLACK_CHANNEL_IDS": "C01234567, C76543210"
      }
    }
  }
}

Использование с VS Code

Для быстрой установки нажмите одну из кнопок установки ниже...

Для ручной установки добавьте следующий блок JSON в файл настроек пользователя (JSON) в VS Code. Это можно сделать, нажав Ctrl + Shift + P и введя Preferences: Open Settings (JSON) .

При желании вы можете добавить его в файл .vscode/mcp.json в вашем рабочем пространстве. Это позволит вам поделиться конфигурацией с другими.

Обратите внимание, что ключ mcp не нужен в файле .vscode/mcp.json .

НПХ

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "slack_bot_token",
        "description": "Slack Bot Token (starts with xoxb-)",
        "password": true
      },
      {
        "type": "promptString",
        "id": "slack_team_id",
        "description": "Slack Team ID (starts with T)"
      }
    ],
    "servers": {
      "slack": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-slack"],
        "env": {
          "SLACK_BOT_TOKEN": "${input:slack_bot_token}",
          "SLACK_TEAM_ID": "${input:slack_team_id}"
        }
      }
    }
  }
}

Докер

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "slack_bot_token",
        "description": "Slack Bot Token (starts with xoxb-)",
        "password": true
      },
      {
        "type": "promptString",
        "id": "slack_team_id",
        "description": "Slack Team ID (starts with T)"
      }
    ],
    "servers": {
      "slack": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "mcp/slack"],
        "env": {
          "SLACK_BOT_TOKEN": "${input:slack_bot_token}",
          "SLACK_TEAM_ID": "${input:slack_team_id}"
        }
      }
    }
  }
}

Переменные среды

1. SLACK_BOT_TOKEN : Обязательно. Токен OAuth пользователя бота, начинающийся с xoxb- .

2. SLACK_TEAM_ID : Обязательно. Ваш идентификатор рабочего пространства Slack, начинающийся с T .

3. SLACK_CHANNEL_IDS : Необязательно. Список идентификаторов каналов, разделенных запятыми, для ограничения доступа к каналу (например, "C01234567, C76543210"). Если не задано, будут перечислены все общедоступные каналы.

Поиск неисправностей

Если вы столкнулись с ошибками разрешений, убедитесь, что:

1. Все необходимые области добавляются в ваше приложение Slack.

2. Приложение правильно установлено на вашем рабочем месте.

3. Токены и идентификатор рабочего пространства корректно скопированы в вашу конфигурацию.

4. Приложение добавлено в каналы, к которым ему необходим доступ.

Строить

Сборка Docker:

docker build -t mcp/slack -f src/slack/Dockerfile .

Лицензия

Этот сервер MCP лицензирован по лицензии MIT. Это означает, что вы можете свободно использовать, изменять и распространять программное обеспечение в соответствии с условиями лицензии MIT. Для получения более подробной информации см. файл LICENSE в репозитории проекта.