Агент CommunitycliQ (предварительная версия)

Агент CommunitycliQ позволяет сотрудникам, чья организация использует CommunitycliQ управлять своими рабочими сообществами из Microsoft Copilot. Выступая в качестве пользователя, вошедшего в систему, они могут обнаруживать и присоединяться к группам ресурсов сотрудников (ERGs/BRG) и сходствам, просматривать лидеров сообщества и главы, следить за событиями, выполнять листы CommunityLab и отслеживать их участие, достижения и награды. Требуется учетная запись CommunitycliQ; пользователи видят только разрешенные разрешения.

Этот соединитель доступен в следующих продуктах и регионах:

Service	Class	Regions
Copilot Studio	Премия	Все регионы Power Automate за исключением следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)
Логические приложения	Стандарт	Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD)
Power Apps	Премия	Все регионы Power Apps кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)
Power Automate	Премия	Все регионы Power Automate за исключением следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)

Контакт
Имя.	MentorcliQ, Inc.
URL	https://www.communitycliq.com
Адрес электронной почты	support@communitycliq.com

Метаданные соединителя
Publisher	Mentorcliq, Inc.
Веб-сайт	https://www.communitycliq.com
Политика конфиденциальности	https://www.mentorcliq.com/privacy-policy
Categories	AI; Кадровые ресурсы

Сервер MCP CommunitycliQ

Сервер удаленного протокола контекста модели (MCP), который подключает помощников по искусственному интеллекту ( например, Claude.ai, Claude Desktop и Microsoft Copilot/Teams — к корпоративной платформе сообщества CommunitycliQ.

Обзор

CommunitycliQ — это корпоративная сообщество и платформа группы ресурсов сотрудников (ERG). Сервер CommunitycliQ MCP позволяет сотрудникам взаимодействовать со своими общинами с помощью естественного языка в помощнике по искусственному интеллекту: обнаруживать ERG, просматривать веб-каналы сообщества и домашние веб-каналы, находить и RSVP на события, читать общие ресурсы и управлять своими членами.

Что это делает: Предоставляет сообщества CommunitycliQ, веб-каналы, события, ресурсы и собственные профили или действия пользователя помощнику по искусственному интеллекту в качестве набора средств MCP.
Кто это за: Сотрудники и участники сообщества, которые уже используют CommunitycliQ и хотят получить доступ к нему от помощника по искусственному интеллекту, который они работают каждый день.
Значение в одной строке: Доведите ваши ERG, события и веб-каналы сообщества в помощник по искусственному интеллекту — каждое действие выполняется по мере использования ваших собственных разрешений.

Сервер в основном читается: большинство инструментов извлекают информацию, и горстка средств записи выполняют только обратимые действия на собственной учетной записи пользователя вошедшего пользователя (присоединение или выход из сообщества, реагирование на запись, rsVP'ing к событию). Нет административных или разрушительных операций.

Модель данных

Некоторые понятия CommunitycliQ отображаются во всех средствах:

Сети или общины — "сообщество" (также называемое сетью) — это группа ERG или интерес. Каждый из них определяется идентификатором UUID. Общины образуют иерархию: общины верхнего уровня могут иметь дочерние главы (например, региональные или конкретные разделы глобального ERG).
Записи — записи на веб-канале сообщества или на агрегированном домашнем веб-канале пользователя. Посты несут реакции типовLIKE, LOVE, CELEBRATE, SUPPORT, и LAUGHINTEREST.
События — события сообщества с узлами, описаниями, часовыми поясами и RSVP/регистрацией (включая списки ожидания при заполнении события). События можно просматривать для каждого сообщества, во всех сообществах пользователей или в виде веб-канала календаря в диапазоне дат.
Членство — членство пользователя в сообществе. Пользователи могут присоединяться и покидать общины.
Ресурсы — документы и ссылки, общие в сообществе, упорядоченные в папки и вложенные папки.

Tools

Все средства запускаются от имени прошедшего проверку подлинности пользователя. Средства чтения помечены (чтение); Средства записи помечены (WRITE) и описаны ниже. Каждое средство записи является обратимым и самоуправляемым — это влияет только на собственную учетную запись пользователя, выполнившего вход.

Профиль и разрешения

whoami (чтение) — получение удостоверения пользователя, прошедшего проверку подлинности (personId, legacyUserId, superUserId). Вызовите этот первый вопрос "я / моя / я".
get_my_profile (чтение) — получение профиля пользователя: имя, отображаемое имя, местоимения, биография, электронная почта, изображение профиля.
get_my_user_record (чтение) — получение полной записи пользователя (профиль плюс даты создания и последнего изменения, идентификатор сотрудника, электронная почта уведомления).
get_my_platform_permissions (чтение) — вывод списка разрешений на уровне платформы пользователя (например, MANAGE_USERS, MANAGE_COMMUNITIES).
get_my_network_permissions (чтение) — вывод списка разрешений пользователя в сообществе или агрегированных во всех общинах.
get_my_notification_settings (чтение) — получение параметров и настроек пользователя.
get_my_m365_integration(чтение) — получение состояния интеграции Microsoft 365 пользователя (Outlook).

Communities

list_top_level_communities (чтение) — список сообществ верхнего уровня (ERG) на платформе.
get_network_hierarchy (чтение) — получение полной иерархии сообщества (верхние уровни и главы).
get_community (чтение) — получение основных сведений для конкретного сообщества.
get_community_branding (чтение) — получение фирменной символики сообщества (логотип, баннер, цвета темы).
list_community_leaders (чтение) — перечисление общественных лидеров сообщества.
list_community_sponsors (чтение) — список исполнительных или бизнес-спонсоров сообщества.
get_community_chapter_information (чтение) — получение сведений о главе для сообщества (родителя или детей).
join_community (WRITE) — присоединение пользователя к сообществу. Обратимо через leave_community.
leave_community (WRITE) — удаление пользователя из сообщества. Идемпотент (успешно, даже если не член); обратимо через join_community.

Канал и записи

list_home_feed_posts (чтение) — вывод списка записей на домашнем веб-канале пользователя (агрегированных по всем их сообществам).
list_community_feed_posts (чтение) — вывод списка записей в веб-канале конкретного сообщества.
get_post_reaction_summary (чтение) — получение счетчиков реакций для записи, по типу реакции.
get_post_reactions (чтение) — список пользователей, которые отреагировали на публикацию, с типом реакции.
react_to_post (ЗАПИСЬ) — реагировать на запись от имени пользователя. Обратимо путем изменения или очистки реакции.

Events

list_my_events (чтение) — вывод списка предстоящих событий во всех сообществах, к которому принадлежит пользователь (доступный для поиска, разбиения на страницы).
list_upcoming_events (чтение) — компактный список предстоящих событий в сообществах пользователей.
list_community_events (чтение) — вывод списка событий сообщества в наиболее подробном представлении (узел, описание, часовой пояс, сведения о RSVP).
list_community_upcoming_events (чтение) — список следующих нескольких предстоящих событий для сообщества (компактный мини-приложение).
get_community_calendar (чтение) — получение событий сообщества в качестве упрощенного веб-канала календаря для диапазона дат.
register_for_event (WRITE) — RSVP пользователь к событию. Идемпотент; присоединяется к списку ожидания, если событие заполнено. Обратимо через unregister_from_event.
unregister_from_event (WRITE) — отмена RSVP пользователя. Идемпотент (успешно, даже если он не зарегистрирован); обратимо через register_for_event.

Действие

list_my_activities (чтение) — вывод списка последних действий и уведомлений пользователя.
get_my_unread_activity_count (чтение) — получение количества непрочитанных действий и уведомлений пользователя.
list_my_leaderships (чтение) — вывод списка сообществ, где пользователь является лидером (пустой список, если нет).

Resources

list_community_resources (чтение) — список ресурсов (документов и ссылок), общих для сообщества.
list_folder_resources (чтение) — вывод списка ресурсов непосредственно в папке ресурсов.
list_folder_subfolders (чтение) — вывод списка вложенных папок в папке ресурсов.

Отчеты и участие

get_my_stats (чтение) — данные о времени существования пользователя (имена входа, записи, комментарии, события зарегистрированы или присутствовали, записи просматриваются).
get_my_events_participation (чтение) — события, в которые участвовал пользователь (присутствовал или просматривал запись).
get_my_engagement_report (чтение) — участие на уровне сообщества по ежемесячной временной шкале (регистрация событий, вложенные часы, заработанные баллы); необязательный фильтр диапазона дат.

CommunityLab (требуется модуль CommunityLab)

list_communitylab_resources (чтение) — ресурсы обучения CommunityLab (категории → сеансы, видео, листы, ход выполнения), доступные пользователю.
get_communitylab_session (чтение) — подробные сведения об одном сеансе CommunityLab, включая его URL-адрес видео.
get_worksheet_fields (чтение) — определения полей или вопросов листа (типы полей и параметры; сам текст вопроса — это только пользовательский интерфейс и не возвращается API).
get_my_worksheet_answers (чтение) — сохраненные в настоящее время ответы пользователя на лист.
save_worksheet_answers_draft (WRITE) — сохраните собственные ответы на лист пользователя в виде черновика ("Сохранить и просмотреть позже"). Обратимым; принимает частичные ответы.
submit_worksheet_answers (WRITE) — завершение и отправка собственных ответов на лист пользователя ("Сохранить"). Проверяет заполнение всех полей; обратимо путем повторного сохранения.

Достижения и вознаграждения (требуется модуль Gamification)

get_my_achievements (чтение) — достижения (значки) пользователя заработали.
list_rewards (чтение) — каталог вознаграждения платформы (разбиение на страницы).

Количество инструментов: 45 инструментов — 38 чтения, 7 записей. 7 средств записи (join_community, , leave_community, react_to_postunregister_from_eventregister_for_event, , save_worksheet_answers_draft) submit_worksheet_answersявляются все обратимыми и действуют только на собственной учетной записи пользователя, выполнившего вход (членство, реакции, RSVPs и ответы на собственный лист пользователя).

Настройка и подключение

Сервер достигается через один общий URL-адрес. При первом подключении вы перейдете в /login средство выбора сайтов, где вы выбираете сайт CommunitycliQ и войдите через единый вход вашей организации или с помощью имени пользователя и пароля. После входа помощник подключается по мере выполнения каждого вызова средства с удостоверением и разрешениями.

Claude.ai / Claude Desktop

Откройте параметры → соединителей (или добавьте настраиваемый соединитель).
Добавьте URL-адрес сервера CommunitycliQ MCP.
Когда появится запрос, выполните вход: выберите сайт на /login странице, а затем выполните проверку подлинности с помощью единого входа или имени пользователя или пароля.
Средства CommunitycliQ становятся доступными в беседах.

Microsoft Copilot / Copilot Studio / Teams

Добавьте соединитель CommunitycliQ с помощью того же URL-адреса общего сервера.
Завершите процесс входа: выберите сайт на /login странице, а затем выполните проверку подлинности с помощью единого входа или имени пользователя или пароля.
Затем соединитель доступен для Copilot и в Teams.

Сведения о регистрации OAuth для конкретной платформы (идентификаторы клиентов, URI перенаправления и т. д.) настраиваются во время установки соединителя и документируются отдельно; Один и тот же один URL-адрес и поток выбора сайта применяется к каждой платформе.

Примеры подсказок

После подключения попробуйте:

"Кто я в CommunityCliQ?"
"Какие общины я могу присоединиться?"
"Какие события приходят в моих общинах на этой неделе?"
"Показать мне последние записи в женской сети".
"Присоединяйтесь ко мне в сообщество гордости". (обратимое, самоуправляемое действие)

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

OAuth 2.1 для каждого пользователя. Сервер является собственным сервером авторизации OAuth 2.1. Проверка подлинности использует поток PKCE (ключ проверки подлинности для кода Exchange).
Параметры входа. Пользователи проходят проверку подлинности через единый вход организации или с помощью имени пользователя и пароля после выбора сайта на /login странице.
Изоляция удостоверений. Удостоверение строго на пользователя. Каждое подключение привязано к одному вошедному пользователю, и каждый вызов средства выполняется так, как этот пользователь — нет общей учетной записи службы и нет доступа между пользователями.
Область разрешений. Средства работают в существующих разрешениях CommunitycliQ пользователя. Пользователь может просматривать и делать только через сервер MCP то, что они могли делать в CommunitycliQ напрямую.
Минимизация данных. Данные не собираются за пределами того, что каждому инструменту необходимо выполнить запрос. Средства записи касаются только собственного членства пользователя, реакций и регистрации событий.

Известные ограничения

Область уровня участника (только в этом соединителе). Сертифицированный соединитель предоставляет возможности для участников — нет средств администрирования (нет управления пользователями, управления сообществом, модерации содержимого или массовых операций). Сервер может при необходимости предоставлять средства сообщества-лидеры (создание событий, модерация post/feed), но они отключены по умолчанию, шлюзованы разрешениями CommunitycliQ пользователя и не являются частью этого соединителя, ожидающего отдельной проверки.
В основном чтение. Большинство инструментов доступны только для чтения. Единственные записи — это семь обратимых, самозаверяемых действий, перечисленных выше (членство, реакции, RSVPs и ответы на собственный лист CommunityLab пользователя); в поверхности участника нет разрушительных операций.
Сайт должен быть выбран во время подключения. Так как URL-адрес предоставляется на разных сайтах, необходимо выбрать сайт CommunitycliQ при входе. Чтобы переключить сайты, вы повторно подключитесь и выберите другой сайт.
Типы реакций исправлены. После реакции ограничены LIKE, LOVE, CELEBRATE, SUPPORT, , LAUGHи INTEREST.

Поддержка

Контакт: support@communitycliq.com. Если средство не ведет себя как документировано, добавьте запрос и имя средства, чтобы мы могли воспроизвести его.

Действия

Управление событиями сообщества CommunitycliQ и CommunityLab

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

Управление событиями сообщества CommunitycliQ и CommunityLab

Идентификатор операции:: InvokeServer