이 글은

Redmine AI Helper 플러그인에 MCP Server 기능을 추가했습니다.

이미 MCP Client 기능 (외부 MCP Server 에 연결하는 기능) 을 가지고 있었지만, 이번에는 새로 MCP Server 기능을 추가했습니다. 이를 통해 Github Copilot 나 Claude Code 등의 외부 AI 도구를 Redmine 에 접근할 수 있게 되었습니다.

기존 Redmine MCP Server 와의 차이점

세상에는 이미 몇 개의 Redmine 전용 MCP Server 가 공개되어 있지만, 저의 지식에 따르면 로컬 MCP Server 만입니다. 이번 구현한 기능은 원격 MCP Server 로 작동하는 것이 큰 특징입니다.

로컬 MCP Server

로컬 MCP Server 는 Python, Node.js, Docker 등의 실행 환경을 로컬에 준비해야 합니다. AI 도구를 사용하려는 터미널마다 환경 구축이 필요하며, 팀에서 사용할 경우 한 명씩 같은 절차를 밟아야 했습니다.

로컬 MCP Server 의 이미지

원격 MCP Server

Remote MCP Server 인 이 기능은 Redmine 측에서 작동하므로, 사용자는 URL 과 API 키를 설정하는だけで 연결할 수 있습니다. 로컬에 설치할 필요가 없습니다.

Remote MCP Server 의 이미지

또한, 로컬 MCP Server 는 Redmine 의 API 를 내부적으로 호출하는 구현이므로, Redmine 의 API 에서 가능한 범위에 기능이 제한되어 있었습니다. 이에 비해 원격 MCP Server 는 Redmine 내부에 직접 구현되어 있으므로, API 의 제약에 묶이지 않고 자유롭게 기능을 만들 수 있습니다. Vector 검색 (세맨틱 검색) 과 프로젝트 메트릭스 획득은 그 예이며, 일반적인 API 로는 실현할 수 없는 검색 기능을 MCP Server 로부터 사용할 수 있습니다.

Claude Code에서의 실행 예

아래는, Claude Code 에서 프로젝트 메트릭스 획득 기능을 사용하여 프로젝트의 상황을 분석한 예입니다. 프로젝트 메트릭스는 티켓의 평균 해결 일수나 클로즈 티켓의 재오픈률 등, AI Helper 의 프로젝트 건강성 보고서 작성에 사용되는 지표의 생 데이터를 획득하는 기능입니다. AI Helper 와는 다른 관점의 분석을 하고 싶다면, AI 도구에서 이 기능을 호출하여独自の 분석을 할 수 있습니다.

MCP Server 를 활성화하는 방법

관리 화면의 "AI Helper" 설정에서 "MCP Server"를 활성화하세요.

활성화되면, 다음 엔드포인트에서 MCP 요청을 받을 수 있게 됩니다.

POST /ai_helper/mcp

연결할 때는 Redmine 의 API 키를 X-Redmine-API-Key 헤더로 전달해야 합니다. 접근 가능한 데이터는 API 키 소유자의 Redmine 권한에 따릅니다.

AI 도구에서의 연결 방법

아래와 같은 이미지로 각 AI 도구에 MCP Server 를 추가하세요. AI 도구마다 설정 방법이 미세하게 다르므로 자세한 것은 공식 문서를 참조하세요.

{
"servers": {
"redmine": {
...
}
}
}

사용할 수 있는 도구 목록

연결된 후 AI 도구에서 사용할 수 있는 도구는 다음 8 그룹입니다.

그룹	내용
Issue
의제 읽기/검색/생성/업데이트
Project
프로젝트 정보와 메트릭스 획득
Wiki
위키 페이지에 접근
Repository
소스 코드/리비전 정보에 접근
Board
포럼/메시지에 접근
User
사용자 검색
Version
마일스톤 정보 획득
File
첨부 파일 콘텐츠 분석
Vector
세맨틱 검색 (벡터 검색 설정 필요)

모든 도구는 Redmine 의 권한 모델에 따르며, API 키 소유자가閲覧/操作할 수 있는 범위 내에서만 작동합니다.

요약

MCP Server 기능을 추가함으로써, Github Copilot 나 Claude Code 등의 AI 도구에서 Redmine 데이터에 직접 접근할 수 있게 되었습니다. 티켓 확인이나 프로젝트 상황 파악 등 일상적인 작업을 AI 어시스턴트에 맡기기가 쉬워졌습니다. 꼭 시도해 보세요.