AX Flow SDK · 인터페이스 명세서
AX Flow는 제조 AI를 위한 운영 계층(Operating layer for manufacturing AI) 으로, 호스트 앱이 가져다 쓸 수 있는 4개 통합 모드와 인증·도구·운영 정책을 한 번에 비교·선택할 수 있는 단일 명세입니다.
대상 독자 — AX Flow 도입을 검토하는 도입사 / 통합 파트너의 호스트 앱 개발팀·CTO·플랫폼 운영팀.
문서 상태 — AXF-SDK-2026-001 · v2.0 · 통합 파트너 검토용 (Confidential).
30초 요약
본 SDK는 하나의 도구 카탈로그를 네 가지 통합 형태로 노출합니다. 어떤 모드를 선택하든 동일한 입력·응답·인증 스키마를 사용하며, 모드 변경 시 호출부만 갈아끼우면 됩니다.
어디부터 읽어야 하나요
1. 5분 안에 첫 응답을 받고 싶다면
Quickstart — curl / Python MCP 클라이언트로 첫 응답을 검증합니다.
2. 어떤 모드가 우리에게 맞는지 비교부터
Integration Modes — 4개 모드 비교 매트릭스 + 모드 선택 기준 + 의사결정 트리.
3. 검색·인입·그래프 도구를 알고 싶다면
Tool Catalog (P0~P3) — retriever / index_local_files / get_rag_status 등 23+1개 도구.
4. 보안·인증·SLA를 검토 중이라면
Auth & Security — OAuth 2.0 Client Credentials Grant · RBAC 4단계 · 외부 호출 정책.
원본 (SSOT)
AX Flow 측 원본(SSOT)은 FastMCP 도구 정의(Pydantic + @mcp.tool + docstring)이며, OpenAPI 스펙·SDK 가이드·MCP tools/list는 모두 그곳에서 자동 파생됩니다. 통합 시점에는 다음 진입점에서 정식 명세를 직접 수신할 수 있습니다.
| 진입점 | 용도 |
|---|---|
https://<host>/docs | Swagger UI — 인터랙티브 테스트 |
https://<host>/redoc | ReDoc — 정적 문서 페이지 |
https://<host>/openapi.json | OpenAPI 3.1 스펙 export (클라이언트 코드 자동 생성용) |
https://<host>/rag/mcp | MCP JSONRPC 마운트 포인트 (tools/list / tools/call) |
본 명세서의 데이터 입출력 스펙·도구 카탈로그·에러 코드 표는 모두 위 자동 파생물의 사람용 발췌이며, 정식 스키마는 /docs 인터랙티브 문서를 단일 기준으로 사용합니다.
본 문서의 코드 샘플에 등장하는 <host> · <access_token> · <client-id> · <client-secret>은 도입사 환경 변수로 치환하여 사용합니다.