메인 콘텐츠로 건너뛰기
Claude나 ChatGPT 없이도 Bridger Gateway는 REST와 표준 MCP SDK로 직접 호출할 수 있습니다.
1

API 키 발급

어드민 대시보드에서 API 키를 발급받습니다. API 키 가이드도 함께 참고하세요.
2

REST API 호출

표준 REST 엔드포인트로 호출합니다.
curl -X GET https://mcp.datari.kr/api/v1/tools \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
REST는 도구 목록·조회·등록·관리용입니다. 도구 실행은 MCP JSON-RPC tools/call(POST /mcp)로 합니다. 아래 MCP SDK 예시를 참고하세요.
3

MCP SDK 연동 (Node.js)

프로그래밍 방식으로 연동하려면 공식 MCP SDK를 사용하세요.
설치
npm install @modelcontextprotocol/sdk
client.js
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";

const transport = new SSEClientTransport(
  new URL("https://mcp.datari.kr/mcp/sse"),
  {
    requestInit: {
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
      },
    },
  }
);

const client = new Client({
  name: "my-app",
  version: "1.0.0",
});

await client.connect(transport);

// 도구 목록 조회
const tools = await client.listTools();
console.log(tools);

// 도구 실행
const result = await client.callTool({
  name: "getweatherforecast",
  arguments: {
    nx: 60,
    ny: 127,
  },
});
console.log(result);
4

MCP SDK 연동 (Python)

동일한 흐름을 Python으로도 구현할 수 있습니다.
설치
pip install mcp
client.py
from mcp import ClientSession
from mcp.client.sse import sse_client
import asyncio

async def main():
    headers = {"Authorization": "Bearer YOUR_API_KEY"}

    async with sse_client(
        "https://mcp.datari.kr/mcp/sse",
        headers=headers,
    ) as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()

            tools = await session.list_tools()
            print(tools)

            result = await session.call_tool(
                "getweatherforecast",
                arguments={"nx": 60, "ny": 127},
            )
            print(result)

asyncio.run(main())
5

BYOAPI — 자체 API 등록 (추후 제공 예정)

OpenAPI 스펙이 있는 어떤 API든 Bridger 도구로 등록할 수 있습니다. (추후 제공 예정) 자세한 흐름은 BYOAPI 개념 문서를 참고하세요.
API 등록
curl -X POST https://mcp.datari.kr/api/v1/register \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "spec_url": "https://api.example.com/openapi.json",
    "name": "my-service",
    "auth": { "type": "bearer", "token": "SERVICE_API_KEY" },
    "visibility": "private"
  }'
spec_url(원격 스펙) 또는 spec_raw(인라인 스펙 문자열) 중 하나와 name은 필수입니다. 등록은 비동기로 처리되며 응답에 job_id가 반환됩니다. 진행 상태는 GET /api/v1/register/:id/status로 조회합니다.

​
API 레퍼런스 요약

메서드경로설명
GET/api/v1/tools등록된 도구 목록
GET/api/v1/tools/:toolId도구 단건 조회
POST/api/v1/registerBYOAPI 등록 ({spec_url|spec_raw, name, auth, visibility})
GET/api/v1/register/:id/statusBYOAPI 등록 작업 상태
GET/registry/servers프리셋 서버(MCP 그룹) 카탈로그
GET/registry/tools평탄화된 도구 목록
GET/mcp/sseMCP SSE 이벤트 스트림
POST/mcpJSON-RPC (tools/list, tools/call) — 도구 실행
전체 스펙은 API Reference 탭을 참고하세요.