Connecteur MCP

Le connecteur MCP donne à un assistant IA 51 outils: employés, champs, modèles, départements, campagnes, déploiements, analytiques, équipe et journal. Il agit avec le rôle de la personne qui l’a autorisé: celui d’un membre ne peut ni changer les réglages, la marque ou les champs, ni supprimer des employés en lot, ni inviter. Vous décrivez ce que vous voulez; l’assistant appelle les bons outils sur votre espace. À partir du forfait Démarrage.

Connecteur distant (recommandé)

Rien à installer. L’adresse du serveur est:

https://app.gensy.email/api/mcp

• Claude.ai et Claude Desktop — Paramètres → Connecteurs → Ajouter un connecteur personnalisé.
• ChatGPT — Paramètres → Connecteurs → Mode développeur.
• Claude Code et Cursor — ajoutez l’adresse comme serveur MCP distant.

L’autorisation se fait par OAuth: l’écran de consentement s’ouvre dans Gensy, où vous choisissez l’espace et la portée. L’accès apparaît dans Accès actifs avec le badge «Connecteur» et se révoque d’un clic; son jeton vaut 30 jours, renouvelés automatiquement.

Serveur local

Pour un client qui ne gère pas les connecteurs distants, npx -y gensy-mcp fonctionne avec une clé API. Voir la page Clés API.

Charger moins d’outils

L’onglet Assistants IA et clés API permet de cocher les jeux d’outils voulus; l’adresse se met à jour, par exemple …/api/mcp?toolsets=employees,analytics. Moins d’outils, moins de contexte consommé dans l’assistant.

Les 51 outils, en dix jeux

• workspace — vue d’ensemble, réglages, marque.
• employees — lister, lire, créer, modifier, modifier en lot, assigner, dupliquer, supprimer.
• templates — lister, lire, créer, modifier, publier, supprimer, galerie.
• departments, campaigns, fields — gestion complète.
• signatures — générer, envoyer par courriel, déployer dans Gmail ou Outlook, dépublier, planifier.
• analytics — vues et clics.
• team — membres et invitations.
• activity — journal et alertes.

Exemples de demandes

• «Combien d’employés n’ont pas de modèle assigné?»
• «Mets tout le département Marketing sur le modèle bilingue, puis planifie le déploiement lundi à 9 h.»
• «Quels liens ont été le plus cliqués ces 30 derniers jours?»

Sécurité

• Les outils destructifs — suppressions (employés, modèles, départements, campagnes, champs), remplacement des champs, dépublication, retrait planifié, annulation d’une planification, retrait d’un membre — exigent une confirmation (confirm: true): l’assistant doit vous la demander.
• Une portée en lecture seule n’expose aucun outil d’écriture.
• Les réponses transitent par le fournisseur du modèle (Anthropic, OpenAI…) et sont soumises à ses conditions; l’écran de consentement le rappelle. Les jetons de portail et les identifiants de facturation ne passent jamais par ce canal.

Réponses trop longues

Chaque réponse d’outil est coupée à 120 000 caractères ([truncated: …]). Demandez à l’assistant de paginer (page, per_page: 50 par défaut, 200 au plus), de filtrer ou de réduire le détail (detail: "minimal" ou "summary"). Les outils MCP n’ont pas de paramètre limit.