본문으로 건너뛰기

MCP

GenOS MCP(Model Context Protocol) 거버넌스 API입니다. MCP 도구 호출, 도구 목록 조회, 호출 로그 관리 기능을 제공합니다.

엔드포인트

POST /api/v1/mcp/call

설명: MCP 도구를 호출합니다. 거버넌스 정책에 따라 호출이 허용/차단됩니다.

요청 본문:

필드타입필수설명
tool_namestringY도구 이름
argumentsobjectN도구 인자

응답:

{
"result": "...",
"allowed": true,
"policy_applied": "default"
}

GET /api/v1/mcp/tools

설명: 사용 가능한 MCP 도구 목록을 반환합니다.

응답:

[
{"name": "tool-name", "description": "도구 설명", "parameters": {}}
]

GET /api/v1/mcp/logs

설명: MCP 도구 호출 로그를 반환합니다.

쿼리 파라미터:

파라미터타입필수설명
pageintN페이지 번호
sizeintN페이지 크기

인증

JWT Bearer 토큰이 필요합니다.

에러 코드

코드설명
400잘못된 도구 이름 또는 인자
403거버넌스 정책에 의해 호출 차단
500MCP 도구 실행 실패