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
Email 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, LAUGHy INTEREST.
  • 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 de leave_community.
  • leave_community (WRITE): quite el usuario de una comunidad. Idempotente (se realiza correctamente incluso si no es miembro); reversible a través de join_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 de unregister_from_event.
  • unregister_from_event (WRITE) — Cancele el RSVP del usuario. Idempotente (se realiza correctamente aunque no esté registrado); reversible a través de register_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

  1. Abra Configuración → Conectores (o Agregar conector personalizado).
  2. Agregue la dirección URL del servidor MCP de CommunitycliQ.
  3. Cuando se le solicite, complete el inicio de sesión: elija el sitio en la /login página y autentíquese con SSO o nombre de usuario o contraseña.
  4. Las herramientas de CommunitycliQ están disponibles en sus conversaciones.

Microsoft Copilot/Copilot Studio/Teams

  1. Agregue el conector CommunitycliQ con la misma dirección URL del servidor compartido.
  2. Complete el flujo de inicio de sesión: elija el sitio en la /login página y autentíquese con SSO o nombre de usuario o contraseña.
  3. 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 /login pá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, LAUGHy INTEREST.

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 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.

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.