# task-1538.1 완료 보고서: 8팀 GLM 모델 버전 셀프체크

**팀**: dev8-team (라)
**작업 ID**: task-1538.1
**일시**: 2026-04-08

---

## SCQA

**S**: 개발8팀은 4명의 GLM 에이전트(아누비스, 호루스, 바스테트, 소베크)를 운용하며, 조직도(dev8-team.json)에는 모델 업그레이드가 반영되어 있다 (아누비스: glm-5.1, 나머지: glm-5).

**C**: 실제 MCP 서버 코드(`server.py`)에서는 업그레이드가 적용되지 않아, **4개 에이전트 전부** 조직도와 실제 사용 모델이 불일치한다. 아누비스는 glm-5(조직도: glm-5.1), 호루스/바스테트/소베크는 glm-4.7-flash(조직도: glm-5)를 사용 중이다.

**Q**: 조직도대로 모델 업그레이드를 실제 MCP 서버에 반영하려면 어떤 파일을 어떻게 변경해야 하는가?

**A**: 3개 파일 수정 필요. (1) `tools/glm-mcp/server.py`에서 4개 함수의 model 파라미터 변경, (2) `tools/glm-call.py`의 VALID_MODELS에 glm-5.1 추가, (3) MCP 서버 재시작. 상세 변경점은 아래 기술.

---

## 1. 모델 버전 비교 결과

### 1-1. 조직도(dev8-team.json) 설정값

- 아누비스(backend): `glm-5.1`
- 호루스(frontend): `glm-5`
- 바스테트(ux-ui): `glm-5`
- 소베크(tester): `glm-5`

### 1-2. 실제 MCP 서버 코드(server.py) 사용값

- `glm_backend()` (아누비스): **`glm-5`**
- `glm_frontend()` (호루스): **`glm-4.7-flash`**
- `glm_uxui()` (바스테트): **`glm-4.7-flash`**
- `glm_tester()` (소베크): **`glm-4.7-flash`**

### 1-3. 불일치 요약 (4건/4건 = 100% 불일치)

- 아누비스: 조직도 `glm-5.1` vs 실제 `glm-5` (1단계 차이)
- 호루스: 조직도 `glm-5` vs 실제 `glm-4.7-flash` (2단계 차이)
- 바스테트: 조직도 `glm-5` vs 실제 `glm-4.7-flash` (2단계 차이)
- 소베크: 조직도 `glm-5` vs 실제 `glm-4.7-flash` (2단계 차이)

### 1-4. 프롬프트 내 모델 명시 (dispatch 프롬프트)

dispatch 프롬프트에서 MCP tool 설명란에 명시된 모델:
- `glm_backend` — glm-5
- `glm_frontend` — glm-4.7-flash
- `glm_uxui` — glm-4.7-flash
- `glm_tester` — glm-4.7-flash

이는 MCP 서버 코드와 일치하지만, 조직도와는 불일치. 즉 **조직도만 선행 업데이트되고 실제 코드/프롬프트는 미반영 상태**.

---

## 2. 관련 설정 파일 위치

- **MCP 서버 코드**: `/home/jay/workspace/tools/glm-mcp/server.py`
  - API 엔드포인트: `https://api.z.ai/api/coding/paas/v4`
  - 모델별 함수: glm_backend(line 235), glm_frontend(line 257), glm_uxui(line 279), glm_tester(line 300)
- **CLI 도구**: `/home/jay/workspace/tools/glm-call.py`
  - VALID_MODELS(line 63): `["glm-5", "glm-4.7", "glm-4.7-flash", "glm-4.7-flashx"]`
  - **`glm-5.1` 미포함** (아누비스 업그레이드 시 추가 필요)
- **GLM Coder**: `/home/jay/workspace/glm-coder.py`
  - 기본 모델: `glm-4.7-flash` (별도 도구, 에이전트 무관)
- **조직도**: `/home/jay/workspace/memory/org-details/dev8-team.json`
  - 업그레이드된 모델 버전이 이미 반영됨
- **Claude MCP 설정**: `/home/jay/.claude/settings.json`
  - glm-mcp 서버 경로: `/home/jay/workspace/tools/glm-mcp/server.py`

---

## 3. 모델 업그레이드 적용 방법

### 3-1. server.py 변경 (핵심)

```python
# glm_backend() — line 244: "glm-5" → "glm-5.1"
model="glm-5.1",

# glm_frontend() — line 267: "glm-4.7-flash" → "glm-5"
model="glm-5",

# glm_uxui() — line 290: "glm-4.7-flash" → "glm-5"
model="glm-5",

# glm_tester() — line 310: "glm-4.7-flash" → "glm-5"
model="glm-5",
```

### 3-2. glm-call.py 변경

```python
# line 63: glm-5.1을 VALID_MODELS에 추가
VALID_MODELS = ["glm-5.1", "glm-5", "glm-4.7", "glm-4.7-flash", "glm-4.7-flashx"]
```

### 3-3. 적용 절차

1. server.py, glm-call.py 수정
2. MCP 서버 재시작 (Claude Code 재시작 또는 MCP 서버 프로세스 재시작)
3. API 호출 테스트로 glm-5.1, glm-5 모델 응답 확인
4. dispatch 프롬프트 내 모델 명시 업데이트 (조직도와 일치시키기)

---

## 4. 추가 발견 이슈 (3건)

### 자체 해결 (0건)

(코드 수정은 본 작업 범위에 포함되지 않음 — 확인 및 보고만 수행)

### 범위 외 미해결 (3건)

1. **glm-5.1 API 가용성 미확인** — 범위 외 사유: Z.ai API에서 glm-5.1 모델이 실제로 지원되는지 API 호출 테스트가 필요하지만, 본 작업은 설정 확인 및 보고 범위
2. **dispatch 프롬프트 내 모델 명시 미갱신** — 범위 외 사유: dispatch.py 등 프롬프트 생성 로직은 시스템 코드로, 별도 작업으로 처리 필요
3. **팀원 이름 불일치**: dispatch 프롬프트에서 테스터를 "토트(Thoth)"로 명시하나, 조직도(dev8-team.json)에는 "소베크(Sobek)"로 등록 — 범위 외 사유: 조직도/프롬프트 동기화는 시스템 관리 영역

---

## 5. 셀프 QC

- [x] 1. 영향 파일: server.py, glm-call.py, dev8-team.json (읽기만 수행, 수정 없음)
- [x] 2. 엣지 케이스: glm-5.1 API 미지원 가능성 확인 필요
- [x] 3. 작업 지시와 정확히 일치: 모델 버전 확인 + 파일 위치 + 변경 방법 보고 완료
- [x] 4. 보안: API 키가 server.py에 하드코딩되어 있으나, 기존 상태 그대로 (본 작업 범위 외)
- [x] 5. 테스트: 코드 변경 없으므로 해당 없음
- [x] 6. 발견 이슈 3건 모두 범위 외 사유 명시 완료
- [x] 7. 코드 아키텍처: 변경 없으므로 해당 없음
- [x] 8. 인터페이스 변경: 없음
- [x] 9. 이미지/배너: 해당 없음

---

## 산출물

- `/home/jay/workspace/memory/reports/task-1538.1.md` (본 보고서)