MCP SSE

보호 객체 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

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 Arguments

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

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

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
    }
  }
}