메인 콘텐츠로 건너뛰기
Model Context Protocol (MCP) 은 Anthropic이 공개한, AI 모델이 외부 도구·데이터·시스템에 표준화된 방식으로 접근하기 위한 오픈 프로토콜입니다. JSON-RPC 2.0 기반이며 STDIO 또는 HTTP + SSE 트랜스포트를 사용합니다.

핵심 개념

Server

도구(tools), 리소스(resources), 프롬프트(prompts)를 노출하는 프로세스.

Client

Claude Desktop, Cursor, 커스텀 에이전트 — Server에 붙어 도구를 호출.

Tool

이름 + 설명 + 입력 스키마(JSON Schema)를 가진 호출 가능한 함수.

Transport

STDIO(로컬 프로세스) 또는 Streamable HTTP(원격) 두 가지 표준 트랜스포트.

표준 메서드

Bridger Gateway가 현재 처리하는 MCP 메서드는 다음과 같습니다.
메서드용도Bridger
initialize핸드셰이크 — 프로토콜 버전, capabilities 교환지원
notifications/initialized초기화 완료 알림지원
tools/list노출하는 도구 메타데이터 조회지원
tools/call도구 실행 — name + arguments를 받아 결과 반환지원
resources/list, resources/read정적/동적 리소스 조회미지원 (도구 중심)
prompts/list, prompts/get사전 정의 프롬프트 템플릿미지원 (도구 중심)
Bridger는 도구(tools) 중심 게이트웨이입니다. resources/*·prompts/*는 MCP 표준 메서드이지만 현재 Gateway에서는 처리하지 않으며, 그 외 메서드는 Method not found로 응답합니다.

Bridger와 MCP

Bridger는 MCP Server 호스팅 플랫폼입니다. 자체 MCP 서버를 작성·배포·운영하지 않아도, OpenAPI 스펙만 있으면 즉시 MCP 도구로 변환됩니다.
OpenAPI 스펙 (preset YAML 또는 BYOAPI 등록)


  ┌─────────────────────────────┐
  │  Bridger Gateway              │
  │  (mcp.datari.kr/mcp)        │
  ├─────────────────────────────┤
  │  • tools/list                │
  │  • tools/call                │
  │  • SSE event stream          │
  └─────────────────────────────┘


   Claude / Cursor / 커스텀 에이전트
  • 한 도메인(mcp.datari.kr)에 수백 개 도구가 이름으로 다중화됩니다 (getultrashortcast, getapttrade…). 공식 프리셋 서버는 {category}/{name} 형식 ID로, BYOAPI 도구는 @{owner}/{slug} 네임스페이스로 구분됩니다.
  • Server를 별도로 띄울 필요 없이 API Key 한 개로 모든 등록 도구 사용.
  • 클라이언트는 어떤 MCP 호환 클라이언트(Claude Desktop, Cursor, ChatGPT Actions 어댑터, 자체 SDK)든 그대로 동작.

다음 단계

아키텍처 보기

Gateway · Registry · 미들웨어가 어떻게 맞물리는지.

첫 도구 호출

실제 JSON-RPC 호출을 직접 실행.