Collegare Claude a FreeScout
Due vie, spiegate passo dopo passo – anche senza conoscenze tecniche
Le immagini mostrano l'interfaccia in tedesco. Per ogni denominazione indichiamo prima quella nella vostra lingua e tra parentesi quella tedesca che vedete nell'immagine. Per claude.ai e la piattaforma Claude indichiamo la denominazione inglese, come la vedete se il vostro Claude è impostato in inglese; altrimenti appare nella vostra lingua.
Con McpConnect, Claude, l'assistente IA di Anthropic, lavora insieme al vostro FreeScout. Per farlo ci sono due vie. Non si escludono a vicenda, molti team le usano entrambe. Questa guida spiega prima la differenza e poi ciascuna via singolarmente.
Le due vie in sintesi
Via 1 – Claude come assistente personale
Lavorate come sempre in Claude Desktop o su claude.ai e da lì collegate Claude a FreeScout. Poi fate domande a Claude nella chat, ad esempio:
- «Quali richieste sono arrivate oggi nella casella Support?»
- «Riassumimi il ticket #1234 in tre frasi.»
- «Scrivi una bozza di risposta per il ticket #1234.»
Claude lavora solo quando glielo chiedete, e lo fa a vostro nome con i vostri diritti in FreeScout. Ogni persona collega il proprio Claude.
Via 2 – Claude come agente in FreeScout
FreeScout riceve un proprio collega IA, ad esempio «James». Lavora in modo autonomo in background: legge ogni nuovo messaggio dei clienti, lo riassume in una nota, prepara le risposte, assegna i ticket secondo le vostre regole e – se lo permettete – può inviare da solo le risposte sicure, anche nella live chat. Inoltre svolge gli incarichi del vostro team nel menu IA (KI).
L'agente lavora con un proprio utente FreeScout e si collega tramite l'interfaccia di programmazione (API) di Anthropic. Un amministratore lo configura una volta per tutti.
Confronto a colpo d'occhio
| Via 1: assistente personale | Via 2: agente in FreeScout | |
|---|---|---|
| Dove lavorate? | in Claude Desktop o su claude.ai | in FreeScout |
| Quando lavora Claude? | solo su vostra domanda | 24 ore su 24, a ogni nuovo messaggio e su incarico |
| A nome di chi? | a vostro nome, con i vostri diritti | come utente proprio, ad es. «James» |
| Chi configura? | ogni persona da sé (dopo una breve preparazione da parte dell'amministratore) | una volta un amministratore |
| Cosa serve? | un account Claude (Free, Pro, Max, Team o Enterprise) | un account sulla piattaforma Claude di Anthropic con credito e una chiave API |
| Costi | inclusi nell'abbonamento Claude | in base al consumo, direttamente presso Anthropic; di solito alcuni centesimi per esecuzione |
| Può rispondere da solo ai clienti? | no – solo bozze, che inviate voi | sì, se lo permettete: solo risposte verificate dalle vostre fonti, con un ritardo per poterle fermare |
| Live chat | no | sì |
| Configurazione | circa 5 minuti per persona | circa 30 minuti, più alcuni giorni di modalità prova |
Vantaggi e svantaggi
Via 1 – Assistente personale
- ✅ configurazione rapida, nessun costo aggiuntivo con l'abbonamento Claude esistente
- ✅ a ogni domanda decidete voi cosa fa Claude
- ✅ ideale per analisi, riassunti e bozze su richiesta
- ✅ Claude può combinare FreeScout con altri connector, ad esempio con il vostro calendario o i vostri documenti
- ❌ lavora solo quando qualcuno chiede – i nuovi ticket restano lì finché non li affidate a Claude
- ❌ ogni persona deve collegare Claude da sé
- ❌ non può rispondere ai clienti in modo autonomo né aiutare nella live chat
Via 2 – Agente in FreeScout
- ✅ lavora in modo autonomo: ogni nuova richiesta è classificata e preparata prima che qualcuno la apra
- ✅ risponde da solo alle domande sicure, anche nella live chat, se lo permettete
- ✅ una sola configurazione per tutto il team, un unico punto per regole, budget e arresto di emergenza
- ✅ gli incarichi ricorrenti, ad esempio un rapporto settimanale, si svolgono da soli
- ❌ costi propri in base al consumo presso Anthropic (limitabili con un budget giornaliero)
- ❌ più configurazione e qualche giorno di modalità prova, finché le regole non sono a punto
- ❌ richiede un proprio utente FreeScout
Quale via fa per voi?
La via 1 fa per voi se siete un piccolo team, ogni persona ha comunque un abbonamento Claude e non volete processi automatici. Claude aiuta allora su richiesta, e ogni persona mantiene il controllo.
La via 2 fa per voi se non tutti hanno un abbonamento Claude o se al centro c'è l'automazione: le nuove richieste devono essere classificate, preparate o risposte da sole, anche nella live chat. Basta un unico account presso Anthropic per tutta l'azienda, e tutto il team ne trae vantaggio – anche senza un abbonamento Claude proprio: tramite una nota all'agente e, se lo attivate per tutti, tramite il menu «IA».
Le due vie si possono anche combinare: l'agente per la routine in background, Claude Desktop per le singole persone che vogliono in più analisi e bozze su richiesta.
Come è strutturata questa guida
| Parte | Per quale via? | Chi se ne occupa? |
|---|---|---|
| Parte A – Preparare FreeScout | entrambe | amministratore, una volta |
| Parte B – Via 1: Claude Desktop e claude.ai | via 1 | amministratore (B1), poi ogni persona |
| Parte C – Via 2: Claude come agente | via 2 | amministratore |
| Parte D – Controllare o terminare le connessioni | entrambe | ogni persona o l'amministratore |
| Parte E – Se qualcosa non funziona | entrambe | tutti |
Non siete amministratori e volete usare solo la via 1? Allora chiedete alla vostra amministratrice o al vostro amministratore se la parte A e il passo B1 sono stati completati, fatevi dare l'indirizzo del server MCP e iniziate da B2.
Alcuni termini prima di iniziare
Non è necessario conoscere questi termini per seguire la guida. Vi aiutano però se li incontrate lungo il percorso.
| Termine | Significato |
|---|---|
| Connector | Via 1: un collegamento tra Claude e un altro programma, qui FreeScout. In Claude il menu si chiama Connectors (Konnektoren). |
| Server MCP | Il punto del vostro FreeScout con cui Claude comunica. Il suo indirizzo Internet termina con /mcp. |
| Finestra di consenso | Via 1: la pagina in FreeScout in cui stabilite cosa può fare Claude. |
| Chiave API | Via 2: una lunga password con cui FreeScout usa Claude per conto della vostra azienda. Consuma credito presso Anthropic. |
| Account di servizio | Via 2: l'utente FreeScout con cui lavora l'agente, ad es. «James». |
| Client di servizio | Via 2: stabilisce cosa può fare l'agente: autorizzazioni, caselle, indirizzi consentiti. |
| Modalità prova | Via 2: l'agente lavora in prova, ma non scrive nulla. Vedete cosa avrebbe fatto. |
| Revocare | terminare una connessione. Da quel momento Claude non ha più accesso. |
Parte A – Preparare FreeScout (entrambe le vie)
Questa parte la svolge una volta una persona con diritti di amministratore in FreeScout.
Il vostro FreeScout deve essere raggiungibile da Internet, tramite un indirizzo con https://. In entrambe le vie Claude lavora sui server di Anthropic e da lì si collega al vostro FreeScout. Se FreeScout funziona solo nella rete aziendale o dietro una VPN, la connessione non funziona.
A1 – Aprire la sezione «Connessioni IA»
- Accedete a FreeScout come amministratore.
- Cliccate in alto nella barra blu su Gestione (Verwalten).
- Cliccate nell'elenco su Connessioni IA (KI-Verbindungen).
A sinistra appare ora una colonna con le sezioni di McpConnect: Client (Clients), Connessioni (Verbindungen), Diritti (Rechte), Agente (Agent), Conoscenze (Wissen) e altre.
A2 – Eseguire l'autocontrollo
L'autocontrollo verifica se il vostro FreeScout è pronto, ad esempio se HTTPS è configurato e se l'accesso viene inoltrato correttamente.
- Cliccate a sinistra su Autocontrollo (Selbstprüfung).
- Cliccate su Controlla ora (Jetzt prüfen).
- Attendete qualche secondo finché appare l'elenco.
Ecco come leggere il risultato:
| Colore | Significato | Cosa fare? |
|---|---|---|
| 🟢 verde | tutto a posto | niente |
| 🟡 giallo | funziona, ma non in modo ideale | leggere l'indicazione; di solito la connessione funziona comunque |
| 🔴 rosso | così la connessione non funziona | correggere prima – la riga dice come |
| ⚪ grigio | non è stato possibile verificarlo dall'interno | nessun errore, ma nemmeno una conferma |
Se la riga «Metadaten» (metadati) è rossa, quasi sempre manca una riga nel file .htaccess del vostro FreeScout. L'autocontrollo mostra la riga. Datela al vostro hoster o al vostro reparto IT, se non avete accesso diretto ai file. Per la via 2 deve inoltre essere verde la riga Cron: l'agente viene avviato dal pianificatore di FreeScout.
A3 – (Facoltativo) Controllare i diritti
In Diritti (Rechte) vedete cosa può fare al massimo un'IA nel vostro FreeScout. Vale per entrambe le vie, indipendentemente da ciò che qualcuno spunterà in seguito. Impostazione di fabbrica:
- consentito direttamente: leggere, note interne, bozze di risposta, cambiare lo stato
- solo dopo l'approvazione di una persona: segnare come spam, spostare nel cestino, spostare, modificare i dati dei clienti
- non possibile: eliminare definitivamente, aggiungere nuovi destinatari nelle risposte, modificare gli indirizzi e-mail dei clienti
Per iniziare non dovete cambiare nulla qui. ✅
Parte B – Via 1: Claude Desktop e claude.ai
Cosa vi serve per la via 1
- La parte A è completata (amministratore).
- Un account utente FreeScout con indirizzo e-mail e password.
- Un account Claude. Funzionano tutti gli abbonamenti: Free, Pro, Max, Team ed Enterprise. Nell'abbonamento gratuito (Free) è possibile esattamente un connector personalizzato.
- L'indirizzo del server MCP, ad esempio
https://support.deine-firma.ch/mcp(vedi B1). - Un browser aggiornato, ad esempio Chrome, Edge, Firefox o Safari.
B1 – Ammettere Claude e comunicare l'indirizzo (amministratore, una volta)
Ammettere Claude:
- In Gestione → Connessioni IA (Verwalten → KI-Verbindungen) cliccate a sinistra su Impostazioni (Einstellungen).
- Cercate il campo Documenti di metadati dell'ID client (Client-ID-Metadaten-Dokumente) e scrivete:
claude.ai - Subito sopra, in Chi può collegare client IA (Wer KI-Clients verbinden darf), verificate che siano spuntati i ruoli giusti: «Utenti» (Benutzer), «Amministratori» (Administratoren) o entrambi.
- Scorrete fino in fondo e cliccate su Salva (Speichern).
Con questa voce FreeScout riconosce Claude dalla sua identità pubblicata. Nella finestra di consenso apparirà poi «Identità confermata da claude.ai» (Identität bestätigt durch claude.ai). Così ogni persona sa che a chiedere è davvero Claude e non un programma estraneo.
Comunicare l'indirizzo:
- Cliccate a sinistra su Client (Clients).
- In alto trovate Indirizzo del server MCP per il client (Adresse des MCP-Servers für den Client) con un indirizzo che termina con
/mcp. - Selezionate l'indirizzo e copiatelo (Mac: ⌘ + C, Windows: Ctrl + C).
- Inoltratelo a tutte le persone che vogliono collegare Claude, ad esempio per e-mail.
B2 – Creare il connector in Claude (Free, Pro, Max)
Avete un account Team o Enterprise della vostra azienda? Allora continuate con B3.
Le immagini mostrano l'interfaccia tedesca di claude.ai. Qui sotto indichiamo prima la denominazione inglese e tra parentesi quella tedesca dell'immagine. Claude mostra le denominazioni nella lingua che avete impostato: se è l'inglese, sono quelle indicate qui; altrimenti le trovate nella vostra lingua nello stesso punto.
- Aprite claude.ai nel browser e accedete.
- Cliccate a sinistra su Customize (Anpassungen) e in alto sulla scheda Connectors (Konnektoren).
- Cliccate a destra su Add (Hinzufügen) e poi su Add custom connector (Benutzerdefinierten Connector hinzufügen).
- Compilate la finestra:
- Name (Name): ad esempio
FreeScout. Questo nome lo vedrete poi in Claude. - Remote MCP server URL (MCP-Server-URL): l'indirizzo da B1, ad esempio
https://support.deine-firma.ch/mcp. Fate attenzione che inizi conhttps://e termini con/mcp, senza spazi.
- Name (Name): ad esempio
- Cliccate su Continue (Weiter).
- Claude verifica l'indirizzo e mostra le impostazioni di accesso. Sono già preselezionate correttamente:
- in «Authentifizierung» (autenticazione): «Jetzt anmelden» (accedi ora) – con l'indicazione «Erkannt» (rilevato)
- in «OAuth-Client» (client OAuth): Use Claude's published identity (Claudes veröffentlichte Identität verwenden) – con l'indicazione «Empfohlen» (consigliato)
- Non cambiate nulla e cliccate su Add.
- Claude mostra ora la pagina del nuovo connector con l'avviso «Du bist noch nicht mit FreeScout verbunden» (non siete ancora connessi a FreeScout). Cliccate lì su Connect (Verbinden).
Non scegliete «Automatisch registrieren» (registra automaticamente) e non «Eigenen OAuth-Client verwenden» (usa il proprio client OAuth), a meno che la vostra amministratrice o il vostro amministratore non lo dica espressamente. Queste due vie richiedono una configurazione aggiuntiva in FreeScout. Se in «Authentifizierung» (autenticazione) non appare «Erkannt» (rilevato), l'indirizzo è sbagliato o FreeScout non è raggiungibile – vedi parte E.
Continuate con B4.
B3 – Collegare il connector (Team, Enterprise)
Negli account Team ed Enterprise una persona con diritti di proprietario (Owner) crea il connector una volta per tutta l'organizzazione:
- Owner: nelle «Organisationseinstellungen» (impostazioni dell'organizzazione) aprire la sezione Connectors (Konnektoren) → Add (Hinzufügen) → «Benutzerdefiniert» (personalizzato) → scegliere «Web».
- Owner: inserire il nome
FreeScoute l'indirizzo da B1 → Continue (Weiter) → lasciare le impostazioni di accesso preselezionate (Use Claude's published identity) → Add.
Poi ogni persona si collega da sé:
- Aprite Customize (Anpassungen) → Connectors.
- Cercate FreeScout nell'elenco. Di solito la voce porta il contrassegno «Benutzerdefiniert» (personalizzato).
- Cliccate su Connect (Verbinden).
B4 – Accedere a FreeScout
Dopo il clic Claude apre una nuova finestra o una nuova scheda con il vostro FreeScout.
- Se in questo browser avete già effettuato l'accesso a FreeScout, si prosegue direttamente con B5.
- Altrimenti appare la pagina di accesso di FreeScout. Inserite lì il vostro solito indirizzo e-mail FreeScout e la vostra password e cliccate su Connettiti (Anmelden).
Se non si apre nessuna finestra, forse il browser l'ha bloccata. Cercate un avviso nella barra degli indirizzi (pop-up bloccato) e consentite i pop-up per claude.ai.
B5 – Stabilire nella finestra di consenso cosa può fare Claude
Ora arriva il passo più importante. FreeScout mostra la pagina «Consentire a Claude di accedere a FreeScout?» («Darf Claude auf FreeScout zugreifen?»). Qui decidete cosa può fare Claude. Prendetevi un momento.
Esaminate la pagina dall'alto verso il basso:
1. Controllare l'intestazione. Lì c'è scritto «Identità confermata da claude.ai» (Identität bestätigt durch claude.ai) e «Ritorna a: claude.ai» (Rückkehr zu: claude.ai). C'è scritto qualcos'altro, oppure non avete avviato voi la connessione? Allora cliccate su Annulla (Abbrechen).
2. Spuntare le autorizzazioni.
- In Lettura (Lesen) le spunte sono già impostate. Così Claude può leggere e cercare nelle vostre caselle e conversazioni. Claude ne ha bisogno per quasi ogni domanda.
- Tutto ciò che scrive è contrassegnato da un'etichetta arancione «scrive» (schreibt) e non è mai preselezionato. Spuntate solo ciò che vi serve davvero:
- Aggiungere note interne a tuo nome (Interne Notizen anlegen): Claude può scrivere note nei ticket. I clienti non le vedono.
- Creare bozze di risposta a tuo nome (Antwortentwürfe anlegen): Claude può preparare risposte. Non vengono mai inviate automaticamente, le controllate e inviate voi.
- A seconda della configurazione vedete altre righe, ad esempio per lo stato dei ticket o per altri moduli. Leggete ogni riga prima di mettere una spunta.
Per iniziare bastano i diritti di lettura preselezionati e, se volete delle bozze, «Creare bozze di risposta a tuo nome». Potete consentire di più in seguito, ricollegando Claude (vedi D3).
3. Scegliere le caselle. Di fabbrica vale «Tutte le caselle che vedo, anche quelle future» (Alle Postfächer, die ich sehe, auch künftige). Se volete mostrare a Claude solo alcune caselle, scegliete «Solo queste caselle:» (Nur diese Postfächer:) e spuntatele.
4. Dati personali. Se «Pseudonimizza» (Pseudonymisieren) è spuntato, Claude vede al posto di nomi, indirizzi, numeri di telefono e indirizzi e-mail reali solo segnaposto come «Vorname.1». Lasciate la spunta se non siete sicuri. Se la vostra amministratrice o il vostro amministratore ha attivato la pseudonimizzazione in modo fisso, qui non potete disattivarla.
5. Indirizzi IP consentiti – lasciare vuoto. Il campo Indirizzi IP consentiti (Erlaubte IP-Adressen) è pensato per casi particolari.
In «Indirizzi IP consentiti» non inserite il vostro indirizzo. Claude non accede dal vostro computer, ma dai server di Anthropic. Con il vostro indirizzo FreeScout escluderebbe Claude.
6. Consentire l'accesso. Cliccate in fondo su Consenti l'accesso (Zugriff erlauben). La finestra si chiude o torna a Claude.
B6 – Verificare che abbia funzionato
- Claude conferma brevemente «Mit FreeScout verbunden» (connesso a FreeScout). Sulla pagina del connector in alto a destra c'è ora Disconnect (Trennen) invece di Connect (Verbinden), sotto l'elenco degli strumenti che Claude può usare in FreeScout.
- Ricevete da FreeScout un'e-mail con l'oggetto «Nuova connessione IA al tuo account FreeScout» («Neue KI-Verbindung zu Ihrem FreeScout-Konto»). È normale ed è una misura di sicurezza: se non avete creato voi la connessione, revocatela subito (vedi parte D).
Le autorizzazioni degli strumenti («Tool-Berechtigungen»). Per ogni strumento ci sono a destra tre piccoli simboli: la spunta per «Immer erlauben» (consenti sempre), la mano per «Genehmigung erforderlich» (approvazione richiesta) e il cerchio barrato per «Blockiert» (bloccato). Con il campo di selezione accanto a un gruppo, ad esempio «Schreibgeschützte Tools» (strumenti di sola lettura, cioè quelli che leggono), cambiate tutti gli strumenti del gruppo in una volta. Per iniziare lasciate tutto com'è.
Questa impostazione vale solo in Claude. Cosa Claude può fare in FreeScout l'avete stabilito in B5 nella finestra di consenso. Uno strumento che lì non avete consentito non compare nemmeno in questo elenco.
B7 – Usare Claude nel lavoro quotidiano
Attivare FreeScout nella chat:
- Avviate in Claude una nuova chat.
- Cliccate in basso a sinistra nel campo di inserimento su +.
- Passate con il mouse su Connectors (Konnektoren). Accanto si apre un elenco.
- Attivate lì FreeScout (l'interruttore diventa blu).
Fare domande. Scrivete normalmente, ad esempio:
- «Mostrami i ticket aperti nella casella Support.»
- «Cosa vuole il cliente nel ticket #1234? Riassumilo brevemente.»
- «Cerca tutti i ticket della settimana scorsa che riguardano fatture.»
- «Scrivi una bozza di risposta per il ticket #1234: cordiale, breve, con un ringraziamento per la pazienza.»
Claude chiede il permesso. Prima di consultare o scrivere qualcosa in FreeScout, Claude ve lo chiede, ad esempio «Claude möchte List mailboxes von FreeScout verwenden» (Claude vuole usare List mailboxes di FreeScout). I nomi degli strumenti sono in inglese: «List mailboxes» significa elencare le caselle, «Search conversations» cercare conversazioni, «Create reply draft» creare una bozza di risposta. Sotto ci sono tre pulsanti:
- «Einmal erlauben» (consenti una volta): solo per questo singolo passo.
- «Immer erlauben» (consenti sempre): Claude non chiede più per questo strumento. Potete ripristinarlo in qualsiasi momento nelle autorizzazioni degli strumenti (B6).
- «Ablehnen» (rifiuta): Claude non può eseguire questo passo.
Le azioni di lettura potete consentirle tranquillamente in modo permanente. Per le azioni di scrittura, come note o bozze, all'inizio «Einmal erlauben» (consenti una volta) è la scelta migliore. Così vedete ogni volta cosa vuole fare Claude.
Dopo il permesso, Claude recupera i dati da FreeScout e risponde nella chat. Con un clic sulla riga grigia sopra la risposta vedete quali strumenti Claude ha usato.
Cosa Claude non può fare con questa via:
- Claude non invia e-mail ai clienti. Le bozze restano bozze finché non le inviate voi.
- Claude non elimina nulla definitivamente e non può aggiungere nuovi destinatari nelle risposte.
- Alcune azioni, ad esempio «segnare come spam», richiedono l'approvazione di una persona. Claude vi dice allora che l'azione è in attesa. Potete approvarla nel menu FreeScout Approvazioni IA (KI-Freigaben) o direttamente nella conversazione.
Claude Desktop. Se usate l'app Claude Desktop su Mac o Windows, non dovete configurare nulla in più. L'app usa lo stesso account Claude, il connector «FreeScout» è lì automaticamente pronto. Attivatelo nella chat come descritto sopra.
Via 1 completata! ✅
Parte C – Via 2: Claude come agente in FreeScout
Questa parte la svolge un amministratore. Prevedete circa 30 minuti e poi alcuni giorni di modalità prova.
Cosa vi serve per la via 2
- La parte A è completata, e l'autocontrollo mostra verde alla riga Cron.
- Diritti di amministratore in FreeScout.
- Un account sulla piattaforma Claude di Anthropic (platform.claude.com) con credito – acquistato con carta di credito oppure, con un abbonamento Max o Team, i crediti API mensili inclusi nell'abbonamento.
- Un indirizzo e-mail per l'agente, ad esempio
james@deine-firma.ch. Non deve ricevere posta da nessuna parte, ma non può appartenere già a un utente FreeScout.
C1 – Creare una chiave API presso Anthropic
Tramite la chiave API FreeScout usa Claude e lo paga con il vostro credito presso Anthropic. Con un proprio Workspace con limite di spesa vi assicurate che l'agente non spenda mai più del previsto.
Le immagini mostrano l'interfaccia tedesca della piattaforma Claude («Claude Console»). Qui sotto indichiamo prima la denominazione inglese e tra parentesi quella tedesca dell'immagine; se la vostra Console è impostata su un'altra lingua, trovate le denominazioni in quella lingua nello stesso punto. Alle impostazioni si accede tramite la rotella a sinistra o tramite il vostro nome in basso a sinistra.
- Aprite platform.claude.com e accedete. Se non avete ancora un account, createne uno (azienda, nome, e-mail).
Credito
- Nelle impostazioni, in «Organisationseinstellungen» (impostazioni dell'organizzazione), aprite la voce Billing (Abrechnung).
- In «Guthaben» (credito) vedete quanto denaro c'è sull'account. Se è vuoto, cliccate su Buy credits (Credits kaufen) e acquistate ad esempio 20 USD. Con «Automatisches Aufladen verwalten» (gestisci la ricarica automatica) potete stabilire che il credito venga ricaricato da solo quando si esaurisce. Così l'agente non si ferma all'improvviso.
Se avete un abbonamento Claude Team o Max, include ogni mese del credito API. Un avviso in alto nella pagina «Billing» lo indica. Allora spesso per iniziare non dovete acquistare nulla.
Workspace con limite di spesa
- In «Organisationseinstellungen» (impostazioni dell'organizzazione) aprite la voce Workspaces (Arbeitsbereiche) e cliccate su Create workspace (Workspace erstellen). Chiamatelo ad esempio
FreeScoute confermate. - Cliccate nell'elenco sul nuovo Workspace. A destra si apre una panoramica.
- Cliccate lì su Spend limits (Ausgabenlimits) e impostate un limite mensile, ad esempio 30 USD. Una volta raggiunto, Anthropic blocca le richieste fino al mese successivo.
Creare la chiave
- In «Organisationseinstellungen» (impostazioni dell'organizzazione) aprite la voce API keys (API-Schlüssel) e cliccate su Create key (Schlüssel erstellen).
- Prima appare una finestra «Mit Identitätsföderation brauchst du keinen API-Schlüssel» (con la federazione delle identità non serve una chiave API). È pensata per grandi ambienti IT e non è adatta a FreeScout. Cliccate in basso su «Mit einem API-Schlüssel fortfahren» (continua con una chiave API).
- Compilate la finestra «API-Schlüssel erstellen» (crea chiave API):
- Name (Name): ad esempio
FreeScout Agent. - Expires (Läuft ab): scegliete Never (Nie). Di fabbrica qui c'è «30 Tage» (30 giorni) – in tal caso l'agente smette di lavorare dopo un mese senza preavviso. L'avviso giallo che appare con Never è corretto: proprio per questo conservate la chiave con cura (passo 11).
- «Verknüpftes Konto» (account collegato): lasciate il vostro nome. Notate l'avviso sottostante: se lasciate l'azienda e il vostro accesso alla piattaforma viene rimosso, anche la chiave viene disattivata. Servirà allora una nuova chiave.
- Scope (Geltungsbereich): scegliete il Workspace del passo 4, cioè FreeScout. Così il limite di spesa vale anche per questa chiave.
- Name (Name): ad esempio
- Cliccate su Create key (Schlüssel erstellen).
- Copiate subito la chiave. Inizia con
sk-ant-e viene mostrata solo questa volta. Conservatela al sicuro fino al passo C4, ad esempio nel vostro gestore di password – non in un'e-mail e non in una chat.
La chiave API è come una password per il vostro credito. Non datela a nessuno. In FreeScout viene salvata in forma cifrata e non viene mai più mostrata. Se l'avete persa, eliminatela sulla piattaforma e createne una nuova.
C2 – Creare un account di servizio per l'agente
L'agente lavora come utente FreeScout proprio. Il suo nome compare su ogni nota e ogni bozza che scrive.
- In FreeScout cliccate su Gestione → Utenti (Verwalten → Benutzer) e poi su Nuovo utente (Neuer Benutzer).
- Compilate:
- Ruolo (Rolle): Utente (Benutzer) (non Amministratore)
- Nome (Vorname): il nome dell'agente, ad esempio
James - Cognome (Nachname): ad esempio
IA, affinché tutti vedano che qui scrive un'IA (nell'immagine: «KI», l'abbreviazione tedesca) - Email (E-Mail): l'indirizzo per l'agente, ad esempio
james@deine-firma.ch - Caselle postali (Postfächer): solo quelle che l'agente deve gestire
- Togliete la spunta da Invia email di invito (Einladungs-E-Mail senden). L'agente non accede mai da sé.
- Cliccate su Crea utente (Benutzer erstellen).
Date all'account di servizio un'immagine di profilo (Profilbild). Appare nel menu «IA» accanto a ogni risposta dell'agente. E nel suo profilo, in Notifiche (Benachrichtigungen), disattivate tutte le notifiche e-mail, altrimenti FreeScout invia e-mail a un indirizzo che nessuno legge.
C3 – Creare il client di servizio
Il client di servizio stabilisce cosa può fare l'agente.
- In Gestione → Connessioni IA (Verwalten → KI-Verbindungen) cliccate a sinistra su Agente (Agent).
- Scorrete fino a Client di servizio (Dienst-Clients) e cliccate su Nuovo client di servizio (Neuer Dienst-Client).
- Compilate la finestra:
- Nome (Name): ad esempio
James - Account di servizio (Dienstkonto): l'utente da C2
- Autorizzazioni (Berechtigungen): è preselezionato ciò che serve all'agente per iniziare: leggere, note, bozze, stato e proporre lo spam. Lasciatelo così per l'avvio. Altri diritti, ad esempio «Fragen in eigenen Worten beantworten» (rispondere alle domande con parole proprie) o i diritti di altri moduli, potete aggiungerli in seguito.
- Caselle (Postfächer): «Tutte quelle che vede l'account di servizio» (Alle, die das Dienstkonto sieht) – la scelta l'avete già fatta in C2.
- Indirizzi IP consentiti (Erlaubte IP-Adressen): lasciate così. Sono preimpostati gli indirizzi da cui Claude lavora presso Anthropic.
- Dati personali (Personendaten): lasciate spuntato «Pseudonimizza» (Pseudonymisieren).
- Nome (Name): ad esempio
- Cliccate su Crea client di servizio (Dienst-Client anlegen).
Il nuovo client di servizio appare nell'elenco.
C4 – Configurare l'agente e avviarlo in modalità prova
In alto nella stessa pagina, nella sezione Esecuzione (Läufer):
- Spuntate Elabora ogni nuovo messaggio del cliente (Jede neue Kundennachricht bearbeiten).
- Spuntate Modalità prova (Probebetrieb). Importante per iniziare: l'agente lavora allora in prova, ma non scrive nulla in FreeScout.
- In Client di servizio (Dienst-Client) scegliete il client da C3.
- In Chiave API Anthropic (Anthropic-API-Schlüssel) incollate la chiave da C1 (Mac: ⌘ + V, Windows: Ctrl + V).
C5 – Modello, forma di cortesia e regole interne
Subito sotto:
- Modello (Modell): di fabbrica
claude-opus-5-5con impegno «medium». È accurato, ma un po' più lento e costoso.claude-sonnet-5-5è più veloce ed economico e basta per molti team. - Modello nella live chat (Modell im Live-Chat): solo se usate la live chat. Nella chat qualcuno sta aspettando, un modello più veloce o un impegno minore risponde prima.
- Forma di cortesia (Anrede): come l'agente si rivolge al team nelle note e ai clienti.
- Regole interne (Hausregeln): scrivete in frasi semplici chi si occupa di cosa, come vi rivolgete ai clienti e cosa non viene mai promesso. Su questo l'agente orienta assegnazioni e bozze.
C6 – Impostare i limiti e salvare
In Limiti (Grenzen) stabilite quanto lavora e spende al massimo l'agente:
- Esecuzioni all'ora (Durchläufe pro Stunde): protegge da picchi anomali, ad esempio durante un'ondata di spam.
- USD al giorno (USD pro Tag): il budget giornaliero. Quando è esaurito, l'agente si mette in pausa fino al giorno successivo.
- Esecuzioni per ticket al giorno (Durchläufe pro Ticket und Tag) e Chiamate di strumenti per esecuzione (Werkzeugaufrufe pro Durchlauf): impediscono che l'agente si incagli su un ticket.
Cliccate poi in fondo su Salva (Speichern). ✅
C7 – Osservare la modalità prova
Lasciate girare l'agente in prova per alcuni giorni. A ogni nuovo messaggio dei clienti decide cosa farebbe, ma non scrive nulla.
- Aprite Gestione → Connessioni IA → Registro (Verwalten → KI-Verbindungen → Protokoll) e lì la scheda Esecuzioni dell'agente (Durchläufe des Agenten).
- Lì vedete per ogni messaggio cosa avrebbe fatto l'agente: il testo completo di nota e bozza, l'assegnazione e i costi.
- Se qualcosa non va, integrate le regole interne (C5).
- Quando siete soddisfatti, togliete in C4 la spunta da Modalità prova e salvate. Da questo momento l'agente lavora davvero.
C8 – L'arresto di emergenza
In cima alla pagina Agente (Agent) si trova l'arresto di emergenza (Notaus). Un clic su Ferma agente (Agent stoppen) ferma subito l'agente, tutti i suoi accessi vengono bloccati. Con Riattiva agente (Agent freigeben) riparte.
C9 – Lavorare con l'agente
Quando l'agente è in funzione, lavora da solo. Inoltre potete dargli degli incarichi:
- Con una nota nel ticket: scrivete una nota interna che inizia con il suo nome o lo menziona, ad esempio «@James, controlla di nuovo il prezzo e riscrivi la bozza». Lui se ne occupa e risponde con una nota.
- Nel menu «IA»: in alto in FreeScout c'è la voce di menu IA (KI). Lì date all'agente incarichi come in una chat, ad esempio «Quali clienti aspettano da più di cinque giorni?». Gli incarichi si possono anche ripetere, ad esempio come rapporto settimanale.
- Approvazioni: se l'agente vuole fare qualcosa che richiede un'approvazione, questo appare in Approvazioni IA (KI-Freigaben) e nella conversazione. Una persona clicca su Approva (Freigeben) o Respingi (Ablehnen).
Tutto ciò che l'agente sa fare in più – rispondere in modo autonomo dalle vostre fonti, aiutare nella live chat, registrare richiami, curare articoli FAQ, lavorare con altri moduli – lo spiega la guida utente di McpConnect nella sezione «Der KI-Agent» (l'agente IA).
Via 2 completata! ✅
Parte D – Controllare o terminare le connessioni
D1 – Via 1: vedere le vostre connessioni in FreeScout
- In FreeScout cliccate in alto a destra sul vostro nome e poi su Il tuo profilo (Ihr Profil).
- Cliccate a sinistra su Connessioni IA (KI-Verbindungen).
Vedete ogni connessione con data di creazione, ultimo utilizzo, le autorizzazioni (Berechtigungen) concesse, le caselle (Postfächer) e se la pseudonimizzazione (Pseudonymisierung) è attiva.
D2 – Via 1: terminare una connessione
- In FreeScout: cliccate accanto alla connessione su Revoca (Widerrufen) e confermate. Da quel momento Claude non ha più accesso.
- In Claude: aprite Customize (Anpassungen) → Connectors (Konnektoren), cliccate sui tre puntini accanto al connector e poi su «Entfernen» (rimuovi).
La cosa più sicura è fare entrambe le cose.
D3 – Via 1: consentire di più o di meno
Le autorizzazioni di una connessione esistente non si possono modificare in seguito. Procedete così:
- Revocate la connessione in FreeScout (D2).
- Ricollegate il connector in Claude, oppure rimuovetelo e createlo di nuovo come nella parte B.
- Nella finestra di consenso mettete le spunte desiderate.
D4 – Via 2: mettere in pausa o terminare l'agente
- Fermare subito: Ferma agente (C8).
- Solo non elaborare più i nuovi messaggi dei clienti: in C4 togliere la spunta da Elabora ogni nuovo messaggio del cliente. Gli incarichi nel menu «IA» continuano a funzionare.
- Cambiare i diritti: cliccare accanto al client di servizio su Modifica (Bearbeiten) (C3).
- Terminare del tutto: disattivare il client di servizio (Disattiva, Sperren), rimuovere la chiave API in C4 ed eliminarla inoltre su platform.claude.com in «Organisationseinstellungen» (impostazioni dell'organizzazione) → API keys (API-Schlüssel).
Parte E – Se qualcosa non funziona
Via 1 – Claude Desktop e claude.ai
| Cosa vedete | Cosa significa | Cosa aiuta |
|---|---|---|
| «Questo client IA non è registrato o è stato disattivato.» («Dieser KI-Client ist nicht registriert oder gesperrt.») | FreeScout non conosce Claude. | Amministratore: controllare B1 – c'è claude.ai nel campo «Documenti di metadati dell'ID client»? In Claude è stato scelto Use Claude's published identity (Claudes veröffentlichte Identität verwenden)? |
| «Non è stato possibile verificare questo client IA (…)» («Dieser KI-Client liess sich nicht bestätigen (…)») | FreeScout non è riuscito a recuperare i dati di Claude da claude.ai. | Amministratore: autocontrollo, riga «Ausgehende Anfragen» (richieste in uscita). Il server deve poter stabilire connessioni verso Internet. |
| «Questa installazione FreeScout non è raggiungibile via HTTPS.» («Diese FreeScout-Installation ist nicht über HTTPS erreichbar.») | L'indirizzo inizia con http:// invece di https://. | Amministratore o hoster: configurare un certificato HTTPS (ad esempio Let's Encrypt). |
| «Il tuo ruolo non può collegare client IA.» («Ihre Rolle darf keine KI-Clients verbinden.») | Il vostro ruolo non è abilitato. | Amministratore: B1, campo «Chi può collegare client IA». |
| Claude segnala che non raggiunge il server, oppure in «Authentifizierung» (autenticazione) manca «Erkannt» (rilevato) | Claude non riesce ad arrivare al vostro FreeScout. | Controllare l'indirizzo (https:// all'inizio, /mcp alla fine, nessuno spazio). FreeScout deve essere raggiungibile da Internet, non solo nella rete aziendale. Autocontrollo: la riga «Metadaten» (metadati) deve essere verde. |
| Dopo «Consenti l'accesso» non succede nulla | Riguardava versioni precedenti di McpConnect in Safari. | Aggiornare McpConnect nel LaStore o usare un altro browser. |
| «Questa richiesta è scaduta.» («Diese Anfrage ist abgelaufen.») | Tra l'avvio in Claude e il clic è passato troppo tempo. | In Claude collegare di nuovo il connector e completare rapidamente. |
| Claude aveva accesso, ora non più | La connessione è stata terminata, ad esempio perché avete cambiato la password di FreeScout, perché è stata revocata o perché è arrivato un accesso da un indirizzo non consentito. | In Claude ricollegare il connector e dare il consenso. Se avete inserito indirizzi IP, eliminateli (B5, punto 5). |
| Volete cambiare l'indirizzo del connector | Claude non consente la modifica. | Rimuovere il connector in Claude e crearlo di nuovo. |
Via 2 – Agente in FreeScout
| Cosa vedete | Cosa significa | Cosa aiuta |
|---|---|---|
| L'agente non fa nulla | È spento, fermato, oppure il pianificatore non gira. | Controllare nella pagina «Agente»: accanto all'esecuzione c'è scritto «in corso» (läuft)? L'arresto di emergenza è disattivato? Autocontrollo: riga «Cron» verde? |
| Non scrive note né bozze | La modalità prova è ancora attiva. | In «Registro → Esecuzioni dell'agente» vedere cosa avrebbe fatto; disattivare la modalità prova in C4. |
| «L’interfaccia IA ha rifiutato la richiesta (…)» («Die KI-Schnittstelle hat die Anfrage abgelehnt (…)») | Anthropic ha respinto la chiamata, ad esempio perché il credito è esaurito, il limite di spesa è raggiunto o la chiave non è valida. | Su platform.claude.com controllare credito e limite; se necessario creare una nuova chiave (C1) e incollarla in C4. |
| Si mette in pausa fino a domani | Il budget giornaliero in FreeScout è esaurito. | Aumentare il budget in C6 o attendere il giorno successivo. |
| Assegna in modo sbagliato o scrive con il tono sbagliato | Le regole interne sono troppo imprecise. | Integrare le regole interne (C5) con frasi semplici e chiare. |
| Non reagisce alla mia nota | La nota non si rivolge a lui. | Iniziare la nota con il suo nome o menzionarlo con «@». |
Se non riuscite ad andare avanti, inviate alla vostra amministratrice o al vostro amministratore uno screenshot del messaggio. In Gestione → Connessioni IA → Registro (Verwalten → KI-Verbindungen → Protokoll) è registrato ogni tentativo di connessione e ogni esecuzione dell'agente con il motivo. Lì di solito si capisce rapidamente qual è il problema.
La sicurezza in breve
- Ogni connessione ha un proprietario. Nella via 1 Claude lavora con i vostri diritti, nella via 2 con i diritti dell'account di servizio – mai con di più.
- I diritti di scrittura non sono mai preselezionati, tranne che nella dotazione di base dell'agente, che vedete in C3.
- Le azioni delicate richiedono l'approvazione di una persona; l'eliminazione definitiva non è affatto possibile.
- I dati personali possono essere pseudonimizzati prima di lasciare FreeScout.
- Ogni nuova connessione viene segnalata da FreeScout per e-mail, ogni azione è registrata nel registro.
- Basta un clic per terminare una connessione o fermare l'agente.
- Collegate solo se l'avete avviato voi. Se qualcuno vi chiede per e-mail o per telefono di «consentire rapidamente qualcosa», cliccate su Annulla e segnalatelo alla vostra amministratrice o al vostro amministratore.