CommunitycliQ Agent (versión preliminar)
CommunitycliQ Agent permite a los empleados cuya organización usa CommunitycliQ administrar sus comunidades del lugar de trabajo desde Microsoft Copilot. Actuando como usuario que ha iniciado sesión, puede detectar y unirse a grupos de recursos de empleados (ERG/BRG) y grupos de afinidad, examinar los líderes y capítulos de la comunidad, mantenerse al día de los eventos, completar hojas de cálculo de CommunityLab y realizar un seguimiento de su participación, logros y recompensas. Requiere una cuenta communitycliQ; los usuarios solo ven lo que permiten sus permisos.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | MentorcliQ, Inc. |
| DIRECCIÓN URL | https://www.communitycliq.com |
| support@communitycliq.com |
| Metadatos del conector | |
|---|---|
| Publicador | Mentorcliq, Inc. |
| Sitio web | https://www.communitycliq.com |
| Directiva de privacidad | https://www.mentorcliq.com/privacy-policy |
| Categorías | IA; Recursos humanos |
Servidor MCP de CommunitycliQ
Un servidor remoto del Protocolo de contexto de modelo (MCP) que conecta asistentes de INTELIGENCIA ARTIFICIAL (como Claude.ai, Claude Desktop y Microsoft Copilot/Teams) a la plataforma de la comunidad empresarial CommunitycliQ.
Visión general
CommunitycliQ es una plataforma de grupo de recursos de empleados (ERG) y de la comunidad empresarial. El servidor MCP communitycliQ permite a los empleados interactuar con sus comunidades a través de lenguaje natural en un asistente de IA: detectar ERG, examinar fuentes de comunidad y hogar, buscar y RSVP a eventos, leer recursos compartidos y administrar sus propias pertenencias.
- Lo que hace: Expone las comunidades de CommunitycliQ, las fuentes, los eventos, los recursos y el propio perfil o actividad del usuario a un asistente de IA como un conjunto de herramientas de MCP.
- Quién es para: Empleados y participantes de la comunidad que ya usan CommunitycliQ y quieren llegar a él desde el asistente de inteligencia artificial en el que trabajan todos los días.
- Valor en una línea: Incorpore los ERG, los eventos y las fuentes de la comunidad al asistente de inteligencia artificial; cada acción se ejecuta a medida que usted tiene el ámbito de sus propios permisos.
El servidor es principalmente de lectura: la mayoría de las herramientas recuperan información, y la serie de herramientas de escritura solo realizan acciones reversibles en la cuenta del usuario que ha iniciado sesión (unirse o salir de una comunidad, reaccionar a una publicación, RSVP'ing a un evento). No hay operaciones administrativas o destructivas.
Modelo de datos
Aparecen algunos conceptos de CommunitycliQ en todas las herramientas:
- Redes o comunidades : una "comunidad" (también denominada red) es un grupo de interés o ERG. Cada uno se identifica mediante un UUID. Las comunidades forman una jerarquía: las comunidades de nivel superior pueden tener capítulos secundarios (por ejemplo, capítulos regionales o específicos del sitio de un ERG global).
-
Publicaciones : entradas en una fuente de la comunidad o en la fuente principal agregada del usuario. Las publicaciones llevan reacciones de tipos
LIKE, ,LOVECELEBRATE,SUPPORT,LAUGHyINTEREST. - Eventos: eventos de la comunidad con hosts, descripciones, zonas horarias y RSVP/registro (incluidas las listas de espera cuando un evento está lleno). Los eventos se pueden ver por comunidad, en todas las comunidades de un usuario o como fuente de calendario en un intervalo de fechas.
- Pertenencias : pertenencia de un usuario a una comunidad. Los usuarios pueden unirse a las comunidades y abandonarlas.
- Recursos : documentos y vínculos compartidos en una comunidad, organizados en carpetas y subcarpetas.
herramientas
Todas las herramientas se ejecutan como el usuario autenticado. Las herramientas de lectura están marcadas (lectura); Las herramientas de escritura están marcadas (WRITE) y se describen a continuación. Cada herramienta de escritura es reversible y autocontenida , solo afecta a la cuenta del usuario que ha iniciado sesión.
Perfil y permisos
-
whoami(leer): obtenga la identidad del usuario autenticado (personId, legacyUserId, superUser). Llámalo primero para cualquier pregunta "me / my / I". -
get_my_profile(leer) — Obtenga el perfil del usuario: nombre, nombre para mostrar, pronombres, biografía, correo electrónico, imagen de perfil. -
get_my_user_record(leer): obtenga el registro completo del usuario (perfil más fechas creadas o modificadas por última vez, id. de empleado, correo electrónico de notificación). -
get_my_platform_permissions(read) — Enumere los permisos para toda la plataforma del usuario (por ejemplo, MANAGE_USERS, MANAGE_COMMUNITIES). -
get_my_network_permissions(leer): enumera los permisos del usuario dentro de una comunidad o agregados en todas las comunidades. -
get_my_notification_settings(read) — Obtener la configuración o preferencias de notificación del usuario. -
get_my_m365_integration(leer): obtenga el estado de integración de Microsoft 365 (Outlook) del usuario.
Communities
-
list_top_level_communities(leer) — Enumere las comunidades de nivel superior (ERG) en la plataforma. -
get_network_hierarchy(leer) — Obtenga la jerarquía de la comunidad completa (niveles superiores más capítulos). -
get_community(leer): obtenga los detalles básicos de una comunidad específica. -
get_community_branding(leer) — Obtener la personalización de marca de una comunidad (logotipo, banner, colores del tema). -
list_community_leaders(leer) — Enumerar los líderes públicos de una comunidad. -
list_community_sponsors(leer) — Enumerar los patrocinadores ejecutivos o empresariales de una comunidad. -
get_community_chapter_information(leer) — Obtener información de capítulo para una comunidad (primaria o secundaria). -
join_community(WRITE) — Únase al usuario a una comunidad. Reversible a través deleave_community. -
leave_community(WRITE): quite el usuario de una comunidad. Idempotente (se realiza correctamente incluso si no es miembro); reversible a través dejoin_community.
Fuente y publicaciones
-
list_home_feed_posts(leer) — Enumere las publicaciones en la fuente principal del usuario (agregada en sus comunidades). -
list_community_feed_posts(leer): enumera las publicaciones dentro de la fuente de una comunidad específica. -
get_post_reaction_summary(read) — Obtener recuentos de reacciones para una publicación, por tipo de reacción. -
get_post_reactions(leer) — Enumere los usuarios que reaccionaron a una publicación, con su tipo de reacción. -
react_to_post(WRITE) — React a una publicación como usuario. Reversible cambiando o borrando la reacción.
Events
-
list_my_events(leer) — Enumere los próximos eventos en todas las comunidades a las que pertenece el usuario (buscable, paginado). -
list_upcoming_events(leer) — Compactar la lista de próximos eventos en las comunidades del usuario. -
list_community_events(leer): enumere los eventos de una comunidad en la vista más detallada (host, descripción, zona horaria, información de RSVP). -
list_community_upcoming_events(leer) — Enumere los próximos eventos para una comunidad (widget compacto). -
get_community_calendar(leer): obtenga los eventos de una comunidad como una fuente de calendario ligera para un intervalo de fechas. -
register_for_event(WRITE) — RSVP del usuario a un evento. Idempotente; se une a la lista de espera si el evento está lleno. Reversible a través deunregister_from_event. -
unregister_from_event(WRITE) — Cancele el RSVP del usuario. Idempotente (se realiza correctamente aunque no esté registrado); reversible a través deregister_for_event.
Actividad
-
list_my_activities(read) — Enumerar las actividades o notificaciones recientes del usuario. -
get_my_unread_activity_count(leer): obtenga el recuento de las actividades o notificaciones no leídas del usuario. -
list_my_leaderships(leer) — Enumere las comunidades en las que el usuario es líder (lista vacía si no existe).
Resources
-
list_community_resources(leer): enumere los recursos (documentos y vínculos) compartidos en una comunidad. -
list_folder_resources(leer): enumere los recursos directamente dentro de una carpeta de recursos. -
list_folder_subfolders(lectura): enumere las subcarpetas dentro de una carpeta de recursos.
Informes e involucración
-
get_my_stats(leer) — Estadísticas de uso de la duración del usuario (inicios de sesión, publicaciones, comentarios, eventos registrados o asistidos, grabaciones vistas). -
get_my_events_participation(leer) — Los eventos en los que el usuario ha participado (asistió o vio la grabación). -
get_my_engagement_report(leer) — Participación por comunidad en una escala de tiempo mensual (registros de eventos, horas invertidas, puntos obtenidos); filtro de intervalo de fechas opcional.
CommunityLab (requiere el módulo CommunityLab)
-
list_communitylab_resources(leer): los recursos de aprendizaje de CommunityLab (categorías → sesiones, vídeos, hojas de cálculo, progreso) disponibles para el usuario. -
get_communitylab_session(leer): detalle de una sola sesión de CommunityLab, incluida su dirección URL de vídeo. -
get_worksheet_fields(lectura) — Definiciones de campo/pregunta de una hoja de cálculo (tipos de campo + opciones; el propio texto de la pregunta es de solo interfaz de usuario y no lo devuelve la API). -
get_my_worksheet_answers(leer): las respuestas guardadas actualmente del usuario para una hoja de cálculo. -
save_worksheet_answers_draft(WRITE) — Guarde las respuestas de la hoja de cálculo del usuario como borrador ("Guardar y revisar más adelante"). Reversible; acepta respuestas parciales. -
submit_worksheet_answers(WRITE) — Finalizar o enviar las respuestas de la hoja de cálculo del usuario ("Guardar"). Valida que se rellenan todos los campos; reversible al volver a guardar.
Logros y recompensas (requiere el módulo Gamification)
-
get_my_achievements(leer) — Los logros (distintivos) que el usuario ha ganado. -
list_rewards(leer) — Catálogo de recompensas de la plataforma (paginado).
Recuento de herramientas: 45 herramientas: 38 lecturas, 7 escrituras. Las 7 herramientas de escritura (join_community, leave_community, react_to_postregister_for_eventunregister_from_event, save_worksheet_answers_draft, ) submit_worksheet_answerssolo son reversibles y actúan solo en la propia cuenta del usuario que ha iniciado sesión (pertenencias, reacciones, RSVPs y respuestas de la propia hoja de cálculo del usuario).
Configuración y conexión
El servidor se alcanza a través de una única dirección URL compartida. Cuando se conecta por primera vez, se le lleva a un /login selector de sitio donde elige el sitio de CommunitycliQ e inicia sesión, ya sea a través del inicio de sesión único de su organización o con su nombre de usuario y contraseña. Después del inicio de sesión, el asistente se conecta a medida que se ejecuta y cada llamada de herramienta se ejecuta con su identidad y permisos.
Claude.ai / Claude Desktop
- Abra Configuración → Conectores (o Agregar conector personalizado).
- Agregue la dirección URL del servidor MCP de CommunitycliQ.
- Cuando se le solicite, complete el inicio de sesión: elija el sitio en la
/loginpágina y autentíquese con SSO o nombre de usuario o contraseña. - Las herramientas de CommunitycliQ están disponibles en sus conversaciones.
Microsoft Copilot/Copilot Studio/Teams
- Agregue el conector CommunitycliQ con la misma dirección URL del servidor compartido.
- Complete el flujo de inicio de sesión: elija el sitio en la
/loginpágina y autentíquese con SSO o nombre de usuario o contraseña. - Después, el conector está disponible para Copilot y en Teams.
Los detalles de registro de OAuth específicos de la plataforma (identificadores de cliente, URI de redirección, etc.) se configuran durante la configuración del conector y se documentan por separado; El mismo flujo de dirección URL y selector de sitio se aplica a todas las plataformas.
Ejemplos de indicaciones
Una vez conectado, pruebe:
- "¿Quién soy yo en CommunityCliQ?"
- "¿Qué comunidades puedo unirme?"
- "¿Qué eventos están llegando en mis comunidades esta semana?"
- "Muéstrame las últimas publicaciones en la red de mujeres".
- "Únase a mí a la comunidad pride". (una acción reversible y autocontenida)
Autenticación y seguridad
- OAuth 2.1 por usuario. El servidor es su propio servidor de autorización de OAuth 2.1. La autenticación usa el flujo PKCE (clave de prueba para código Exchange).
- Opciones de inicio de sesión. Los usuarios se autentican a través del inicio de sesión único de su organización o con un nombre de usuario y una contraseña, después de seleccionar su sitio en la
/loginpágina. - Aislamiento de identidad. La identidad es estrictamente por usuario. Cada conexión está enlazada a un usuario que ha iniciado sesión y cada llamada de herramienta se ejecuta como ese usuario : no hay ninguna cuenta de servicio compartida y ningún acceso entre usuarios.
- Ámbito de permisos. Las herramientas funcionan dentro de los permisos de CommunitycliQ existentes del usuario. Un usuario solo puede ver y hacer a través del servidor MCP lo que podía hacer directamente en CommunitycliQ.
- Minimización de datos. No se recopilan datos más allá de lo que cada herramienta necesita para satisfacer la solicitud. Las herramientas de escritura solo tocan las propias pertenencias, reacciones y registros de eventos del usuario.
Limitaciones conocidas
- Solo superficie de nivel de participante (en este conector). El conector certificado expone funcionalidades orientadas a participantes: no hay herramientas administrativas (ninguna administración de usuarios, administración de la comunidad, moderación de contenido o operaciones masivas). Opcionalmente, el servidor puede exponer herramientas líderes de la comunidad (creación de eventos, moderación posterior a la fuente), pero están deshabilitadas de forma predeterminada, cerradas por los permisos communitycliQ del usuario y no forman parte de este conector pendiente de revisión independiente.
- Lectura principalmente. La mayoría de las herramientas son de solo lectura. Las únicas escrituras son las siete acciones reversibles autoestables enumeradas anteriormente (pertenencias, reacciones, RSVPs y respuestas de hoja de cálculo de CommunityLab propias del usuario); no hay operaciones destructivas en la superficie del participante.
- El sitio debe seleccionarse en tiempo de conexión. Dado que la dirección URL se comparte entre sitios, debe elegir el sitio communitycliQ al iniciar sesión. Para cambiar los sitios que vuelva a conectar y elija otro sitio.
- Los tipos de reacción son fijos. Las reacciones posteriores se limitan a
LIKE,LOVE,CELEBRATE,SUPPORT,LAUGHyINTEREST.
Apoyo
Contacto: support@communitycliq.com. Si una herramienta no se comporta como se documenta, incluya el mensaje y el nombre de la herramienta para que podamos reproducirlo.
Acciones
|
Administrar eventos de comunidades communitycliQ y Community |
Permite a los empleados que han iniciado sesión detectar y unirse a comunidades y grupos de recursos de empleados, ver eventos, completar hojas de cálculo de CommunityLab y realizar un seguimiento de su participación en CommunitycliQ. |
Administrar eventos de comunidades communitycliQ y CommunityLab
Permite a los empleados que han iniciado sesión detectar y unirse a comunidades y grupos de recursos de empleados, ver eventos, completar hojas de cálculo de CommunityLab y realizar un seguimiento de su participación en CommunitycliQ.