Тема
Подключение к NORM
NORM берёт данные компании — встречи, людей, должности, протоколы — у её MCP-сервера. Эта страница — для разработчика такого сервера и для администратора компании в NORM: как подключить сервер и какие инструменты нужны каждой функции NORM. Что именно вернуть на вызов инструмента, описывает контракт MCP, текущая версия — v0.13.0.
Сверено с NORM 26 октября 2026 года
Кабинет, шлюз MCP и агенты NORM на эту дату. Строки и пункты агентов и сервера стандарта NORM сверены 3 ноября 2026 года на версиях агентов: «Дайджест встреч» — 2.3.0, «Протоколы встреч» — 4.5.0, «Аналитик встреч» — 2.3.0, «Аналитик конкурентов» — 0.4.1; «Align: слаженность команды» — 5 ноября 2026 года на версии 2.4.0; строка экрана «Коммуникации» — 6 ноября 2026 года. Если кнопка или экран в кабинете называется иначе — верьте кабинету.
С чего начать
- Реализуйте на своём сервере инструменты
norm_*из каталога контракта — те, что нужны вашим функциям: смотрите что нужно функциям NORM. - Откройте сервер в интернет по HTTPS. Транспорт и формат вызова — в разделе контракта «Подключение».
- Подключите сервер в кабинете NORM и дождитесь статуса «Работает».
- Подключите нужных агентов в разделе «Агенты» кабинета. Как устроены агенты — в разделе портала «Агенты».
Как подключить сервер
Кто подключает
Сотрудник с правом «Управление MCP-интеграциями». По умолчанию оно есть у владельца и администратора компании.
Где
Настройки компании → вкладка «MCP-серверы» → «MCP компании» → кнопка «Подключить сервер». Сначала выберите способ входа — «OAuth» или «Токен», затем заполните поля.
Что ввести
- Идентификатор сервера — короткое имя, уникальное в компании, например
company-crm. Его видно в карточке подключения, а модель в чате NORM видит его рядом с описанием каждого инструмента сервера. - Адрес MCP endpoint — адрес, по которому сервер принимает MCP-запросы, например
https://mcp.example.com/mcp. Адрес должен открываться из интернета по HTTPS: на внутренние и частные адреса NORM не ходит. - Приоритет — целое число, по умолчанию 10. Если один и тот же инструмент есть у нескольких подключённых серверов, NORM вызывает сервер с большим приоритетом. Если инструменты серверов не пересекаются, приоритет ни на что не влияет.
Адрес и приоритет можно поменять потом — кнопкой «Настройки» в карточке подключения. У подключения через OAuth адрес не меняется.
Вход: OAuth или токен
NORM передаёт токен в заголовке Authorization: Bearer <токен> каждого запроса. Откуда он берётся, выбирают при подключении.
- OAuth — вход по спецификации авторизации MCP. После «Продолжить через OAuth» откроется страница входа вашего сервера авторизации; токен NORM получает и обновляет сам. Что для этого должен уметь сервер — в разделе контракта «Подключение».
- Токен — постоянный токен доступа, который выпускаете вы. Вставьте его в поле «Токен доступа». NORM хранит токен в шлюзе MCP и не обновляет его; прочитать сохранённый токен нельзя, только заменить — кнопкой «Заменить токен» в карточке подключения.
Личность сотрудника
Серверу бывает нужно знать, кто из сотрудников вызывает инструмент, — например, чтобы отдавать каждому только его данные. Это решает галочка «Это сервер нашей компании — передавать ему личность сотрудников».
- Галочка есть только у подключения по токену. С ней NORM передаёт серверу почту, роль и права сотрудника, который обращается к серверу.
- Без галочки и при подключении через OAuth сервер личность сотрудников не получает: для него все вызовы приходят с одним токеном подключения.
- Потом галочку не поставить и не снять. Чтобы изменить решение, удалите подключение и подключите сервер заново.
Нужна личность сотрудника — подключайте сервер по токену и ставьте галочку. Ставьте её только серверу, которым управляет ваша компания: сторонний сервис личность сотрудников получать не должен.
Как сервер узнаёт сотрудника. Когда NORM вызывает инструмент от имени сотрудника, шлюз добавляет к запросу HTTP-заголовки. Их получают только сервер, подключённый по токену с галочкой, и общие проверенные серверы.
| Заголовок | Что в нём |
|---|---|
x-ds-principal-id | кто вызывает: идентификатор сотрудника в NORM |
x-ds-principal-email | почта сотрудника строчными буквами; если почты нет, заголовка нет |
x-ds-tenant-id | идентификатор компании в NORM |
x-ds-role | роль сотрудника в компании: owner, admin или member |
x-ds-scopes | права сотрудника — JSON-массив строк, например ["ops.read","write.notes"] |
x-ds-principal-exp | до какого момента действуют эти сведения — Unix-время в секундах |
x-ds-delegation-id | поручение, по которому NORM действует от имени сотрудника |
x-ds-mcp-server-id | идентификатор подключения — тот, что ввели в кабинете |
x-ds-authz-version, x-ds-tenant-authz-version | версии прав сотрудника и компании в NORM — целые числа |
Проверку сервера и чтение списка инструментов шлюз делает без этих заголовков. Заголовок x-ds-correlation-id — номер запроса для журналов — приходит всем серверам с любым запросом.
Заголовки не подписаны
Верьте им, только если в том же запросе пришёл ваш токен подключения (Authorization: Bearer …): этот токен знает только шлюз NORM. Запрос с такими заголовками, но без вашего токена — не от NORM.
Раздел контракта «Принципал» описывает целевой способ — подписанный заголовок X-Norm-Principal (ES256). Платформа его пока не передаёт: сейчас личность сотрудника приходит только в заголовках из таблицы выше.
После подключения
- Шлюз MCP NORM — часть NORM, через которую идут все вызовы к серверу; в кабинете он называется Gateway. Сразу после подключения статус сервера — «Не подтверждено», а список инструментов пуст. Когда проверка сервера пройдёт, шлюз сам запросит у него список инструментов (
tools/list). Чтобы увидеть его в карточке подключения, в блоке «Обнаруженные инструменты», откройте раздел заново или нажмите «Обновить инструменты». Инструмент с аннотацией MCPreadOnlyHint: falseотмечен как «изменяет данные» — ставьте аннотацию каждому инструменту. - Новые инструменты сами не появятся. Добавили или изменили инструменты на сервере — нажмите «Обновить инструменты» в карточке. Сам шлюз перечитывает список, только пока он пуст.
- Шлюз регулярно проверяет, отвечает ли сервер. Статус — в карточке:
- «Работает» — проверка прошла, инструменты сервера доступны функциям NORM;
- «Есть проблема» — сервер не прошёл проверку. Пока статус не вернётся к «Работает», NORM его инструменты не вызывает: экраны останутся без данных, агенты не смогут работать;
- «Не подтверждено» — шлюз ещё не проверил сервер; инструменты станут доступны, когда статус сменится на «Работает».
- Токен перестал подходить. На ответ HTTP 401 подключение получает пометку «Требуется повторный вход» (OAuth) или «Требуется новый токен». Тогда нажмите в карточке «Войти снова» или «Заменить токен».
Общие серверы
В том же разделе есть блок «Golden Standard MCP» — общие проверенные серверы, которые ведёт NORM. Каждый подключается к компании отдельно, кнопкой «Подключить». Среди них — сервер стандарта NORM: без него не подключить агента «Align: слаженность команды», ему нужны инструменты стандарта evaluation_kit, get и list. Текста встреч и имён участников на сервере стандарта нет: агент передаёт ему только коды видов встреч и норм, дату оценки и служебные признаки запроса, а шлюз, как всем общим серверам, — личность сотрудника, от чьего имени работает агент. Подробно — на странице агента.
Агенту «Протоколы встреч» сервер стандарта не обязателен. Если сервер отдаёт инструменты list_genres, norms_for_genre и get_norm, агент пишет протокол по нормам для вида встречи, а нет — без норм. Серверу стандарта агент передаёт только коды вида встречи и норм, а шлюз — личность сотрудника. Подробно — на странице агента.
Что нужно функциям NORM
Каталог контракта открытый: ни один инструмент не обязателен для всех. Обязательность появляется у конкретной функции NORM.
- Экран кабинета читает данные у сервера, когда его открывают. Без обязательного инструмента экран останется без данных и скажет почему. Без желательного откроется, но часть экрана будет пустой или проще.
- Агент работает по расписанию. Без обязательного инструмента агента нельзя подключить: кабинет скажет, каких инструментов компании не хватает. Без желательного агент работает, но пропускает часть работы.
Инструменты одной функции могут лежать на разных серверах компании: NORM ищет каждый инструмент среди всех подключённых серверов в статусе «Работает».
Экраны раздела Align
Раздел Align в кабинете — главная страница «Align» (в контракте — экран «Обзор») и подпункты «Сотрудники», «Коммуникации», «Должности». Подпункт «Оргструктура» ведёт в оргструктуру самого NORM: MCP-сервер она не читает.
Экраны читают данные у сервера правами сотрудника, который их открыл.
- Главную страницу «Align», «Коммуникации» и выводы о людях на «Сотрудниках» видят только владелец и администратор компании.
- Список сотрудников, карточку сотрудника и «Должности» видят и другие участники.
- Всем им нужен доступ «Записи и расшифровки встреч». У владельца и администратора он есть по умолчанию, остальным его выдают отдельно.
Ответ не по контракту экран считает сбоем и остаётся без данных.
| Экран | Обязательные — без них экран без данных | Желательные — что будет без них |
|---|---|---|
| Главная страница «Align» | norm_align_summary_get | norm_org_units, norm_people_list — люди в выводах без должностейnorm_roles_list — должности только из role_name в назначениях сотрудников |
| «Сотрудники», карточка сотрудника | norm_org_unitsnorm_people_list | norm_roles_list — должности только из role_name в назначениях сотрудников; блоки «Должности без исполнителя» и «Держится на одном человеке» скажут, что компания не ведёт справочник должностей |
| «Должности» | norm_roles_list — списокnorm_role_get — карточка должности | norm_org_units — должности без подразделенийnorm_people_list — не видно, кто занимает должностьnorm_role_description — описание должности не скачать |
| «Коммуникации» | norm_meeting_reviews_list | norm_people_list, norm_org_units — сотрудниками считаются все участники встреч, отделов нет; экран об этом предупредитnorm_roles_list — должности организаторов только из role_name в назначенияхnorm_protocol_types — типы из справочника компании без названий: экран покажет их кодомnorm_hour_costs_list — нет стоимости встречnorm_meeting_advice_get — нет рекомендацийnorm_meetings_list — экран не покажет, сколько встреч за период всего и сколько из них разобрано; список за период он читает целиком, по страницам |
Данные двух экранов пишут агенты, поэтому серверу нужны и инструменты записи этих агентов (таблица ниже):
- сводку для главной страницы «Align» пишет агент «Align: слаженность команды». Пока он её не записал, экран скажет, что сводки за период пока нет;
- разборы встреч и рекомендации для «Коммуникаций» пишет агент «Аналитик встреч». Экран строится только по разборам: встречу, которую агент ещё не разобрал, он не покажет. Человеко-часы, потери и стоимость экран считает сам, по разборам: итогов сервер компании не хранит.
Агенты
- «Аналитик встреч» разбирает каждую новую встречу и раз в день предлагает шаги, которые сократят потери времени; по его разборам и рекомендациям строится экран «Коммуникации».
- «Дайджест встреч» собирает один дайджест встреч выбранных людей за день или неделю: календари против записей и протоколов, нарушения правил компании по её документам, решения и поручения. Дневной дописывает найденные нарушения в реестр нарушений компании.
- «Align: слаженность команды» разбирает каждую новую встречу по нормам стандарта NORM и раз в день пишет сводку для главной страницы «Align».
- «Аналитик конкурентов» каждый день пишет, что изменилось у конкурентов. Сервер компании ему не нужен: он читает открытые сайты конкурентов. Общие серверы NORM ему тоже не нужны, поэтому в таблице ниже его нет.
Агент обращается к серверу от имени своего владельца — сотрудника, который его подключил или которому агента передали, — и с его доступами: сервер, который получает личность, отдаст агенту то же, что владельцу агента. Поэтому агентов, которые должны видеть все встречи компании, подключает владелец или администратор компании.
Как агенты работают — от чьего имени, где результат, что значат статусы прогона и ошибки — на странице «Как устроены агенты NORM».
| Агент | Обязательные — без них агента не подключить | Желательные — что будет без них |
|---|---|---|
| «Аналитик встреч» | norm_meetings_listnorm_meeting_getnorm_meeting_transcriptnorm_meeting_reviews_listnorm_meeting_reviews_upsert | norm_protocol_types — типы встреч из стартового перечня агента, а не из справочника компанииnorm_people_list — сотрудником считается каждый участник с почтойnorm_meeting_advice_upsert — нет рекомендацийnorm_north_get — разбор и рекомендации без миссии, видения и ценностей компании; на дату сверки кабинет этот инструмент агентам не выдаёт |
| «Дайджест встреч» | norm_people_listnorm_meetings_listnorm_protocols_listnorm_protocol_get | norm_calendar_events_list — без запланированных встреч и состояния календарей: не видно, что прошло без записи, что отменили и у кого пустой календарьnorm_documents_list, norm_document_get — без проверки правил компании: нет нарушений, системных встреч и целейnorm_meeting_get — запись без почт участников не привязать к людям, событие и запись связываются только по времени и участникам, повестка записей неизвестнаnorm_violations_list — дневной не покажет открытые нарушения, недельный — итога недели по рееструnorm_violations_append — дневной не допишет нарушения в реестрnorm_north_get — без миссии, видения и ценностей компании; на дату сверки кабинет этот инструмент агентам не выдаёт |
| «Align: слаженность команды» | norm_meetings_listnorm_meeting_getnorm_meeting_transcriptnorm_align_assessments_listnorm_align_assessments_upsertnorm_align_summary_upsertс сервера стандарта NORM: evaluation_kit, get, list | norm_people_list — цитаты и люди в сводке не связаны с сотрудниками компанииnorm_north_get — сводка без миссии, видения и ценностей компании; на дату сверки кабинет этот инструмент агентам не выдаёт |
Если у сервера нет календаря, документов или реестра нарушений, «Дайджест встреч» так и пишет в самом дайджесте.
Агенты «Протоколы встреч» и «Аналитика команды» пока работают на инструментах, которых нет в контракте (например, meetings_recent и record_upsert). С сервером, который реализует только контракт, их не подключить. Какие инструменты и доступы нужны «Протоколам встреч» и что будет без желательных — на странице агента.
Чат
Чат NORM получает инструменты подключённых серверов в статусе «Работает», доступные сотруднику: и norm_*, и собственные инструменты сервера. Обязательных нет — без них чат отвечает, не зная данных компании. Инструмент модель выбирает по описанию из tools/list: пишите в нём, что инструмент делает и когда его звать.
Где описаны данные
Всё о форме данных — в контракте MCP, текущая версия — v0.13.0:
- Каталог инструментов — все
norm_*по семействам, с аргументами и примерами ответов. - Ответ инструмента, постраничная выдача и пределы — общая форма ответа любого инструмента.
- Ошибки и состояния — коды ошибок и доменные состояния: например, как ответить, что данных пока нет.
- Версии и изменения — как контракт меняется от версии к версии.
- Установка — как поставить пакет контракта в свой проект.