> For the complete documentation index, see [llms.txt](https://docs.aisuru.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aisuru.com/avanzate/integrazioni/model-context-protocol-mcp-su-aisuru/mcp-di-aisuru-quali-sono-e-come-si-attivano/20.-firebird-mcp-server.md).

# 20. Firebird MCP Server

Una volta collegato il tuo database **Firebird MCP** al tuo Agente (inclusi i sistemi legacy line-of-business): l'Agente interroga i dati tramite SQL ed esplora lo schema, connettendosi tramite il **protocollo Firebird nativo** (senza necessità di **ODBC(Open Database Connectivity)**).

## Cosa può fare

* Esegui query SQL (in sola lettura) su tabelle e **viste;**
* Esplora lo schema: tabelle, viste, procedure memorizzate, colonne e relazioni;
* Produci risposte, conteggi e riepiloghi a partire dai dati aziendali.

## Esempi

*"Mostrami tutto ciò che il cliente X ha fatto negli ultimi 18 mesi: corsi, ore, date, persone e formatore."*\
\
*"Quanti corsi sono stati erogati per area nell'ultimo trimestre?"*

## Parametri di configurazione

Il connettore si collega al server Firebird con i parametri seguenti. Sono consigliati un **utente dedicato in sola lettura** e **viste appositamente progettate** ottimizzate per le domande degli Agenti.

| Parametro           | Obbligatorio | Descrizione                                                                                            |
| ------------------- | ------------ | ------------------------------------------------------------------------------------------------------ |
| `FIREBIRD_HOST`     | Sì           | Nome host o IP del server Firebird, raggiungibile da AIsuru.                                           |
| `FIREBIRD_PORT`     | No           | Porta Firebird (predefinita: `3050`).                                                                  |
| `FIREBIRD_DATABASE` | Sì           | Percorso o alias del file `.fdb` sul server Firebird (ad es. `/var/lib/firebird/data/gestionale.fdb`). |
| `FIREBIRD_USER`     | Sì           | Utente Firebird. È consigliato un utente dedicato in sola lettura.                                     |
| `FIREBIRD_PASSWORD` | Sì           | Password dell'utente Firebird.                                                                         |
| `FIREBIRD_ROLE`     | No           | Ruolo Firebird opzionale (ad es. `RDB$ADMIN`), se richiesto dalla configurazione del tuo database.     |

### Parametri personalizzati

Non sono necessari parametri aggiuntivi.

{% hint style="warning" %}
**Nota:** il server Firebird deve essere **raggiungibile da AIsuru** (direttamente con i nostri IP inseriti nella whitelist oppure tramite un tunnel). In alternativa, l'MCP può essere eseguito all'interno della rete del cliente ed esposto come endpoint HTTP MCP. Sintassi Firebird: per limitare le righe usa `FIRST n` / `ROWS n` (non `LIMIT`).
{% endhint %}