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.

​
Dva způsoby připojení

Oba způsoby používají stejný API klíč pracovního prostoru a dávají agentovi stejné nástroje.
Potřebujete roli, která může otevřít Workspace Config a spravovat API keys (obvykle SuperAdmin nebo Admin). Pro místní nastavení potřebujete také Node.js 20+ na počítači, kde běží Claude Desktop nebo Cursor — hostovaný server nevyžaduje žádnou instalaci.

​
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

Tuto cestu použijte, když Claude Desktop nebo Cursor běží na vašem počítači. Pokud agent běží v cloudu, přejděte na Připojení cloudového agenta.
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řipojení cloudového agenta (hostovaný server)

Pokud váš agent běží tam, kde nemůžete nic instalovat — Cloudflare Workers, funkce Vercel, n8n nebo hostovaný Claude či Cursor — nasměrujte ho na MCP server, který pro vás provozujeme:
Není co instalovat ani jaký server udržovat. Každý požadavek ověřte stejným API klíčem pracovního prostoru jako bearer tokenem. Pracovní prostor se čte z klíče, takže každý uživatel se připojuje tím svým. Cursor, Claude Code a každý hostitel, který posílá vlastní hlavičky:
Claude Desktop neumí posílat vlastní hlavičky — přemostěte to pomocí mcp-remote:
Claude Code z příkazové řádky:
Adresa je kořenová cesta — https://mcp.agencyhandy.com/, nikoli /mcp. Dostupnost serveru ověříte otevřením https://mcp.agencyhandy.com/health.
Stavíte místo toho vlastní integraci nad HTTP API? Posílejte s požadavky hlavičku User-Agent. Některá běhová prostředí — včetně fetch() v Cloudflare Workers — ji ve výchozím stavu neposílají a požadavky bez ní jsou odmítnuty dřív, než dorazí k API.

​
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.
  • Hostovaný server pro cloudové agenty: https://mcp.agencyhandy.com/ (kontrola stavu na /health)
  • Balíček: agencyhandy-mcp na npm (npx -y agencyhandy-mcp@1)