연동 관리
GitLab · LLM · Jira 외부 시스템 연결을 관리하는 방법과, 연결 테스트를 통과해야 적용되는 셀프서비스 설정 절차를 안내합니다.
설정 → 워크스페이스 → 연동(Owner 전용)에서 Mantis가 사용하는 외부 시스템 연결을 관리합니다. v1.1.0에서 새로 추가된 셀프서비스 기능으로, 관리자가 화면에서 직접 연결 정보를 등록·변경할 수 있습니다. 변경 사항은 연결 테스트를 통과해야 적용됩니다.
연동 화면에는 GitLab, LLM, Jira 세 개의 카드가 있습니다.
GitLab 카드
Mantis가 분석하는 GitLab 연결 상태를 보여 줍니다.
| 항목 | 설명 |
|---|---|
| 상태 | 연결됨 / 비활성 |
| URL | 연결된 GitLab 주소 |
| API 토큰 | 설정됨(마스킹) / 미설정 |
| DB 연결 | 연결됨(읽기 전용) / Mock 모드(개발) / 미설정 |
| 마지막 저장 | 연동 정보를 마지막으로 저장한 시각 |
설정을 누르면 연결 정보를 등록·변경하는 폼이 열립니다.
| 필드 | 설명 |
|---|---|
| GitLab URL | GitLab 서버 주소 (예: https://gitlab.com) |
| GitLab API 토큰 | 새 토큰을 입력하면 교체됩니다. 비워 두면 기존 토큰을 유지하며, 삭제 옵션으로 지울 수 있습니다. |
| GitLab mirror DB DSN | 읽기 전용 미러 PostgreSQL 연결 문자열. 비우면 기존 값 유지, 삭제하면 운영 환경에서는 연결 필요 상태가 됩니다. |
- GitLab API 테스트와 DB 연결 테스트로 각각 검증합니다.
- URL·토큰·DSN을 바꿨다면 해당 항목의 연결 테스트를 통과해야 저장할 수 있습니다. 기존 값을 그대로 두는 경우에는 재검증이 필요 없습니다.
🔒 Mantis는 GitLab DB에 읽기 전용으로만 접근합니다. MR·커밋·파이프라인 등 원본 데이터를 읽어 분석할 뿐, GitLab 데이터를 변경하지 않습니다.
LLM 카드
분석에 사용할 AI 모델(Anthropic Claude)을 관리합니다. 조직 전용 API 키를 등록하거나, 비워 두면 인포그랩 제공 키(managed)를 사용합니다. 모델은 Claude Opus 4.5와 Claude Sonnet 4.5 중에서 고릅니다. 자세한 설정은 AI 모델 & 비용을 참고하세요.
Jira 카드
계획(Jira)과 실행(GitLab)을 잇는 크로스소스 분석을 위한 연동입니다. 현재는 준비 단계로, 카드의 토글로 활성화 / 비활성화를 전환할 수 있습니다.
연결 변경 시 주의
⚠️ GitLab 연동 정보(URL·토큰·DB)를 바꾸면, 기존에 만든 프로젝트·보고서·인사이트가 참조하던 데이터와 어긋날 수 있습니다. 변경 사항은 연결 테스트를 통과한 뒤 저장하세요. 저장한 연결은 이후의 분석 요청부터 적용됩니다.