MCP 연동
도움말
사용자 Bearer Token을 전달해 GPT-5.4-mini Select AI 자연어 조회를 실행하는 단일 MCP tool을 제공합니다. Select AI는 comment, annotation, constraint 메타데이터를 함께 사용하고, DB에서는 토큰 기준 행 접근 context가 적용됩니다.
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 → GPT-5.4-mini Select AI 자연어 질의 · limit → 최대 반환 행 수
|
| 등록된 MCP tool이 없습니다. | |||
tools/call parameter 예시 보기
tools/call Arguments
{
"prompt": "KB_CLAIMS의 전체 청구 건수를 조회해 줘.",
"limit": 50
}
등록 tool은 ords.query.kb_select_ai_vpd 하나입니다. HTTP Authorization의 사용자 Bearer Token으로 컨텍스트를 설정한 뒤 GPT-5.4-mini가 comment, annotation, constraint를 참고해 생성한 검증된 읽기 전용 KB 원장 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": "ords.query.kb_select_ai_vpd",
"arguments": {
"prompt": "KB_CLAIMS의 전체 청구 건수를 조회해 줘.",
"limit": 50
}
}
}