> ## 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

> Используйте Hybridbox через конечную точку и инструменты протокола контекста модели.

# Руководство по MCP

Hybridbox предоставляет конечную точку протокола контекста модели (MCP) для клиентов агентов, которые хотят обнаруживать и вызывать псевдофункции Hybridbox через среду выполнения агента A2A.

Конечная точка MCP — `/mcp`. Исходные маршруты регистрируют `POST /mcp` для запросов MCP JSON-RPC. `GET /mcp` зарегистрирован, но метод возврата не разрешен, поэтому клиентам следует использовать POST для трафика MCP.

<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`

Выполняет общедоступные псевдофункции Hybridbox, используя псевдокод Python, используя тот же путь авторизации и выполнения, что и агент A2A.

Аргументы:

* `code`: обязательная строка, содержащая код вызова функции псевдопитона Hybridbox, например `domains.list(account_id='acc_123')`.

<Warning>
  Выполняйте код только после проверки соответствующей схемы функции и проверки аргументов. Путь выполнения использует профиль авторизации аутентифицированного сеанса.
</Warning>

## Рекомендуемый рабочий процесс

<Steps>
  <Step title="List functions">
    Вызовите `tools/list`, затем вызовите `Hybridbox_functions_list`, чтобы проверить псевдофункции, доступные для аутентифицированного сеанса.
  </Step>

  <Step title="Explain functions">
    Вызовите `Hybridbox_functions_explain` с помощью `function` или `functions` перед выполнением. Используйте возвращенную схему и примеры для подготовки действительных аргументов.
  </Step>

  <Step title="Execute with validated arguments">
    Вызов `Hybridbox_execute` со строкой `code` только после того, как имя функции и аргументы соответствуют описанной схеме.
  </Step>
</Steps>

## Каталог функций

Созданный каталог функций A2A является справочником по доступным псевдофункциям Hybridbox и их сигнатурам.

<CardGroup cols={2}>
  <Card title="A2A function catalog" icon="list" href="/ru/agents/a2a-function-catalog">
    Просмотрите созданные сигнатуры функций, возможности и сопоставления маршрутов общедоступного API.
  </Card>

  <Card title="Raw function catalog JSON" icon="code" href="/a2a_functions.v1.json">
    Проверьте сгенерированные данные каталога `Hybridbox.A2A.functions.v1`.
  </Card>
</CardGroup>