Skip to main content
Glama
in2out

Mattermost S MCP

by in2out

mattermost-s-mcp

Mattermost 웹훅을 MCP(Model Context Protocol)로 노출하여 Claude Desktop 등 AI 도구에서 바로 메시지를 전송할 수 있게 해주는 MCP 서버입니다.

특징

  • 간단한 설정: YAML 파일로 여러 웹훅 채널 관리

  • Claude Desktop 통합: MCP 프로토콜로 Claude와 완벽하게 연동

  • 기본 채널 지정: 자주 사용하는 채널을 기본으로 설정

  • 안전한 로깅: 웹훅 URL이 자동으로 마스킹되어 로그에 기록

Related MCP server: Mattermost MCP Server

요구사항

  • Node.js 18 이상

  • npm

빠른 시작

1. 설치

git clone <repository-url> mattermost-s-mcp
cd mattermost-s-mcp
npm install

2. 설정

config/webhooks.yaml 파일을 편집하여 Mattermost 웹훅 정보를 추가합니다:

version: 1
default_channel: ops-alert
webhooks:
  - channel: ops-alert
    url: https://your-mattermost-server/hooks/your-webhook-token
    description: 운영 알림 채널
  - channel: dev-notice
    url: https://your-mattermost-server/hooks/another-webhook-token
    description: 개발 공지 채널

3. Claude Desktop 등록

Claude Desktop 설정 파일에 다음을 추가합니다:

위치:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mattermost-s-mcp": {
      "command": "node",
      "args": ["/절대/경로/mattermost-s-mcp/index.js"],
      "env": {
        "MATTERMOST_MCP_CONFIG": "/절대/경로/mattermost-s-mcp/config/webhooks.yaml"
      }
    }
  }
}

중요: 경로는 반드시 절대 경로로 지정해야 합니다.

4. Claude Desktop 재시작

Claude Desktop을 완전히 종료하고 다시 시작합니다.

사용 방법

Claude Desktop에서 다음과 같이 요청하면 됩니다:

예시 1: 메시지 전송

Mattermost로 "배포 완료" 메시지 보내줘

예시 2: 채널 목록 확인

Mattermost 채널 목록 보여줘

예시 3: 특정 채널로 전송

Mattermost dev-notice 채널로 "긴급 공지" 메시지 보내줘

사용 가능한 도구

  1. mattermost.list_webhooks: 등록된 채널 목록과 기본 채널 확인

  2. mattermost.set_default: 기본 채널 설정

  3. mattermost.send_message: 메시지 전송

문제 해결

"server disconnected" 에러

  • Node.js 경로 확인: which node 또는 where node

  • 절대 경로 사용 확인

  • config/webhooks.yaml 파일 존재 확인

메시지 전송 실패

  • 웹훅 URL이 올바른지 확인

  • Mattermost 서버 접근 가능 여부 확인

  • 웹훅이 활성화되어 있는지 확인

라이선스

MIT

Available Tools

3 tools
mattermost_list_webhooksB

등록된 Mattermost 웹훅 채널 목록을 확인합니다.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. While '확인합니다' (check/verify) implies a read-only operation, the description doesn't explicitly state whether this requires authentication, what permissions are needed, how results are returned, or any rate limits. It provides minimal behavioral context beyond the basic action.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence in Korean that directly states the tool's purpose without any unnecessary words or structural complexity. It's appropriately sized for a simple list operation with no parameters.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a zero-parameter list operation with no output schema, the description adequately explains what the tool does. However, without annotations covering behavioral aspects like authentication requirements or response format, and with sibling tools that aren't differentiated, there are clear contextual gaps that prevent higher completeness.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has 0 parameters with 100% schema description coverage, so the schema fully documents the lack of inputs. The description appropriately doesn't discuss parameters, maintaining focus on the tool's purpose. This meets the baseline expectation for zero-parameter tools.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('확인합니다' - check/verify) and resource ('등록된 Mattermost 웹훅 채널 목록' - registered Mattermost webhook channel list), providing a specific verb+resource combination. However, it doesn't explicitly distinguish this from sibling tools like mattermost_send_message or mattermost_set_default, which prevents a perfect score.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus the sibling tools mattermost_send_message or mattermost_set_default. There's no mention of alternatives, prerequisites, or specific contexts where this tool is appropriate versus others.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

mattermost_send_messageC

기본 또는 지정한 채널 웹훅으로 메시지를 전송합니다.

ParametersJSON Schema
NameRequiredDescriptionDefault
textYes전송할 메시지 텍스트
channelNo메시지를 보낼 채널명 (선택)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It states the tool sends messages but lacks details on permissions, rate limits, error handling, or response format. This is inadequate for a mutation tool, as it doesn't inform the agent about potential side effects or operational constraints.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that gets straight to the point without unnecessary words. It's appropriately sized for the tool's complexity, though it could be slightly more structured (e.g., by explicitly noting optional parameters).

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's mutation nature, lack of annotations, and no output schema, the description is incomplete. It doesn't explain what happens after sending (e.g., success/failure response, message ID), how defaults work, or any behavioral nuances, leaving significant gaps for an AI agent to operate effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% description coverage, so the schema already documents both parameters ('text' and 'channel'). The description adds minimal value by implying the 'channel' parameter is optional, but this is redundant with the schema's required field list. Baseline 3 is appropriate as the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('send message') and resource ('via default or specified channel webhook'), making the purpose understandable. However, it doesn't explicitly differentiate from sibling tools like 'mattermost_list_webhooks' or 'mattermost_set_default', which prevents a perfect score.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives (e.g., 'mattermost_set_default' for setting defaults) or any prerequisites. It mentions a 'default or specified channel webhook' but doesn't clarify how defaults are set or when to specify a channel, leaving usage context vague.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

mattermost_set_defaultC

지정한 채널을 기본 웹훅으로 설정합니다.

ParametersJSON Schema
NameRequiredDescriptionDefault
channelYes기본으로 설정할 채널명

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. While '설정합니다' (sets) implies a mutation operation, the description doesn't disclose important behavioral traits like whether this requires admin permissions, whether it overwrites existing default webhook settings, what happens if the channel doesn't exist, or any rate limits. For a mutation tool with zero annotation coverage, this represents a significant gap in behavioral transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that gets straight to the point without any wasted words. It's appropriately sized for a single-parameter tool and front-loads the essential information about what the tool does.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a mutation tool with no annotations and no output schema, the description is insufficiently complete. It doesn't explain what happens after execution (success/failure indicators), doesn't mention permission requirements, and provides no information about the tool's behavior beyond the basic action. Given the complexity of a system configuration tool, more contextual information would be expected.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 100%, with the single parameter 'channel' well-documented in the schema as '기본으로 설정할 채널명' (channel name to set as default). The description doesn't add any meaningful parameter semantics beyond what the schema already provides, so it meets the baseline of 3 for high schema coverage situations.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('지정한 채널을...설정합니다' - sets the specified channel) and resource ('기본 웹훅' - default webhook), providing a specific verb+resource combination. However, it doesn't explicitly differentiate from sibling tools like mattermost_list_webhooks or mattermost_send_message, which prevents a perfect score.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. There's no mention of prerequisites (e.g., needing admin permissions), when this should be used instead of other webhook-related tools, or any exclusions. It simply states what the tool does without contextual usage information.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 3 tool updates
    • First observedmattermost_list_webhooks
    • First observedmattermost_send_message
    • First observedmattermost_set_default

TDQS

B3.2/5.0
Disambiguation5/5

Each tool has a clearly distinct purpose with no overlap: list_webhooks retrieves information, send_message posts content, and set_default configures preferences. The descriptions clearly differentiate between monitoring, communication, and setup functions.

Naming Consistency5/5

All tools follow a consistent 'mattermost_verb_noun' pattern with snake_case throughout. The naming is predictable and uniform across the set, making it easy to understand the domain and action for each tool.

Tool Count3/5

With only 3 tools, the server feels thin for a Mattermost integration, as it lacks operations like updating or deleting webhooks, managing users, or handling other common chat platform features. However, it covers a basic workflow adequately.

Completeness2/5

The tool set is severely incomplete for a Mattermost server, missing essential CRUD operations such as creating, updating, or deleting webhooks, as well as broader functionality like user management, channel operations, or message editing. This will likely cause agent failures in more complex tasks.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    F
    maintenance
    An MCP server that enables Claude and other MCP clients to interact with Mattermost workspaces, providing channel management, messaging capabilities, and topic monitoring functionality.
    42
    -
  • -
    license
    Not graded
    quality
    Not graded
    maintenance
    A Model Context Protocol server that enables Claude to interact with Mattermost instances, supporting post management, channel operations, user management, and reaction management.
    10
    1
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables sending WhatsApp messages through Claude Desktop and other MCP-compatible LLMs. Supports single and bulk messaging, phone number validation, and session management via the zapr.link service.
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/in2out/mattermost-s-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server