MCP 연동

도움말

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

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 또는 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을 만들어줘."
    }
  }
}