메인 콘텐츠로 건너뛰기
이 페이지는 Bridger Gateway에 연결한 직후 어떤 호출이 어떤 응답으로 돌아오는지를 보여 줍니다. 도구 한 개를 골라 입력 → 출력 흐름을 확인하면 그다음부터는 어떤 도구든 동일한 패턴으로 호출할 수 있습니다.

​
준비

  • API 키 발급 완료
  • DATA_BRIDGE_API_KEY 환경변수에 키 저장
export DATA_BRIDGE_API_KEY="dk_live_..."

​
1. 등록된 도구 목록 조회

tools/list는 Bridger에 로드된 모든 MCP 도구의 메타데이터를 반환합니다 (name, description, inputSchema). 
curl -X POST https://mcp.datari.kr/mcp \
  -H "x-api-key: $DATA_BRIDGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
응답에는 다음과 같은 구조의 도구가 포함됩니다. 
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "getultrashortcast",
        "description": "기상청 초단기예보 조회 — 공공데이터포털 OpenAPI",
        "inputSchema": {
          "type": "object",
          "properties": {
            "searchKeyword": { "type": "string", "description": "검색 키워드" },
            "pageNo": { "type": "integer", "description": "페이지 번호" },
            "numOfRows": { "type": "integer", "description": "한 페이지 결과 수" }
          }
        }
      }
    ]
  }
}

​
2. 도구 실행

도구 하나를 골라 tools/call로 실행합니다. 예시는 서울 강남구 초단기예보입니다. 
curl -X POST https://mcp.datari.kr/mcp \
  -H "x-api-key: $DATA_BRIDGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "getultrashortcast",
      "arguments": {
        "searchKeyword": "서울",
        "numOfRows": 10
      }
    }
  }'

​
3. SSE로 실시간 이벤트 받기

장시간 실행 도구나 스트리밍 응답은 SSE 엔드포인트(/mcp/sse)로 받습니다. 
curl -N https://mcp.datari.kr/mcp/sse \
  -H "x-api-key: $DATA_BRIDGE_API_KEY"
gateway/toolResult 이벤트가 도구 실행마다 브로드캐스트됩니다.

​
다음 단계

Claude에 연결

위와 동일한 도구를 Claude가 자연어로 호출하도록 연결.

API Reference

JSON-RPC · SSE 전체 스펙과 에러 코드.