Skip to content

Подключение к 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 года. Если кнопка или экран в кабинете называется иначе — верьте кабинету.

С чего начать ​

  1. Реализуйте на своём сервере инструменты norm_* из каталога контракта — те, что нужны вашим функциям: смотрите что нужно функциям NORM.
  2. Откройте сервер в интернет по HTTPS. Транспорт и формат вызова — в разделе контракта «Подключение».
  3. Подключите сервер в кабинете NORM и дождитесь статуса «Работает».
  4. Подключите нужных агентов в разделе «Агенты» кабинета. Как устроены агенты — в разделе портала «Агенты».

Как подключить сервер ​

Кто подключает ​

Сотрудник с правом «Управление 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). Чтобы увидеть его в карточке подключения, в блоке «Обнаруженные инструменты», откройте раздел заново или нажмите «Обновить инструменты». Инструмент с аннотацией MCP readOnlyHint: 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_getnorm_org_units, norm_people_list — люди в выводах без должностей
norm_roles_list — должности только из role_name в назначениях сотрудников
«Сотрудники», карточка сотрудникаnorm_org_units
norm_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_listnorm_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_list
norm_meeting_get
norm_meeting_transcript
norm_meeting_reviews_list
norm_meeting_reviews_upsert
norm_protocol_types — типы встреч из стартового перечня агента, а не из справочника компании
norm_people_list — сотрудником считается каждый участник с почтой
norm_meeting_advice_upsert — нет рекомендаций
norm_north_get — разбор и рекомендации без миссии, видения и ценностей компании; на дату сверки кабинет этот инструмент агентам не выдаёт
«Дайджест встреч»norm_people_list
norm_meetings_list
norm_protocols_list
norm_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_list
norm_meeting_get
norm_meeting_transcript
norm_align_assessments_list
norm_align_assessments_upsert
norm_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: