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

Connecter Claude à FreeScout

Deux méthodes, expliquées pas à pas – même sans connaissances techniques

ℹ️ Bon à savoir

Les captures d'écran montrent l'interface allemande. Pour chaque libellé, nous indiquons d'abord celui de votre langue en gras, puis entre parenthèses le libellé allemand de la capture. Pour claude.ai et la plateforme Claude, nous indiquons le libellé anglais, tel qu'il apparaît si votre Claude est réglé en anglais – sinon, il s'affiche dans votre langue.

Avec McpConnect, Claude, l'assistant IA d'Anthropic, travaille avec votre FreeScout. Il existe pour cela deux méthodes. Elles ne s'excluent pas : de nombreuses équipes utilisent les deux. Ce guide explique d'abord la différence, puis chaque méthode séparément.

Les deux méthodes en bref

Méthode 1 – Claude comme assistant personnel

Vous travaillez comme d'habitude dans Claude Desktop ou sur claude.ai et y connectez Claude à FreeScout. Ensuite, vous posez vos questions à Claude dans le chat, par exemple :

Claude travaille uniquement quand vous le lui demandez, et ce en votre nom, avec vos droits FreeScout. Chaque personne connecte son propre Claude.

Méthode 2 – Claude comme agent dans FreeScout

FreeScout reçoit son propre collègue IA, par exemple « James ». Il travaille de manière autonome en arrière-plan : il lit chaque nouveau message client, le résume dans une note, prépare des réponses, attribue les tickets selon vos règles et peut – si vous l'autorisez – envoyer lui-même des réponses sûres, y compris dans le chat en direct. En plus, il exécute les demandes de votre équipe dans le menu IA (KI).

L'agent travaille sous un utilisateur FreeScout dédié et se connecte via l'interface de programmation (API) d'Anthropic. Un administrateur le configure une seule fois pour tout le monde.

Comparaison en un coup d'œil

Méthode 1 : assistant personnelMéthode 2 : agent dans FreeScout
Où travaillez-vous ?dans Claude Desktop ou sur claude.aidans FreeScout
Quand Claude travaille-t-il ?uniquement quand vous le lui demandez24 heures sur 24, à chaque nouveau message et sur demande
Au nom de qui ?au vôtre, avec vos droitscomme utilisateur dédié, p. ex. « James »
Qui configure ?chaque personne elle-même (après une courte préparation par l'administrateur)un administrateur, une seule fois
De quoi a-t-on besoin ?un compte Claude (Free, Pro, Max, Team ou Enterprise)un compte sur la plateforme Claude d'Anthropic avec du crédit, et une clé d'API
Coûtsinclus dans l'abonnement Claudeselon la consommation, directement chez Anthropic ; en général quelques centimes par passage
Peut répondre lui-même aux clients ?non – uniquement des brouillons que vous envoyezoui, si vous l'autorisez : uniquement des réponses vérifiées tirées de vos sources, avec un délai pour pouvoir arrêter l'envoi
Chat en directnonoui
Mise en placeenviron 5 minutes par personneenviron 30 minutes, plus quelques jours en mode test

Avantages et inconvénients

Méthode 1 – assistant personnel

Méthode 2 – agent dans FreeScout

Quelle méthode vous convient ?

La méthode 1 convient si vous êtes une petite équipe, que chaque personne a de toute façon un abonnement Claude et que vous ne voulez pas de processus automatiques. Claude aide alors à la demande, et chaque personne garde elle-même le contrôle.

La méthode 2 convient si tout le monde n'a pas d'abonnement Claude ou si l'automatisation est prioritaire : les nouvelles demandes doivent être classées, préparées ou traitées automatiquement, y compris dans le chat en direct. Il suffit pour cela d'un seul compte Anthropic pour toute l'entreprise, et toute l'équipe en profite – même sans abonnement Claude personnel : via une note adressée à l'agent et, si vous l'ouvrez à tous, via le menu IA.

💡 Conseil

Les deux méthodes peuvent aussi être combinées : l'agent pour la routine en arrière-plan, Claude Desktop pour les personnes qui veulent en plus des analyses et des brouillons à la demande.

Structure de ce guide

PartiePour quelle méthode ?Qui s'en charge ?
Partie A – Préparer FreeScoutles deuxadministrateur, une fois
Partie B – Méthode 1 : Claude Desktop et claude.aiméthode 1administrateur (B1), puis chaque personne
Partie C – Méthode 2 : Claude comme agentméthode 2administrateur
Partie D – Vérifier ou mettre fin aux connexionsles deuxchaque personne ou l'administrateur
Partie E – En cas de problèmeles deuxtout le monde

Vous n'êtes pas administrateur et voulez seulement utiliser la méthode 1 ? Demandez à votre administratrice ou à votre administrateur si la partie A et l'étape B1 sont faites, demandez-lui l'adresse du serveur MCP et commencez à l'étape B2.

Quelques notions pour commencer

Vous n'avez pas besoin de connaître ces notions pour suivre le guide. Elles vous aideront toutefois si vous les rencontrez en chemin.

NotionSignification
ConnecteurMéthode 1 : une connexion entre Claude et un autre programme, ici FreeScout. Dans Claude, le menu s'appelle Connectors (Konnektoren).
Serveur MCPL'endroit de votre FreeScout avec lequel Claude communique. Son adresse Internet se termine par /mcp.
Dialogue de consentementMéthode 1 : la page de FreeScout où vous définissez ce que Claude a le droit de faire.
Clé d'APIMéthode 2 : un long mot de passe avec lequel FreeScout utilise Claude pour le compte de votre entreprise. Son utilisation consomme du crédit chez Anthropic.
Compte de serviceMéthode 2 : l'utilisateur FreeScout sous lequel l'agent travaille, p. ex. « James ».
Client de serviceMéthode 2 : définit ce que l'agent a le droit de faire : autorisations, boîtes, adresses autorisées.
Mode testMéthode 2 : l'agent travaille à titre d'essai, mais n'écrit rien. Vous voyez ce qu'il aurait fait.
Révoquermettre fin à une connexion. Claude perd immédiatement tout accès.

Partie A – Préparer FreeScout (les deux méthodes)

Cette partie est réalisée une seule fois par une personne disposant des droits d'administrateur dans FreeScout.

⚠️ Important

Votre FreeScout doit être accessible depuis Internet, via une adresse en https://. Avec les deux méthodes, Claude travaille sur les serveurs d'Anthropic et se connecte de là à votre FreeScout. Si FreeScout ne fonctionne que dans le réseau de l'entreprise ou derrière un VPN, la connexion échoue.

A1 – Ouvrir la section « Connexions IA »

  1. Connectez-vous à FreeScout en tant qu'administrateur.
  2. Dans la barre bleue en haut, cliquez sur Gérer (Verwalten).
  3. Dans la liste, cliquez sur Connexions IA (KI-Verbindungen).
Dans le menu « Gérer » (Verwalten), vous trouvez l'entrée « Connexions IA » (KI-Verbindungen). Les autres entrées peuvent être différentes chez vous – selon les modules installés.
Figure 1 Dans le menu « Gérer » (Verwalten), vous trouvez l'entrée « Connexions IA » (KI-Verbindungen). Les autres entrées peuvent être différentes chez vous – selon les modules installés.

À gauche apparaît maintenant une colonne avec les sections de McpConnect : Clients, Connexions (Verbindungen), Droits (Rechte), Agent, Connaissances (Wissen) et d'autres.

A2 – Lancer l'autocontrôle

L'autocontrôle vérifie si votre FreeScout est prêt, par exemple si HTTPS est configuré et si la connexion est correctement transmise.

  1. À gauche, cliquez sur Autocontrôle (Selbstprüfung).
  2. Cliquez sur Vérifier maintenant (Jetzt prüfen).
  3. Attendez quelques secondes que la liste s'affiche.
Vous lancez l'autocontrôle avec « Vérifier maintenant » (Jetzt prüfen).
Figure 2 Vous lancez l'autocontrôle avec « Vérifier maintenant » (Jetzt prüfen).

Voici comment lire le résultat :

CouleurSignificationQue faire ?
🟢 verten ordrerien
🟡 jaunefonctionne, mais pas idéalementlire la remarque ; la connexion fonctionne généralement quand même
🔴 rougela connexion ne fonctionnera pas ainsicorriger d'abord – la ligne indique comment
⚪ grisn'a pas pu être vérifié de l'intérieurpas une erreur, mais pas une confirmation non plus
💡 Conseil

Si la ligne metadata est rouge, c'est presque toujours parce qu'il manque une ligne dans le fichier .htaccess de votre FreeScout. L'autocontrôle affiche cette ligne. Transmettez-la à votre hébergeur ou à votre service informatique si vous n'avez pas vous-même accès aux fichiers. Pour la méthode 2, la ligne cron doit en outre être verte : l'agent est déclenché par le planificateur de FreeScout.

A3 – (Facultatif) Vérifier les droits

Sous Droits, vous voyez ce qu'une IA peut faire au maximum dans votre FreeScout. Cela vaut pour les deux méthodes, quoi que quelqu'un coche plus tard. Par défaut :

Pour commencer, vous n'avez rien à changer ici. ✅

Partie B – Méthode 1 : Claude Desktop et claude.ai

Ce dont vous avez besoin pour la méthode 1

B1 – Autoriser Claude et transmettre l'adresse (administrateur, une fois)

Autoriser Claude :

  1. Sous Gérer → Connexions IA, cliquez à gauche sur Paramètres (Einstellungen).
  2. Cherchez le champ Documents de métadonnées de l'ID client (Client-ID-Metadaten-Dokumente) et saisissez : claude.ai
  3. Juste au-dessus, sous Qui peut connecter des clients IA (Wer KI-Clients verbinden darf), vérifiez que les bons rôles sont cochés : Utilisateurs (Benutzer), Administrateurs (Administratoren) ou les deux.
  4. Faites défiler tout en bas et cliquez sur Enregistrer (Speichern).
Dans le champ « Documents de métadonnées de l'ID client » (Client-ID-Metadaten-Dokumente), saisissez « claude.ai ». Au-dessus, vous définissez qui a le droit de se connecter.
Figure 3 Dans le champ « Documents de métadonnées de l'ID client » (Client-ID-Metadaten-Dokumente), saisissez « claude.ai ». Au-dessus, vous définissez qui a le droit de se connecter.
ℹ️ Bon à savoir

Grâce à cette entrée, FreeScout reconnaît Claude à son identité publiée. Le dialogue de consentement affichera plus tard Identité confirmée par claude.ai (Identität bestätigt durch claude.ai). Ainsi, chaque personne sait que c'est vraiment Claude qui fait la demande, et non un programme inconnu.

Transmettre l'adresse :

  1. À gauche, cliquez sur Clients.
  2. Tout en haut figure Adresse du serveur MCP pour le client (Adresse des MCP-Servers für den Client), avec une adresse qui se termine par /mcp.
  3. Sélectionnez l'adresse et copiez-la (Mac : ⌘ + C, Windows : Ctrl + C).
  4. Transmettez-la à toutes les personnes qui veulent connecter Claude, par exemple par e-mail.
L'adresse du serveur MCP figure en haut de la page « Clients ».
Figure 4 L'adresse du serveur MCP figure en haut de la page « Clients ».

B2 – Créer le connecteur dans Claude (Free, Pro, Max)

Vous avez un compte Team ou Enterprise de votre entreprise ? Passez alors à B3.

ℹ️ Bon à savoir

Les captures d'écran montrent l'interface allemande de claude.ai. Claude affiche les libellés dans la langue que vous avez réglée. Nous indiquons ci-dessous les libellés anglais, par exemple Customize → Connectors → Add → Add custom connector, Continue, Use Claude's published identity et Connect, avec entre parenthèses le libellé allemand de la capture.

  1. Ouvrez claude.ai dans votre navigateur et connectez-vous.
  2. À gauche, cliquez sur Customize (Anpassungen), puis en haut sur l'onglet Connectors (Konnektoren).
Sous « Customize » (Anpassungen), vous trouvez l'onglet « Connectors » (Konnektoren).
Figure 5 Sous « Customize » (Anpassungen), vous trouvez l'onglet « Connectors » (Konnektoren).
  1. À droite, cliquez sur Add (Hinzufügen), puis sur Add custom connector (Benutzerdefinierten Connector hinzufügen).
« Add » (Hinzufügen) ouvre un petit menu avec « Add custom connector » (Benutzerdefinierten Connector hinzufügen).
Figure 6 « Add » (Hinzufügen) ouvre un petit menu avec « Add custom connector » (Benutzerdefinierten Connector hinzufügen).
  1. Remplissez la fenêtre :
    • Name (Name) : par exemple FreeScout. C'est ce nom que vous verrez ensuite dans Claude.
    • Remote MCP server URL (MCP-Server-URL) : l'adresse de B1, par exemple https://support.deine-firma.ch/mcp. Veillez à ce qu'elle commence par https:// et se termine par /mcp, sans espace.
  2. Cliquez sur Continue (Weiter).
Saisir le nom et l'adresse, puis « Continue » (Weiter).
Figure 7 Saisir le nom et l'adresse, puis « Continue » (Weiter).
  1. Claude vérifie l'adresse et affiche les paramètres de connexion. Ils sont déjà correctement présélectionnés :
    • pour « Authentifizierung » (authentification) : « Jetzt anmelden » (se connecter maintenant) – avec la mention « Erkannt » (détecté)
    • pour « OAuth-Client » (client OAuth) : Use Claude's published identity (Claudes veröffentlichte Identität verwenden) – avec la mention « Empfohlen » (recommandé)
  2. Ne changez rien et cliquez sur Add (Hinzufügen).
  3. Claude affiche maintenant la page du nouveau connecteur avec la mention « Du bist noch nicht mit FreeScout verbunden » (vous n'êtes pas encore connecté à FreeScout). Cliquez là sur Connect (Verbinden).
Claude détecte lui-même les paramètres de connexion. « Jetzt anmelden » (se connecter maintenant) et « Use Claude's published identity » sont corrects – cliquez simplement sur « Add ».
Figure 8 Claude détecte lui-même les paramètres de connexion. « Jetzt anmelden » (se connecter maintenant) et « Use Claude's published identity » sont corrects – cliquez simplement sur « Add ».
⚠️ Important

Ne choisissez pas « Automatisch registrieren » (enregistrement automatique) ni « Eigenen OAuth-Client verwenden » (utiliser votre propre client OAuth), sauf si votre administratrice ou votre administrateur vous le demande expressément. Ces deux options nécessitent une configuration supplémentaire dans FreeScout. Si « Erkannt » (détecté) n'apparaît pas sous « Authentifizierung », l'adresse est fausse ou FreeScout n'est pas accessible – voir la partie E.

Continuez avec B4.

B3 – Connecter le connecteur (Team, Enterprise)

Pour les comptes Team et Enterprise, une personne disposant des droits de propriétaire (Owner) crée le connecteur une seule fois pour toute l'organisation :

  1. Owner : dans les « Organisationseinstellungen » (paramètres de l'organisation), ouvrir la section Connectors → Add → « Benutzerdefiniert » (personnalisé) → choisir « Web ».
  2. Owner : saisir le nom FreeScout et l'adresse de B1 → Continue → laisser les paramètres de connexion présélectionnés (Use Claude's published identity) → Add.

Ensuite, chaque personne se connecte elle-même :

  1. Ouvrez Customize → Connectors.
  2. Cherchez FreeScout dans la liste. L'entrée porte généralement la mention « Benutzerdefiniert » (personnalisé).
  3. Cliquez sur Connect.

B4 – Se connecter à FreeScout

Après le clic, Claude ouvre une nouvelle fenêtre ou un nouvel onglet avec votre FreeScout.

La page de connexion habituelle de votre FreeScout. C'est ici qu'il faut saisir vos identifiants FreeScout – et non ceux de Claude.
Figure 9 La page de connexion habituelle de votre FreeScout. C'est ici qu'il faut saisir vos identifiants FreeScout – et non ceux de Claude.
💡 Conseil

Si aucune fenêtre ne s'ouvre, le navigateur l'a peut-être bloquée. Cherchez un avertissement dans la barre d'adresse (« Pop-up bloqué ») et autorisez les pop-ups pour claude.ai.

B5 – Définir dans le dialogue de consentement ce que Claude a le droit de faire

Voici l'étape la plus importante. FreeScout affiche la page Autoriser Claude à accéder à FreeScout ? (Darf Claude auf FreeScout zugreifen?). C'est ici que vous décidez ce que Claude a le droit de faire. Prenez un moment.

Le dialogue de consentement. Tout en haut figurent l'auteur de la demande et la manière dont vous êtes connecté. Tout en bas, vous autorisez l'accès.
Figure 10 Le dialogue de consentement. Tout en haut figurent l'auteur de la demande et la manière dont vous êtes connecté. Tout en bas, vous autorisez l'accès.

Parcourez la page de haut en bas :

1. Vérifier l'en-tête. On y lit Identité confirmée par claude.ai et Retour vers : claude.ai (Rückkehr zu: claude.ai). Si quelque chose d'autre y figure, ou si vous n'avez pas lancé la connexion vous-même, cliquez sur Annuler (Abbrechen).

2. Cocher les autorisations.

💡 Conseil

Pour commencer, les droits de lecture présélectionnés suffisent, plus « Créer des brouillons de réponse » si vous souhaitez des brouillons. Vous pourrez en autoriser davantage plus tard en reconnectant Claude (voir D3).

3. Choisir les boîtes. Par défaut, l'option Toutes les boîtes que je vois, y compris les futures (Alle Postfächer, die ich sehe, auch künftige) est active. Si vous ne voulez montrer à Claude que certaines boîtes, choisissez Uniquement ces boîtes : (Nur diese Postfächer:) et cochez-les.

4. Données personnelles. Si Pseudonymiser (Pseudonymisieren) est coché, Claude ne voit à la place des vrais noms, adresses, numéros de téléphone et adresses e-mail que des espaces réservés comme « Vorname.1 ». Laissez la case cochée en cas de doute. Si votre administratrice ou votre administrateur a activé la pseudonymisation de manière fixe, vous ne pouvez pas la décocher ici.

5. Adresses IP autorisées – laisser vide. Le champ Adresses IP autorisées (Erlaubte IP-Adressen) est prévu pour des cas particuliers.

⚠️ Important

Ne saisissez pas votre propre adresse sous « Adresses IP autorisées ». Claude n'accède pas depuis votre ordinateur, mais depuis les serveurs d'Anthropic. Avec votre propre adresse, FreeScout bloquerait Claude.

6. Autoriser l'accès. Tout en bas, cliquez sur Autoriser l'accès (Zugriff erlauben). La fenêtre se ferme ou revient à Claude.

B6 – Vérifier que tout a fonctionné

  1. Claude affiche brièvement « Mit FreeScout verbunden » (connecté à FreeScout). Sur la page du connecteur, en haut à droite, figure maintenant Disconnect (Trennen) au lieu de Connect, avec en dessous la liste des outils que Claude peut utiliser dans FreeScout.
  2. Vous recevez de FreeScout un e-mail avec l'objet Nouvelle connexion IA à votre compte FreeScout (Neue KI-Verbindung zu Ihrem FreeScout-Konto). C'est normal, il s'agit d'une mesure de sécurité : si vous n'avez pas établi la connexion vous-même, révoquez-la immédiatement (voir la partie D).
Connecté : en haut « Disconnect » (Trennen), en dessous les « Tool-Berechtigungen » (autorisations des outils). Par défaut, tout est réglé sur « Genehmigung erforderlich » (approbation requise) – Claude demande donc avant chaque étape.
Figure 11 Connecté : en haut « Disconnect » (Trennen), en dessous les « Tool-Berechtigungen » (autorisations des outils). Par défaut, tout est réglé sur « Genehmigung erforderlich » (approbation requise) – Claude demande donc avant chaque étape.

Les autorisations des outils (« Tool-Berechtigungen »). Pour chaque outil, il y a à droite trois petits symboles : la coche pour « Immer erlauben » (toujours autoriser), la main pour « Genehmigung erforderlich » (approbation requise) et le cercle barré pour « Blockiert » (bloqué). Avec le menu déroulant à côté d'un groupe, par exemple « Schreibgeschützte Tools » (outils en lecture seule, ce sont ceux qui lisent), vous changez tous les outils du groupe en une fois. Pour commencer, laissez tout tel quel.

ℹ️ Bon à savoir

Ce réglage ne vaut que dans Claude. Ce que Claude peut faire dans FreeScout, vous l'avez défini en B5 dans le dialogue de consentement. Un outil que vous n'y avez pas autorisé n'apparaît même pas dans cette liste.

B7 – Utiliser Claude au quotidien

Activer FreeScout dans le chat :

  1. Démarrez un nouveau chat dans Claude.
  2. En bas à gauche du champ de saisie, cliquez sur +.
  3. Passez la souris sur Connectors (Konnektoren). Une liste s'ouvre à côté.
  4. Activez-y FreeScout (l'interrupteur devient bleu).
« + » → « Connectors » (Konnektoren) → interrupteur à côté de « FreeScout ». S'il est bleu, Claude peut accéder à FreeScout dans ce chat.
Figure 12 « + » → « Connectors » (Konnektoren) → interrupteur à côté de « FreeScout ». S'il est bleu, Claude peut accéder à FreeScout dans ce chat.

Poser des questions. Écrivez tout à fait normalement, par exemple :

Claude demande la permission. Avant de consulter ou d'écrire quoi que ce soit dans FreeScout, Claude vous le demande, par exemple « Claude möchte List mailboxes von FreeScout verwenden » (Claude souhaite utiliser List mailboxes de FreeScout). Les noms des outils sont en anglais : « List mailboxes » signifie lister les boîtes, « Search conversations » rechercher des conversations, « Create reply draft » créer un brouillon de réponse. En dessous figurent trois boutons :

💡 Conseil

Vous pouvez sans crainte autoriser durablement les actions de lecture. Pour les actions d'écriture comme les notes ou les brouillons, « autoriser une fois » est le meilleur choix au début. Ainsi, vous voyez à chaque fois ce que Claude veut faire.

La demande de confirmation avant l'utilisation d'un outil de FreeScout.
Figure 13 La demande de confirmation avant l'utilisation d'un outil de FreeScout.

Une fois l'autorisation donnée, Claude récupère les informations dans FreeScout et répond dans le chat. En cliquant sur la ligne grise au-dessus de la réponse, vous voyez quels outils Claude a utilisés.

Claude répond avec les informations de FreeScout. Les adresses e-mail sont masquées sur l'image.
Figure 14 Claude répond avec les informations de FreeScout. Les adresses e-mail sont masquées sur l'image.

Ce que Claude ne peut pas faire avec cette méthode :

Claude Desktop. Si vous utilisez l'application Claude Desktop sur Mac ou Windows, vous n'avez rien à configurer en plus. L'application utilise le même compte Claude, le connecteur « FreeScout » y est automatiquement disponible. Activez-le dans le chat comme décrit ci-dessus.

La méthode 1 est terminée ! ✅

Partie C – Méthode 2 : Claude comme agent dans FreeScout

Cette partie est réalisée par un administrateur. Prévoyez environ 30 minutes, puis quelques jours en mode test.

Ce dont vous avez besoin pour la méthode 2

C1 – Créer une clé d'API chez Anthropic

Grâce à la clé d'API, FreeScout utilise Claude et paie avec votre crédit chez Anthropic. Avec un Workspace dédié et une limite de dépenses, vous vous assurez que l'agent ne dépense jamais plus que prévu.

ℹ️ Bon à savoir

Les captures d'écran montrent l'interface allemande de la plateforme Claude (« Claude Console »). La Console affiche les libellés dans la langue que vous avez réglée. Nous indiquons ci-dessous les libellés anglais, par exemple Billing, Workspaces, Spend limits, API keys et Create key, avec entre parenthèses le libellé allemand de la capture. Vous accédez aux paramètres via la roue dentée à gauche ou via votre nom en bas à gauche.

  1. Ouvrez platform.claude.com et connectez-vous. Si vous n'avez pas encore de compte, créez-en un (entreprise, nom, e-mail).

Crédit

  1. Dans les paramètres, sous « Organisationseinstellungen » (paramètres de l'organisation), ouvrez Billing (Abrechnung).
  2. Sous « Guthaben » (crédit), vous voyez combien d'argent se trouve sur le compte. S'il est vide, cliquez sur Buy credits (Credits kaufen) et achetez par exemple 20 USD. Avec « Automatisches Aufladen verwalten » (gérer la recharge automatique), vous pouvez faire en sorte que le crédit se recharge tout seul lorsqu'il devient bas. Ainsi, l'agent ne s'arrête pas subitement.
« Billing » (Abrechnung) : à gauche le crédit, à côté « Buy credits » (Credits kaufen) et « Automatisches Aufladen verwalten » (gérer la recharge automatique). Les montants sont masqués sur l'image.
Figure 15 « Billing » (Abrechnung) : à gauche le crédit, à côté « Buy credits » (Credits kaufen) et « Automatisches Aufladen verwalten » (gérer la recharge automatique). Les montants sont masqués sur l'image.
💡 Conseil

Si vous avez un abonnement Claude Team ou Max, il inclut chaque mois du crédit API. Une mention en haut de la page Billing l'indique. Pour commencer, vous n'avez alors souvent rien à acheter.

Workspace avec limite de dépenses

  1. Sous « Organisationseinstellungen », ouvrez Workspaces (Arbeitsbereiche) et cliquez sur Create workspace (Workspace erstellen). Nommez-le par exemple FreeScout et confirmez.
  2. Dans la liste, cliquez sur le nouveau Workspace. Une vue d'ensemble s'ouvre à droite.
  3. Cliquez-y sur Spend limits (Ausgabenlimits) et fixez une limite mensuelle, par exemple 30 USD. Une fois celle-ci atteinte, Anthropic bloque les requêtes jusqu'au mois suivant.
La vue d'ensemble du Workspace. Sous « Spend limits » (Ausgabenlimits), vous voyez combien a été consommé ce mois-ci et où se situe la limite (valeurs d'exemple).
Figure 16 La vue d'ensemble du Workspace. Sous « Spend limits » (Ausgabenlimits), vous voyez combien a été consommé ce mois-ci et où se situe la limite (valeurs d'exemple).

Créer la clé

  1. Sous « Organisationseinstellungen », ouvrez API keys (API-Schlüssel) et cliquez sur Create key (Schlüssel erstellen).
  2. Une fenêtre « Mit Identitätsföderation brauchst du keinen API-Schlüssel » (avec la fédération d'identité, vous n'avez pas besoin de clé d'API) apparaît d'abord. Elle est prévue pour les grands environnements informatiques et ne convient pas à FreeScout. Cliquez en bas sur « Mit einem API-Schlüssel fortfahren » (continuer avec une clé d'API).
Vous passez cette fenêtre avec « Mit einem API-Schlüssel fortfahren » (continuer avec une clé d'API).
Figure 17 Vous passez cette fenêtre avec « Mit einem API-Schlüssel fortfahren » (continuer avec une clé d'API).
  1. Remplissez la fenêtre « API-Schlüssel erstellen » (créer une clé d'API) :
    • Name (Name) : par exemple FreeScout Agent.
    • Expires (Läuft ab) : choisissez Never (Nie). Par défaut, « 30 Tage » (30 jours) est sélectionné – l'agent cesse alors de fonctionner au bout d'un mois, sans avertissement. L'avertissement jaune qui apparaît avec Never est normal : c'est pourquoi vous conservez la clé avec soin (étape 11).
    • « Verknüpftes Konto » (compte associé) : laissez votre propre nom. Tenez compte de la remarque en dessous : si vous quittez l'entreprise et que votre accès à la plateforme est supprimé, la clé est également désactivée. Il faudra alors une nouvelle clé.
    • Scope (Geltungsbereich) : choisissez le Workspace de l'étape 4, donc FreeScout. La limite de dépenses s'applique alors aussi à cette clé.
  2. Cliquez sur Create key (Schlüssel erstellen).
L'important : « Expires: Never » (Läuft ab: Nie) et le bon « Scope » (Geltungsbereich).
Figure 18 L'important : « Expires: Never » (Läuft ab: Nie) et le bon « Scope » (Geltungsbereich).
  1. Copiez la clé immédiatement. Elle commence par sk-ant- et n'est affichée que cette seule fois. Conservez-la en lieu sûr jusqu'à l'étape C4, par exemple dans votre gestionnaire de mots de passe – ni dans un e-mail, ni dans un chat.
⚠️ Important

La clé d'API est comme un mot de passe pour votre crédit. Ne la communiquez à personne. Dans FreeScout, elle est enregistrée chiffrée et n'est plus jamais affichée. Si vous l'avez perdue, supprimez-la sur la plateforme et créez-en une nouvelle.

C2 – Créer un compte de service pour l'agent

L'agent travaille comme un utilisateur FreeScout à part entière. Son nom figure sur chaque note et chaque brouillon qu'il écrit.

  1. Dans FreeScout, cliquez sur Gérer → Utilisateurs (Benutzer), puis sur Nouvel utilisateur (Neuer Benutzer).
  2. Remplissez :
    • Rôle (Rolle) : Utilisateur (Benutzer) (pas administrateur)
    • Prénom (Vorname) : le nom de l'agent, par exemple James
    • Nom de famille (Nachname) : par exemple IA, pour que tout le monde voie qu'une IA écrit ici (dans l'image : « KI », l'abréviation allemande)
    • Email (E-Mail) : l'adresse de l'agent, par exemple james@deine-firma.ch
    • Boîtes de réception (Postfächer) : uniquement celles que l'agent doit traiter
  3. Décochez Envoyer un e-mail d'invitation (Einladungs-E-Mail senden). L'agent ne se connecte jamais lui-même.
  4. Cliquez sur Créer un utilisateur (Benutzer erstellen).
Un utilisateur dédié pour l'agent, avec le rôle « Utilisateur » (Benutzer) et uniquement les boîtes qu'il doit traiter.
Figure 19 Un utilisateur dédié pour l'agent, avec le rôle « Utilisateur » (Benutzer) et uniquement les boîtes qu'il doit traiter.
💡 Conseil

Donnez au compte de service une Image de profil (Profilbild). Elle apparaît dans le menu IA à côté de chaque réponse de l'agent. Et dans son profil, sous Notifications (Benachrichtigungen), désactivez toutes les notifications par e-mail, sinon FreeScout envoie des e-mails à une adresse que personne ne lit.

C3 – Créer le client de service

Le client de service définit ce que l'agent a le droit de faire.

  1. Sous Gérer → Connexions IA, cliquez à gauche sur Agent.
  2. Faites défiler jusqu'à Clients de service (Dienst-Clients) et cliquez sur Nouveau client de service (Neuer Dienst-Client).
  3. Remplissez la fenêtre :
    • Nom (Name) : par exemple James
    • Compte de service (Dienstkonto) : l'utilisateur créé en C2
    • Autorisations (Berechtigungen) : ce dont l'agent a besoin pour commencer est présélectionné : lire, notes, brouillons, statut et proposer comme spam. Laissez cela tel quel pour démarrer. D'autres droits, par exemple « Répondre aux questions avec ses propres mots » (Fragen in eigenen Worten beantworten) ou les droits d'autres modules, peuvent être ajoutés plus tard.
    • Boîtes (Postfächer) : « Toutes celles que voit le compte de service » (Alle, die das Dienstkonto sieht) – vous avez déjà fait la sélection en C2.
    • Adresses IP autorisées : laisser tel quel. Les adresses depuis lesquelles Claude travaille chez Anthropic sont déjà saisies.
    • Données personnelles (Personendaten) : laisser Pseudonymiser coché.
  4. Cliquez sur Créer le client de service (Dienst-Client anlegen).
Le client de service définit ce que l'agent a le droit de faire. La présélection convient pour démarrer.
Figure 20 Le client de service définit ce que l'agent a le droit de faire. La présélection convient pour démarrer.

Le nouveau client de service apparaît dans la liste.

Le client de service dans la liste. Vous n'avez pas besoin de « Nouveau secret » (Neues Geheimnis) pour l'agent dans FreeScout.
Figure 21 Le client de service dans la liste. Vous n'avez pas besoin de « Nouveau secret » (Neues Geheimnis) pour l'agent dans FreeScout.

C4 – Configurer l'agent et le démarrer en mode test

En haut de la même page, dans la section Exécution (Läufer) :

  1. Cochez Traiter chaque nouveau message client (Jede neue Kundennachricht bearbeiten).
  2. Cochez Mode test (Probebetrieb). Important pour commencer : l'agent travaille alors à titre d'essai, mais n'écrit rien dans FreeScout.
  3. Sous Client de service (Dienst-Client), choisissez le client créé en C3.
  4. Sous Clé d'API Anthropic (Anthropic-API-Schlüssel), collez la clé de C1 (Mac : ⌘ + V, Windows : Ctrl + V).
Activer l'exécution, avec le mode test, choisir le client de service et coller la clé d'API.
Figure 22 Activer l'exécution, avec le mode test, choisir le client de service et coller la clé d'API.

C5 – Modèle, formule d'adresse et règles maison

Juste en dessous :

Modèle, formule d'adresse et règles maison. Les règles maison sont de simples phrases – vous n'avez rien à programmer.
Figure 23 Modèle, formule d'adresse et règles maison. Les règles maison sont de simples phrases – vous n'avez rien à programmer.

C6 – Fixer des limites et enregistrer

Sous Limites (Grenzen), vous définissez combien l'agent peut travailler et dépenser au maximum :

Les limites de passages et de coûts. Le budget journalier est la plus importante.
Figure 24 Les limites de passages et de coûts. Le budget journalier est la plus importante.

Cliquez ensuite en bas sur Enregistrer. ✅

C7 – Observer le mode test

Laissez l'agent tourner quelques jours à titre d'essai. À chaque nouveau message client, il décide de ce qu'il ferait, mais n'écrit rien.

  1. Ouvrez Gérer → Connexions IA → Journal (Protokoll) et, dans cette page, l'onglet Exécutions de l'agent (Durchläufe des Agenten).
  2. Vous y voyez pour chaque message ce que l'agent aurait fait : le texte complet de la note et du brouillon, l'attribution et les coûts.
  3. Si quelque chose ne convient pas, complétez les Règles maison (C5).
  4. Si vous êtes satisfait, décochez Mode test en C4 et enregistrez. À partir de là, l'agent travaille pour de vrai.

C8 – L'arrêt d'urgence

Tout en haut de la page Agent se trouve l'Arrêt d'urgence (Notaus). Un clic sur Arrêter l'agent (Agent stoppen) l'arrête immédiatement, et tous ses accès sont bloqués. Avec Réactiver l'agent (Agent freigeben), il reprend.

L'arrêt d'urgence arrête l'agent immédiatement.
Figure 25 L'arrêt d'urgence arrête l'agent immédiatement.

C9 – Travailler avec l'agent

Une fois en service, l'agent travaille tout seul. Vous pouvez en plus lui confier des tâches :

Dans le menu « IA » (KI), vous confiez des tâches à l'agent comme dans un chat – ici un rapport hebdomadaire récurrent.
Figure 26 Dans le menu « IA » (KI), vous confiez des tâches à l'agent comme dans un chat – ici un rapport hebdomadaire récurrent.
Une action de l'agent attend la validation d'un humain.
Figure 27 Une action de l'agent attend la validation d'un humain.
ℹ️ Bon à savoir

Tout ce que l'agent sait encore faire – répondre de manière autonome à partir de vos sources, aider dans le chat en direct, enregistrer des rappels, tenir à jour des articles de FAQ, travailler avec d'autres modules – est expliqué dans le guide d'utilisation de McpConnect, à la section « Der KI-Agent » (l'agent IA).

La méthode 2 est terminée ! ✅

Partie D – Vérifier ou mettre fin aux connexions

D1 – Méthode 1 : voir vos connexions dans FreeScout

  1. Dans FreeScout, cliquez en haut à droite sur votre nom, puis sur Votre profil (Ihr Profil).
  2. À gauche, cliquez sur Connexions IA.
Dans votre propre profil, vous trouvez à gauche la section « Connexions IA » (KI-Verbindungen).
Figure 28 Dans votre propre profil, vous trouvez à gauche la section « Connexions IA » (KI-Verbindungen).

Vous voyez chaque connexion avec sa date de création, sa dernière utilisation, les Autorisations accordées, les Boîtes et si la Pseudonymisation (Pseudonymisierung) est active.

Votre connexion à Claude dans le profil. Avec « Révoquer » (Widerrufen), vous y mettez fin immédiatement.
Figure 29 Votre connexion à Claude dans le profil. Avec « Révoquer » (Widerrufen), vous y mettez fin immédiatement.

D2 – Méthode 1 : mettre fin à une connexion

Le plus sûr est de faire les deux.

D3 – Méthode 1 : autoriser plus ou moins

Les autorisations d'une connexion existante ne peuvent pas être modifiées après coup. Procédez ainsi :

  1. Révoquez la connexion dans FreeScout (D2).
  2. Reconnectez le connecteur dans Claude, ou supprimez-le et recréez-le comme dans la partie B.
  3. Cochez les cases souhaitées dans le dialogue de consentement.

D4 – Méthode 2 : mettre l'agent en pause ou l'arrêter définitivement

Partie E – En cas de problème

Méthode 1 – Claude Desktop et claude.ai

Ce que vous voyezCe que cela signifieCe qui aide
« Ce client IA n'est pas enregistré ou a été désactivé. »FreeScout ne connaît pas Claude.Administrateur : vérifier B1 – claude.ai figure-t-il dans le champ « Documents de métadonnées de l'ID client » ? Dans Claude, Use Claude's published identity a-t-il été choisi ?
« Ce client IA n'a pas pu être vérifié (…) »FreeScout n'a pas pu récupérer les informations sur Claude auprès de claude.ai.Administrateur : autocontrôle, ligne outbound. Le serveur doit pouvoir établir des connexions vers Internet.
« Cette installation FreeScout n'est pas accessible en HTTPS. »L'adresse commence par http:// au lieu de https://.Administrateur ou hébergeur : installer un certificat HTTPS (par exemple Let's Encrypt).
« Votre rôle ne peut pas connecter de clients IA. »Votre rôle n'est pas autorisé.Administrateur : B1, champ « Qui peut connecter des clients IA ».
Claude indique qu'il ne peut pas joindre le serveur, ou « Erkannt » (détecté) manque sous « Authentifizierung »Claude n'arrive pas à atteindre votre FreeScout.Vérifier l'adresse (https:// au début, /mcp à la fin, pas d'espace). FreeScout doit être accessible depuis Internet, pas seulement dans le réseau de l'entreprise. Autocontrôle : la ligne metadata doit être verte.
Rien ne se passe après « Autoriser l'accès »Concernait d'anciennes versions de McpConnect dans Safari.Mettre à jour McpConnect dans le LaStore ou utiliser un autre navigateur.
« Cette demande a expiré. »Trop de temps s'est écoulé entre le lancement dans Claude et le clic.Reconnecter le connecteur dans Claude et terminer rapidement.
Claude avait accès, mais plus maintenantLa connexion a pris fin, par exemple parce que vous avez changé votre mot de passe FreeScout, qu'elle a été révoquée ou qu'un accès est venu d'une adresse non autorisée.Reconnecter le connecteur dans Claude et donner votre accord. Si vous avez saisi des adresses IP, supprimez-les (B5, point 5).
Vous voulez modifier l'adresse du connecteurClaude ne permet pas de la modifier.Supprimer le connecteur dans Claude et le recréer.

Méthode 2 – agent dans FreeScout

Ce que vous voyezCe que cela signifieCe qui aide
L'agent ne fait rienIl est désactivé, arrêté, ou le planificateur ne tourne pas.Sur la page Agent, vérifier : l'exécution indique-t-elle en cours (läuft) ? L'arrêt d'urgence est-il levé ? Autocontrôle : la ligne cron est-elle verte ?
Il n'écrit ni notes ni brouillonsLe mode test est encore actif.Sous Journal → Exécutions de l'agent, voir ce qu'il aurait fait ; désactiver le mode test en C4.
« L'interface IA a refusé la demande (…) »Anthropic a rejeté l'appel, par exemple parce que le crédit est épuisé, que la limite de dépenses est atteinte ou que la clé n'est pas valide.Vérifier le crédit et la limite sur platform.claude.com ; au besoin, créer une nouvelle clé (C1) et la coller en C4.
Il fait une pause jusqu'à demainLe budget journalier dans FreeScout est épuisé.Augmenter le budget en C6 ou attendre le lendemain.
Il attribue mal ou écrit sur le mauvais tonLes règles maison sont trop vagues.Compléter les règles maison (C5) avec des phrases simples et claires.
Il ne réagit pas à ma noteLa note ne s'adresse pas à lui.Commencer la note par son nom ou le mentionner avec « @ ».
ℹ️ Bon à savoir

Si vous êtes bloqué, envoyez à votre administratrice ou à votre administrateur une capture d'écran du message. Sous Gérer → Connexions IA → Journal, chaque tentative de connexion et chaque passage de l'agent sont consignés avec leur motif. On y voit généralement vite d'où vient le problème.

La sécurité en bref