Mattermost 연동
기준일: 2026-07-26
난이도: 중급
공식 기준: Mattermost
개요
Hermes Mattermost 어댑터는 셀프호스트/클라우드 Mattermost에 봇으로 접속해 채널·DM에서 에이전트를 운영합니다.
핵심 개념
| 항목 | 내용 |
|---|---|
| 서버 | Mattermost base URL |
| 인증 | Bot token / Personal Access Token (원문 권장 방식) |
| 식별 | User ID |
| 채널 | 팀 채널 + DM, 멘션 게이트 |
| 보안 | allowlist, 채널 제한 |
상세
설정
- Mattermost에서 봇 계정·토큰 생성
- 봇을 팀/채널에 초대
- 본인 User ID 수집
hermes gateway setup→ Mattermost
MATTERMOST_URL=https://chat.example.com
MATTERMOST_TOKEN=...
MATTERMOST_ALLOWED_USERS=user_id_1,user_id_2
# MATTERMOST_HOME_CHANNEL=channel_id
hermes gateway
정확한 env 키·추가 옵션(require_mention, websocket vs poll)은 배포본 공식 표를 따릅니다.
동작
- DM: allowlist 통과 시 직접 응답
- 채널: 보통 @멘션 필요 (팀 소음 방지)
- Home channel: cron delivery
트러블슈팅
연결 실패 → URL(https)·토큰·프록시. 무응답 → 채널 멤버십, 멘션, allowlist. 권한 → 봇 post 권한.
보안
토큰 보호, 프로덕션에서 open allow 금지, 내부 Mattermost라도 터미널 툴 결합 시 승인 정책 유지.
체크리스트
- 공식 원문과 명령·설정 키를 대조했다
- 로컬/
config.yaml/.env에서 재현 경로를 확인했다 - 권한·allowlist·시크릿 노출을 점검했다
- 실패 시 롤백·비활성화 방법을 알고 있다
다음 단계
- 공식 문서: Mattermost
- 메시징 게이트웨이
- Hermes Agent 소개
기준일: 2026-07-26 — 공식 문서 동기화 코퍼스