MCP
GenOS MCP(Model Context Protocol) 거버넌스 API입니다. MCP 도구 호출, 도구 목록 조회, 호출 로그 관리 기능을 제공합니다.
엔드포인트
POST /api/v1/mcp/call
설명: MCP 도구를 호출합니다. 거버넌스 정책에 따라 호출이 허용/차단됩니다.
요청 본문:
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
| tool_name | string | Y | 도구 이름 |
| arguments | object | N | 도구 인자 |
응답:
{
"result": "...",
"allowed": true,
"policy_applied": "default"
}
GET /api/v1/mcp/tools
설명: 사용 가능한 MCP 도구 목록을 반환합니다.
응답:
[
{"name": "tool-name", "description": "도구 설명", "parameters": {}}
]
GET /api/v1/mcp/logs
설명: MCP 도구 호출 로그를 반환합니다.
쿼리 파라미터:
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
| page | int | N | 페이지 번호 |
| size | int | N | 페이지 크기 |
인증
JWT Bearer 토큰이 필요합니다.
에러 코드
| 코드 | 설명 |
|---|---|
| 400 | 잘못된 도구 이름 또는 인자 |
| 403 | 거버넌스 정책에 의해 호출 차단 |
| 500 | MCP 도구 실행 실패 |