중급 · 3/4강
에이전트와 데스크톱에 med-lit 연결하기
클라이언트별 설치 경로와 실제 도구 연결 확인을 안내합니다.
수업 후 사용할 클라이언트만 연결합니다
med-lit은 에이전트가 실행하는 별도 로컬 MCP 서버입니다. SGB 서버를 연결했다고 med-lit까지 연결되는 것은 아닙니다. 각 서버의 도구와 상태를 따로 확인합니다.
| 클라이언트 | 현재 설치 경로 |
|---|---|
| Hermes·Claude Code·Codex | uvx med-lit-mcp setup의 대화형 설정 |
| Claude Desktop | 릴리스의 .mcpb 확장 열기 |
| ChatGPT 데스크톱 Work/Codex, Windows x64 | 릴리스의 Install med-lit.bat 실행 후 브라우저 설정 |
| ChatGPT 데스크톱 Work/Codex, macOS | 릴리스의 서명된 .dmg 설치 도우미와 브라우저 설정 |
릴리스와 자세한 설치 안내는 med-lit 공개 저장소에서 확인합니다. 일반 웹 채팅이나 모바일 앱에서 로컬 서버가 자동으로 실행되는 것은 아닙니다.
CLI 설정에서는 대상 클라이언트를 고릅니다
터미널 방식은 uv를 먼저 준비합니다. uvx는 Python 도구를 내려받아 실행하는 명령입니다. 다음 중 사용하는 클라이언트의 명령 하나를 실행합니다.
uvx med-lit-mcp setup --client hermes
uvx med-lit-mcp setup --client claude-code
uvx med-lit-mcp setup --client codex
연락 이메일과 검토 프로젝트 폴더를 입력합니다. 데이터베이스 키는 선택 사항이며 설정 화면의 비공개 입력으로 넣습니다. 대화에 키를 붙여 넣지 않습니다. Codex 설정은 med-lit 항목을 등록하고 다른 설정을 보존합니다. 변경된 연결을 대체할지 묻는 경우 현재 항목을 먼저 확인합니다.
데스크톱 설치에서는 연결 검사를 끝까지 확인합니다
Claude Desktop은 다운로드한 MCPB를 열어 설정합니다. ChatGPT 데스크톱은 설치 도우미의 브라우저 화면에서 Save and connect를 누르고 med-lit is ready를 확인합니다. 실패하면 Retry connection으로 실제 서버 시작을 재검사합니다. ChatGPT를 재시작한 뒤 Work에서 검토 폴더를 로컬 프로젝트로 엽니다.
CLI에서도 클라이언트를 재시작하거나 새 세션을 시작하고 도구 연결 상태를 확인합니다. 설정 파일을 쓴 것과 서버가 실제로 도구를 제공하는 것은 서로 다른 확인입니다.
첫 요청은 질문 제안까지로 제한합니다
med-lit으로 학생 면담에서 LLM 활용을 조사하고 싶습니다. 사용할 프로젝트와 저장 폴더를 확인한 뒤 질문과 검색 범위를 제안해 주세요. 내 승인 전에는 검색하지 마세요.
guide, 프로젝트 조회, 질문 검증 등 실제 med-lit 도구 호출을 확인합니다. 모델의 일반 답변만 나온다면 도구 연결이 된 것으로 기록하지 않습니다. 새 문헌 검색을 요청할 때 SGB의 보관함 검색과 혼동하지 않는지도 확인합니다.
직접 해 보기약 10분
사용할 클라이언트 하나와 설치 경로를 고릅니다. 실행했다면 서버 상태와 호출 도구를 적고, 실행 전이면 ‘설치 계획’이라고 표시합니다. 검토 파일을 저장할 실제 폴더도 정하십시오.
| 선택한 클라이언트·설치 경로 | 프로젝트 폴더·서버 상태 | 실제 호출 또는 미실행 계획 |
|---|---|---|
1행
2행
3행
표를 채운 뒤 Markdown 파일로 내려받으십시오. 다음 조사에서 같은 기록을 다시 열어 확인합니다.
연구에 적용하면
med-lit의 설치 경로는 클라이언트마다 다릅니다. 설치 완료 후에는 실제 서버 상태, 프로젝트 폴더와 도구 호출을 확인합니다. 연결이 확인되면 질문과 범위를 승인하고 검색합니다.
확인한 자료
med-lit 0.1.8 README를 기준으로 작성했습니다. 예시 요청과 판단 표는 교육용이며 실제 검색 결과를 뜻하지 않습니다.