준비
강의 전 현재 폴더, 계정, 설치 상태를 확인합니다.
Phase 88-1
MCP 서버란?
MCP의 원리와 권한 범위를 이해하고 Claude Code에서 korean-law 공개 서버를 연결해 법령을 조회하는 순서를 실습합니다.
Execution Kit
실습 중 막히지 않기 위한 진행표
실행
MCP는 AI가 외부 서비스(Gmail, Calendar, Notion 등)를 직접 조작할 수 있게 해주는 프로토콜입니다.
검증
명령 결과, 파일 변화, 브라우저 화면 중 하나로 성공 여부를 확인합니다.
기록
잘 된 명령과 막힌 지점을 다음 실습을 위한 로그로 남깁니다.
막혔을 때 Claude Code에 붙여넣을 양식
나는 코딩 경험이 많지 않은 실무자입니다. "MCP 서버란?" 강의를 따라 하고 있습니다.
현재 상태:
- 사용하는 컴퓨터:
- 방금 실행한 명령:
- 화면에 나온 결과 또는 오류:
- 내가 만들고 싶은 업무 결과물:
요청:
1. 지금 상황을 초보자 기준으로 진단해줘.
2. 다음에 실행할 명령을 한 줄씩 제시해줘.
3. 각 명령이 무엇을 하는지 쉬운 말로 설명해줘.
4. 성공 여부를 확인할 체크 포인트를 정리해줘.
5. 실패하면 다시 붙여넣을 오류 보고 양식을 만들어줘.MCP란 무엇인가요?
MCP(Model Context Protocol)는 AI가 외부 서비스와 직접 소통할 수 있게 해주는 표준 프로토콜입니다. 쉽게 말하면, AI에게 '손과 발'을 달아주는 기술입니다.
노무사 사무실에 비유하면, MCP는 사무장이나 경리 직원이 해주던 행정 업무를 AI가 대신 처리할 수 있게 해주는 연결 통로입니다. 사무장에게 '오늘 온 우편물 정리하고 기일 달력에 표시해 놓으세요'라고 하듯이, AI에게 같은 일을 시킬 수 있는 것입니다.
지금까지 우리가 AI에게 업무를 시키려면, AI가 만들어준 결과물을 복사해서 이메일에 붙여넣거나, 캘린더에 직접 일정을 등록해야 했습니다. MCP를 사용하면 AI가 직접 이메일을 읽고 캘린더에 일정을 추가하고 Notion에 데이터를 기록할 수 있습니다.
비유하자면, 기존 AI는 '말만 잘하는 인턴'이었다면, MCP가 연결된 AI는 '사무장처럼 행정 시스템을 직접 다룰 수 있는 인턴'인 셈입니다.
노무사에게 MCP가 필요한 이유
노무사 업무에는 이메일 확인, 사건 자료 정리, 기일 확인, 진행 상황 기록처럼 여러 도구를 오가는 작업이 있습니다. MCP는 승인된 범위에서 이 도구들을 연결합니다.
연결했다고 모든 업무가 자동으로 정확해지는 것은 아닙니다. AI가 검색한 메일과 기일의 원문을 확인하고 개인정보를 외부 서비스에 보내도 되는지 점검해야 합니다. 이메일 발송·일정 등록·대외 제출은 초안과 검토를 거쳐 사람이 승인한 뒤 실행합니다.
먼저 공개 자료 조회처럼 되돌릴 수 있는 작은 작업부터 연결합니다. 무료 서비스라도 사용량 제한과 서비스 정책은 바뀔 수 있으며 AI 구독과 API 사용량 과금은 구분해야 합니다.
MCP 서버 설정 방법
Claude Code에는 외부 제공자의 HTTP MCP 서버를 등록하거나 내 컴퓨터에서 stdio 서버를 실행하는 방식이 있습니다. 이 강의는 별도 서버 프로그램을 설치하지 않는 HTTP 연결부터 실습합니다.
Claude Code의 터미널 명령과 Claude Desktop의 설정 파일은 서로 다릅니다. 등록할 때 현재 버전의 claude mcp add --help를 먼저 확인합니다. 이미 연결된 서버는 중복 등록하거나 지우지 말고 claude mcp list와 claude mcp get으로 확인합니다.
이 실습의 user 범위는 현재 계정의 여러 프로젝트에서 연결을 사용하도록 하는 선택입니다. 팀에 공유하는 project 설정에는 실제 인증키나 비밀번호를 넣지 않습니다. 등록 범위와 사용 권한은 같은 개념이 아니므로 도구별 승인선은 별도로 유지합니다.
# 현재 CLI의 등록·조회 문법과 기존 연결 확인
claude mcp add --help
claude mcp get --help
claude mcp list
# 새 korean-law 연결 실습은 다음 섹션을 따릅니다.TIP: Gmail·캘린더 같은 계정 연결은 서비스별 제공 범위와 OAuth 권한을 확인합니다. 다른 사용자의 인증값을 복사하거나 새 패키지가 필요하다고 임의로 판단하지 않습니다.
korean-law 쉽게 연결하기: 터미널 한 줄부터
준비물은 설치된 Claude Code와 인터넷 연결입니다. Claude Code에 로그인되어 있는지 확인한 다음 아래 명령을 터미널에서 실행합니다. 이 예시는 공개 원격 서버를 등록하므로 추가 npm 패키지 설치나 새 유료 API 가입이 필요하지 않습니다.
등록 후에는 Claude Code 대화창에서 /mcp를 열어 korean-law의 연결 상태와 도구 목록을 확인합니다. 터미널에 입력하는 claude mcp 명령과 대화창에 입력하는 /mcp를 구분하세요. 이미 korean-law가 등록되어 있다면 같은 이름으로 다시 추가하지 말고 상세 설정부터 확인합니다.
# 먼저 현재 버전의 등록 문법과 기존 연결 확인
claude mcp add --help
claude mcp list
# korean-law가 없는 경우에만 공개 HTTP 서버 등록
claude mcp add --scope user --transport http korean-law https://mcp.gomdori.app/law
# 등록된 주소와 설정 확인
claude mcp get korean-law
# Claude Code 대화창에서 입력
/mcpTIP: 이 주소는 외부 제공자가 운영하는 공개 서비스입니다. 첫 실습에는 법령명 같은 공개 질의만 사용하고 의뢰인 이름·사건 원문·연락처·건강정보는 보내지 않습니다. 공개 서비스의 인증 정책과 요청 한도는 바뀔 수 있습니다.
설치 완료가 아니라 조회 결과까지 확인합니다
도구 이름이 목록에 보이는 것과 법령을 실제로 조회할 수 있는 것은 다릅니다. 공개 법령명으로 작은 요청을 보내고 법령명·현행 표시·공포일·시행일·법령ID가 돌아오는지 확인합니다. 조회 기준일은 질의한 날짜로 따로 기록합니다. 공식 원문 링크는 도구 결과에 제공된 경우에만 표시하고, 결과에 없으면 링크 미제공으로 남깁니다.
자료 없음, 연결 오류, 요청 한도 초과, 인증 필요는 서로 다른 상태입니다. 429나 시간 초과가 나오면 반복 호출을 멈추고 오류와 현재 버전을 기록합니다. 인증 정책이 달라졌다면 제공자의 현재 안내를 확인하고 본인 인증값은 비공개 경로로만 설정합니다. 기존 인증 설정을 지우거나 다른 사람의 키를 복사해서 해결하지 않습니다.
법령 검색이 성공해도 해당 사건에 적용되는 법률 판단까지 검증된 것은 아닙니다. 기준 시점과 예외를 확인하고 최종 해석·서면 제출은 노무사가 검토합니다.
# Claude Code 대화창에 붙여 넣을 공개 자료 실습 요청
근로기준법을 search_law로 검색해 주세요.
법령명, 현행 표시, 공포일, 시행일과 법령ID를 표시하세요.
조회 기준일은 질의한 날짜로 따로 적으세요. 날짜를 확인하지 못하면 미확인으로 남기세요.
공식 원문 링크는 도구 결과에 있을 때만 표시하고, 없으면 링크 미제공이라고 쓰세요.
검색 결과가 없거나 연결 오류가 나면 그 상태를 구분해서 보고하세요.
개인정보 입력, 다른 설정 수정, 메일 발송은 하지 마세요.TIP: 연결 점검에서는 search_law와 get_law_text 같은 공개 조회 도구부터 확인합니다. 판례 인용은 사건번호 실존뿐 아니라 판시 내용과 적용 가능성을 별도로 검토합니다.
핵심 정리
- ✓MCP는 AI가 외부 서비스(Gmail, Calendar, Notion 등)를 직접 조작할 수 있게 해주는 프로토콜입니다.
- ✓MCP 연결은 권한·개인정보·사람 승인과 함께 설계합니다.
- ✓korean-law는 공개 HTTP 연결을 등록한 뒤 /mcp와 실제 법령 조회 결과를 함께 확인합니다.
- ✓연결 실패와 자료 부존재를 구분하고 인증키·비밀번호는 공개 문서나 팀 공유 설정에 넣지 않습니다.