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 referenza rapida qui sotto.

Apri API Keys

Riferimento rapido di connessione

La referenza rapida contiene già il tuo URL MCP; sostituisci solo YOUR_API_KEY con la tua chiave, poi inseriscila in Cherry Studio.

{
  "mcpServers": {
    "casii": {
      "type": "streamableHttp",
      "url": "https://api.casii.io/mcp/",
      "name": "Casii MCP",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

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

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 del riepilogo 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.

   
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.

   

Verifica del funzionamento

Richiedi l’esportazione 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.