Usa Casii MCP in Cherry Studio

Prerequisiti

1. Cherry Studio installato con accesso effettuato.
2. Una chiave API creata nella dashboard; l’URL MCP è già inserito nella configurazione mostrata nei passaggi.

Apri API Keys

Passi di configurazione

1. 1

   Apri Cherry Studio e clicca sull’icona a ingranaggio in basso a sinistra per aprire le Impostazioni.

   
2. 2

   Nella barra laterale delle Impostazioni, clicca su «MCP» sotto Strumenti e poi su «+ Aggiungi» in alto a destra.

   
3. 3

   Scegli «Creazione rapida» dal menu.

   
4. 4

   Incolla in «URL» l’indirizzo MCP qui sotto (con la barra finale). In «Header», inserisci Authorization=Bearer LA_TUA_CHIAVE_API (uno spazio tra Bearer e la chiave), poi clicca su «Salva» in basso a destra.

   

   Inserisci la mia chiave API

   Name: Casii
   Type: Streamable HTTP (streamableHttp)
   URL: https://api.casii.io/mcp/
   Headers: Authorization=Bearer YOUR_API_KEY

5. 5

   Scorri in alto e verifica che il Nome sia Casii e il Tipo sia «HTTP in streaming (streamableHttp)». Attiva l’interruttore in alto a destra: quando accanto al nome compare «Connesso» e la scheda Strumenti mostra un numero, la connessione funziona.

   
6. 6

   Torna alla chat e verifica che Casii risulti «Connesso» nell’elenco MCP sopra la casella di testo.

   
7. 7

   Scrivi la richiesta di esportazione con parole tue (puoi copiare l’esempio qui sotto). La prima volta che l’IA chiama uno strumento Casii compare una conferma: clicca su «Consenti».

   
8. 8

   Attendi che l’IA finisca. La risposta riporta il numero di righe, i crediti addebitati e un link di download CSV: cliccalo per scaricare. Per Excel, sostituisci format=csv alla fine del link con format=xlsx.

   

Le chiavi nelle schermate sono oscurate: in configurazione usa la tua chiave API.

Verifica del funzionamento

Chiedi direttamente in chat su Cherry Studio, ad esempio:

Alla prima chiamata verrà richiesta l’autorizzazione degli strumenti; poi l’IA gestisce rilevamento, preventivo e creazione in automatico. La creazione e la continuazione devono includere una chiave di idempotenza stabile (idempotency_key, formato UUID) generata una sola volta: riprovare con la stessa chiave e gli stessi parametri restituisce le attività originali e non addebita mai due volte; solo parametri diversi costituiscono una nuova operazione con una nuova chiave.