# Sviluppatori: collegare un software o un assistente IA

Nel menu del tuo account, apri «Sviluppatori». La pagina si chiama «Client API». Questa voce è visibile in modalità esperto ed è contrassegnata come BETA.

### Creare un client API

Per creare client API serve un abbonamento a pagamento o un periodo di prova attivo. Puoi avere fino a 5 client.

1. Apri «Creare un client API». Se hai già un client, fai clic su «Nuova chiave API».
2. In «Identificativo», assegna un nome alla tua integrazione per riconoscerla.
3. Fai clic su «Generare una chiave API» e salva il `client_id` e il `client_secret`. Il segreto viene mostrato una sola volta.

<div class="alert">
<p><span class="lead">Importante</span></p>
<p>Mantieni il segreto riservato, come una password. Usalo solo sul server, mai nel codice del browser o in un’applicazione pubblica. Non incollarlo in una conversazione con un assistente IA.</p></div>

### Collegare il tuo software

Il software scambia queste credenziali con un token di accesso su `https://api2.rentila.com/oauth/token`, usando `client_credentials`. Poi usa il token per chiamare l’API. Riutilizzalo fino alla scadenza, quindi richiedine uno nuovo.

Apri «Istruzioni per l'accesso» per gli esempi di connessione e «Documentazione  dell'API» per le operazioni e i relativi parametri.

### Collegare un assistente tramite MCP

1. Nel client compatibile con MCP, aggiungi un server con l’indirizzo `https://api2.rentila.com/mcp`.
2. Avvia la connessione. Nella pagina Rentila che si apre nel browser, scegli il paese del tuo account e inserisci le credenziali abituali.
3. Inserisci il codice di autenticazione a due fattori, se richiesto, e torna al client.

Non occorre creare un client API per questa connessione tramite browser. Puoi poi chiedere, ad esempio: «Elenca i miei immobili» o «Quali canoni ho incassato a ottobre?». Alcune operazioni modificano i tuoi dati: controlla la richiesta e le conferme proposte dal client.

Il pulsante «Claude MCP» copia un link di configurazione da aprire nel browser. «Claude Code», «Codex» e «Cursor» copiano un testo di configurazione da usare nello strumento scelto. Inserisci la password solo nella pagina di accesso Rentila.

### Gestire i tuoi client API

L’elenco mostra nome, `client_id`, data di creazione e ultimo accesso. Il segreto resta nascosto. Per eliminare un client, usa l’icona del cestino e conferma.

Se perdi il segreto, crea un nuovo client e aggiorna il software. In caso di divulgazione, elimina anche il client compromesso. Se hai raggiunto il limite di 5 client, eliminane uno inutilizzato prima di crearne un altro.

---

https://www.rentila.it/support/developers-api-mcp
