Mattermost

mm-mcp

Mattermost 用の MCP サーバーです。AI エージェントが Mattermost を読み取り、検索できます。また、許可すれば、あなたとして、またはボットとして投稿や返信もできます。

mm-mcp は独立したプロジェクトです。Mattermost, Inc. との提携、同社による承認やサポートはありません。Mattermost は Mattermost, Inc. の商標です。

ツールはチャンネル、スレッド、未読の投稿、メンション、ファイルを読み取り、投稿、ファイル、ユーザー、チャンネルを検索します。書き込みを許可すると、投稿、返信、編集、リアクション、ピン留め、投稿の提案、チャンネルへの参加、退出、作成、ステータスの設定もできます。Mattermost から貼り付けたリンクは、ID を必要とする読み取りツールであればどこでも使えます。すべての回答には、名前が挙がった投稿、チャンネル、チームへのリンクが含まれ、書き込みが他の人にどのアドレスから見えるかも示されます。添付ファイル、そのプレビュー、プロフィール画像、カスタム絵文字も、クライアントが読み取れる MCP リソースです。ツールのページにすべてのツールを掲載しています。MCP Apps ビューを表示できるクライアントでは、スレッド、自分の未読項目、エージェントが作成または提案した投稿を、Mattermost と同じレイアウトでチャット内に表示できます。今後、さらにビューを追加する予定です。イシューに計画を掲載しています。

エージェントが作成し、あなたが投稿、変更、破棄するのを待っている返信と、表示を依頼したスレッドは、ビューを表示できる AI アプリに表示されます（実際に試す）：

このような仕組みになっている理由

• 明示的に許可するまでは読み取り専用です。 投稿や変更を行うツールは、MM_MCP_ALLOW_WRITES が true になるまで提供されません。その後は、各呼び出しに対する MCP クライアント独自の承認によって実行が決まり、mm-mcp は変更を行う前に、変更内容が他の人にどのように見えるかを確認します。投稿や編集が何人に届くか、投稿が何人に通知されるか、編集によってどのテキストが置き換えられるか、削除によって何が失われるか、そしてそれがどのアドレスに表示されるかを確認します。デフォルトでは、すべての投稿と編集に AI が作成したことが明記されます。MM_MCP_ELICITATION_OPT_IN=true にすると、質問を表示できるクライアントで mm-mcp があなたにも確認を求めます。
• 自分のトークン、ボットのトークン、または自分のログインを使えます。 個人用アクセストークン、ボットトークン、または mm-mcp login による自分のログイン（シングルサインオンを含む）をシステムの資格情報ストアに保存して使えます。個人用アクセストークンが無効になっているサーバーにも対応します。
• Mattermost 独自のクライアントを使用します。 リクエストと回答には、手書きの API 説明ではなく、サーバー独自の Go クライアントと型を使用します。
• サポート対象のすべてのリリースをテストしています。 すべてのツールを、実際の Mattermost Team Edition で、Extended Support Release と最新リリースでは変更のたびに、その間のすべてのリリースでは毎週テストしています。
• stdio と Streamable HTTP に対応します。 クライアントはローカルプロセスとして起動するか、ループバックアドレスで Streamable HTTP を提供します。

クイックスタート

brew install vriesdemichael/tap/mm-mcp、 winget install vriesdemichael.mm-mcp、または scoop install vriesdemichael/mm-mcp（事前に scoop bucket add vriesdemichael https://github.com/vriesdemichael/scoop を実行）で mm-mcp をインストールするか、 お使いのマシン用のバイナリを 最新のリリースからダウンロードします。 次に、Mattermost の プロフィール → セキュリティ → パーソナルアクセストークン で個人用アクセストークンを取得し、クライアントの設定には含めず、システムの資格情報ストアに保管します。そのうえで mm-mcp login --with paste --url https://chat.example.com を実行します。トークンが無効になっている場合は、代わりに mm-mcp login --url https://chat.example.com で一度ログインしてください。

{
  "mcpServers": {
    "mattermost": {
      "command": "mm-mcp",
      "args": ["serve"],
      "env": {
        "MM_URL": "https://chat.example.com"
      }
    }
  }
}

または Claude Code を使う場合は、アドレスと、mm-mcp login の後は空欄のままにできるトークンを尋ねるプラグインを使います。

/plugin marketplace add vriesdemichael/mm-mcp
/plugin install mm-mcp@mm-mcp

またはサーバー単体の場合：

claude mcp add mattermost --scope user --env MM_URL=https://chat.example.com -- mm-mcp serve

Claude Desktop ユーザーは、代わりに最新のリリースからお使いのマシン用の .mcpb バンドルを開くことができます。

うまく動作しない場合は、mm-mcp doctor --url https://chat.example.com を実行すると、設定、保存済みのログイン情報、サーバーへの接続経路、資格情報を確認し、修正すべき点を提示します。MCP クライアント内では、diagnose ツールがクライアント独自の設定を使って同じ確認を行います。

ドキュメントには、すべての設定、ツール、サポート対象の Mattermost リリースが記載されています。

コントリビューション

CONTRIBUTING.mdを参照してください。このプロジェクトの構築方針については、docs/site/adrをご覧ください。

ライセンス

Apache-2.0