MCP 연동
도움말
HMM HR MCP는 표준 용어 변환, HR 데이터 조회, HR 규정 PDF 검색의 세 도구를 제공합니다. 모든 도구는 읽기 전용이며, 휴가·근태 표현이 모호하면 용어 변환을 먼저 사용합니다.
DB 연결을 확인할 수 없습니다.
서비스 구성
공개 MCP Endpoint
https://hmm-backoffice.cloud-handson.com/mcp
Private Agent Factory와 외부 MCP client가 사용하는 Streamable HTTP Endpoint입니다.
인증
Authorization: Bearer <HMM MCP Token>
고정 MCP 서버 토큰으로 인증합니다. DB 비밀번호와 Wallet은 전달하지 않습니다.
도구 수
3개
용어 표준화 → HR 데이터/규정 검색 순서로 사용합니다.
Endpoint 상세 보기
Endpoint
| HMM MCP | https://hmm-backoffice.cloud-handson.com/mcp |
|---|---|
| Transport | Streamable HTTP |
| 백오피스 호환 Endpoint | /mcp — 로그인 세션에서 같은 HMM 도구 계약을 확인합니다. |
| Auth | Authorization: Bearer <HMM MCP Token> — 공개 MCP 서버의 고정 인증 토큰입니다. |
| Methods | initialize, tools/list, tools/call |
Tools
| Name | Object | Agent Tool | Instruction / parameter mapping |
|---|---|---|---|
ords.query.admin.board_posts |
ADMIN.BOARD_POSTS | HMM_HR_TERM_RESOLVER |
ORDS 행 접근 조회 도구 설명
resolve_hr_term.term → 표준 용어·코드 · search_hr_data.query → HR 데이터 · search_hr_policy.query → 규정 PDF 검색
|
| 등록된 MCP tool이 없습니다. | |||
tools/call parameter 예시 보기
tools/call Arguments
{
"term": "연차 이월"
}
등록 도구는 resolve_hr_term, search_hr_data, search_hr_policy입니다. 표준 용어가 필요한 질문은 resolve_hr_term 결과를 사용해 데이터 또는 규정 검색을 이어갑니다.
JSON-RPC 예시 보기
JSON-RPC 예시
initialize
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {}
}
tools/list
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list",
"params": {}
}
tools/call
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "search_hr_policy",
"arguments": {
"query": "연차 휴가 이월 기준과 제한을 알려줘."
}
}
}