Connecteur Geswork pour Claude
Vos données Geswork, directement dans Claude
Interrogez vos clients, devis, factures, missions, planning et parc matériel en langage naturel depuis Claude (Anthropic), et faites-lui créer clients, tâches, rendez-vous ou devis brouillons.
Claude agit avec vos droits Geswork et ne voit que les organisations que vous choisissez.
https://api.v2.geswork.fr/mcp
Ce que vous pouvez faire
Une fois connecté, demandez simplement à Claude, par exemple :
Claude cherche l'information dans Geswork, la croise et vous répond. Par défaut, le connecteur est en lecture seule.
Si vous l'autorisez lors de la connexion, Claude peut aussi agir dans Geswork, après votre confirmation :
Prérequis
- Un compte utilisateur Geswork actif dans au moins une organisation.
- L'option « Accès OAuth 2.0 pour applications tierces » activée par un administrateur de l'organisation (voir étape 1).
- Un compte Claude : claude.ai (web), Claude Desktop, l'application mobile ou Claude Code.
Installation pas à pas
L'administrateur active l'accès
Dans Geswork, un administrateur ouvre Paramètres du compte → Clés API et active « Accès OAuth 2.0 pour applications tierces ».
À faire une seule fois par organisation. Désactiver cette option coupe immédiatement l'accès de Claude pour toute l'organisation.
Ajoutez Geswork dans Claude
Dans Claude, ouvrez Paramètres → Connecteurs, recherchez Geswork dans l'annuaire et cliquez sur Connecter.
Vous pouvez aussi choisir Ajouter un connecteur personnalisé et coller l'URL https://api.v2.geswork.fr/mcp. Sur les offres Team et Enterprise, c'est le propriétaire de l'organisation Claude qui ajoute le connecteur.
Connectez-vous et choisissez vos organisations
Claude ouvre la page de connexion Geswork. Identifiez-vous, puis, sur l'écran d'autorisation, cochez la ou les organisations à partager avec Claude, cochez si besoin « Autoriser aussi Claude à créer et modifier des données » et cliquez sur Autoriser.
Vous êtes redirigé vers Claude : le connecteur est prêt.
Avec Claude Code
Dans un terminal :
claude mcp add --transport http geswork https://api.v2.geswork.fr/mcpLancez ensuite /mcp dans Claude Code pour vous authentifier dans le navigateur.
Activer l'écriture après coup ?
Le choix lecture seule / écriture se fait sur l'écran d'autorisation. Pour le changer, déconnectez puis reconnectez le connecteur dans Claude.
Plusieurs organisations ?
Cochez toutes celles que vous voulez partager sur l'écran d'autorisation. Claude travaille par défaut sur votre organisation principale et peut cibler les autres à votre demande (« dans Electromaintenance, … »). Seules les organisations dont un administrateur a activé l'accès OAuth sont proposées ; les autres apparaissent grisées. Pour modifier la sélection, déconnectez puis reconnectez le connecteur.
Outils disponibles
Consultation
Chaque outil renvoie uniquement ce que vos droits Geswork vous permettent de voir.
| Outil | Ce qu'il fait |
|---|---|
get_connection_info | Utilisateur connecté et organisation partagée. |
search_customers · get_customer | Recherche de clients et prospects ; fiche client avec contacts, encours et indicateurs (CA, panier moyen, délai de paiement). |
search_sites · get_site | Sites d'intervention rattachés aux clients. |
search_contacts | Interlocuteurs des clients, sites et fournisseurs. |
search_suppliers | Fournisseurs. |
search_documents · get_document | Devis, factures, avoirs, bons de commande, bons de livraison et contrats, filtrables par statut et par client ; détail avec lignes et totaux. |
search_supplier_invoices | Factures et avoirs fournisseurs. |
search_missions · get_mission | Missions et interventions : statut, dates, intervenants, matériel, documents liés. |
list_employees | Collaborateurs de l'organisation. |
get_planning | Planning sur une période de 62 jours maximum, limité aux plannings que vous pouvez consulter. |
search_parks · list_park_equipments | Parcs matériel des clients et arborescence de leurs équipements. |
search_intervention_reports · get_intervention_report | Rapports d'intervention : équipements contrôlés, comptes rendus et essais inclus, verdicts non conformes, anomalies et conclusions. |
get_equipment_report · list_equipment_reports | Contenu complet d'un compte rendu : plaque signalétique, mesures saisies et calculées avec unités, tableaux, essais, verdicts, recommandations et anomalies. |
list_equipment_models | Catalogue des modèles d'équipement (transformateur, cellule, disjoncteur…). |
search_stock_items | Articles du catalogue et du stock. |
list_tasks · list_workspaces | Tâches, espaces de travail et leurs colonnes. |
Création et modification (si autorisées à la connexion)
| Outil | Ce qu'il fait |
|---|---|
create_customer · update_customer | Créer un client ou prospect avec son adresse ; modifier ses coordonnées. |
create_contact | Ajouter un interlocuteur à un client, un site ou un fournisseur (sans email envoyé au contact). |
add_note | Ajouter une note interne sur un client, site, fournisseur, contact, mission, document ou parc. |
create_task · update_task | Créer une tâche dans un espace de travail ; la modifier ou la marquer terminée. |
create_planning_event | Ajouter un créneau au planning, limité aux plannings que vous pouvez modifier. |
create_quote | Créer un devis brouillon avec ses lignes (jamais envoyé au client). |
set_document_status | Changer le statut d'un devis ou d'une facture (accepté, refusé…). |
update_report_field · remove_report_table_rows | Corriger un compte rendu ou un essai non verrouillé : modifier un champ (observations, valeur, verdict manuel) ou retirer des lignes d'un tableau de mesures. |
create_park · add_park_equipment | Créer un parc matériel pour un client ou un site et y ajouter des équipements du catalogue (ex. TR1, TR2). |
Sécurité et cloisonnement
- Connexion avec votre propre compte via OAuth 2.0 (code d'autorisation + PKCE). Claude ne connaît jamais votre mot de passe Geswork.
- Double authentification respectée : la connexion demande le même second facteur que l'application (application d'authentification, code par email ou validation sur l'application mobile). Si votre organisation impose la double authentification, elle s'applique aussi au connecteur.
- Seulement les organisations cochées par vous sur l'écran d'autorisation, et parmi elles celles dont l'administrateur a activé l'accès OAuth. Aucune donnée d'une autre organisation n'est accessible.
- Vos droits, rien de plus : chaque requête de Claude passe par les mêmes contrôles que l'application Geswork (modules, licences, rôles et permissions). Si vous ne voyez pas une donnée dans Geswork, Claude ne la voit pas non plus.
- Contrôle par l'administrateur : l'option « Accès OAuth 2.0 pour applications tierces » peut être désactivée à tout moment, ce qui coupe immédiatement l'accès.
- Lecture seule par défaut : la création et la modification ne sont possibles que si vous cochez « Autoriser aussi Claude à créer et modifier des données » sur l'écran d'autorisation. Claude vous demande confirmation avant chaque action (sauf si vous l'autorisez durablement dans Claude), et aucune suppression n'est possible.
- Pas d'envoi au client : le connecteur n'envoie jamais de devis, de facture ni d'email à vos clients ou contacts. Seuls vos collaborateurs assignés à une tâche ou à un créneau reçoivent les notifications Geswork habituelles.
- Jetons de courte durée : jeton d'accès valable 1 heure, renouvelé automatiquement ; jeton de renouvellement valable 30 jours, révocable à tout moment.
- Journal des accès : chaque appel d'outil (outil utilisé, paramètres, date) est journalisé pour la sécurité et le support.
- Hébergement en France : vos données Geswork restent hébergées en France ; seules les réponses aux questions que vous posez sont transmises à Claude.
Déconnecter Claude
Deux possibilités, qui fonctionnent indépendamment :
- Dans Geswork : Paramètres utilisateur → API Tokens → Applications connectées, puis Révoquer l'accès sur la ligne « Claude ».
- Dans Claude : Paramètres → Connecteurs → Geswork → Déconnecter.
Dépannage
| Message | Solution |
|---|---|
| « L'accès OAuth aux applications tierces n'est activé sur aucune de vos entreprises. » | Demandez à un administrateur d'activer l'option (étape 1). |
| « L'accès à cette organisation n'est plus autorisé… » | L'option a été désactivée ou votre profil a été retiré de l'organisation. Contactez votre administrateur, puis reconnectez le connecteur. |
| « Accès refusé par Geswork… » | Vos droits ne couvrent pas cette donnée (module non activé, licence ou permission manquante). C'est le même comportement que dans l'application. |
| « Votre organisation impose la double authentification… » | Activez la double authentification dans l'application Geswork (Paramètres utilisateur), puis reconnectez le connecteur. |
| « Session Geswork expirée… » | Déconnectez puis reconnectez le connecteur dans Claude. |
| « Trop de requêtes… » | Patientez une minute avant de relancer votre demande. |
Données personnelles et support
Le traitement des données via le connecteur est décrit dans notre politique de confidentialité (section « AI assistant connector »). Les conversations avec Claude sont traitées par Anthropic selon ses propres conditions.
Support : support@geswork.fr · Données personnelles : protection-donnees@gsme.fr
In English
The Geswork connector for Claude lets Claude read your Geswork data (customers, quotes, invoices, jobs, schedule, installed equipment, stock and tasks) using your own Geswork account, and, if you allow it, create and update records on your behalf.
- Server URL:
https://api.v2.geswork.fr/mcp(remote MCP server, Streamable HTTP, OAuth 2.0 with dynamic client registration and PKCE). - Setup: (1) an organisation administrator enables OAuth 2.0 third-party access under Account settings → API keys; (2) in Claude, open Settings → Connectors and add Geswork ; (3) sign in to Geswork, tick the organisation(s) to share and click Authorize.
- Scope: only the organisations ticked at consent time (and enabled by their administrator); Claude works on the default one unless asked otherwise. Every request goes through the same access controls as the Geswork app (modules, licences, roles and permissions).
- Strong sign-in: the Geswork sign-in requires the same second factor as the app (authenticator app, email code or mobile approval), and organisation-wide 2FA requirements apply to the connector.
- Read-only by default: creating and updating data (customers, contacts, notes, tasks, schedule entries, draft quotes, document status) is only possible if you tick the write option on the consent screen. Claude asks for confirmation before each action; nothing can be deleted, and nothing is ever sent to your customers.
- Revoke: User settings → API Tokens → Connected applications in Geswork, or Settings → Connectors in Claude .
- Privacy: see the AI assistant connector section of our privacy policy. Support: support@geswork.fr.
Dernière mise à jour : 6 octobre 2026