현재 문서
public endpoint + access model
현재 docs는 공개 endpoint와 접근 모델을 설명하는 최소면입니다.
DEVELOPERS
문서가 아니라 계약으로 보는 시장 맥락
API와 이후 MCP surface는 route list보다 contract, scope, context package 관점으로 보여야 합니다.
현재 공개 상태
현재 준비
API key / auth scope
dashboard와 auth shell은 있으며 developer lane은 다음 단계입니다.
다음 단계
MCP-ready surface
tool, connector, context package, scope 문서가 developer plane으로 이어집니다.
developer plane
Scopes
사용자 키, org 키, tool scope를 분리해서 보여줄 수 있는 기반이 필요합니다.
Contracts
route list가 아니라 요청/응답 계약, context package, output schema가 중심이 되어야 합니다.
MCP lane
장기적으로는 tool/connector catalog와 auth boundary를 가진 MCP surface로 이어집니다.
현재 문서에서 다음 문서로
TODAY
Public docs
현재는 public API와 접근 모델을 설명합니다.
NEXT
Contract docs
context package, artifact schema, auth scope 문서가 추가되어야 합니다.
LATER
MCP surfaces
tool/connector catalog와 호출 경계를 설명하는 면으로 이어집니다.
developer lane 준비도
| developer surface | 현재 public | 다음 단계 |
|---|---|---|
| API docs | 공개 endpoint + 접근 모델 | contract + schema + examples |
| Auth scopes | API key 발급 shell | scope / org / tool 권한 분리 |
| MCP tools | 설명 없음 | tool / connector catalog |
| Sandbox | 별도 surface 없음 | local/staging sandbox guide |