Skip to main content
MCP připojení AgencyHandy vám umožní mluvit s Claude nebo Cursor přirozeným jazykem a provádět každodenní práci v workspace AgencyHandy — aniž byste otevírali každou obrazovku sami. Kontrolu si ponecháte. Claude a Cursor jednají jen s API klíčem workspace, který vygenerujete, a požádají o potvrzení, když jméno sedí na více osob.
Potřebujete roli, která může otevřít Workspace Config a spravovat API keys (obvykle SuperAdmin nebo Admin). Na počítači, kde běží Claude Desktop nebo Cursor, potřebujete také Node.js 20+.

​
Požadavky

MCP balíček na npm je agencyhandy-mcp. Claude a Cursor jej spouští přes npx -y agencyhandy-mcp@1.

​
Nastavení Claude nebo Cursor MCP

1

Otevřít Workspace Config

V AgencyHandy otevřete Workspace Config (nastavení společnosti) a přejděte na kartu API Key.
2

Vygenerovat API klíč workspace

Vytvořte nový API klíč workspace (nebo použijte uložený). Zkopírujte klíč, až se zobrazí — AgencyHandy už později nemůže ukázat celý klíč znovu.
3

Zkopírovat MCP konfiguraci

Na stejné kartě API Key použijte panel Claude / Cursor MCP. Klikněte na Copy MCP config, aby JSON obsahoval klíč a URL backendu.
4

Vložit do Cursor nebo Claude Desktop

Vložte konfiguraci do:
  • Cursor: projektový nebo uživatelský .mcp.json
  • Claude Desktop: claude_desktop_config.json
Ponechte příkaz npx -y agencyhandy-mcp@1 a API klíč tak, jak byly vygenerovány.
5

Restartovat a vyzkoušet prompt

Úplně ukončete a znovu otevřete Cursor nebo Claude Desktop. Pak požádejte o něco jednoduchého, například ranní briefing workspace.
Pokud Claude nebo Cursor nenajde MCP server, ověřte instalaci Node.js 20+ a restart aplikace po uložení konfigurace.

​
Příklady promptů

Používejte přirozený jazyk. Při přiřazování práce preferujte celá jména nebo e-maily, aby byla vybrána správná osoba.

​
Když dvě osoby sdílejí stejné jméno

Pokud se dvě kolegyně jmenují Sara, Claude se zeptá, kterou myslíte. Nevymýšlí ID a netipuje potichu. Do promptu vždy uveďte celé jméno nebo e-mail, když by se jména mohla srazit.

​
Co funguje teď vs ještě ne

MCP podporuje čtení workspace a akce (vytvořit, přiřadit, odeslat, aktualizovat) s vaším API klíčem. Odpovědi v klientském chatu zatím přes MCP nejsou — pro tyto konverzace použijte AgencyHandy.

​
Související

  • Generujte klíče a kopírujte konfiguraci v aplikaci pod 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.