설정 파일에 서버를 한 번 등록하면 대화 중에 search_kds 와 get_kds_figure 가 붙습니다. 서버는 사용자 컴퓨터에서 직접 실행되고, 질의도 조문도 네트워크로 나가지 않습니다.
Optra 저장소를 받고 가상환경을 만든 뒤 requirements.txt 를 설치합니다. 파이썬 3.11 이상이 필요합니다.
Claude Desktop 의 설정 → 개발자 → 설정 편집으로 열거나, 아래 경로를 직접 엽니다.
파일이 없으면 새로 만듭니다.
경로 두 곳을 실제 설치 위치로 바꿉니다. 둘 다 절대경로여야 합니다 — Claude Desktop 은 홈 디렉터리 기호(~)를 풀어주지 않습니다.
{
"mcpServers": {
"Optra-kds": {
"command": "/경로/optra/.venv/bin/python3",
"args": ["/경로/optra/server/server.py"]
}
}
}
이미 다른 서버가 등록돼 있으면 mcpServers 안에 항목만 추가합니다.
창만 닫으면 프로세스가 남아 설정을 다시 읽지 않습니다. macOS 는 Cmd+Q 로 종료합니다.
대화 입력창의 도구 목록에 Optra-kds 가 보이면 붙은 것입니다. "KDS 41 12 00 5.7.3(3) 보여줘" 처럼 조문번호로 물어보면 정확매칭으로 바로 찾아옵니다.
서버는 뜰 때 조문 캐시를 한 번만 읽습니다. build_phase2.py 로 캐시를 다시 만든 뒤에는 Claude Desktop 을 재시작해야 새 내용이 반영됩니다.
재빌드 중에는 캐시에 _rebuilding 표시가 놓이고 서버가 뜰 때 경고를 냅니다. 경고가 보이면 끝날 때까지 기다립니다.