MCP 연동

도움말

보호 객체 ORDS 조회를 외부 MCP client에서 호출할 수 있도록 context path별 SSE transport로 제공합니다.

DB 연결 설정이 필요합니다.

DB 연결을 확인할 수 없습니다.

서비스 구성

기본 서비스 /mcp/sse 기존 MCP client 설정과 호환됩니다.

Context 서비스 /mcp/{contextPath}/sse 업무/환경별 이름으로 같은 ORDS tool set을 분리 노출합니다.

예시 /mcp/vpd-live/sse SSE 연결 시 message endpoint가 같은 context로 반환됩니다.

Endpoint 상세 보기

Endpoint

Default SSE	`/mcp/sse`
Default Message	`/mcp/messages?sessionId={sessionId}`
Context SSE	`/mcp/{contextPath}/sse`
Context Message	`/mcp/{contextPath}/messages?sessionId={sessionId}`
Context Path	영문/숫자로 시작하고 영문/숫자/`_`/`-`만 사용합니다. 예: `vpd`, `ords-prod`
Auth	`Basic Auth` / `BACKOFFICE_ADMIN_USER`, `BACKOFFICE_ADMIN_PASSWORD`
Methods	`initialize`, `tools/list`, `tools/call`

Tools

Name	Object	ORDS Path	Instruction / parameter mapping
`ords.query.admin.board_posts`	ADMIN.BOARD_POSTS	`cb-ords/cb-object-query/admin/board_posts`	VPD/ORDS 조회 도구 설명 `bearerToken` → Authorization · `limit` → ORDS limit · object → 이 도구에 고정 · `embedding[]` → 검색 JSON 본문
등록된 MCP tool이 없습니다.

tools/call parameter 예시 보기

tools/call Arguments

{
  "bearerToken": "vpd_live_xxx",
  "limit": 50
}

벡터 검색 tool인 CB_VECTOR_SEARCH_DOCUMENTS는 여기에 외부 임베딩 모델이 만든 embedding 숫자 배열을 추가합니다. 토큰·limit은 모든 tool에 공통이고, embedding은 벡터 tool에만 필요합니다.

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": "ords.query.admin.board_posts",
    "arguments": {
      "bearerToken": "vpd_live_xxx",
      "limit": 50
    }
  }
}