플러그인 구성 설정
Entry, Professional, Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.
시스템 콘솔(System Console)에서 Product 
메뉴를 선택하고 System Console, Plugins를 차례로 선택해 다음 플러그인 구성 옵션을 확인하고 관리하세요.
- 플러그인 관리
- Calls
- AI Agents
- GitLab
- GitHub
- Jira
- Legal Hold
- Microsoft Calendar 연동
- MS Teams
- 성능 메트릭
- 협업 플레이북
- 사용자 만족도 조사
- ServiceNow
- Zoom
- config.json 전용 설정
자체 호스팅 Mattermost 배포를 관리하는 시스템 관리자는 아래 표에 설명된 대로 config.json 파일을 편집할 수 있습니다. 아래의 각 구성 값에는 JSON을 다룰 수 있는 도구로 config.json 파일에서 해당 값에 프로그래밍 방식으로 접근할 수 있는 JSON 경로가 함께 표시됩니다. 예를 들어 Enable 값은 PluginSettings 아래에 있습니다.
- jq 같은 도구를 사용한다면 다음과 같이 입력합니다:
cat config/config.json | jq '.PluginSettings.Enable' config.json파일을 직접 편집할 때는PluginSettings같은 객체를 찾은 뒤 그 객체 안에서Enable키를 찾습니다.
플러그인 관리
시스템 콘솔에서 Plugins > Plugin Management로 이동해 다음 구성 설정에 접근합니다.
플러그인 활성화 (Enable plugins)
|
|
대규모 배포에서 이 구성 설정을 비활성화하면 다음 영역에서 서버 성능이 향상될 수 있습니다.
- 자원 소비: 플러그인은 CPU, 메모리, 디스크 같은 시스템 자원을 소비합니다. 플러그인을 비활성화하면 이 자원이 해제되어 핵심 Mattermost 애플리케이션이 더 효율적으로 동작할 수 있습니다.
- 복잡도 감소: 플러그인마다 추가 로직과 처리 요구 사항이 더해집니다. 활성 플러그인 수를 줄이면 시스템의 복잡도와 잠재적 장애 지점이 줄어듭니다.
- 로드 시간 단축: 플러그인을 비활성화하면 시스템이 초기화하고 관리할 구성 요소가 줄어들어 서버 시작이 빨라지고 사용자 상호작용 시 지연 시간이 낮아집니다.
- 안정성: 일부 플러그인에는 Mattermost 인스턴스의 전반적인 성능과 안정성에 영향을 주는 버그나 성능 문제가 있을 수 있습니다. 문제가 있거나 거의 쓰이지 않는 플러그인을 비활성화하면 시스템 안정성이 높아집니다.
- 유지 보수와 업데이트: 플러그인 수가 적으면 유지 보수와 업데이트에 드는 부담이 줄어들어 운영이 매끄러워지고 다운타임도 줄어듭니다
- 다만 플러그인은 Mattermost를 다른 서비스 및 워크플로와 연동하는 데 필수적인 경우가 많습니다. 성능 향상과 조직 및 사용자의 필요 사이에서 균형을 잡는 것이 중요합니다.
플러그인 서명 요구 (Require plugin signature)
|
|
- 이 설정은 자체 호스팅 배포에만 적용됩니다.
- Mattermost 서버 v10.11부터 사전 패키지 플러그인은 시작 시 서명 검증이 필요합니다. 커스텀 사전 패키지 플러그인을 함께 배포하는 배포판은
PluginSettings.SignaturePublicKeyFiles를 통해 커스텀 공개 키를 구성해 서명을 검증해야 합니다. - Mattermost 서버 v10.10 이하: 사전 패키지 플러그인은 서명 검증 대상이 아닙니다.
- Marketplace를 통해 설치되는 플러그인은 다운로드 시점에 항상 서명 검증을 거칩니다.
- 이 설정을 활성화하면 시스템 콘솔에서 플러그인 파일 업로드가 비활성화됩니다.
사전 패키지 플러그인 자동 설치 (Automatic prepackaged plugins)
|
|
사전 패키지 플러그인 설치 동작: 시스템 관리자가 플러그인 파일을 (.sig 서명 파일과 함께) prepackaged_plugins 디렉터리에 넣더라도 플러그인이 자동으로 설치되지는 않습니다. 사전 패키지는 플러그인을 "오프라인" 설치에 사용할 수 있도록 만들어 둘 뿐입니다. 시스템 관리자가 config.json에서 해당 플러그인을 활성화하도록 미리 구성한 경우에만 플러그인이 자동으로 설치됩니다.
플러그인 업로드 (Upload Plugin)
|
|
- 이 설정은 자체 호스팅 배포에만 적용됩니다.
- 플러그인 업로드가 활성화된 상태에서 플러그인 파일을 업로드할 때
Received invlaid response from the server오류가 나타난다면, 대개 MaxFileSize 구성 설정이 해당 플러그인 파일 업로드를 감당할 만큼 크지 않다는 뜻입니다. 프록시 설정도 함께 조정해야 할 수 있습니다. - 플러그인 서명 요구 구성 설정이 활성화되어 있으면 플러그인 파일 업로드 기능이 비활성화됩니다.
Marketplace 활성화 (Enable Marketplace)
|
|
원격 Marketplace 활성화 (Enable remote Marketplace)
|
|
- Mattermost v9.1부터 구성된 원격 Marketplace URL에 접근하려면 이 구성 설정 값을
true로 설정하세요. - Mattermost v9.0에서는 구성된 원격 Marketplace URL에 접근하려면
MM_FEATUREFLAGS_STREAMLINEDMARKETPLACE기능 플래그를false로 설정하고 이 구성 설정을true로 설정해야 합니다. - 각 Mattermost 호스트는 MarketplaceURL에 설정된 엔드포인트에 네트워크로 접근할 수 있어야 합니다.
Marketplace URL
이 설정은 원격 Marketplace의 URL을 저장합니다. 문자열을 입력합니다. 기본값은 https://api.integrations.mattermost.com입니다. |
|
설치된 플러그인 상태 (Installed plugin state)
이 설정은 설치된 플러그인 목록과 각 플러그인의 활성화/비활성화 상태입니다.
|
|
플러그인 설정 (Plugin settings)
이 설정은 플러그인별 데이터를 담습니다.
|
|
Calls
시스템 콘솔에서 Plugins > Calls로 이동해 다음 구성 설정에 접근합니다.
플러그인 활성화 (Enable plugin)
|
|
RTC 서버 주소(UDP) (RTC server address (UDP))
이 설정은 RTC 서버가 UDP 연결을 수신할 IP 주소를 제어합니다. 모든 통화 UDP 트래픽이 이 IP를 통해 처리됩니다. 이 설정을 변경하면 적용을 위해 플러그인을 재시작해야 합니다. 설정하지 않으면(기본값) 서비스가 사용 가능한 모든 인터페이스에서 수신합니다. |
|
이 설정은 자체 호스팅 배포에만, 그리고 독립 실행형 rtcd 서비스를 통해 통화를 처리하지 않는 경우에만 적용됩니다.
RTC 서버 주소(TCP) (RTC server address (TCP))
이 설정은 RTC 서버가 TCP 연결을 수신할 IP 주소를 제어합니다. 모든 통화 TCP 트래픽이 이 IP를 통해 처리됩니다. 이 설정을 변경하면 적용을 위해 플러그인을 재시작해야 합니다. 설정하지 않으면(기본값) 서비스가 사용 가능한 모든 인터페이스에서 수신합니다. |
|
이 설정은 플러그인 버전 0.17부터 사용할 수 있으며, 독립 실행형 rtcd 서비스를 통해 통화를 처리하지 않는 자체 호스팅 배포에만 적용됩니다.
RTC 서버 포트(UDP) (RTC server port (UDP))
이 설정은 RTC 서버가 수신할 UDP 포트를 제어합니다. 모든 통화 UDP 트래픽이 이 포트를 통해 처리됩니다. 이 설정을 변경하면 적용을 위해 플러그인을 재시작해야 합니다. 기본값은 8443입니다. |
|
이 설정은 독립 실행형 rtcd 서비스를 통해 통화를 처리하지 않는 자체 호스팅 배포에만 적용됩니다.
RTC 서버 포트(TCP) (RTC server port (TCP))
이 설정은 RTC 서버가 수신할 TCP 포트를 제어합니다. 모든 통화 TCP 트래픽이 이 포트를 통해 처리됩니다. 이 설정을 변경하면 적용을 위해 플러그인을 재시작해야 합니다. 기본값은 8443입니다. |
|
이 설정은 플러그인 버전 0.17부터 사용할 수 있으며, 독립 실행형 rtcd 서비스를 통해 통화를 처리하지 않는 자체 호스팅 배포에만 적용됩니다.
특정 채널에서 활성화 (Enable on specific channels)
Mattermost v7.7부터 관리자가 이 설정을 구성할 수 없습니다. 자체 호스팅 배포에서는 숨겨진 채 항상 활성화되어 있습니다
|
|
테스트 모드 (Test mode)
이 설정은 Mattermost v7.7까지 Enable on all channels로 불렸습니다. 코드에서는 defaultenabled로, 제품에서는 Test Mode로 이름이 바뀌었으며 자체 호스팅 배포에만 적용됩니다.
|
|
시스템 관리자는 이 설정을 사용해 통화가 정상적으로 동작하는지 확인하세요. false일 때는 통화를 시작하려는 사용자에게 시스템 관리자에게 문의하라는 안내가 표시되고, 시스템 관리자에게는 라이브 모드로 전환하기 전에 통화가 정상 동작하는지 확인하라는 안내가 표시됩니다.
ICE 호스트 재정의 (ICE host override)
이 설정은 통화 연결 시 클라이언트에 알리는 호스트 주소를 재정의하는 데 사용할 수 있습니다. 허용되는 형식은 다음과 같습니다.
선택 항목입니다. 이 설정을 변경하면 적용을 위해 플러그인을 재시작해야 합니다. |
|
- 이 설정은 독립 실행형
rtcd서비스를 통해 통화를 처리하지 않는 자체 호스팅 배포에만 적용됩니다. - 네트워크 구성에 따라(예: 인스턴스가 NAT 장비 뒤에 있는 경우) 클라이언트가 연결할 수 있도록 이 필드에 클라이언트 대상 외부 IP를 설정해야 할 수 있습니다. 비어 있거나 설정되지 않은 경우 RTC 서비스는 STUN을 통해 인스턴스의 공인 IP를 찾으려 시도합니다.
- 이 설정에는 호스트 이름(예: 도메인 이름)을 지정할 수 있지만 클라이언트에는 IP 주소가 전달됩니다. 즉, DNS 해석이 Mattermost 인스턴스에서 일어나며 클라이언트가 보게 될 IP 주소와 달라져 연결이 실패할 수 있습니다. 확신이 서지 않는다면 IP 주소를 직접 사용하거나, 호스트 측 해석 결과가 클라이언트 측과 일치하는지 확인하는 것을 권장합니다.
ICE 호스트 포트 재정의 (ICE host port override)
이 설정은 통화 연결 시 클라이언트에 알리는 ICE 호스트 후보에 사용되는 포트를 재정의하는 데 사용할 수 있습니다. RTC 서버 앞에 통화 트래픽을 다른 포트로 라우팅하는 네트워크 구성 요소(예: NLB)가 있는 경우에 유용합니다. 이 설정을 변경하면 적용을 위해 플러그인을 재시작해야 합니다. |
|
- 이 설정은 자체 호스팅 배포에만 적용됩니다.
- 이 값은 UDP와 TCP 호스트 후보 모두에 적용됩니다.
RTCD 서비스 URL (RTCD service URL)
Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.
통화를 호스팅할, 실행 중인 rtcd 서비스 인스턴스의 URL입니다. 값이 설정되면(비어 있지 않으면) 모든 통화가 이 외부 서비스에서 처리됩니다. 선택 항목입니다. 이 설정을 변경하면 적용을 위해 플러그인을 재시작해야 합니다. |
|
- 이 설정은 자체 호스팅 배포에만 적용됩니다.
- 환경 변수
MM_CALLS_RTCD_URL은 사용 중단되었으며MM_CALLS_RTCD_SERVICE_URL로 대체되었습니다. - 클라이언트는 서비스에 처음 연결할 때 스스로 등록하고 인증 키를 데이터베이스에 저장합니다. 클라이언트 ID를 명시하지 않으면 Mattermost 설치의 진단 ID가 사용됩니다.
- 서비스 URL은
http://clientID:authKey@hostname형식의 자격 증명을 지원합니다. 또는 Mattermost 서버에 환경 변수 재정의로MM_CALLS_RTCD_CLIENT_ID와MM_CALLS_RTCD_AUTH_KEY를 전달할 수도 있습니다 - 클라이언트는 서비스에 처음 연결할 때 스스로 등록하고 인증 키를 데이터베이스에 저장합니다. 클라이언트 ID를 명시하지 않으면 Mattermost 설치의 진단 ID가 사용됩니다.
- 서비스 URL은
http://clientID:authKey@hostname형식의 자격 증명을 지원합니다. 또는 Mattermost 서버에 환경 변수 재정의로MM_CALLS_RTCD_CLIENT_ID와MM_CALLS_RTCD_AUTH_KEY를 전달할 수도 있습니다
최대 통화 참가자 수 (Max call participants)
이 설정은 하나의 통화에 참여할 수 있는 참가자 수를 제한합니다. 기본값은 0(제한 없음)입니다. |
|
- 이 설정은 자체 호스팅 배포에만 적용됩니다.
- 환경 변수
MM_CALLS_MAX_PARTICIPANTS는 사용 중단되었으며MM_CALLS_MAX_CALL_PARTICIPANTS로 대체되었습니다. - 이 설정은 선택 사항이지만 권장 최대 참가자 수는 50입니다. 통화 참가자 수 한계는 인스턴스 자원에 크게 좌우됩니다. 자세한 내용은 Calls 배포 가이드 문서를 참고하세요.
ICE 서버 구성 (ICE servers configurations)
이 설정은 서비스가 사용할 ICE 서버(STUN/TURN) 목록을 JSON 형식으로 저장합니다. 선택 항목입니다. 이 설정을 변경하면 적용을 위해 플러그인 재시작이 필요할 수 있습니다. 기본값은 |
|
- 이 설정은 자체 호스팅 배포에만 적용됩니다.
- 위 구성에 포함된 STUN 및 TURN 서버 정보는 클라이언트로 전송되어 로컬 후보를 생성하는 데 사용됩니다.
- 플러그인을 통해 통화를 호스팅하는 경우(즉 RTCD service를 사용하지 않는 경우), ICE Host Override 옵션으로 공인 IP가 제공되지 않으면 구성된 STUN 서버가 인스턴스의 공인 IP를 찾는 데 사용될 수도 있습니다.
예시
[
{
"urls":[
"stun:stun.global.calls.mattermost.com:3478"
]
},
{
"urls":[
"turn:turn.example.com:3478"
],
"username":"webrtc",
"credentials":"turnpassword"
}
]예시(생성된 TURN 자격 증명 사용)
[{
"urls": ["turn:turn.example.com:443"]
}]TURN 생성 자격 증명을 사용하려면 아래의 TURN static auth secret 설정으로 시크릿을 제공해야 합니다.
TURN 정적 인증 시크릿 (TURN static auth secret)
TURN 서버용 단기 자격 증명을 생성하는 데 사용하는 정적 시크릿입니다. 선택 항목입니다. |
|
이 설정은 자체 호스팅 배포에만 적용됩니다.
TURN 자격 증명 만료 시간 (TURN credentials expiration)
TURN 서버용으로 생성된 단기 자격 증명의 만료 시간(분)입니다. 기본값은 1440(하루)입니다. |
|
이 설정은 자체 호스팅 배포에만 적용됩니다.
서버 측 TURN (Server side TURN)
이 설정을 변경하면 적용을 위해 플러그인을 재시작해야 합니다. |
|
이 설정은 자체 호스팅 배포에만 적용됩니다.
화면 공유 허용 (Allow screen sharing)
이 설정을 변경하면 적용을 위해 플러그인을 재시작해야 합니다. |
|
이 설정은 자체 호스팅 배포에만 적용됩니다.
화면 공유 simulcast 활성화 (Enable simulcast for screen sharing, Experimental)
|
|
- 이 실험적 설정은 자체 호스팅 배포에만 적용됩니다.
- 이 기능에는 Calls 플러그인 v0.16.0 이상과 (사용하는 경우)
rtcdv0.10.0 이상이 필요합니다. - 이 실험적 구성 설정과 AV1 활성화 실험적 구성 설정을 동시에 활성화하지 마세요.
통화 녹화 활성화 (Enable call recordings)
Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.
녹화에는 통화 창 전체 화면과 참가자의 오디오 트랙, 공유된 화면 영상이 포함됩니다. 녹화 파일은 Mattermost에 저장됩니다. 이 설정을 변경하면 적용을 위해 플러그인을 재시작해야 합니다. |
|
이 설정은 자체 호스팅 배포에만 적용됩니다.
작업 서비스 URL (Job service URL)
Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.
녹화 관련 처리가 이루어지는, 실행 중인 작업 서비스의 URL입니다. 생성된 녹화 파일은 Mattermost에 저장됩니다. 필수 항목입니다. 이 설정을 변경하면 적용을 위해 플러그인을 재시작해야 합니다. |
|
- 이 설정은 자체 호스팅 배포에만 적용됩니다.
- 클라이언트는 서비스에 처음 연결할 때 스스로 등록하고 인증 키를 데이터베이스에 저장합니다. 클라이언트 ID를 명시하지 않으면 Mattermost 설치의 진단 ID가 사용됩니다.
- 서비스 URL은
http://clientID:authKey@hostname형식의 자격 증명을 지원합니다. 또는 Mattermost 서버에 환경 변수 재정의로MM_CALLS_JOB_SERVICE_CLIENT_ID와MM_CALLS_JOB_SERVICE_AUTH_KEY를 전달할 수도 있습니다. - Calls v0.25부터는
MM_CALLS_RECORDER_SITE_URL또는MM_CALLS_TRANSCRIBER_SITE_URL환경 변수를 설정해 작업이 연결에 사용하는 사이트 URL을 각각 재정의할 수 있습니다. 이렇게 하면 작업이 Mattermost에 구성된 공개 Site URL을 통해 연결하지 않도록 해 공용 네트워크를 우회할 수 있습니다.
최대 통화 녹화 시간 (Maximum call recording duration)
Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.
통화 녹화의 최대 길이(분)입니다. 기본값은 60이며 최댓값은 180입니다. 필수 값입니다. |
|
이 설정은 자체 호스팅 배포에만 적용됩니다.
통화 녹화 품질 (Call recording quality)
Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.
통화 녹화의 음성 및 영상 품질입니다. 사용할 수 있는 옵션은 Low, Medium, *High*입니다. 기본값은 Medium입니다. 필수 값입니다. |
|
- 이 설정은 자체 호스팅 배포에만 적용됩니다.
- 이 품질 설정은 작업 서비스의 성능과 녹화 파일 크기에 영향을 줍니다. 자세한 내용은 Calls 배포 가이드 문서를 참고하세요.
통화 전사 활성화 (Enable call transcriptions)
Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.
전사는 통화 참가자의 오디오 트랙에서 생성되며, 녹화가 끝나면 결과 파일이 통화 스레드에 첨부됩니다. 자막은 선택에 따라 녹화 파일 영상 플레이어 위에 표시할 수 있습니다. |
|
전사기 모델 크기 (Transcriber model size)
Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.
사용할 음성-텍스트 변환 모델의 크기입니다. 무거운 모델일수록 정확도가 높지만 처리 시간과 자원 사용량이 늘어납니다. 사용할 수 있는 옵션은 Tiny, Base, *Small*입니다. 기본값은 Base입니다. 필수 값입니다. |
|
- 이 설정은 자체 호스팅 배포에만 적용됩니다.
- 이 설정은 플러그인 버전 0.22부터 사용할 수 있습니다. 모델 크기 설정은 작업 서비스의 성능에 영향을 줍니다. 자세한 내용은 Calls 배포 가이드 문서를 참고하세요.
통화 전사기 스레드 수 (Call transcriber threads)
Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.
통화 종료 후 전사기가 사용하는 스레드 수입니다. [1, numCPUs] 범위여야 합니다. 기본값은 2입니다. 필수 값입니다. |
|
- 이 설정은 자체 호스팅 배포에만 적용됩니다.
- 통화 전사기 스레드 수 설정은 작업 서비스의 성능에 영향을 줍니다. 자세한 내용은 Calls 배포 가이드 문서를 참고하세요. 이 설정은 플러그인 버전 0.26.2부터 사용할 수 있습니다.
실시간 자막 활성화 (Enable live captions)
Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.
실시간 자막은 통화 참가자의 오디오 트랙에서 생성되며, [cc] 옵션을 선택하면 통화 클라이언트에 표시할 수 있습니다. |
|
실시간 자막: 모델 크기 (Live captions: Model size)
Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.
실시간 자막에 사용할 음성-텍스트 변환 모델의 크기입니다. 무거운 모델일수록 정확도가 높을 수 있지만, 실시간 자막은 전사기가 최대 10초 분량의 오디오를 2초 안에 처리해야 하므로 `base` 이하 크기를 권장합니다. 사용할 수 있는 옵션은 Tiny, Base, *Small*입니다. 기본값은 Tiny입니다. 필수 값입니다. |
|
- 이 설정은 자체 호스팅 배포에만 적용됩니다.
- 이 설정은 플러그인 버전 0.26.2부터 사용할 수 있습니다. 모델 크기 설정은 작업 서비스의 성능에 영향을 줍니다. 자세한 내용은 성능 및 확장성 권장 사항 문서를 참고하세요.
실시간 자막: 통화당 사용하는 전사기 수 (Live captions: Number of transcribers used per call)
Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.
통화마다 사용할 별도 실시간 자막 전사기의 개수입니다. 각 전사기는 한 번에 하나의 오디오 스트림을 전사합니다. LiveCaptionsNumTranscribers * LiveCaptionsNumThreadsPerTranscriber 값은 [1, numCPUs] 범위여야 합니다. 기본값은 1입니다. 필수 값입니다. |
|
- 이 설정은 자체 호스팅 배포에만 적용됩니다.
- 이 설정은 플러그인 버전 0.26.2부터 사용할 수 있습니다. 실시간 자막 전사기 수 설정은 작업 서비스의 성능에 영향을 줍니다. 자세한 내용은 성능 및 확장성 권장 사항 문서를 참고하세요.
실시간 자막: 전사기당 스레드 수 (Live captions: Number of threads per transcriber)
Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.
실시간 자막 전사기 하나당 스레드 수입니다. 기본값은 2입니다. 필수 값입니다. |
|
- 이 설정은 자체 호스팅 배포에만 적용됩니다.
- 이 설정은 플러그인 버전 0.26.2부터 사용할 수 있습니다. 실시간 자막 전사기당 스레드 수 설정은 작업 서비스의 성능에 영향을 줍니다. 자세한 내용은 성능 및 확장성 권장 사항 문서를 참고하세요
실시간 자막 언어 (Live captions language)
Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.
실시간 자막 전사기에 전달할 언어입니다. 'en'과 같이 두 글자 ISO 639 Set 1 언어 코드여야 합니다. 비워 두면 기본값으로 'en'(영어)이 설정됩니다. |
|
이 설정은 자체 호스팅 배포에만 적용됩니다.
(실험적) IPv6 활성화 ((Experimental) Enable IPv6)
이 설정을 변경하면 적용을 위해 플러그인을 재시작해야 합니다. |
|
- 이 설정은 자체 호스팅 배포에만 적용됩니다.
- 이 설정은 플러그인 버전 0.17부터 사용할 수 있으며, 독립 실행형
rtcd서비스를 통해 통화를 처리하지 않는 경우에만 적용됩니다.
통화 벨소리 활성화 (Enable call ringing)
|
|
Mattermost 통화에서 통화 벨소리를 활성화하는 기능은 베타 단계입니다.
AV1 활성화 (Enable AV1, Experimental)
|
|
이 실험적 구성 설정과 화면 공유 simulcast 활성화 실험적 구성 설정을 동시에 활성화하지 마세요.
DM에서 영상 통화 활성화 (Enable video calls in DMs, Experimental)
DM 통화의 영상은 데스크톱 앱과 웹 앱에서만 지원됩니다. 모바일 사용자는 영상 통화를 시작할 수 없으며, 영상이 포함된 DM 통화에 참여하면 음성과 화면 공유만 수신합니다. 통화 녹화에는 음성과 화면 공유만 담기며 영상은 녹화되지 않습니다. |
|
DM에서 영상 통화를 활성화하는 기능은 현재 실험적 단계입니다.
배포 환경에서 통화를 RTCD 서비스로 오프로드하는 경우, DM 통화의 영상에는 rtcd v1.2.2 이상이 필요합니다. 사용 중인 Calls 플러그인 릴리스에 포함된 rtcd 버전(Calls v1.12.0의 경우 rtcd v1.2.5)을 사용하고 플러그인과 함께 rtcd도 최신 상태로 유지하는 것을 권장합니다. 플러그인 내장 RTC 서버를 사용하는(RTCD를 쓰지 않는) 배포에서는 추가 구성 없이 영상을 지원합니다.
DC 시그널링 활성화 (Enable DC signaling, Experimental)
|
|
- 전용 WebRTC 서비스를 통해 통화를 호스팅할 때 이 기능이 동작하려면 RTCD service v0.18.0 이상이 필요합니다.
- 이 실험적 구성 설정은 WebRTC 기반 통화 설정의 일부를 시스템이 어떻게 처리할지 결정하므로 활성화할 때 주의하세요. 이 구성 설정을 활성화하면 상황에 따라 통화 설정이 조금 더 빠르거나 안정적일 수 있습니다.
AI Agents
Mattermost Agents는 이전에 Mattermost Copilot으로 불렸습니다.
시스템 콘솔에서 Plugins > Agents로 이동해 다음 Mattermost Agents 구성 설정에 접근합니다.
플러그인 활성화 (Enable plugin)
|
|
표시 이름 (Display name)
시스템의 다른 봇과 구분하기 위해 Mattermost에 표시되는 봇의 이름입니다. 문자열을 입력합니다. |
|
에이전트 사용자 이름 (Agent username)
채널에서 봇을 @멘션할 때 사용하는 봇의 사용자 이름입니다. 문자열을 입력합니다. |
|
에이전트 아바타 (Agent avatar)
Mattermost에서 에이전트의 아바타로 사용할 이미지를 업로드합니다. 이미지 업로드 인터페이스입니다. |
|
서비스 (Service)
AI 지원에 사용할 LLM 서비스 제공자를 선택합니다. 사용할 수 있는 옵션: OpenAI, OpenAI Compatible, Azure, Anthropic, Ask Sage. |
|
사용자 이름 (Username)
Ask Sage LLM 서비스 인증에 사용하는 사용자 이름입니다. 문자열 입력이 필요합니다. |
|
비밀번호 (Password)
Ask Sage LLM 서비스 인증에 사용하는 비밀번호입니다. 문자열 입력이 필요합니다. 이 값은 저장 시 암호화됩니다. |
|
API URL
Mattermost가 LLM의 API와 통신할 때 사용할 엔드포인트입니다. OpenAI Compatible과 Azure LLM 서비스에는 필수입니다. 문자열(URL 형식)을 입력합니다. |
|
API 키 (API key)
LLM의 API 요청을 인증하는 데 사용하는 키입니다. OpenAI, OpenAI Compatible, Anthropic LLM 서비스에는 필수입니다. 문자열을 입력합니다. 이 값은 저장 시 암호화됩니다. |
|
조직 ID (Organization ID)
해당하는 경우 요청이 올바른 조직으로 청구되고 처리되도록 합니다. OpenAI, OpenAI Compatible, Azure LLM 서비스에서 지원됩니다. 문자열을 입력합니다. |
|
사용자 ID 전송 (Send user ID)
이 설정을 활성화하기 전에 LLM의 데이터 프라이버시 정책을 검토하세요. |
|
사용자 정보를 전송하는 것이 조직의 규제 체계 안에서 허용되고 안전한지 확인하려면 LLM의 데이터 프라이버시 정책을 검토할 것을 권장합니다. 사용자 식별 가능 데이터를 외부 서비스와 공유하는 것을 제한하는 엄격한 프라이버시 규제(예: GDPR)를 준수해야 한다면 이 설정을 활성화하지 마세요.
기본 모델 (Default model)
다른 모델을 명시적으로 선택하지 않은 경우 쿼리 처리에 사용할 LLM입니다. 모든 LLM 서비스에서 지원됩니다. 문자열(모델 이름)을 입력합니다. |
|
입력 토큰 한도 (Input token limit)
선택한 LLM이 하나의 프롬프트 또는 요청에서 처리할 수 있는 토큰(단어, 문장 부호, 특수 문자를 포함한 텍스트 조각)의 최대 개수입니다. 숫자 값입니다. 처리할 수 있는 사용자 쿼리의 크기에 직접 영향을 줍니다. |
|
출력 토큰 한도 (Output token limit)
LLM이 쿼리에 대한 응답으로 생성할 수 있는 토큰(단어, 문장 부호, 특수 문자를 포함한 텍스트 조각)의 최대 개수입니다. 숫자 값입니다. Anthropic LLM 서비스에서는 0보다 커야 합니다. |
|
스트리밍 제한 시간 (Streaming timeout)
스트리밍(실시간) 출력 모드를 사용할 때 시스템이 LLM의 응답을 얼마나 기다릴지 결정합니다. OpenAI, OpenAI Compatible, Azure LLM 서비스에서 지원됩니다. 숫자 값(초)입니다. LLM이 설정된 제한 시간보다 오래 걸리면 연결이 종료됩니다. |
|
스트리밍을 사용하면 LLM이 응답을 생성하면서 점진적으로 표시할 수 있어 사용자에게 더 매끄럽고 상호작용적인 경험을 제공합니다.
맞춤 지시문 (Custom instructions)
LLM에 대한 맥락적·행동적 지침을 미리 설정합니다. 모델의 응답을 조직의 요구, 어조, 기대에 맞추는 데 도움이 됩니다. 모든 LLM 서비스에서 지원됩니다. 텍스트를 입력합니다. 모델이 모든 상호작용에서 암묵적으로 따르는 지시문으로, 일관성과 적응성을 제공합니다. |
|
맞춤 지시문에는 행동 지침, 어조 선호, 맥락적 기능, 조직의 선호 사항을 담을 수 있습니다. 이를 통해 응답이 조직의 언어 및 어조 가이드라인을 따르도록 하고, 모델의 동작을 특정 역할이나 목적에 맞출 수 있습니다.
비전 활성화 (Enable vision)
|
|
이 기능은 베타 단계입니다. 활성화하면 LLM이 지원되는 범위에서 이미지 분석, 시각 관련 지원, 시각적 출력 등 이미지 관련 입력이 포함된 프롬프트를 처리할 수 있습니다.
도구 활성화 (Enable tools)
|
|
활성화하면 기본 쿼리 처리를 넘어선 고급 기능을 통해 LLM이 지원되는 범위에서 데이터 조회, 외부 API 연동, 연산 수행 같은 특수 작업을 할 수 있습니다.
채널 접근 (Channel access)
봇이 특정 채널의 내용을 읽고 그 채널에 있는 내용만으로 답변할 수 있는지 여부를 결정합니다. 모든 LLM 서비스에서 지원됩니다. 사용할 수 있는 옵션: Allow for all channels, Allow for selected channels, Block selected channels, Block all channels. |
|
사용자 접근 (User access)
이 봇과 대화하는 사용자가 자신이 접근할 수 있는 모든 채널의 내용에 대해 비공개로 지원을 받을 수 있는지 여부를 결정합니다. 모든 LLM 서비스에서 지원됩니다. 사용할 수 있는 옵션: Allow for all users, Allow for selected users, Block selected users. |
|
기본 에이전트 (Default agent)
에이전트를 여러 개 구성한 경우 AI 기능에 사용할 기본 봇을 선택합니다. 정의된 에이전트를 기준으로 합니다. |
|
허용 업스트림 호스트 이름 (Allowed upstream hostnames)
LLM이 도구를 사용할 때 연결할 수 있는 호스트 이름을 쉼표로 구분해 나열한 목록입니다. 예: JIRA 도구 사용을 허용하려면 |
|
LLM 추적 활성화 (Enable LLM trace)
|
|
이 설정은 디버깅 목적으로만 사용하세요. 활성화하면 민감한 대화 데이터가 로그에 남을 수 있습니다.
임베딩 검색 활성화 (Enable embedding search)
Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.
|
|
임베딩 검색에는 Enterprise 라이선스가 필요하며 실험적 기능으로 제공됩니다. PostgreSQL 데이터베이스에서 pgvector 확장도 활성화해야 합니다. 데이터셋이 크면 성능이 달라질 수 있습니다.
임베딩 제공자 유형 (Embedding provider type)
의미 기반 검색용 임베딩을 생성할 제공자를 선택합니다. 사용할 수 있는 옵션: OpenAI, OpenAI Compatible. |
|
API 키 (API Key)
임베딩 제공자의 API 요청을 인증하는 데 사용하는 API 키입니다. OpenAI Compatible 임베딩 제공자에는 필수입니다. 문자열을 입력합니다. 이 값은 저장 시 암호화됩니다. |
|
모델 (Model)
콘텐츠의 벡터 표현을 생성하는 데 사용할 임베딩 모델입니다. 선택한 임베딩 제공자와 호환되어야 합니다. 문자열(모델 이름)을 입력합니다. |
|
API URL
OpenAI 호환 임베딩 API의 엔드포인트 URL입니다. 문자열(URL 형식) 입력이 필요합니다. |
|
차원 수 (Dimensions)
임베딩 벡터의 차원 수이며 선택한 임베딩 모델과 일치해야 합니다. 일반적인 값으로 OpenAI text-embedding-ada-002는 1536, text-embedding-3-large는 3072를 사용합니다. 숫자를 입력합니다. 모델에 따라 768, 1024, 1536이 흔히 쓰입니다. |
|
청킹 전략 (Chunking strategy)
임베딩 생성을 위해 콘텐츠를 더 작은 청크로 나누는 방식입니다. 사용할 수 있는 옵션: Sentences, Paragraphs, Fixed Size. 콘텐츠 유형과 검색 요구 사항에 맞춰 선택하세요. |
|
청크 크기 (Chunk size)
각 콘텐츠 청크의 최대 크기(문자 수)입니다. 권장 범위는 512~1024자입니다. 최적값은 청킹 전략에 따라 다릅니다. 숫자를 입력합니다. |
|
청크 중첩 (Chunk overlap)
맥락 연속성을 높이기 위해 연속된 청크가 공유하는 토큰 수입니다. Fixed Size 청킹의 권장 범위는 20~50자입니다. 숫자를 입력합니다. |
|
최소 청크 크기 비율 (Minimum chunk size ratio)
문장 및 문단 청크가 크기 요건을 충족하는지 검증할 때 사용하는 최소 비율입니다. 설정된 청크 크기에 비해 지나치게 작은 청크를 걸러내는 데 사용합니다. 숫자(소수 비율)를 입력합니다. |
|
모든 게시물 재인덱싱 (Reindex all posts)
Reindex Posts를 선택하면 임베딩 검색을 위해 모든 게시물을 완전히 재인덱싱합니다. 임베딩 제공자, 모델, 청킹 구성을 변경했을 때 이 기능으로 검색 인덱스를 다시 만드세요. 재인덱싱이 진행되는 동안 인덱싱 진행 상황을 확인할 수 있습니다. |
|
GitLab
자세한 내용은 Mattermost에 GitLab 연결하기 제품 문서를 참고하세요.
GitHub
자세한 내용은 Mattermost에 GitHub 연결하기 제품 문서를 참고하세요.
Jira
사용할 수 있는 Mattermost 구성 옵션은 Mattermost에 Jira 연결하기 제품 문서를 참고하세요.
Legal hold
Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.
자세한 내용은 리걸 홀드 제품 문서를 참고하세요.
Microsoft Calendar 연동 (Microsoft Calendar Integration)
사용할 수 있는 Mattermost 구성 옵션은 Mattermost에 Microsoft Calendar 연동 연결하기 제품 문서를 참고하세요.
Microsoft Teams Meetings
사용할 수 있는 Mattermost 구성 옵션은 Mattermost에 Microsoft Teams Meetings 연결하기 제품 문서를 참고하세요.
MS Teams
Mattermost for Microsoft Teams를 사용하면 Teams의 실시간 채팅 알림을 Mattermost로 전달해, Mattermost와 Teams가 혼재된 환경에서 생기는 사일로를 해소할 수 있습니다.
Mattermost가 조직의 Microsoft 도구 활용도를 어떻게 높이는지 알아보려면 Mattermost for Microsoft Teams 데이터시트를 내려받으세요.
시스템 콘솔에서 Plugins > MS Teams로 이동해 다음 구성 설정에 접근합니다.
플러그인 활성화 (Enable plugin)
모든 Mattermost 팀에 대해 Mattermost for Microsoft Teams 플러그인을 활성화합니다.
|
|
어떤 Mattermost 팀이 다이렉트 메시지와 그룹 메시지를 Microsoft Teams 채팅과 동기화할지 지정하려면 Enabled Teams 구성 옵션을 사용하세요.
테넌트 ID (Tenant ID)
Azure 포털에서 확인한 Microsoft Teams 테넌트 ID를 지정합니다. |
|
클라이언트 ID (Client ID)
Azure 포털에 등록한 OAuth 앱의 Microsoft Teams 클라이언트 ID를 지정합니다. |
|
클라이언트 시크릿 (Client secret)
Azure 포털에 등록한 OAuth 앱의 클라이언트 시크릿을 지정합니다. 영숫자 값입니다. |
|
저장 데이터 암호화 키 (At rest encryption key)
새 암호화 시크릿을 다시 생성합니다. 이 암호화 시크릿은 OAuth 토큰을 암호화하고 복호화하는 데 사용됩니다. 영숫자 값입니다. |
|
Regenerate를 선택하면 새 키가 생성됩니다.
웹훅 시크릿 (Webhook secret)
Microsoft Teams가 Mattermost로 메시지를 보낼 때 사용할 웹훅 시크릿을 생성합니다. |
|
Regenerate를 선택하면 새 키가 생성됩니다.
평가용 API 유료 모델 사용 (Use the evaluation API pay model)
테스트 목적으로만 활성화하세요. 실제 운영 환경에서 충분한 메시지 알림을 처리하려면 유료 모델이 필요합니다.
|
|
알림 동기화 (Sync notifications)
Microsoft Teams에서 채팅이나 그룹 채팅을 수신하면 Mattermost의 연결된 사용자에게 알립니다.
|
|
일괄 다운로드를 지원할 첨부 파일 최대 크기 (Maximum size of attachments to support complete one time download)
메모리에 한 번에 올릴 수 있는 첨부 파일의 최대 크기를 메비바이트(MiB) 단위로 지정합니다. 이 값보다 큰 첨부 파일은 Microsoft Teams에서 Mattermost로 스트리밍됩니다. 숫자 값입니다. 기본값은 20 MiB입니다. |
|
파일 스트리밍 버퍼 크기 (Buffer size for streaming files)
Microsoft Teams에서 Mattermost로 첨부 파일을 스트리밍할 때 사용할 버퍼 크기를 메비바이트(MiB) 단위로 지정합니다. 숫자 값입니다. 기본값은 20 MiB입니다. |
|
성능 메트릭
Entry, Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다(Professional에서는 사용할 수 없습니다).
사용할 수 있는 Mattermost 구성 옵션은 성능 메트릭 모니터링 제품 문서를 참고하세요.
협업 플레이북
Mattermost의 협업 플레이북을 사용하면 반복적인 팀 기반 프로세스에 구조, 모니터링, 자동화를 더해 Mattermost 플랫폼과 통합할 수 있습니다.
시스템 콘솔에서 Plugins > Collaborative playbooks로 이동해 다음 구성 설정에 접근합니다.
플러그인 활성화 (Enable plugin)
|
|
활성화된 팀 (Enabled teams)
모든 Mattermost 팀 또는 선택한 팀에 대해서만 협업 플레이북을 활성화합니다. |
|
실험적 기능 활성화 (Enable experimental features)
|
|
ServiceNow
사용할 수 있는 Mattermost 구성 옵션은 Mattermost에 ServiceNow 연결하기 제품 문서를 참고하세요.
Zoom
사용할 수 있는 Mattermost 구성 옵션은 Mattermost에 Zoom 연결하기 제품 문서를 참고하세요.
config.json 전용 설정
다음 자체 호스팅 배포 설정은 config.json 파일에서만 구성할 수 있으며 시스템 콘솔에서는 제공되지 않습니다.
서명 공개 키 파일 (Signature public key files)
이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.
서버에 내장된 Mattermost 플러그인 서명 키에 더해, 여기에 지정한 각 공개 키도 플러그인 서명을 검증하는 데 신뢰됩니다.
Mattermost v10.11부터 사전 패키지 플러그인은 시작 시 서명 검증이 필요합니다. 커스텀 사전 패키지 플러그인을 함께 배포하는 배포판은 서명된 플러그인이 올바르게 검증되도록 이 설정에 커스텀 공개 키를 반드시 구성해야 합니다. 커스텀 플러그인 서명 키를 정의하려면 PluginSettings.SignaturePublicKeyFiles를 사용하세요.
커스텀 플러그인을 함께 배포할 때는 다음을 수행합니다.
- 플러그인 파일과 그에 대응하는
.sig서명 파일을 함께prepackaged_plugins디렉터리에 넣습니다. - 이 구성 설정에 커스텀 공개 키를 추가해 서명을 검증합니다.
이 기능의 |
Chimera OAuth 프록시 URL (Chimera OAuth proxy URL)
이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.
Mattermost 플러그인이 미리 생성된 OAuth 애플리케이션에 연결할 때 사용하는 Chimera URL을 지정합니다.
이 기능의 |