> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bridger.kr/llms.txt
> Use this file to discover all available pages before exploring further.

# Model Context Protocol(MCP)이란?

> Anthropic의 MCP 표준과 Bridger가 어떻게 맞물리는지 살펴봅니다.

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

## 핵심 개념

<CardGroup cols={2}>
  <Card title="Server" icon="server">
    도구(`tools`), 리소스(`resources`), 프롬프트(`prompts`)를 노출하는 프로세스.
  </Card>

  <Card title="Client" icon="plug">
    Claude Desktop, Cursor, 커스텀 에이전트 — Server에 붙어 도구를 호출.
  </Card>

  <Card title="Tool" icon="wrench">
    이름 + 설명 + 입력 스키마(JSON Schema)를 가진 호출 가능한 함수.
  </Card>

  <Card title="Transport" icon="route">
    STDIO(로컬 프로세스) 또는 Streamable HTTP(원격) 두 가지 표준 트랜스포트.
  </Card>
</CardGroup>

## 표준 메서드

Bridger Gateway가 현재 처리하는 MCP 메서드는 다음과 같습니다.

| 메서드                                | 용도                                     | Bridger     |
| ---------------------------------- | -------------------------------------- | ----------- |
| `initialize`                       | 핸드셰이크 — 프로토콜 버전, capabilities 교환       | 지원          |
| `notifications/initialized`        | 초기화 완료 알림                              | 지원          |
| `tools/list`                       | 노출하는 도구 메타데이터 조회                       | 지원          |
| `tools/call`                       | 도구 실행 — `name` + `arguments`를 받아 결과 반환 | 지원          |
| `resources/list`, `resources/read` | 정적/동적 리소스 조회                           | 미지원 (도구 중심) |
| `prompts/list`, `prompts/get`      | 사전 정의 프롬프트 템플릿                         | 미지원 (도구 중심) |

<Note>
  Bridger는 **도구(tools) 중심** 게이트웨이입니다. `resources/*`·`prompts/*`는 MCP 표준
  메서드이지만 현재 Gateway에서는 처리하지 않으며, 그 외 메서드는 `Method not found`로 응답합니다.
</Note>

## Bridger와 MCP

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

```text theme={null}
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)든 그대로 동작.

## 다음 단계

<CardGroup cols={2}>
  <Card title="아키텍처 보기" icon="diagram-project" href="/concepts/architecture">
    Gateway · Registry · 미들웨어가 어떻게 맞물리는지.
  </Card>

  <Card title="첫 도구 호출" icon="play" href="/getting-started/first-tool">
    실제 JSON-RPC 호출을 직접 실행.
  </Card>
</CardGroup>