Amaranth10 MCP
Officialby nubison
README.md
# Amaranth10 MCP
더존 아마란스10 그룹웨어를 Claude 등 MCP 클라이언트에서 사용하는 서버입니다. 메일·일정·전자결재·원챔버 드라이브를 확인하고, 메일을 보내고, 회의실 예약과 개인 일정을 관리하고, 휴가와 출장을 신청할 수 있습니다.
“안 읽은 메일을 요약해 줘.” · “내일 오후에 비어 있는 회의실을 찾아 줘.” · “남은 연차를 보고 금요일 오후반차를 신청해 줘.”
[릴리스](https://github.com/nubison/amaranth10-mcp/releases) · [CI](https://github.com/nubison/amaranth10-mcp/actions/workflows/ci.yml) · [상세 가이드](docs/guide.md)
## 설치
그룹웨어 주소와 아이디·비밀번호가 필요합니다. OTP 등 추가 인증이 필요한 계정은 지원하지 않습니다.
### Claude Code
Node.js 20 이상과 Git이 필요합니다.
```bash
npx -y github:nubison/amaranth10-mcp#semver:x setup
```
주소·아이디·비밀번호를 입력하고 Claude Code 등록에 동의한 뒤, Claude Code를 새로 열면 됩니다. `#semver:x`는 최신 릴리스를 뜻하며, Claude Code를 열 때마다 새 릴리스를 확인해 받으므로 다시 설치할 필요가 없습니다. 예전에 `#v0.8.1`처럼 버전을 지정해 설치했다면 위 명령으로 setup을 한 번 다시 실행하세요.
### Claude Desktop (macOS)
[최신 릴리스](https://github.com/nubison/amaranth10-mcp/releases/latest)의 `.mcpb` 파일을 열어 설치하고 그룹웨어 접속 정보를 입력하세요. Node.js는 별도로 설치하지 않아도 됩니다. 확장은 자동으로 업데이트되지 않으므로 새 릴리스가 나오면 `.mcpb`를 다시 설치하세요.
서버·컨테이너는 [환경변수로 설정](docs/guide.md#환경변수로-설정)할 수 있습니다.
## 제공 도구
계정에 허용된 범위에서 동작합니다. ✓는 지원, —는 미지원입니다.
| 기능 | 조회·검색 | 등록·예약 | 수정 | 삭제·취소 | 참고 |
|---|:---:|:---:|:---:|:---:|---|
| 메일 | ✓ | ✓ | ✓ | ✓ | 열면 읽음 처리, 삭제는 휴지통으로 |
| 게시판 | ✓ | — | — | — | 열면 조회수 증가 |
| 자원·회의실 | ✓ | ✓ | ✓ | ✓ | 본인 예약만, 참석자 알림 |
| 일정 | ✓ | ✓ | ✓ | ✓ | 개인 일정만, 초대 알림 |
| 전자결재 | ✓ | — | — | — | 수신참조 포함, 열람이 기안자에게 보일 수 있음 |
| 드라이브 | ✓ | — | — | — | 원챔버 폴더·파일 조회, 파일은 임시 폴더에 저장 |
| 조직도 | ✓ | — | — | — | 직원 검색, 부서원 조회 |
| 휴가·출장 | ✓ | ✓ | — | ✓ | 결재 전에만 취소, 결재자 알림 |
| 알림 | ✓ | — | — | — | 최근 알림 |
- 메일 보내기·삭제, 예약·일정 변경, 휴가·출장 신청·취소는 미리보기 확인과 승인 후 실행됩니다. 휴가·출장 신청·취소는 입력 폼을 띄울 수 있는 클라이언트(Claude Code 등)에서 폼으로 직접 확인받습니다. 자원 예약·수정과 휴가·출장 상신이 끝나면 그룹웨어에서 그 예약이나 결재 문서를 바로 여는 링크를 함께 돌려줍니다. 읽음·안 읽음 표시와 조회수 변경에는 승인 절차가 적용되지 않습니다.
- 변경 요청은 자동 재시도하지 않습니다. 결과가 불확실하면 그룹웨어에서 처리 여부를 먼저 확인하세요.
- 날짜와 시각은 한국 시간 기준입니다. 출퇴근·근무 기록 조회, 경조휴가·출산·육아휴직 신청, 휴가·출장 외 전자결재 작성과 결재 승인은 지원하지 않습니다.
[도구 목록과 메일·예약·일정·휴가·출장 변경 제한](docs/guide.md#도구-목록)은 상세 가이드에서 확인할 수 있습니다.
## 접속 정보
setup은 macOS 키체인에 비밀번호를 보관합니다. **다른 OS나 키체인 저장 실패 시에는 파일에 평문으로 저장합니다.** Desktop 확장은 Claude Desktop에서 관리합니다.
비밀번호를 변경했다면 setup 또는 확장 설정을 갱신하세요. 로그인 실패 시 같은 비밀번호로 반복 시도하면 계정이 잠길 수 있습니다. [저장·삭제 방법과 문제 해결](docs/guide.md#접속-정보-관리)
## 개발 및 라이선스
`npm ci` → `npm test`로 테스트합니다. 실제 그룹웨어에는 요청하지 않습니다. [개발·릴리스 안내](docs/guide.md#개발)
[MIT](LICENSE). 더존비즈온과 제휴하거나 공식 지원을 받는 프로젝트가 아닙니다. Amaranth 10은 더존비즈온의 상표입니다. 그룹웨어 웹 API를 사용하므로 회사의 IT·보안 정책을 확인하세요.
This server cannot be deployed
Maintenance
ActivityNo data
ResponsivenessOutdated data