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

# MCP 가이드

> Model Context Protocol 엔드포인트 및 도구를 통해 Hybridbox를 사용하세요.

# MCP 가이드

Hybridbox는 A2A 에이전트 런타임을 통해 Hybridbox 의사 기능을 검색하고 호출하려는 에이전트 클라이언트를 위한 MCP(모델 컨텍스트 프로토콜) 엔드포인트를 노출합니다.

MCP 엔드포인트는 다음과 같습니다.`/mcp`. 소스 경로 등록`POST /mcp`MCP JSON-RPC 요청의 경우.`GET /mcp`등록되었지만 메서드를 반환할 수 없으므로 클라이언트는 MCP 트래픽에 POST를 사용해야 합니다.

<Note />

## 프로토콜 표면

지원되는 JSON-RPC 방법은 다음과 같습니다.

* `initialize`
* `ping`
* `notifications/initialized`
* `tools/list`
* `tools/call`

인증된 세션이 필요합니다.`tools/list`그리고`tools/call`. 표시되는 도구와 호출 가능한 기능은 인증된 세션에 따라 다릅니다.

## MCP 도구

### `hybridbox_functions_list`

인증된 세션에 표시되는 Hybridbox 의사 기능을 나열합니다. 이 도구는 인수를 허용하지 않습니다.

상담원이 호출하기 전에 어떤 기능을 사용할 수 있는지 이해해야 할 때 이 기능을 먼저 사용하세요.

### `hybridbox_functions_explain`

스키마, 문서 및 예제를 통해 가시적인 Hybridbox 의사 기능을 설명합니다.

인수:

* `function`: 설명할 선택적 단일 의사 함수 이름입니다.
* `functions`: 설명할 의사 함수 이름의 선택적 배열입니다.

에이전트가 이름, 필수 인수, 선택적 인수 및 예상 결과의 유효성을 검사할 수 있도록 실행 전에 이를 사용합니다.

### `hybridbox_execute`

A2A 에이전트와 동일한 인증 및 실행 경로를 통해 의사 파이썬 코드를 사용하여 Hybridbox 공개 의사 기능을 실행합니다.

인수:

* `code`: 의사 파이썬 Hybridbox 함수 호출 코드를 포함하는 필수 문자열(예:`domains.list(account_id='acc_123')`.

<Warning>
  관련 함수 스키마를 확인하고 인수의 유효성을 검사한 후에만 코드를 실행하세요. 실행 경로는 인증된 세션의 권한 부여 프로필을 사용합니다.
</Warning>

## 권장 워크플로우

<Steps>
  <Step title="목록 기능">
    부르다`tools/list`, 그런 다음 전화하세요`hybridbox_functions_list`인증된 세션에서 사용할 수 있는 의사 기능을 검사합니다.
  </Step>

  <Step title="기능 설명">
    부르다`hybridbox_functions_explain`\~와 함께`function`또는`functions`실행 전. 반환된 스키마와 예시를 사용하여 유효한 인수를 준비하세요.
  </Step>

  <Step title="검증된 인수로 실행">
    부르다`hybridbox_execute`와`code`함수 이름과 인수 뒤의 문자열만 설명된 스키마와 일치합니다.
  </Step>
</Steps>

## 기능 카탈로그

생성된 A2A 기능 카탈로그는 사용 가능한 Hybridbox 의사 기능 및 해당 서명에 대한 참조입니다.

<CardGroup cols={2}>
  <Card title="A2A 기능 카탈로그" icon="list" href="/ko/agents/a2a-function-catalog">
    생성된 함수 서명, 기능 및 공개 API 경로 매핑을 찾아보세요.
  </Card>

  <Card title="원시 함수 카탈로그 JSON" icon="code" href="/a2a_functions.v1.json">
    생성된 내용을 검사합니다.`hybridbox.a2a.functions.v1`카탈로그 데이터.
  </Card>
</CardGroup>