Skip to main content
A ligação MCP da AgencyHandy permite falar com o Claude ou o Cursor em linguagem natural e executar o trabalho diário no seu espaço AgencyHandy — sem abrir cada ecrã você mesmo. Mantém o controlo. O Claude e o Cursor só atuam com a chave API do espaço que gera e pedem confirmação quando um nome corresponde a mais do que uma pessoa.
Precisa de um papel que possa abrir Workspace Config e gerir API keys (normalmente SuperAdmin ou Admin). Também precisa de Node.js 20+ no computador onde o Claude Desktop ou o Cursor corre.

​
Requisitos

O pacote MCP no npm é agencyhandy-mcp. O Claude e o Cursor executam-no com npx -y agencyhandy-mcp@1.

​
Configurar Claude ou Cursor MCP

1

Abrir Workspace Config

No AgencyHandy, abra Workspace Config (definições da empresa) e vá ao separador API Key.
2

Gerar uma chave API do espaço

Crie uma nova chave API do espaço (ou use uma já guardada). Copie a chave quando aparecer — o AgencyHandy não poderá mostrar a chave completa depois.
3

Copiar a config MCP

No mesmo separador API Key, use o painel de configuração Claude / Cursor MCP. Clique em Copy MCP config para que o JSON inclua a sua chave e o URL do backend.
4

Colar no Cursor ou Claude Desktop

Cole a config em:
  • Cursor: projeto ou utilizador .mcp.json
  • Claude Desktop: claude_desktop_config.json
Mantenha o comando npx -y agencyhandy-mcp@1 e a sua chave API como gerados.
5

Reiniciar e testar um prompt

Feche completamente e reabra o Cursor ou o Claude Desktop. Depois peça algo simples, como um briefing matinal do espaço.
Se o Claude ou o Cursor não encontrarem o servidor MCP, confirme que o Node.js 20+ está instalado e que reiniciou a app após guardar a config.

​
Exemplos de prompts

Use linguagem natural. Prefira nomes completos ou e-mails ao atribuir trabalho para selecionar a pessoa certa.

​
Quando duas pessoas partilham o mesmo nome

Se duas colegas se chamam Sara, o Claude pergunta a qual se refere. Não inventa IDs nem adivinha em silêncio. Inclua sempre um nome completo ou e-mail no prompt quando os nomes puderem colidir.

​
O que funciona agora vs ainda não

O MCP permite ler o seu espaço e executar ações (criar, atribuir, enviar, atualizar) com a sua chave API. As respostas do chat de cliente ainda não estão expostas pelo MCP — use o AgencyHandy para essas conversas.

​
Relacionado

  • Gere chaves e copie a config na app em Workspace Config → API Key
  • Pacote: agencyhandy-mcp no npm (npx -y agencyhandy-mcp@1)
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.