메인 콘텐츠로 건너뛰기
Bridger의 BYOAPI(Bring Your Own API) 는 OpenAPI 스펙만 가지고 있다면 어떤 API든 별도 컨테이너 빌드/배포 없이 Bridger Gateway의 MCP 도구로 등록하는 기능입니다.
BYOAPI는 추후 제공 예정입니다. 아래 내용은 동작 방식을 미리 안내하는 것으로, 현재는 공식 프리셋 카탈로그를 통해 도구를 제공합니다.

​
핵심 아이디어 — 배포가 아니라 등록

기존 방식

API 한 개당 컨테이너 한 개를 빌드·배포·운영. 비용·관리 모두 폭증.

Bridger BYOAPI

Tool 정의만 DB에 등록. 단일 Gateway가 ID로 라우팅 → 수 초 내 완료.
하나의 Bridger Gateway (mcp.datari.kr)
  ├─ 공식 프리셋   tool_id: @datari/weather-ultra-shortcast   → tool: getultrashortcast
  ├─ 공식 프리셋   tool_id: @datari/realestate-apt-trade      → tool: getapttrade
  ├─ BYOAPI       tool_id: @user123/my-petstore              → tool: listpets, getpetbyid
  ├─ BYOAPI       tool_id: @company/internal-crm             → tool: ...
  └─ ... 230+ tools

​
도구 이름과 식별자 체계

Bridger에는 두 가지 등록 경로가 있고, 식별자 체계가 다릅니다. 1. 공식 프리셋 — vendor/spec의 OpenAPI YAML에서 Gateway가 직접 로드합니다.
  • Tool ID(레지스트리 등록 ID)는 프리셋 파일 경로 기반의 @datari/{category}-{name} 형식입니다. 예: @datari/weather-ultra-shortcast. 인메모리 서버 카탈로그(/registry/servers)에서는 동일 그룹이 servers[].id = {category}/{name}(예: weather/ultra-shortcast)로 노출됩니다.
  • 도구 이름(tools[].name)은 OpenAPI operationId에서 파생됩니다. 영숫자가 아닌 문자를 밑줄(_)로 치환한 뒤 소문자로 변환합니다. 예: getUltraShortcast → getultrashortcast. 도구 이름 자체에는 네임스페이스 접두사가 없으며, tools/call에는 이 이름을 그대로 사용합니다.
2. BYOAPI 도구 — 사용자가 /api/v1/register로 등록한 도구입니다.
  • Tool ID는 @{owner}/{slug} 네임스페이스를 가집니다. 예: @user123/my-petstore, @company/internal-crm. owner가 @로 시작하지 않으면 자동으로 @가 붙습니다.
  • 개별 도구 이름은 프리셋과 동일하게 operationId에서 파생된 이름입니다. 예: listpets.
  • 등록 시 카테고리를 지정하지 않으면 기본값은 byoapi이며, 공개 데이터로 감지되면 해당 카테고리가 적용됩니다.
구분식별자 형식예시
공식 프리셋 (Tool ID)@datari/{category}-{name}@datari/weather-ultra-shortcast
공식 프리셋 (도구 이름)operationId 파생getultrashortcast
BYOAPI (tool_id)@{owner}/{slug}@user123/my-petstore

​
등록 파이프라인

1

Ingestion

OpenAPI 스펙을 URL · 파일 업로드 · 인라인 텍스트 중 하나로 입력합니다.
2

Validation

스펙 유효성과 변환 가능한 엔드포인트 수를 점검하고 적합성 점수(score)를 계산합니다. 유효하지 않거나 변환할 엔드포인트가 없으면 422로 거부됩니다.
3

Generation

OpenAPI paths를 MCP Tool 정의로 변환합니다 (name, description, inputSchema).
4

Registration

Tool Registry DB에 등록 — 컨테이너 배포 없음.
5

Ready

즉시 mcp.datari.kr/mcp의 tools/list에 노출, tools/call 시 런타임 프록시로 upstream 호출.

​
등록 후 동작

단계설명
도구 노출등록된 도구는 tools/list 응답에 포함됩니다.
호출 라우팅tools/call 요청의 도구 ID를 기준으로 대상 API를 선택합니다.
인증 주입저장된 인증 설정에 따라 upstream 요청에 필요한 헤더나 토큰을 주입합니다.
응답 정규화upstream 응답을 MCP 클라이언트가 읽기 쉬운 형태로 반환합니다.

​
tools/list 응답 예시

{
  "tools": [
    {
      "name": "getweatherforecast",
      "description": "기상청 단기예보 — 위치 기반 날씨 정보",
      "inputSchema": {
        "type": "object",
        "properties": {
          "nx": { "type": "integer", "description": "예보지점 X 좌표" },
          "ny": { "type": "integer", "description": "예보지점 Y 좌표" }
        },
        "required": ["nx", "ny"]
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "openWorldHint": false
      }
    },
    {
      "name": "listpets",
      "description": "List all pets in the store",
      "inputSchema": { /* ... */ }
    }
  ]
}

​
데이터 모델 (요약)

CREATE TABLE tool_registrations (
  id            UUID PRIMARY KEY,
  owner_id      UUID NOT NULL REFERENCES users(id),
  tool_id       VARCHAR(128) NOT NULL UNIQUE,   -- 프리셋: @datari/{category}-{name}, BYOAPI: @{owner}/{slug}
  display_name  VARCHAR(256),
  description   TEXT,
  category      VARCHAR(64),

  source_type   VARCHAR(16),     -- preset | byoapi | manual
  source_spec   TEXT,            -- 원본 OpenAPI (압축)
  spec_hash     VARCHAR(64),     -- SHA-256

  upstream_base_url VARCHAR(512),
  upstream_paths    JSONB,       -- [{method, path, operationId, inputSchema, ...}]
  auth_config       JSONB        -- {type, header, tokenEndpoint, ...}
);
세부 등록 화면과 필드 설명은 어드민 대시보드의 BYOAPI 등록 플로우에서 확인할 수 있습니다.
내 API를 공용 프리셋으로 모두에게 제공하고 싶다면 support@datari.kr 또는 채널톡으로 문의해 주세요.

​
다음 단계

API Reference

Registry · MCP JSON-RPC · SSE 전체 스펙.

인증·보안

BYOAPI 등록 도구의 시크릿/감사/PII 처리.