Skip to main content
A conexão MCP da AgencyHandy permite falar com o Claude ou o Cursor em linguagem natural e executar o trabalho diário no seu workspace AgencyHandy — sem abrir cada tela você mesmo. Você continua no controle. Claude e Cursor só agem com a chave de API do workspace que você gera e pedem confirmação quando um nome corresponde a mais de uma pessoa.
Você precisa de uma função que possa abrir Workspace Config e gerenciar API keys (geralmente SuperAdmin ou Admin). Também precisa de Node.js 20+ no computador onde o Claude Desktop ou o Cursor roda.

​
Requisitos

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

​
Configurar Claude ou Cursor MCP

1

Abrir Workspace Config

No AgencyHandy, abra Workspace Config (configurações da empresa) e vá para a aba API Key.
2

Gerar uma chave de API do workspace

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

Copiar a config MCP

Na mesma aba API Key, use o painel de setup Claude / Cursor MCP. Clique em Copy MCP config para que o JSON inclua sua chave e a URL do backend.
4

Colar no Cursor ou Claude Desktop

Cole a config em:
  • Cursor: projeto ou usuário .mcp.json
  • Claude Desktop: claude_desktop_config.json
Mantenha o comando npx -y agencyhandy-mcp@1 e sua chave de 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 workspace.
Se Claude ou Cursor não encontrarem o servidor MCP, confirme que o Node.js 20+ está instalado e que você reiniciou o app após salvar 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 têm o mesmo nome

Se duas colegas se chamam Sara, o Claude pergunta a qual você se refere. Ele 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 seu workspace e executar ações (criar, atribuir, enviar, atualizar) com sua chave de API. Respostas do chat do cliente ainda não estão expostas pelo MCP — use o AgencyHandy para essas conversas.

​
Relacionado

  • Gere chaves e copie a config no 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.