Skip to main content
Połączenie MCP AgencyHandy pozwala rozmawiać z Claude lub Cursor w naturalnym języku i wykonywać codzienną pracę w przestrzeni AgencyHandy — bez otwierania każdego ekranu samodzielnie. Ty zachowujesz kontrolę. Claude i Cursor działają tylko z kluczem API przestrzeni, który wygenerujesz, i proszą o potwierdzenie, gdy nazwa pasuje do więcej niż jednej osoby.
Potrzebujesz roli, która może otworzyć Workspace Config i zarządzać API keys (zwykle SuperAdmin lub Admin). Potrzebujesz też Node.js 20+ na komputerze, na którym działa Claude Desktop lub Cursor.

​
Wymagania

Pakiet MCP w npm to agencyhandy-mcp. Claude i Cursor uruchamiają go przez npx -y agencyhandy-mcp@1.

​
Konfiguracja Claude lub Cursor MCP

1

Otwórz Workspace Config

W AgencyHandy otwórz Workspace Config (ustawienia firmy), a następnie kartę API Key.
2

Wygeneruj klucz API przestrzeni

Utwórz nowy klucz API przestrzeni (lub użyj zapisanego). Skopiuj klucz, gdy się pojawi — AgencyHandy nie pokaże pełnego klucza ponownie później.
3

Skopiuj konfigurację MCP

Na tej samej karcie API Key użyj panelu Claude / Cursor MCP. Kliknij Copy MCP config, aby JSON zawierał klucz i URL backendu.
4

Wklej do Cursor lub Claude Desktop

Wklej konfigurację do:
  • Cursor: projektowy lub użytkownika .mcp.json
  • Claude Desktop: claude_desktop_config.json
Zachowaj polecenie npx -y agencyhandy-mcp@1 i klucz API w wygenerowanej postaci.
5

Uruchom ponownie i wypróbuj prompt

Całkowicie zamknij i otwórz ponownie Cursor lub Claude Desktop. Następnie poproś o coś prostego, np. poranny briefing przestrzeni.
Jeśli Claude lub Cursor nie znajdzie serwera MCP, potwierdź instalację Node.js 20+ i restart aplikacji po zapisaniu konfiguracji.

​
Przykładowe prompty

Używaj naturalnego języka. Przy przypisywaniu pracy preferuj pełne imiona lub e-maile, aby wybrać właściwą osobę.

​
Gdy dwie osoby mają to samo imię

Jeśli dwie osoby w zespole nazywają się Sara, Claude zapyta, o którą chodzi. Nie wymyśla ID i nie zgaduje po cichu. Zawsze podawaj pełne imię i nazwisko lub e-mail w prompcie, gdy imiona mogą się kolidować.

​
Co działa teraz vs jeszcze nie

MCP umożliwia odczyt przestrzeni i działania (tworzenie, przypisywanie, wysyłanie, aktualizację) z kluczem API. Odpowiedzi w czacie klienta nie są jeszcze dostępne przez MCP — użyj AgencyHandy do tych rozmów.

​
Powiązane

  • Generuj klucze i kopiuj konfigurację w aplikacji: Workspace Config → API Key
  • Pakiet: agencyhandy-mcp w 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.