---
title: Affinity CLI — 실제 연결 프로토콜과 문서 조회 수정
date: 2026-10-29T20:50:34+09:00
version: v1.0.1
status: 수정·실제 실행 검증 완료
project: affinity-cli
type: 수정사항
category: 도구 연결
summary: 실제 Affinity 서버가 이전 MCP 프로토콜을 거부하는 문제와 문서 조회 세션의 preamble 선행 누락을 수정했습니다.
format: legacy-v1
---

Affinity 서버가 초기화에 Unsupported protocol version을 반환한 것을 확인했습니다. 초기화 프로토콜을 2025-11-25로 바꾼 뒤 doctor·status에서 연결 성공과 Affinity 3.3.1.4940 Win32 버전을 확인했습니다. docs 명령도 동일 연결에서 preamble을 먼저 읽도록 수정해 문서 조회의 선행 조건 오류를 해결했습니다.

## 검증

- CLI 기존 회귀 테스트 22개 통과. 이는 CLI 검증이며 실제 디자인 품질 검증과 구분합니다.
- 실제 Affinity에서 Pixora 벡터 도형·문자 생성, 세션 ID 대상 채움·이동 수정, spread 렌더링 성공을 확인했습니다.
- 파일 저장·PNG 출력은 추가 SDK 파일 권한 없이 Affinity UI를 사용했습니다. SDK 파일 저장 기능이나 화면 포커스 비간섭까지 검증했다고 주장하지 않습니다.
- XERJ: 실패 — 연결 도구가 제공되지 않고 노드 중지 확인 후 rg로 CLI 소스를 확인했습니다.

## 시간 기록

제안 시간: 15~25분. 시작 2026-10-29 20:25:02 KST. 실제 소요 25분 32초, 완료 기록 2026-10-29T20:50:34+09:00 KST. 프로젝트 푸시와 보고서 원본 작성까지이며 HTML 빌드·아카이브 동기화 종료 시각은 최종 채팅에 별도 기록합니다.

이 시간은 Pixora 로고 작업과 함께 진행한 전체 작업 구간이며 별도 중복 가산하지 않습니다. 프로젝트별로 보고서를 분리했습니다.