McpConnect · Guida · Deutsch | English | Français | Italiano

Collegare Claude a FreeScout

Due vie, spiegate passo dopo passo – anche senza conoscenze tecniche

ℹ️ Buono a sapersi

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:

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 personaleVia 2: agente in FreeScout
Dove lavorate?in Claude Desktop o su claude.aiin FreeScout
Quando lavora Claude?solo su vostra domanda24 ore su 24, a ogni nuovo messaggio e su incarico
A nome di chi?a vostro nome, con i vostri diritticome 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
Costiinclusi nell'abbonamento Claudein base al consumo, direttamente presso Anthropic; di solito alcuni centesimi per esecuzione
Può rispondere da solo ai clienti?no – solo bozze, che inviate voisì, se lo permettete: solo risposte verificate dalle vostre fonti, con un ritardo per poterle fermare
Live chatnosì
Configurazionecirca 5 minuti per personacirca 30 minuti, più alcuni giorni di modalità prova

Vantaggi e svantaggi

Via 1 – Assistente personale

Via 2 – Agente in 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».

💡 Suggerimento

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

PartePer quale via?Chi se ne occupa?
Parte A – Preparare FreeScoutentrambeamministratore, una volta
Parte B – Via 1: Claude Desktop e claude.aivia 1amministratore (B1), poi ogni persona
Parte C – Via 2: Claude come agentevia 2amministratore
Parte D – Controllare o terminare le connessionientrambeogni persona o l'amministratore
Parte E – Se qualcosa non funzionaentrambetutti

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.

TermineSignificato
ConnectorVia 1: un collegamento tra Claude e un altro programma, qui FreeScout. In Claude il menu si chiama Connectors (Konnektoren).
Server MCPIl punto del vostro FreeScout con cui Claude comunica. Il suo indirizzo Internet termina con /mcp.
Finestra di consensoVia 1: la pagina in FreeScout in cui stabilite cosa può fare Claude.
Chiave APIVia 2: una lunga password con cui FreeScout usa Claude per conto della vostra azienda. Consuma credito presso Anthropic.
Account di servizioVia 2: l'utente FreeScout con cui lavora l'agente, ad es. «James».
Client di servizioVia 2: stabilisce cosa può fare l'agente: autorizzazioni, caselle, indirizzi consentiti.
Modalità provaVia 2: l'agente lavora in prova, ma non scrive nulla. Vedete cosa avrebbe fatto.
Revocareterminare 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.

⚠️ Importante

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»

  1. Accedete a FreeScout come amministratore.
  2. Cliccate in alto nella barra blu su Gestione (Verwalten).
  3. Cliccate nell'elenco su Connessioni IA (KI-Verbindungen).
Nel menu «Gestione» (Verwalten) trovate la voce «Connessioni IA» (KI-Verbindungen). Le altre voci possono essere diverse da voi – a seconda dei moduli installati.
Figura 1 Nel menu «Gestione» (Verwalten) trovate la voce «Connessioni IA» (KI-Verbindungen). Le altre voci possono essere diverse da voi – a seconda dei moduli installati.

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.

  1. Cliccate a sinistra su Autocontrollo (Selbstprüfung).
  2. Cliccate su Controlla ora (Jetzt prüfen).
  3. Attendete qualche secondo finché appare l'elenco.
L'autocontrollo si avvia con «Controlla ora» (Jetzt prüfen).
Figura 2 L'autocontrollo si avvia con «Controlla ora» (Jetzt prüfen).

Ecco come leggere il risultato:

ColoreSignificatoCosa fare?
🟢 verdetutto a postoniente
🟡 giallofunziona, ma non in modo idealeleggere l'indicazione; di solito la connessione funziona comunque
🔴 rossocosì la connessione non funzionacorreggere prima – la riga dice come
⚪ grigionon è stato possibile verificarlo dall'internonessun errore, ma nemmeno una conferma
💡 Suggerimento

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:

Per iniziare non dovete cambiare nulla qui. ✅

Parte B – Via 1: Claude Desktop e claude.ai

Cosa vi serve per la via 1

B1 – Ammettere Claude e comunicare l'indirizzo (amministratore, una volta)

Ammettere Claude:

  1. In Gestione → Connessioni IA (Verwalten → KI-Verbindungen) cliccate a sinistra su Impostazioni (Einstellungen).
  2. Cercate il campo Documenti di metadati dell'ID client (Client-ID-Metadaten-Dokumente) e scrivete: claude.ai
  3. 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.
  4. Scorrete fino in fondo e cliccate su Salva (Speichern).
Nel campo «Documenti di metadati dell'ID client» (Client-ID-Metadaten-Dokumente) va «claude.ai». Sopra stabilite chi può collegarsi.
Figura 3 Nel campo «Documenti di metadati dell'ID client» (Client-ID-Metadaten-Dokumente) va «claude.ai». Sopra stabilite chi può collegarsi.
ℹ️ Buono a sapersi

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:

  1. Cliccate a sinistra su Client (Clients).
  2. 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.
  3. Selezionate l'indirizzo e copiatelo (Mac: ⌘ + C, Windows: Ctrl + C).
  4. Inoltratelo a tutte le persone che vogliono collegare Claude, ad esempio per e-mail.
L'indirizzo del server MCP si trova in alto nella pagina «Client» (Clients).
Figura 4 L'indirizzo del server MCP si trova in alto nella pagina «Client» (Clients).

B2 – Creare il connector in Claude (Free, Pro, Max)

Avete un account Team o Enterprise della vostra azienda? Allora continuate con B3.

ℹ️ Buono a sapersi

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.

  1. Aprite claude.ai nel browser e accedete.
  2. Cliccate a sinistra su Customize (Anpassungen) e in alto sulla scheda Connectors (Konnektoren).
In «Customize» (Anpassungen) trovate la scheda «Connectors» (Konnektoren).
Figura 5 In «Customize» (Anpassungen) trovate la scheda «Connectors» (Konnektoren).
  1. Cliccate a destra su Add (Hinzufügen) e poi su Add custom connector (Benutzerdefinierten Connector hinzufügen).
«Add» (Hinzufügen) apre un piccolo menu con «Add custom connector» (Benutzerdefinierten Connector hinzufügen).
Figura 6 «Add» (Hinzufügen) apre un piccolo menu con «Add custom connector» (Benutzerdefinierten Connector hinzufügen).
  1. 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 con https:// e termini con /mcp, senza spazi.
  2. Cliccate su Continue (Weiter).
Inserite nome e indirizzo, poi «Continue» (Weiter).
Figura 7 Inserite nome e indirizzo, poi «Continue» (Weiter).
  1. 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)
  2. Non cambiate nulla e cliccate su Add.
  3. 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).
Le impostazioni di accesso le riconosce Claude da solo. «Jetzt anmelden» (accedi ora) e «Use Claude's published identity» (Claudes veröffentlichte Identität verwenden) sono corretti – basta cliccare «Add» (Hinzufügen).
Figura 8 Le impostazioni di accesso le riconosce Claude da solo. «Jetzt anmelden» (accedi ora) e «Use Claude's published identity» (Claudes veröffentlichte Identität verwenden) sono corretti – basta cliccare «Add» (Hinzufügen).
⚠️ Importante

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:

  1. Owner: nelle «Organisationseinstellungen» (impostazioni dell'organizzazione) aprire la sezione Connectors (Konnektoren) → Add (Hinzufügen) → «Benutzerdefiniert» (personalizzato) → scegliere «Web».
  2. Owner: inserire il nome FreeScout e 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é:

  1. Aprite Customize (Anpassungen) → Connectors.
  2. Cercate FreeScout nell'elenco. Di solito la voce porta il contrassegno «Benutzerdefiniert» (personalizzato).
  3. Cliccate su Connect (Verbinden).

B4 – Accedere a FreeScout

Dopo il clic Claude apre una nuova finestra o una nuova scheda con il vostro FreeScout.

La solita pagina di accesso del vostro FreeScout. Qui vanno i vostri dati di accesso a FreeScout – non quelli di Claude.
Figura 9 La solita pagina di accesso del vostro FreeScout. Qui vanno i vostri dati di accesso a FreeScout – non quelli di Claude.
💡 Suggerimento

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.

La finestra di consenso. In alto c'è scritto chi fa la richiesta e con quale account avete effettuato l'accesso. In fondo consentite l'accesso.
Figura 10 La finestra di consenso. In alto c'è scritto chi fa la richiesta e con quale account avete effettuato l'accesso. In fondo consentite l'accesso.

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.

💡 Suggerimento

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.

⚠️ Importante

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

  1. 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.
  2. 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).
Connesso: in alto «Disconnect» (Trennen), sotto le «Tool-Berechtigungen» (autorizzazioni degli strumenti). Di fabbrica tutto è su «Genehmigung erforderlich» (approvazione richiesta) – Claude quindi chiede prima di ogni passo.
Figura 11 Connesso: in alto «Disconnect» (Trennen), sotto le «Tool-Berechtigungen» (autorizzazioni degli strumenti). Di fabbrica tutto è su «Genehmigung erforderlich» (approvazione richiesta) – Claude quindi chiede prima di ogni passo.

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'è.

ℹ️ Buono a sapersi

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:

  1. Avviate in Claude una nuova chat.
  2. Cliccate in basso a sinistra nel campo di inserimento su +.
  3. Passate con il mouse su Connectors (Konnektoren). Accanto si apre un elenco.
  4. Attivate lì FreeScout (l'interruttore diventa blu).
«+» → «Connectors» (Konnektoren) → interruttore accanto a «FreeScout». Se è blu, Claude può accedere a FreeScout in questa chat.
Figura 12 «+» → «Connectors» (Konnektoren) → interruttore accanto a «FreeScout». Se è blu, Claude può accedere a FreeScout in questa chat.

Fare domande. Scrivete normalmente, ad esempio:

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:

💡 Suggerimento

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.

La richiesta di conferma prima di uno strumento di FreeScout.
Figura 13 La richiesta di conferma prima di uno strumento di FreeScout.

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.

Claude risponde con i dati di FreeScout. Gli indirizzi e-mail sono resi illeggibili nell'immagine.
Figura 14 Claude risponde con i dati di FreeScout. Gli indirizzi e-mail sono resi illeggibili nell'immagine.

Cosa Claude non può fare con questa via:

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

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.

ℹ️ Buono a sapersi

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.

  1. Aprite platform.claude.com e accedete. Se non avete ancora un account, createne uno (azienda, nome, e-mail).

Credito

  1. Nelle impostazioni, in «Organisationseinstellungen» (impostazioni dell'organizzazione), aprite la voce Billing (Abrechnung).
  2. 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.
«Billing» (Abrechnung): a sinistra il credito, accanto «Buy credits» (Credits kaufen) e «Automatisches Aufladen verwalten» (gestisci la ricarica automatica). Gli importi sono resi illeggibili nell'immagine.
Figura 15 «Billing» (Abrechnung): a sinistra il credito, accanto «Buy credits» (Credits kaufen) e «Automatisches Aufladen verwalten» (gestisci la ricarica automatica). Gli importi sono resi illeggibili nell'immagine.
💡 Suggerimento

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

  1. In «Organisationseinstellungen» (impostazioni dell'organizzazione) aprite la voce Workspaces (Arbeitsbereiche) e cliccate su Create workspace (Workspace erstellen). Chiamatelo ad esempio FreeScout e confermate.
  2. Cliccate nell'elenco sul nuovo Workspace. A destra si apre una panoramica.
  3. 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.
La panoramica del Workspace. In «Spend limits» (Ausgabenlimits) vedete quanto è stato consumato questo mese e dove si trova il limite (valori di esempio).
Figura 16 La panoramica del Workspace. In «Spend limits» (Ausgabenlimits) vedete quanto è stato consumato questo mese e dove si trova il limite (valori di esempio).

Creare la chiave

  1. In «Organisationseinstellungen» (impostazioni dell'organizzazione) aprite la voce API keys (API-Schlüssel) e cliccate su Create key (Schlüssel erstellen).
  2. 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).
Questa finestra la saltate con «Mit einem API-Schlüssel fortfahren» (continua con una chiave API).
Figura 17 Questa finestra la saltate con «Mit einem API-Schlüssel fortfahren» (continua con una chiave API).
  1. 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.
  2. Cliccate su Create key (Schlüssel erstellen).
Importanti sono «Expires: Never» (Läuft ab: Nie) e lo «Scope» (Geltungsbereich) giusto.
Figura 18 Importanti sono «Expires: Never» (Läuft ab: Nie) e lo «Scope» (Geltungsbereich) giusto.
  1. 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.
⚠️ Importante

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.

  1. In FreeScout cliccate su Gestione → Utenti (Verwalten → Benutzer) e poi su Nuovo utente (Neuer Benutzer).
  2. 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
  3. Togliete la spunta da Invia email di invito (Einladungs-E-Mail senden). L'agente non accede mai da sé.
  4. Cliccate su Crea utente (Benutzer erstellen).
Un utente proprio per l'agente, con il ruolo «Utente» (Benutzer) e solo le caselle che deve gestire.
Figura 19 Un utente proprio per l'agente, con il ruolo «Utente» (Benutzer) e solo le caselle che deve gestire.
💡 Suggerimento

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.

  1. In Gestione → Connessioni IA (Verwalten → KI-Verbindungen) cliccate a sinistra su Agente (Agent).
  2. Scorrete fino a Client di servizio (Dienst-Clients) e cliccate su Nuovo client di servizio (Neuer Dienst-Client).
  3. 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).
  4. Cliccate su Crea client di servizio (Dienst-Client anlegen).
Il client di servizio stabilisce cosa può fare l'agente. La preselezione va bene per l'avvio.
Figura 20 Il client di servizio stabilisce cosa può fare l'agente. La preselezione va bene per l'avvio.

Il nuovo client di servizio appare nell'elenco.

Il client di servizio nell'elenco. «Nuovo segreto» (Neues Geheimnis) non vi serve per l'agente in FreeScout.
Figura 21 Il client di servizio nell'elenco. «Nuovo segreto» (Neues Geheimnis) non vi serve per l'agente in FreeScout.

C4 – Configurare l'agente e avviarlo in modalità prova

In alto nella stessa pagina, nella sezione Esecuzione (Läufer):

  1. Spuntate Elabora ogni nuovo messaggio del cliente (Jede neue Kundennachricht bearbeiten).
  2. Spuntate Modalità prova (Probebetrieb). Importante per iniziare: l'agente lavora allora in prova, ma non scrive nulla in FreeScout.
  3. In Client di servizio (Dienst-Client) scegliete il client da C3.
  4. In Chiave API Anthropic (Anthropic-API-Schlüssel) incollate la chiave da C1 (Mac: ⌘ + V, Windows: Ctrl + V).
Attivare l'esecuzione con la modalità prova, scegliere il client di servizio e incollare la chiave API.
Figura 22 Attivare l'esecuzione con la modalità prova, scegliere il client di servizio e incollare la chiave API.

C5 – Modello, forma di cortesia e regole interne

Subito sotto:

Modello, forma di cortesia e regole interne. Le regole interne sono frasi semplici – non dovete programmare nulla.
Figura 23 Modello, forma di cortesia e regole interne. Le regole interne sono frasi semplici – non dovete programmare nulla.

C6 – Impostare i limiti e salvare

In Limiti (Grenzen) stabilite quanto lavora e spende al massimo l'agente:

I limiti per esecuzioni e costi. Il budget giornaliero è il più importante.
Figura 24 I limiti per esecuzioni e costi. Il budget giornaliero è il più importante.

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.

  1. Aprite Gestione → Connessioni IA → Registro (Verwalten → KI-Verbindungen → Protokoll) e lì la scheda Esecuzioni dell'agente (Durchläufe des Agenten).
  2. Lì vedete per ogni messaggio cosa avrebbe fatto l'agente: il testo completo di nota e bozza, l'assegnazione e i costi.
  3. Se qualcosa non va, integrate le regole interne (C5).
  4. 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.

L'arresto di emergenza ferma subito l'agente.
Figura 25 L'arresto di emergenza ferma subito l'agente.

C9 – Lavorare con l'agente

Quando l'agente è in funzione, lavora da solo. Inoltre potete dargli degli incarichi:

Nel menu «IA» (KI) date all'agente incarichi come in una chat – qui un rapporto settimanale ricorrente.
Figura 26 Nel menu «IA» (KI) date all'agente incarichi come in una chat – qui un rapporto settimanale ricorrente.
Un'azione dell'agente attende l'approvazione di una persona.
Figura 27 Un'azione dell'agente attende l'approvazione di una persona.
ℹ️ Buono a sapersi

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

  1. In FreeScout cliccate in alto a destra sul vostro nome e poi su Il tuo profilo (Ihr Profil).
  2. Cliccate a sinistra su Connessioni IA (KI-Verbindungen).
Nel vostro profilo trovate a sinistra la sezione «Connessioni IA» (KI-Verbindungen).
Figura 28 Nel vostro profilo trovate a sinistra la sezione «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.

La vostra connessione a Claude nel profilo. Con «Revoca» (Widerrufen) la terminate subito.
Figura 29 La vostra connessione a Claude nel profilo. Con «Revoca» (Widerrufen) la terminate subito.

D2 – Via 1: terminare una connessione

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ì:

  1. Revocate la connessione in FreeScout (D2).
  2. Ricollegate il connector in Claude, oppure rimuovetelo e createlo di nuovo come nella parte B.
  3. Nella finestra di consenso mettete le spunte desiderate.

D4 – Via 2: mettere in pausa o terminare l'agente

Parte E – Se qualcosa non funziona

Via 1 – Claude Desktop e claude.ai

Cosa vedeteCosa significaCosa 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 nullaRiguardava 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 connectorClaude non consente la modifica.Rimuovere il connector in Claude e crearlo di nuovo.

Via 2 – Agente in FreeScout

Cosa vedeteCosa significaCosa 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é bozzeLa 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 domaniIl budget giornaliero in FreeScout è esaurito.Aumentare il budget in C6 o attendere il giorno successivo.
Assegna in modo sbagliato o scrive con il tono sbagliatoLe regole interne sono troppo imprecise.Integrare le regole interne (C5) con frasi semplici e chiare.
Non reagisce alla mia notaLa nota non si rivolge a lui.Iniziare la nota con il suo nome o menzionarlo con «@».
ℹ️ Buono a sapersi

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