HR MCP 서버

운영 현황

모든 도구는 조회 전용입니다 (데이터 변경 없음)

MCP 서버--

HR API 연결확인 중…-

public 엔드포인트확인 중…-

MCP 도구-readOnlyHint = true

public 엔드포인트 자가 점검

점검 중…

연결 방법

stdio(로컬) 또는 public(원격 URL) 중 선택

stdio 로컬 연결 — Claude Desktop · Claude Code

이 PC에서 MCP 클라이언트가 기존 fastapi 컨테이너 안의 App_MCP/server.py를 표준 입출력으로 실행합니다. Docker Desktop이 켜져 있어야 합니다.

1. 실행 명령

2. Claude Code

3. Claude Desktop — `claude_desktop_config.json`

설정 → 개발자 → 구성 편집에서 아래 내용을 넣고 Claude Desktop을 다시 시작합니다.

public 원격 연결 — ChatGPT · Claude

PoC 모드라 인증이 없습니다. ChatGPT·Claude 서버가 접속하려면 HTTPS 공개 주소가 필요하므로 터널로 localhost:8000을 공개합니다. 공개 주소를 아는 사람은 누구나 HR 데이터를 조회할 수 있으니 테스트가 끝나면 터널을 종료하세요.

1. 터널 실행 (하나 선택)

cloudflared tunnel --url http://localhost:8000
ngrok http 8000
tailscale funnel 8000

2. 공개 주소 입력 → 커넥터 URL 생성

로컬 확인용: · 레거시 SSE:

3. ChatGPT

설정 → 앱 및 커넥터(Apps & Connectors) → 고급 설정 → 개발자 모드 켜기
커넥터 만들기 → 이름 hr-api, MCP 서버 URL에 위 커넥터 URL 입력
인증: 인증 없음(No authentication) → 만들기 → 채팅에서 개발자 모드로 커넥터 선택

4. Claude (claude.ai · Claude Desktop)

설정 → 커넥터 → 사용자 지정 커넥터 추가
이름 hr-api, 원격 MCP 서버 URL에 위 커넥터 URL 입력 (OAuth 항목은 비워 둠)
추가 → 채팅 입력창의 도구 메뉴에서 커넥터 활성화

MCP 도구 테스트

실제 MCP tools/call로 HR API를 조회합니다

도구를 선택하세요

결과가 여기에 표시됩니다.

REST API

GET 전용 · Swagger 문서

메서드	경로	이름	설명
불러오는 중…