> ## 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 エージェントと同じ認可および実行パスを通じて、擬似 Python コードを使用して、Hybridbox パブリック擬似関数を実行します。

引数:

* `code`: 疑似 Python 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="/ja/agents/a2a-function-catalog">
    生成された関数のシグネチャ、機能、およびパブリック API ルート マッピングを参照します。
  </Card>

  <Card title="生の関数カタログ JSON" icon="code" href="/a2a_functions.v1.json">
    生成されたものを検査する`hybridbox.a2a.functions.v1`カタログデータ。
  </Card>
</CardGroup>