Skip to main content
MCP-подключение AgencyHandy позволяет говорить с Claude или Cursor обычным языком и выполнять повседневную работу в рабочем пространстве AgencyHandy — без открытия каждого экрана вручную. Контроль остаётся за вами. Claude и Cursor действуют только с API-ключом пространства, который вы создаёте, и просят подтверждение, если имя совпадает с несколькими людьми.
Нужна роль, которая может открывать Workspace Config и управлять API keys (обычно SuperAdmin или Admin). Также нужен Node.js 20+ на компьютере, где запущены Claude Desktop или Cursor.

​
Требования

MCP-пакет на npm — agencyhandy-mcp. Claude и Cursor запускают его командой npx -y agencyhandy-mcp@1.

​
Настройка Claude или Cursor MCP

1

Открыть Workspace Config

В AgencyHandy откройте Workspace Config (настройки компании), затем вкладку API Key.
2

Создать API-ключ пространства

Создайте новый API-ключ пространства (или используйте сохранённый). Скопируйте ключ, когда он появится — позже AgencyHandy не сможет показать полный ключ снова.
3

Скопировать MCP-конфиг

На той же вкладке API Key используйте панель настройки Claude / Cursor MCP. Нажмите Copy MCP config, чтобы JSON включил ключ и URL бэкенда.
4

Вставить в Cursor или Claude Desktop

Вставьте конфиг в:
  • Cursor: проектный или пользовательский .mcp.json
  • Claude Desktop: claude_desktop_config.json
Сохраните команду npx -y agencyhandy-mcp@1 и API-ключ как сгенерировано.
5

Перезапустить и проверить запрос

Полностью закройте и снова откройте Cursor или Claude Desktop. Затем попросите что-то простое, например утренний брифинг по пространству.
Если Claude или Cursor не находят MCP-сервер, убедитесь, что установлен Node.js 20+, и перезапустите приложение после сохранения конфига.

​
Примеры запросов

Используйте естественный язык. При назначении работы предпочитайте полные имена или email, чтобы выбрать нужного человека.

​
Когда у двух людей одно имя

Если в команде две Сары, Claude спросит, кого вы имеете в виду. Он не придумывает ID и не угадывает молча. Всегда указывайте полное имя или email в запросе, если имена могут совпасть.

​
Что работает сейчас vs ещё нет

MCP позволяет читать пространство и выполнять действия (создать, назначить, отправить, обновить) с вашим API-ключом. Ответы в клиентском чате через MCP пока не доступны — используйте AgencyHandy для этих разговоров.

​
Связанные материалы

  • Создавайте ключи и копируйте конфиг в приложении: 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.