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

> Utilizza Hybridbox tramite l'endpoint e gli strumenti Model Context Protocol.

# MCP guida

Hybridbox espone un endpoint Model Context Protocol (MCP) per i client dell'agente che desiderano individuare e chiamare le pseudo-funzioni Hybridbox tramite il runtime dell'agente A2A.

L'endpoint MCP è `/mcp`. I percorsi di origine registrano `POST /mcp` per le richieste MCP JSON-RPC. `GET /mcp` è registrato ma il metodo di restituzione non è consentito, quindi i client devono utilizzare POST per il traffico MCP.

<Note />

## Superficie del protocollo

I metodi JSON-RPC supportati includono:

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

Sono necessarie sessioni autenticate per `tools/list` e `tools/call`. Gli strumenti visibili e le funzioni richiamabili dipendono dalla sessione autenticata.

## MCP strumenti

### `hybridbox_functions_list`

Elenca le pseudo-funzioni Hybridbox visibili alla sessione autenticata. Lo strumento non accetta argomenti.

Utilizzalo prima quando un agente deve capire quali funzioni sono disponibili prima di chiamare qualsiasi cosa.

### `hybridbox_functions_explain`

Spiega le pseudo-funzioni visibili Hybridbox con schemi, documentazione ed esempi.

Argomenti:

* `function`: nome di pseudo-funzione singola opzionale da spiegare.
* `functions`: array opzionale di nomi di pseudo-funzioni da spiegare.

Utilizzarlo prima dell'esecuzione in modo che l'agente possa convalidare nomi, argomenti obbligatori, argomenti facoltativi e risultati attesi.

### `hybridbox_execute`

Esegue le pseudo-funzioni pubbliche Hybridbox utilizzando codice pseudo-python attraverso lo stesso percorso di autorizzazione e di esecuzione dell'agente A2A.

Argomenti:

* `code`: stringa richiesta contenente il codice di chiamata della funzione Hybridbox pseudo-python, ad esempio `domains.list(account_id='acc_123')`.

<Warning>
  Esegui il codice solo dopo aver controllato lo schema della funzione pertinente e convalidato gli argomenti. Il percorso di esecuzione utilizza il profilo di autorizzazione della sessione autenticata.
</Warning>

## Flusso di lavoro consigliato

<Steps>
  <Step title="Funzioni di elenco">
    Chiama `tools/list`, quindi chiama `hybridbox_functions_list` per verificare le pseudo-funzioni disponibili per la sessione autenticata.
  </Step>

  <Step title="Spiegare le funzioni">
    Richiama `hybridbox_functions_explain` con `function` o `functions` prima dell'esecuzione. Utilizzare lo schema e gli esempi restituiti per preparare argomenti validi.
  </Step>

  <Step title="Esegui con argomenti convalidati">
    Chiama `hybridbox_execute` con una stringa `code` solo dopo che il nome della funzione e gli argomenti corrispondono allo schema spiegato.
  </Step>
</Steps>

## Catalogo delle funzioni

Il catalogo delle funzioni A2A generato è il riferimento per le pseudofunzioni Hybridbox disponibili e le relative firme.

<CardGroup cols={2}>
  <Card title="A2A catalogo delle funzioni" icon="list" href="/it/agents/a2a-function-catalog">
    Sfoglia le firme delle funzioni generate, le funzionalità e le mappature delle rotte pubbliche API.
  </Card>

  <Card title="Catalogo funzioni grezze JSON" icon="code" href="/a2a_functions.v1.json">
    Ispezionare i dati del catalogo `hybridbox.a2a.functions.v1` generati.
  </Card>
</CardGroup>