API 레퍼런스

bldinit Gateway 는 160+ provider 에 걸쳐 수백 개의 op 를 노출합니다. op 목록과 스키마는 항상 라이브로 확인하는 것이 정확합니다(서비스가 계속 추가됩니다).

1. MCP transport — agent 가 자동 fetch

Claude / Cursor / Codex 등 MCP client 가 bldinit 에 연결하면 자동으로 도구 목록 + docstring 을 fetch 합니다. agent 가 자연어 prompt 를 도구 호출로 매핑할 때 docstring 을 직접 읽습니다. 연결한 서비스의 도구만 {provider}_{tool} 형식(예: cafe24_list_orders, toss_get_payment) 으로 보입니다.

2. REST API — Swagger / OpenAPI

curl https://app.bldinit.com/openapi.json

또는 브라우저에서:

• Swagger UI — 모든 endpoint 의 schema + try-it-now
• ReDoc — 정적 docs view

provider 별 op 수·스키마는 위 Swagger 에서 실시간으로 확인하세요.

REST 호출 형태

연결된 서비스의 원본 API 를 그대로 passthrough 합니다:

curl 'https://app.bldinit.com/api/v1/passthrough/cafe24/admin/products?limit=5' \
  -H 'X-API-Key: mw_...' \
  -H 'X-Mcpweave-Connection-Id: conn_xxx'

응답은 provider 의 raw 응답 그대로입니다 (Native pass-through).

OpenAPI yaml — provider 별 정의

각 provider 의 yaml 정의는 소스에서 직접 확인할 수 있습니다:

backend/src/mcpweave/providers/{provider_name}/openapi/*.yaml

내부 코드네임은 mcpweave 로 동결되어 있습니다(브랜드 bldinit 와 별개 — 패키지/키 prefix 불변).