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

# Guide MCP

> Utilisez Hybridbox via le point de terminaison et les outils Model Context Protocol.

# Guide MCP

Hybridbox expose un point de terminaison Model Context Protocol (MCP) pour les clients d'agent qui souhaitent découvrir et appeler les pseudo-fonctions Hybridbox via le runtime d'agent A2A.

Le point de terminaison MCP est `/mcp`. Les routes sources enregistrent `POST /mcp` pour les requêtes MCP JSON-RPC. `GET /mcp` est enregistré mais renvoie une méthode non autorisée, les clients doivent donc utiliser POST pour le trafic MCP.

<Note />

## Surface du protocole

Les méthodes JSON-RPC prises en charge incluent :

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

Des sessions authentifiées sont requises pour `tools/list` et `tools/call`. Les outils visibles et les fonctions appelables dépendent de la session authentifiée.

## Outils MCP

### `hybridbox_functions_list`

Répertorie les pseudo-fonctions Hybridbox visibles par la session authentifiée. L'outil n'accepte pas les arguments.

Utilisez-le en premier lorsqu'un agent a besoin de comprendre quelles fonctions sont disponibles avant d'appeler quoi que ce soit.

### `hybridbox_functions_explain`

Explique les pseudo-fonctions Hybridbox visibles avec des schémas, de la documentation et des exemples.

Arguments :

* `function` : nom de pseudo-fonction unique facultatif à expliquer.
* `functions` : tableau facultatif de noms de pseudo-fonctions à expliquer.

Utilisez-le avant l'exécution afin que l'agent puisse valider les noms, les arguments requis, les arguments facultatifs et les résultats attendus.

### `hybridbox_execute`

Exécute les pseudo-fonctions publiques Hybridbox à l'aide de code pseudo-python via le même chemin d'autorisation et d'exécution que l'agent A2A.

Arguments :

* `code` : chaîne obligatoire contenant le code d'appel de fonction pseudo-python Hybridbox, tel que `domains.list(account_id='acc_123')`.

<Warning>
  N'exécutez le code qu'après avoir vérifié le schéma de fonction pertinent et validé les arguments. Le chemin d'exécution utilise le profil d'autorisation de la session authentifiée.
</Warning>

## Flux de travail recommandé

<Steps>
  <Step title="Fonctions de liste">
    Appelez `tools/list`, puis appelez `hybridbox_functions_list` pour inspecter les pseudo-fonctions disponibles pour la session authentifiée.
  </Step>

  <Step title="Expliquer les fonctions">
    Appelez `hybridbox_functions_explain` avec `function` ou `functions` avant l'exécution. Utilisez le schéma et les exemples renvoyés pour préparer des arguments valides.
  </Step>

  <Step title="Exécuter avec des arguments validés">
    Appelez `hybridbox_execute` avec une chaîne `code` uniquement après que le nom de la fonction et les arguments correspondent au schéma expliqué.
  </Step>
</Steps>

## Catalogue de fonctions

Le catalogue de fonctions A2A généré est la référence pour les pseudo-fonctions Hybridbox disponibles et leurs signatures.

<CardGroup cols={2}>
  <Card title="Catalogue de fonctions A2A" icon="list" href="/fr/agents/a2a-function-catalog">
    Parcourez les signatures de fonctions générées, les capacités et les mappages de routes publics API.
  </Card>

  <Card title="Catalogue de fonctions brutes JSON" icon="code" href="/a2a_functions.v1.json">
    Inspectez les données du catalogue `hybridbox.a2a.functions.v1` générées.
  </Card>
</CardGroup>