Skip to main content
La connexion MCP d’AgencyHandy vous permet de parler à Claude ou Cursor en langage naturel et de leur faire exécuter le travail quotidien dans votre espace de travail AgencyHandy — sans ouvrir chaque écran vous-même. Vous restez maître. Claude et Cursor n’agissent qu’avec la clé API d’espace de travail que vous générez, et vous demandent de confirmer lorsqu’un nom correspond à plusieurs personnes.
Vous avez besoin d’un rôle pouvant ouvrir Workspace Config et gérer les API keys (en général SuperAdmin ou Admin). Vous avez aussi besoin de Node.js 20+ sur l’ordinateur où Claude Desktop ou Cursor s’exécute.

​
Prérequis

Le package MCP sur npm est agencyhandy-mcp. Claude et Cursor l’exécutent avec npx -y agencyhandy-mcp@1.

​
Configurer Claude ou Cursor MCP

1

Ouvrir Workspace Config

Dans AgencyHandy, ouvrez Workspace Config (paramètres de l’entreprise), puis allez à l’onglet API Key.
2

Générer une clé API d’espace de travail

Créez une nouvelle clé API d’espace de travail (ou utilisez une clé déjà enregistrée). Copiez la clé lorsqu’elle apparaît — AgencyHandy ne pourra plus afficher la clé complète ensuite.
3

Copier la config MCP

Sur le même onglet API Key, utilisez le panneau de configuration Claude / Cursor MCP. Cliquez sur Copy MCP config pour que le JSON inclue votre clé et l’URL du backend.
4

Coller dans Cursor ou Claude Desktop

Collez la config dans :
  • Cursor : projet ou utilisateur .mcp.json
  • Claude Desktop : claude_desktop_config.json
Conservez la commande npx -y agencyhandy-mcp@1 et votre clé API telles que générées.
5

Redémarrer et tester une invite

Quittez complètement puis rouvrez Cursor ou Claude Desktop. Demandez ensuite quelque chose de simple, par exemple un briefing du matin pour votre espace de travail.
Si Claude ou Cursor ne trouve pas le serveur MCP, confirmez que Node.js 20+ est installé et que vous avez redémarré l’application après avoir enregistré la config.

​
Exemples de prompts

Utilisez un langage naturel. Préférez les noms complets ou les e-mails lorsque vous assignez du travail afin de sélectionner la bonne personne.

​
Quand deux personnes partagent le même nom

Si deux collègues s’appellent toutes les deux Sara, Claude demandera laquelle vous voulez. Il n’invente pas d’IDs et ne devine pas en silence. Incluez toujours un nom complet ou un e-mail dans l’invite lorsque les noms peuvent entrer en collision.

​
Ce qui fonctionne maintenant vs pas encore

MCP prend en charge la lecture de votre espace de travail et les actions (créer, assigner, envoyer, mettre à jour) avec votre clé API. Les réponses du chat client et les valeurs de champs personnalisés ne sont pas encore exposées via MCP — définissez les champs dans Workspace Config → Custom Fields et renseignez-les sur les fiches lead ou client dans AgencyHandy.

​
Ressources associées

  • Générez les clés et copiez la config dans l’app sous Workspace Config → API Key
Latest package on the 1 tag is 1.7.2+. Claude can read ah://api-context (also inside ah://full-context) for API path gotchas: leads, projects/orders, tasks, comments, labels, clients, invoices, vouchers, and forms.