MCP 연동

도움말

사용자 Bearer Token을 검증한 뒤 구성된 Select AI 프로파일로 업무 데이터 Text2SQL을 생성하는 MCP tool을 제공합니다. Select AI는 comment, annotation, constraint 메타데이터를 함께 사용하며, 생성 SQL은 자동 실행하지 않습니다.

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	`Authorization: Bearer <사용자 Bearer Token>` — 이 토큰 하나로 행 접근 컨텍스트를 설정합니다.
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`	ORDS 행 접근 조회 도구 설명 HTTP `Authorization` → 활성 사용자 토큰 검증 · `prompt` → 업무 데이터 Text2SQL 생성 · 결과 SQL은 검토 후 별도 실행
등록된 MCP tool이 없습니다.

tools/call parameter 예시 보기

tools/call Arguments

{
  "prompt": "최신 기준 활성 사용자 수를 조회하는 SQL을 만들어줘."
}

등록 tool은 oracle.select_ai.data_text2sql 하나입니다. 활성 사용자 Bearer Token을 확인한 뒤 Select AI가 comment, annotation, constraint를 참고해 읽기 전용 업무 데이터 SQL을 생성합니다. 실행은 자동으로 수행하지 않습니다.

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": "oracle.select_ai.data_text2sql",
    "arguments": {
      "prompt": "최신 기준 활성 사용자 수를 조회하는 SQL을 만들어줘."
    }
  }
}