Skip to main content
La connessione MCP di AgencyHandy ti consente di parlare con Claude o Cursor in linguaggio naturale ed eseguire il lavoro quotidiano nel workspace AgencyHandy — senza aprire ogni schermata tu stesso. Restate voi al comando. Claude e Cursor agiscono solo con la chiave API del workspace che generate e chiedono conferma quando un nome corrisponde a più di una persona.
Serve un ruolo che possa aprire Workspace Config e gestire le API keys (in genere SuperAdmin o Admin). Serve anche Node.js 20+ sul computer dove girano Claude Desktop o Cursor.

​
Requisiti

Il pacchetto MCP su npm è agencyhandy-mcp. Claude e Cursor lo eseguono con npx -y agencyhandy-mcp@1.

​
Configurare Claude o Cursor MCP

1

Aprire Workspace Config

In AgencyHandy, apri Workspace Config (impostazioni azienda), poi vai alla scheda API Key.
2

Generare una chiave API del workspace

Crea una nuova chiave API del workspace (o usa una già salvata). Copia la chiave quando compare — AgencyHandy non potrà più mostrare la chiave completa in seguito.
3

Copiare la config MCP

Nella stessa scheda API Key, usa il pannello di setup Claude / Cursor MCP. Fai clic su Copy MCP config così il JSON include chiave e URL del backend.
4

Incollare in Cursor o Claude Desktop

Incolla la config in:
  • Cursor: progetto o utente .mcp.json
  • Claude Desktop: claude_desktop_config.json
Mantieni il comando npx -y agencyhandy-mcp@1 e la chiave API come generati.
5

Riavviare e provare un prompt

Chiudi completamente e riapri Cursor o Claude Desktop. Poi chiedi qualcosa di semplice, ad esempio un briefing mattutino del workspace.
Se Claude o Cursor non trovano il server MCP, conferma che Node.js 20+ è installato e che hai riavviato l’app dopo aver salvato la config.

​
Esempi di prompt

Usa il linguaggio naturale. Preferisci nome completo o email quando assegni lavoro, così viene scelta la persona giusta.

​
Quando due persone hanno lo stesso nome

Se due colleghe si chiamano entrambe Sara, Claude chiede a quale ti riferisci. Non inventa ID e non indovina in silenzio. Includi sempre un nome completo o un’email nel prompt quando i nomi possono entrare in conflitto.

​
Cosa funziona ora vs non ancora

MCP consente di leggere il workspace e compiere azioni (creare, assegnare, inviare, aggiornare) con la chiave API. Le risposte della chat cliente non sono ancora esposte via MCP — usa AgencyHandy per quelle conversazioni.

​
Correlati

  • Genera le chiavi e copia la config nell’app in 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.