MCP 연동

도움말

사용자 Bearer Token을 검증한 뒤 구성된 Select AI 프로파일의 Text2SQL·SHOWPROMPT와 QA 벡터 예제 SQL 조회·저장 MCP tool을 제공합니다. QA 조회는 SQL 생성 전에 few-shot 후보를 확인하는 용도이며, 저장은 검토된 예제를 축적하는 용도입니다.

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` 또는 `question` 입력 · QA 조회 결과는 few-shot 예제 SQL 검토용
등록된 MCP tool이 없습니다.

tools/call parameter 예시 보기

tools/call Arguments

// qa_vector_search
{
  "question": "최신 기준 활성 사용자 수를 조회해줘.",
  "topK": 3
}

// qa_vector_store
{
  "question": "최신 기준 활성 사용자 수를 조회해줘.",
  "answerSql": "SELECT COUNT(*) AS AU_COUNT FROM ...",
  "answer": "AU_COUNT=123"
}

Text2SQL·SHOWPROMPT는 prompt를 사용하고, oracle.select_ai.qa_vector_search는 few-shot 후보를 조회하며 oracle.select_ai.qa_vector_store는 검토된 읽기 전용 예제 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을 만들어줘."
    }
  }
}