AATexЦУП ААТех
Документация
AI-интеграция

MCP: подключение AI-ассистента

Подключите Claude, Cursor или другого AI-ассистента к ЦУП ААТех и управляйте данными голосом или текстом. 101 инструментов для карточек, звонков, аналитики, производства, финансов и мессенджера.

Что такое MCP

MCP (Model Context Protocol) — открытый стандарт, по которому AI-ассистенты общаются с внешними системами. ЦУП ААТех предоставляет MCP-сервер: ваш AI-клиент (например, Claude Desktop) подключается к нему и получает доступ к 101 инструментам для работы с вашими данными.

Что это даёт: вы говорите AI «создай заказ на 10 шкафов для клиента Рога и Копыта, ответственный — Иван», и AI сам найдёт контрагента, выберет нужную доску, создаст карточку и назначит ответственного. Никакой ручной работы с интерфейсом.

Как это работает

Вы → «создай карточку заказа для ООО Ромашка»
  │
  ▼
AI-клиент (Claude Desktop, Cursor, …)
  │  JSON-RPC поверх HTTPS
  ▼
https://app.aatex.ru/mcp
  │
  ▼
MCP-сервер ЦУП ААТех
  ├─ проверяет JWT + права пользователя
  ├─ вызывает нужный инструмент (list_contragents, create_card, …)
  └─ возвращает результат
  │
  ▼
AI отвечает: «создал карточку #123, ссылка …»
Адрес сервера: https://app.aatex.ru/mcp

Как подключить AI-клиента

  1. Откройте Профиль → MCP в ЦУП ААТех.
  2. Нажмите «Создать ключ» и скопируйте значение — оно показывается один раз.
  3. В AI-клиенте добавьте MCP-сервер: URL https://app.aatex.ru/mcp, заголовок авторизации Authorization: Bearer <ваш ключ>.
  4. Укажите организацию заголовком x-organization-id: <id вашей организации>.
  5. Перезапустите AI-клиент — инструменты появятся автоматически.
Для доступа к MCP нужно разрешение org.mcp или org.manage. По умолчанию есть у owner/admin и ролей, где включён MCP.

Группы инструментов

Инструменты сгруппированы по доменам. AI-клиент сам решает какой вызвать — вам достаточно описать задачу на естественном языке.

Навигация и доски

6 инструментов

Пространства, доски и колонки — чтобы AI понял структуру ваших данных.

▼
list_spacesСписок пространств организации
list_boardsСписок досок в пространстве
list_all_boardsВсе доски организации одним запросом
get_board_columnsКолонки доски и ограничения по типам карточек
delete_boardАрхивировать доску (soft-delete)
archive_boardАлиас для delete_board

Карточки

15 инструментов

CRUD карточек, поиск, перемещение, история и иерархия.

▼
list_cardsКарточки на доске (compact, с пагинацией)
get_cardПолные детали одной карточки
create_cardСоздать карточку любого типа
update_cardОбновить поля карточки, контрагентов, даты
delete_cardУдалить карточку (soft-delete)
move_cardПереместить карточку в другую колонку или на другую доску
search_cardsПоиск по названию
get_card_childrenДочерние карточки одного уровня
get_card_treeВсё дерево потомков рекурсивно
get_card_historyИстория изменений (аудит-лог)
archive_cardАрхивация / разархивация
bulk_move_cardsМассовое перемещение
assign_responsibleНазначить ответственного
get_user_cardsВсе карточки конкретного пользователя
get_card_commentsЧтение комментариев к карточке

Аналитика

8 инструментов

Общая картина организации, просрочки, загрузка команды, цикл выполнения.

▼
get_board_summaryСводка по одной доске
get_overdue_cardsПросроченные карточки доски
get_team_workloadЗагрузка команды на доске
get_org_summaryСнимок по всей организации
get_org_overdue_cardsВсе просрочки по организации
get_org_team_workloadЗагрузка всех сотрудников
get_recent_activityПоследние события из истории
get_cycle_time_statsСреднее время прохождения колонок

Мой рабочий день

4 инструментов

AI-клиент помогает рядовому сотруднику спланировать день.

▼
get_my_tasksМои активные задачи (сегодня, просрочки, неделя)
get_my_deadlinesБлижайшие дедлайны — карточки и события календаря
get_my_mentionsНепрочитанные упоминания и важные уведомления
get_my_activity_feedЧто я делал за период (1д/7д/30д)

Файлы

6 инструментов

Загрузка и скачивание вложений карточек, комментариев и сообщений.

▼
upload_card_fileЗагрузить файл в карточку (base64)
upload_comment_fileФайл для комментария
upload_message_fileФайл для сообщения мессенджера
list_card_attachmentsСписок файлов карточки
get_attachment_urlСсылка для скачивания (1 час)
delete_attachmentУдалить вложение

Мессенджер

7 инструментов

Чаты, групповые беседы и каналы — AI может читать и писать.

▼
list_conversationsСписок бесед
list_messagesСообщения в беседе
send_messageОтправить сообщение (+ вложения)
create_conversationСоздать чат или канал
get_unread_summaryСводка непрочитанных
add_conversation_participantsДобавить участников
search_messagesПоиск по сообщениям

Комментарии

2 инструментов

Обсуждение карточек.

▼
list_card_commentsКомментарии к карточке
create_card_commentДобавить комментарий (+ вложения)

Пользователи

2 инструментов

Поиск сотрудников организации.

▼
list_usersСписок пользователей (с поиском)
get_userИнформация о пользователе по ID

Контрагенты (CRM)

5 инструментов

Клиенты и партнёры, поиск по ИНН в ЕГРЮЛ.

▼
list_contragentsСписок контрагентов
get_contragentРеквизиты, контакты, банк
create_contragentСоздать контрагента
update_contragentОбновить данные
search_contragent_by_innПоиск в ЕГРЮЛ по ИНН

Уведомления

3 инструментов

Чтение и пометка уведомлений пользователя.

▼
get_notificationsСписок уведомлений
get_unread_countКоличество непрочитанных
mark_notifications_readОтметить прочитанными

Продукция и производство

9 инструментов

Каталог изделий, производственные доски и планирование потока.

▼
list_productsКаталог продукции
get_productДетали изделия
list_product_boardsДоступные производственные доски
get_product_boardДетали доски и holidays
list_product_categoriesКатегории каталога
get_product_category_statsАгрегаты по категориям
list_production_ordersЗаказы на производство (с фильтрами)
place_card_on_productionРазместить карточку в потоке
remove_card_from_productionСнять карточку

Финансы

6 инструментов

Баланс, подписка, счета и транзакции (для руководителя).

▼
get_org_usageПлан, лимиты, потребление
get_balanceБаланс организации в рублях
list_transactionsИстория транзакций
list_invoicesСчета организации
get_invoiceДетали счёта
get_subscriptionАктивная подписка и следующее списание

Отчёты

2 инструментов

Выручка по периодам и загрузка производственных досок.

▼
get_revenue_reportВыручка за период с разбивкой
get_cell_metrics_reportЗагрузка досок по дням (utilization %)

Звонки

6 инструментов

История звонков, записи и транскрипции.

▼
list_callsИстория звонков пользователя
get_callДетали звонка с участниками и записями
get_active_callТекущий активный звонок
get_call_recording_urlСсылка на аудиозапись (1 час)
get_call_transcriptionТекст транскрипции — AI читает о чём говорили
request_call_transcriptionЗапустить транскрипцию вручную

Календарь событий

13 инструментов

Календари организации и события, привязанные к карточкам.

▼
list_calendar_boardsВсе календари организации
get_calendar_boardНастройки и доступы календаря
create_calendar_boardСоздать календарь
update_calendar_boardОбновить настройки
update_calendar_board_accessУправлять доступом (editors/viewers)
delete_calendar_boardУдалить календарь
list_calendar_eventsСобытия в диапазоне дат
get_calendar_eventДетали события
create_calendar_eventСоздать событие (цвет, тип, assignee)
update_calendar_eventОбновить событие
delete_calendar_eventУдалить событие
toggle_calendar_event_completeПереключить статус выполнения
list_card_calendar_eventsВсе события карточки

Организация и команда

7 инструментов

Участники, приглашения, роли, свойства и выходные.

▼
list_membersУчастники с ролями
invite_memberПригласить нового сотрудника
change_member_roleИзменить роль
deactivate_memberДеактивировать участника
list_invitesОжидающие приглашения
list_propertiesЦветные лейблы карточек
list_holidaysПроизводственные выходные

Типичные сценарии

Несколько примеров того, как AI выстраивает цепочку инструментов для решения задачи.

Создать заказ

  1. list_contragents — найти покупателя и продавца
  2. list_spaces → list_boards → get_board_columns — найти доску «Заказы» и колонку
  3. create_card c cardType: "order" и данными контрагентов

Переместить карточку

  1. search_cards — найти карточку по названию
  2. get_board_columns — получить ID целевой колонки
  3. move_card — переместить с новой позицией

Мой рабочий день

  1. get_my_tasks (filter: "today") — активные задачи на сегодня
  2. get_my_deadlines (days: 7) — ближайшие дедлайны
  3. get_my_mentions — непрочитанные упоминания

Руководитель: общая картина

  1. get_org_summary (period: "7d") — снимок по всей организации
  2. get_org_overdue_cards — все просрочки с фильтрами
  3. get_org_team_workload — загрузка всех сотрудников

Разобраться в звонке

  1. list_calls — история звонков
  2. get_call_transcription — прочитать о чём говорили (без скачивания аудио)
  3. request_call_transcription — если транскрипция ещё не сделана

Планирование производства

  1. list_product_boards → get_product_board — найти доску и holidays
  2. get_cell_metrics_report — загрузка по дням
  3. place_card_on_production — поставить карточку в поток

Создать контрагента по ИНН

  1. search_contragent_by_inn — проверить в ЕГРЮЛ
  2. create_contragent — создать с данными из ЕГРЮЛ

Создать событие в календаре

  1. list_calendar_boards — найти нужный календарь
  2. search_cards — найти карточку для привязки
  3. create_calendar_event — создать событие с датой, временем и assignee

Безопасность

AI работает от вашего имени с теми же правами, что и в веб-интерфейсе. Пять уровней защиты не дадут AI-клиенту превысить ваши полномочия.

1

JWT-аутентификация

Каждый запрос требует подписанный токен. Без токена — 401.

2

Мгновенный отзыв токена

При выходе (logout) инкрементится tokenVersion в БД — все MCP-сессии пользователя моментально теряют доступ.

3

Привязка к организации

Обязательный заголовок x-organization-id проверяется на каждом запросе. Сменить организацию внутри сессии нельзя.

4

Привязка сессии к пользователю

Чужую сессию использовать нельзя — проверка session.userId на каждом запросе.

5

Изоляция данных в инструментах

Карточки, доски, комментарии и мессенджер проходят через тот же access control, что и UI. Viewer не сможет создать карточку через MCP, если не может через интерфейс.

На практике: AI-клиент видит ровно те же данные и может делать ровно то же, что и пользователь, от имени которого подключился. Multi-tenant изоляция работает на всех уровнях — данные вашей организации недоступны из других.

Частые вопросы

Какие AI-клиенты поддерживаются?

Любой, умеющий работать с MCP по протоколу HTTP: Claude Desktop, Cursor, Continue, собственные боты на MCP SDK. Для десктопа Claude — нужна версия с поддержкой «remote MCP» (URL-серверов).

Сколько стоит?

MCP включён во все тарифы — отдельной оплаты нет. Доступ регулируется только разрешением org.mcp в роли.

Как долго живёт сессия?

Сессия живёт 2 часа с момента последнего запроса. Access-token обновляется автоматически при каждом запросе — AI-клиент присылает свежий, сервер его подхватывает.

AI что-то сломает?

AI видит ровно ваши права. Если у вас нет прав удалять карточки — AI тоже не сможет. Все действия пишутся в аудит-лог (get_card_history).

Можно ли использовать для нескольких организаций?

Да, но каждая организация — отдельная MCP-сессия со своим заголовком x-organization-id. В Claude Desktop можно подключить несколько серверов с разными заголовками.

Где посмотреть список инструментов в AI-клиенте?

После подключения большинство клиентов показывают доступные tools в настройках MCP. Полный список с описаниями — в разделе «Группы инструментов» выше.