Connecteur FreeScout
FreeScout est un outil de support client auto-hébergeable, sous licence AGPL-3.0. Le connecteur lit les conversations, clients et boîtes de réception via l'API REST de FreeScout. Il est en lecture seule.
Mesuré le 2026-10-03 dans connectors/freescout.yaml : 15 outils, tous en méthode GET.
Ce connecteur n'est pas appelable aujourd'hui : son identifiant ne figure pas dans la liste des serveurs autorisés (section Déploiement plus bas). Vous pouvez enregistrer ses identifiants, mais tools/list n'affiche pas ses outils et un appel est refusé.
Ce que déclare le fichier
| Propriété | Valeur |
|---|---|
| Fichier | connectors/freescout.yaml |
| Protocole | API REST, chemins sous /api/ |
| Authentification | clé d'API en en-tête X-FreeScout-API-Key, lue dans FREESCOUT_API_KEY |
| Adresse de l'instance | variable FREESCOUT_URL |
| Licence déclarée | AGPL-3.0 |
| Statut amont | a_verifier |
Le statut a_verifier est celui que porte le fichier. Dans le dépôt, il signifie qu'aucune sonde n'a encore établi qu'un amont répond (référentiel de statut amont du dépôt). Les outils sont donc vérifiés contre le contrat déclaré de l'API, pas contre une réponse réelle.
Outils
| Outil | Rôle |
|---|---|
list_conversations | Lister les conversations (filtres : boîte, statut, page) |
get_conversation | Lire une conversation avec ses échanges |
list_mailboxes | Lister les boîtes de réception |
list_mailbox_folders | Lister les dossiers d'une boîte |
list_mailbox_custom_fields | Lister les champs personnalisés d'une boîte |
list_customers | Lister les clients |
get_customer | Lire un client |
list_tags | Lister les étiquettes |
list_timelogs | Lister les temps passés |
list_conversation_timelogs | Lister les temps passés sur une conversation |
list_users | Lister les agents |
get_user | Lire un agent |
get_current_user | Lire l'utilisateur de la clé |
list_webhooks | Lister les webhooks |
get_report | Lire un rapport |
Le fichier précise que les 14 opérations d'écriture de l'API FreeScout ont été laissées de côté sur décision du titulaire, le 2026-09-04. Répondre à un ticket, changer un statut ou assigner une conversation n'est donc pas possible avec ce connecteur.
Configuration
| Variable | Rôle |
|---|---|
FREESCOUT_URL | Adresse de l'instance FreeScout |
FREESCOUT_API_KEY | Clé d'API |
Dans l'application : page Identifiants (/credentials), fiche FreeScout Helpdesk, champs « URL du serveur » et « API Key ».
Déploiement
Ni podman-compose.vps2.yml ni podman-compose.yml ne déploient FreeScout. Le connecteur vise une instance que vous fournissez. L'entrée du catalogue métier a le statut coming-soon.
L'identifiant freescout ne figure pas dans ALLOWED_MCP_SERVERS (liste des serveurs autorisés du code). Le fichier se charge, mais ses outils n'apparaissent pas dans tools/list et le dispatch les refuse (un test du dépôt le verrouille).
Cas d'usage
- Retrouver une conversation ou un client par l'agent.
- Consulter les temps passés et les rapports.
Fichier source
Le connecteur est déclaré dans connectors/freescout.yaml.
Voir aussi
- Vue d'ensemble : chiffres mesurés, chargement et règles communes aux douze connecteurs
- Créer votre premier connecteur MCP : forme d'un fichier YAML et ajout d'un connecteur à la passerelle
- Routes MCP : ouvrir une session et appeler un outil par JSON-RPC
- Tarification : nombre de connecteurs métier inclus dans chaque offre
- Utiliser les connecteurs MCP : fiches de connecteurs présentes et consultation du catalogue par l'API