Connecter Claude et Cursor pour piloter AgencyHandy avec MCP

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.

Deux façons de se connecter

Où s’exécute votre agent	Comment se connecter	Configuration
Sur votre ordinateur — Claude Desktop ou Cursor	Le package `agencyhandy-mcp`, lancé par l’application	Configurer Claude ou Cursor MCP, ci-dessous — nécessite Node.js 20+
Dans le cloud — Cloudflare Workers, Vercel, n8n, un Claude ou Cursor hébergé	Notre serveur MCP hébergé sur `https://mcp.agencyhandy.com/`	Connecter un agent cloud, ci-dessous — rien à installer

Les deux utilisent la même clé API d’espace de travail et donnent à l’agent les mêmes outils.

Vous avez besoin d’un rôle pouvant ouvrir Workspace Config et gérer les API keys (en général SuperAdmin ou Admin). Pour l’installation locale, il vous faut aussi Node.js 20+ sur l’ordinateur où s’exécute Claude Desktop ou Cursor — le serveur hébergé ne demande aucune installation.

Prérequis

Exigence	Détails
Espace de travail AgencyHandy	Accès à Workspace Config → API Key
Un hôte MCP	Claude Desktop ou Cursor sur votre ordinateur, ou tout agent capable d’appeler un serveur MCP via HTTP
Node.js (installation locale uniquement)	Version 20 ou plus récente (`node -v` pour vérifier)
Package MCP (installation locale uniquement)	`npx -y agencyhandy-mcp@1` (livre 1.7.2+ sur le tag `1`)

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

Utilisez cette méthode quand Claude Desktop ou Cursor s’exécute sur votre propre ordinateur. Pour un agent qui tourne dans le cloud, passez directement à Connecter un agent cloud.

Ouvrir Workspace Config

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

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.

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.

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.

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.

Connecter un agent cloud (serveur hébergé)

Si votre agent s’exécute là où vous ne pouvez pas installer de package — Cloudflare Workers, fonctions Vercel, n8n, ou un Claude ou Cursor hébergé — pointez-le vers le serveur MCP que nous hébergeons pour vous :

https://mcp.agencyhandy.com/

Rien à installer, aucun serveur à maintenir. Authentifiez chaque requête avec la même clé API d’espace de travail en tant que bearer token. L’espace de travail est lu depuis la clé, donc chaque utilisateur se connecte avec la sienne. Cursor, Claude Code et tout hôte qui envoie des en-têtes personnalisés :

{
  "mcpServers": {
    "agency-handy": {
      "url": "https://mcp.agencyhandy.com/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop ne peut pas envoyer d’en-têtes personnalisés : faites le pont avec mcp-remote :

{
  "mcpServers": {
    "agency-handy": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.agencyhandy.com/",
        "--header", "Authorization:Bearer YOUR_API_KEY"
      ]
    }
  }
}

Claude Code en ligne de commande :

claude mcp add agency-handy --transport http https://mcp.agencyhandy.com/ \
  --header "Authorization: Bearer YOUR_API_KEY"

L’adresse est la racine — https://mcp.agencyhandy.com/, et non /mcp. Pour vérifier que le serveur répond, ouvrez https://mcp.agencyhandy.com/health.

Vous construisez plutôt votre propre intégration avec l’API HTTP ? Envoyez un en-tête User-Agent avec vos requêtes. Certains environnements — dont le fetch() de Cloudflare Workers — n’en envoient aucun par défaut, et les requêtes sans en-tête sont rejetées avant d’atteindre l’API.

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.

Objectif	Exemple de prompt
Briefing du matin	« Donne-moi un briefing du matin : tickets ouverts, factures impayées et propositions en attente côté clients. »
Assigner un ticket	« Assigne le ticket sur le redesign de la homepage Acme à Jordan Lee (jordan@agency.com). »
Envoyer une facture	« Envoie la facture INV-1042 au client par e-mail. »
Créer un lead	« Crée un lead pour Nora Patel chez Bright Studio, e-mail nora@brightstudio.com. »
Marquer une facture payée	« Marque la facture INV-1042 comme paid. »

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

Fonctionne maintenant	Pas encore disponible via MCP
Briefings et recherches sur les propositions, projets, tickets et factures	Répondre dans le client chat depuis MCP
Assigner des tickets et d’autres travaux d’équipe	Remplir les valeurs de champs personnalisés lead ou client
Créer des leads	—
Envoyer des factures et les marquer payées	—

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.

Serveur hébergé pour les agents cloud : https://mcp.agencyhandy.com/ (vérification via /health)
Package : agencyhandy-mcp sur npm (npx -y agencyhandy-mcp@1)
Champs personnalisés des leads · Champs personnalisés des clients

Prise en main

Configuration de l'espace de travail

CRM

Services et commandes

Propositions et factures

Équipe et tâches

Formulaires et fichiers

Compte et facturation

Paiements

Intégrations

Connecter Claude et Cursor pour piloter AgencyHandy avec MCP

Deux façons de se connecter

Prérequis

Configurer Claude ou Cursor MCP

Connecter un agent cloud (serveur hébergé)

Exemples de prompts

Quand deux personnes partagent le même nom

Ce qui fonctionne maintenant vs pas encore

Ressources associées

​Deux façons de se connecter

​Prérequis

​Configurer Claude ou Cursor MCP

​Connecter un agent cloud (serveur hébergé)

​Exemples de prompts

​Quand deux personnes partagent le même nom

​Ce qui fonctionne maintenant vs pas encore

​Ressources associées

Deux façons de se connecter

Prérequis

Configurer Claude ou Cursor MCP

Connecter un agent cloud (serveur hébergé)

Exemples de prompts

Quand deux personnes partagent le même nom

Ce qui fonctionne maintenant vs pas encore

Ressources associées