Skip to main content
La conexión MCP de AgencyHandy te permite hablar con Claude o Cursor en lenguaje natural y que ejecuten el trabajo diario en tu espacio de trabajo AgencyHandy — sin abrir cada pantalla tú mismo. Tú mantienes el control. Claude y Cursor solo actúan con la clave API del workspace que generas, y te piden confirmación cuando un nombre coincide con más de una persona.
Necesitas un rol que pueda abrir Workspace Config y gestionar API keys (normalmente SuperAdmin o Admin). También necesitas Node.js 20+ en el equipo donde se ejecuta Claude Desktop o Cursor.

​
Requisitos

El paquete MCP en npm es agencyhandy-mcp. Claude y Cursor lo ejecutan con npx -y agencyhandy-mcp@1.

​
Configurar Claude o Cursor MCP

1

Abrir Workspace Config

En AgencyHandy, abre Workspace Config (ajustes de la empresa) y ve a la pestaña API Key.
2

Generar una clave API del workspace

Crea una nueva clave API del workspace (o usa una que ya hayas guardado). Copia la clave cuando aparezca — AgencyHandy no podrá mostrar la clave completa después.
3

Copiar la config MCP

En la misma pestaña API Key, usa el panel de configuración Claude / Cursor MCP. Haz clic en Copy MCP config para que el JSON incluya tu clave y la URL del backend.
4

Pegar en Cursor o Claude Desktop

Pega la config en:
  • Cursor: proyecto o usuario .mcp.json
  • Claude Desktop: claude_desktop_config.json
Mantén el comando npx -y agencyhandy-mcp@1 y tu clave API tal como se generaron.
5

Reiniciar y probar un prompt

Cierra por completo y vuelve a abrir Cursor o Claude Desktop. Luego pide algo sencillo, como un briefing matutino de tu workspace.
Si Claude o Cursor no encuentran el servidor MCP, confirma que Node.js 20+ está instalado y que reiniciaste la app después de guardar la config.

​
Ejemplos de prompts

Usa lenguaje natural. Prefiere nombres completos o correos al asignar trabajo para seleccionar a la persona correcta.

​
Cuando dos personas comparten el mismo nombre

Si dos compañeros se llaman Sara, Claude preguntará a cuál te refieres. No inventa IDs ni adivina en silencio. Incluye siempre un nombre completo o un email en el prompt cuando los nombres puedan chocar.

​
Qué funciona ahora vs todavía no

MCP permite leer tu workspace y realizar acciones (crear, asignar, enviar, actualizar) con tu clave API. Las respuestas del chat de cliente aún no están expuestas por MCP — usa AgencyHandy para esas conversaciones.

​
Relacionado

  • Genera claves y copia la config en la app en 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.