MCP 연동

도움말

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

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

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

서비스 구성

공개 MCP Endpoint https://example.com/mcp Private Agent Factory와 외부 MCP client가 사용하는 Streamable HTTP Endpoint입니다.

인증 Authorization: Bearer <사용자 토큰> 선택 사용자의 활성 토큰으로 인증합니다. DB 비밀번호와 Wallet은 전달하지 않습니다.

도구 수 0개 배포 환경의 MCP 도구 allowlist가 적용됩니다.

Endpoint 상세 보기

Endpoint

MCP	`https://example.com/mcp`
Transport	Streamable HTTP
백오피스 호환 Endpoint	`/mcp` — 같은 설정 기반 도구 계약을 제공합니다.
Auth	`Authorization: Bearer <사용자 토큰>` — 활성 업무 사용자 토큰입니다.
Methods	`initialize`, `tools/list`, `tools/call`

Tools

Name	Object	실행 대상	Instruction
`ords.query.admin.board_posts`	ADMIN.BOARD_POSTS	`AGENT_TOOL_OR_SELECT_AI`	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을 만들어줘."
    }
  }
}