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.

​
Dwa sposoby połączenia

Oba sposoby używają tego samego klucza API przestrzeni roboczej i dają agentowi te same narzędzia.
Potrzebujesz roli, która może otworzyć Workspace Config i zarządzać API keys (zwykle SuperAdmin lub Admin). Przy instalacji lokalnej potrzebujesz też Node.js 20+ na komputerze, na którym działa Claude Desktop lub Cursor — serwer hostowany nie wymaga żadnej instalacji.

​
Wymagania

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

​
Konfiguracja Claude lub Cursor MCP

Wybierz tę drogę, gdy Claude Desktop lub Cursor działa na Twoim komputerze. Jeśli agent działa w chmurze, przejdź do sekcji Podłączenie agenta w chmurze.
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.

​
Podłączenie agenta w chmurze (serwer hostowany)

Jeśli Twój agent działa tam, gdzie nie możesz zainstalować pakietu — Cloudflare Workers, funkcje Vercel, n8n albo hostowany Claude lub Cursor — skieruj go na serwer MCP, który prowadzimy za Ciebie:
Nie ma nic do instalowania ani serwera do utrzymania. Uwierzytelniaj każde żądanie tym samym kluczem API przestrzeni roboczej jako tokenem bearer. Przestrzeń robocza jest odczytywana z klucza, więc każdy użytkownik łączy się swoim własnym. Cursor, Claude Code i każdy host wysyłający własne nagłówki:
Claude Desktop nie wysyła własnych nagłówków — użyj mostu mcp-remote:
Claude Code z wiersza poleceń:
Adresem jest ścieżka główna — https://mcp.agencyhandy.com/, a nie /mcp. Aby sprawdzić, czy serwer odpowiada, otwórz https://mcp.agencyhandy.com/health.
Budujesz własną integrację na bazie API HTTP? Wysyłaj nagłówek User-Agent wraz z żądaniami. Niektóre środowiska — w tym fetch() w Cloudflare Workers — domyślnie go nie wysyłają, a żądania bez niego są odrzucane, zanim dotrą do API.

​
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
  • Serwer hostowany dla agentów w chmurze: https://mcp.agencyhandy.com/ (sprawdzenie pod /health)
  • 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.