Mattermost MCP: каналы, сообщения и администрирование через Claude

cloud-ru-tech/mcp-server-mattermost· Проверено 12.11.2026· 53на GitHub

Даёт агенту читать, искать и писать в Mattermost: каналы, треды, реакции, файлы и пользователи, а через mmctl ещё и администрировать сервер: команды, плагины, лицензии.

3 реализации:

39 инструментов по API v4 с токеном бота: каналы, сообщения, треды, реакции, файлы, закладки; есть режим HTTP с токеном на каждого клиента или OAuth через Mattermost.

Как подключить

Что сделать до подключения

uv с командой uvx или Python 3.10 и новее; есть образ Docker legard/mcp-server-mattermost

Токен бота Mattermost или личный токен доступа

MATTERMOST_TOKEN

токен бота Mattermost (bot account) или личный токен доступа

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'MATTERMOST_URL=https://<ваш сервер Mattermost>' --env 'MATTERMOST_TOKEN=<токен бота или личный токен>' --transport stdio mattermost \
  -- uvx mcp-server-mattermost

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mattermost]
command = "uvx"
args = ["mcp-server-mattermost"]

[mcp_servers.mattermost.env]
MATTERMOST_URL = "https://<ваш сервер Mattermost>"
MATTERMOST_TOKEN = "<токен бота или личный токен>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mattermost": {
      "command": "uvx",
      "args": ["mcp-server-mattermost"],
      "env": {
        "MATTERMOST_URL": "https://<ваш сервер Mattermost>",
        "MATTERMOST_TOKEN": "<токен бота или личный токен>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mattermost": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-server-mattermost"],
      "env": {
        "MATTERMOST_URL": "https://<ваш сервер Mattermost>",
        "MATTERMOST_TOKEN": "<токен бота или личный токен>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mattermost": {
      "command": "uvx",
      "args": ["mcp-server-mattermost"],
      "env": {
        "MATTERMOST_URL": "https://<ваш сервер Mattermost>",
        "MATTERMOST_TOKEN": "<токен бота или личный токен>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mattermost": {
      "command": "uvx",
      "args": ["mcp-server-mattermost"],
      "env": {
        "MATTERMOST_URL": "https://<ваш сервер Mattermost>",
        "MATTERMOST_TOKEN": "<токен бота или личный токен>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mattermost": {
        "type": "local",
        "command": ["uvx", "mcp-server-mattermost"],
        "environment": {
          "MATTERMOST_URL": "https://<ваш сервер Mattermost>",
          "MATTERMOST_TOKEN": "<токен бота или личный токен>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "mattermost": {
      "command": "uvx",
      "args": ["mcp-server-mattermost"],
      "env": {
        "MATTERMOST_URL": "https://<ваш сервер Mattermost>",
        "MATTERMOST_TOKEN": "<токен бота или личный токен>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mattermost": {
      "command": "uvx",
      "args": ["mcp-server-mattermost"],
      "env": {
        "MATTERMOST_URL": "https://<ваш сервер Mattermost>",
        "MATTERMOST_TOKEN": "<токен бота или личный токен>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

list_my_channelsпоказывает мои каналы с непрочитанным

list_public_channelsперечисляет публичные каналы

create_channelсоздаёт канал

join_channelвступает в канал

create_direct_channelоткрывает личный чат

post_messageотправляет сообщение

get_channel_messagesчитает сообщения канала

search_messagesищет по сообщениям

update_messageправит сообщение

get_threadчитает тред

add_reactionставит реакцию

pin_messageзакрепляет сообщение

search_usersищет пользователей

get_user_statusпоказывает статус в сети

list_teamsперечисляет команды

upload_fileзагружает файл в канал

download_fileскачивает вложение

create_bookmarkдобавляет закладку в канал

Показано 18 из 39.

Администрирование через mmctl в локальном режиме: команды, каналы, пользователи, плагины, конфигурация, права, вебхуки, боты, LDAP и лицензии.

Как подключить

Что сделать до подключения

Go 1.20 или новее: go install github.com/jespino/mmctl-mcp@latest

mmctl на сервере Mattermost, вход: mmctl auth login https://<ваш сервер> --name <имя>

По желанию ANTHROPIC_API_KEY для инструментов claude_prompt и claude_file_analysis

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio mmctl-mcp \
  -- mmctl-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mmctl-mcp]
command = "mmctl-mcp"
args = []

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mmctl-mcp": {
      "command": "mmctl-mcp",
      "args": []
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mmctl-mcp": {
      "type": "stdio",
      "command": "mmctl-mcp",
      "args": []
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mmctl-mcp": {
      "command": "mmctl-mcp",
      "args": []
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mmctl-mcp": {
      "command": "mmctl-mcp",
      "args": []
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mmctl-mcp": {
        "type": "local",
        "command": ["mmctl-mcp"]
      }
    }
  }
}

{
  "mcpServers": {
    "mmctl-mcp": {
      "command": "mmctl-mcp",
      "args": []
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mmctl-mcp": {
      "command": "mmctl-mcp",
      "args": []
    }
  }
}

Инструменты сервера

system_infoпоказывает сведения о системе

team_createсоздаёт команду

team_listперечисляет команды

channel_createсоздаёт канал

channel_archiveархивирует канал

user_listперечисляет пользователей

user_createсоздаёт пользователя

post_createпубликует сообщение

plugin_listперечисляет плагины

plugin_disableотключает плагин

config_getчитает настройку сервера

config_setменяет настройку сервера

permission_addдобавляет право роли

webhook_create_incomingсоздаёт входящий вебхук

bot_createсоздаёт бота

ldap_syncсинхронизирует LDAP

job_listпоказывает задания сервера

license_uploadзагружает лицензию

Небольшой сервер на Node.js с мониторингом тем: по расписанию cron просматривает каналы и упоминает вас, когда обсуждают заданное.

Как подключить

Что сделать до подключения

Node.js; склонировать репозиторий, выполнить npm install и npm run build

Создать config.local.json с mattermostUrl, token и teamId; для мониторинга заполнить блок monitoring

token

личный токен доступа Mattermost, кладётся в config.local.json

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio mattermost-mcp \
  -- node '<путь к mattermost-mcp>/build/index.js'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mattermost-mcp]
command = "node"
args = ["<путь к mattermost-mcp>/build/index.js"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mattermost-mcp": {
      "command": "node",
      "args": ["<путь к mattermost-mcp>/build/index.js"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mattermost-mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["<путь к mattermost-mcp>/build/index.js"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mattermost-mcp": {
      "command": "node",
      "args": ["<путь к mattermost-mcp>/build/index.js"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mattermost-mcp": {
      "command": "node",
      "args": ["<путь к mattermost-mcp>/build/index.js"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mattermost-mcp": {
        "type": "local",
        "command": ["node", "<путь к mattermost-mcp>/build/index.js"]
      }
    }
  }
}

{
  "mcpServers": {
    "mattermost-mcp": {
      "command": "node",
      "args": ["<путь к mattermost-mcp>/build/index.js"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mattermost-mcp": {
      "command": "node",
      "args": ["<путь к mattermost-mcp>/build/index.js"]
    }
  }
}

Инструменты сервера

mattermost_list_channelsперечисляет публичные каналы

mattermost_get_channel_historyчитает последние сообщения

mattermost_post_messageотправляет сообщение

mattermost_reply_to_threadотвечает в тред

mattermost_add_reactionставит реакцию

mattermost_get_thread_repliesчитает ответы в треде

mattermost_run_monitoringзапускает проверку тем

mattermost_get_usersперечисляет пользователей

mattermost_get_user_profileчитает профиль пользователя

Что попросить агента

«Что я пропустил в #engineering со вчерашнего утра?»mcp-server-mattermost вызовет get_channel_messages с параметром since и перескажет

«Найди сообщения об аварии на прошлой неделе и подведи итог»Агент вызовет search_messages и get_thread

«Отправь в #engineering сообщение о статусе сборки с красным вложением»mcp-server-mattermost вызовет post_message с attachments

«Создай команду engineering и в ней приватный канал security-updates»mmctl-mcp вызовет team_create и channel_create с флагом приватности

«Отключи плагин jira»mmctl-mcp вызовет plugin_list и plugin_disable

Для каких задач

Пересказать, что вы пропустили в канале со вчерашнего утра

Найти обсуждение аварии за прошлую неделю и подвести итог

Отправить в канал оповещение о сборке с цветным вложением

Загрузить отчёт в канал и поделиться ссылкой

Создать команду и приватный канал, завести пользователя

Отключить плагин или загрузить новую лицензию сервера

Ограничения

mmctl-mcp лежит в организации Mattermost, но у него 2 звезды и последнее обновление в апреле 2025; ставится из репозитория jespino/mmctl-mcp

mmctl-mcp действует с правами учётки, под которой вошёл mmctl: для агента лучше завести отдельную учётку с нужными правами

Закладки в mcp-server-mattermost работают только в редакциях Entry, Professional и Enterprise версии 10.1 и новее, в Team Edition их нет

В режиме HTTP со static_token mcp-server-mattermost открывает эндпоинт без авторизации от имени общего токена

Если не работает

Клиент без токена получает 401 от mcp-server-mattermost

В режиме client_token каждый клиент должен слать свой токен Mattermost в заголовке Authorization: Bearer <токен>.

Ошибки прав в mattermost-mcp (pvev)

Проверьте права личного токена, что он скопирован без ошибок и что адрес Mattermost и teamId верны.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
mcp-server-mattermost	cloud-ru-tech	53	локально	токен	39	2 ноября 2026
mmctl-mcpразработчик сервиса	Mattermost	2	локально	не нужен	18	3 апреля 2025
mattermost-mcp (pvev)	pvev	44	локально	токен	9	22 сентября 2026

Частые вопросы

Какой вариант выбрать?

Для работы в каналах — mcp-server-mattermost: он читает и ищет сообщения, пишет, ставит реакции, загружает файлы. Для администрирования сервера — mmctl-mcp. Сервер pvev нужен, если хочется, чтобы агент по расписанию следил за темами в каналах.

Где взять токен Mattermost?

Подойдёт токен бота Mattermost или личный токен доступа. Его передают в MATTERMOST_TOKEN, адрес сервера — в MATTERMOST_URL.

Можно ли дать каждому сотруднику свой доступ?

Да, у mcp-server-mattermost в режиме HTTP: MATTERMOST_AUTH_MODE=client_token, и каждый клиент шлёт свой токен в заголовке Authorization: Bearer. Есть и режим oauth_proxy со входом через OAuth-приложение Mattermost.

Работает ли с самоподписанным сертификатом?

Да. В mcp-server-mattermost добавьте свой корневой сертификат через MATTERMOST_EXTRA_CA_CERTS или отключите проверку: MATTERMOST_VERIFY_SSL=false.

Как подключить Mattermost MCP к Claude Code?

Откройте вкладку Claude Code в блоке «Как подключить»: там команда для uvx mcp-server-mattermost с MATTERMOST_URL и MATTERMOST_TOKEN. Для режима OAuth: claude mcp add --transport http mattermost https://<адрес сервера MCP>/mcp.

Есть ли MCP-сервер у самой Mattermost?

В организации Mattermost на GitHub лежит mmctl-mcp для администрирования через mmctl, но он почти не обновляется: последний раз в апреле 2025.

Работает ли сервер из России?

Серверы запускаются у вас и обращаются к вашему серверу Mattermost по токену; если Mattermost развёрнут в своей сети, внешние сервисы не нужны.

Mattermost MCP: каналы, сообщения и администрирование через Claude

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы