> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agencyhandy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Подключите Claude и Cursor для работы с AgencyHandy через MCP

> Настройте пакет MCP AgencyHandy, чтобы просить Claude Desktop или Cursor о брифинге, назначении тикетов, отправке счетов и другом — на обычном языке.

MCP-подключение AgencyHandy позволяет говорить с **Claude** или **Cursor** обычным языком и выполнять повседневную работу в рабочем пространстве AgencyHandy — без открытия каждого экрана вручную.

Контроль остаётся за вами. Claude и Cursor действуют только с API-ключом пространства, который вы создаёте, и просят подтверждение, если имя совпадает с несколькими людьми.

<Note>
  Нужна роль, которая может открывать **Workspace Config** и управлять **API keys** (обычно **SuperAdmin** или **Admin**). Также нужен **Node.js 20+** на компьютере, где запущены Claude Desktop или Cursor.
</Note>

## Требования

| Требование                           | Подробности                                       |
| ------------------------------------ | ------------------------------------------------- |
| **Node.js**                          | Версия **20** или новее (проверьте `node -v`)     |
| **Claude Desktop** или **Cursor**    | Одно из этих приложений установлено на компьютере |
| **Рабочее пространство AgencyHandy** | Доступ к **Workspace Config** → **API Key**       |

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

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

<Steps>
  <Step title="Открыть Workspace Config">
    В AgencyHandy откройте **Workspace Config** (настройки компании), затем вкладку **API Key**.
  </Step>

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

  <Step title="Скопировать MCP-конфиг">
    На той же вкладке **API Key** используйте панель настройки Claude / Cursor MCP. Нажмите **Copy MCP config**, чтобы JSON включил ключ и URL бэкенда.
  </Step>

  <Step title="Вставить в Cursor или Claude Desktop">
    Вставьте конфиг в:

    * **Cursor**: проектный или пользовательский `.mcp.json`
    * **Claude Desktop**: `claude_desktop_config.json`

    Сохраните команду `npx -y agencyhandy-mcp@1` и API-ключ как сгенерировано.
  </Step>

  <Step title="Перезапустить и проверить запрос">
    Полностью закройте и снова откройте **Cursor** или **Claude Desktop**. Затем попросите что-то простое, например утренний брифинг по пространству.
  </Step>
</Steps>

<Tip>
  Если Claude или Cursor не находят MCP-сервер, убедитесь, что установлен **Node.js 20+**, и перезапустите приложение после сохранения конфига.
</Tip>

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

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

| Цель                         | Пример запроса                                                                                             |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------- |
| **Утренний брифинг**         | «Дай утренний брифинг: открытые тикеты, неоплаченные счета и предложения в ожидании клиентов.»             |
| **Назначить тикет**          | «Назначь тикет по редизайну главной Acme на Jordan Lee ([jordan@agency.com](mailto:jordan@agency.com)).»   |
| **Отправить счёт**           | «Отправь счёт INV-1042 клиенту по email.»                                                                  |
| **Создать лид**              | «Создай лид для Nora Patel из Bright Studio, email [nora@brightstudio.com](mailto:nora@brightstudio.com).» |
| **Отметить счёт оплаченным** | «Отметь счёт INV-1042 как paid.»                                                                           |

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

Если в команде две Сары, Claude спросит, кого вы имеете в виду. Он **не придумывает** ID и не угадывает молча.

Всегда указывайте **полное имя** или **email** в запросе, если имена могут совпасть.

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

| Работает сейчас                                              | Пока недоступно через MCP          |
| ------------------------------------------------------------ | ---------------------------------- |
| Брифинги и поиск по предложениям, проектам, тикетам и счетам | Ответы в **client chat** через MCP |
| Назначение тикетов и другой командной работы                 | —                                  |
| Создание лидов                                               | —                                  |
| Отправка счетов и отметка об оплате                          | —                                  |

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

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

* Создавайте ключи и копируйте конфиг в приложении: **Workspace Config** → **API Key**

<Note>
  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.
</Note>

* Пакет: [`agencyhandy-mcp`](https://www.npmjs.com/package/agencyhandy-mcp) на npm (`npx -y agencyhandy-mcp@1`)