Agente CommunitycliQ (Pré-visualização)

O CommunitycliQ Agent permite que os colaboradores cuja organização utiliza o CommunitycliQ geram as suas comunidades de local de trabalho a partir do Microsoft Copilot. Atuando como utilizador iniciado, pode descobrir e juntar-se a Grupos de Recursos para Colaboradores (ERGs/BRGs) e grupos de afinidade, explorar líderes e capítulos da comunidade, acompanhar eventos, preencher folhas de trabalho do CommunityLab e acompanhar a sua participação, conquistas e recompensas. Requer uma conta CommunitycliQ; Os utilizadores só veem o que as suas permissões permitem.

Este conector está disponível nos seguintes produtos e regiões:

Serviço	Class	Regions
Estúdio Copiloto	Premium	Todas as regiões Power Automate exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas	Standard	Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões Azure China - Departamento de Defesa dos EUA (DoD)
Power Apps	Premium	Todas as regiões Power Apps exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD)
Power Automate	Premium	Todas as regiões Power Automate exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD)

Contact
Nome	MentorcliQ, Inc.
URL	https://www.communitycliq.com
Email	support@communitycliq.com

Metadados do conector
Editor	Mentorcliq, Inc.
Sítio Web	https://www.communitycliq.com
Política de privacidade	https://www.mentorcliq.com/privacy-policy
Categorias	IA; Recursos Humanos

CommunitycliQ MCP Server

Um servidor remoto de Protocolo de Contexto de Modelo (MCP) que liga assistentes de IA — como Claude.ai, Claude Desktop e Microsoft Copilot/Teams — à plataforma comunitária empresarial CommunitycliQ.

Descrição geral

CommunitycliQ é uma comunidade empresarial e uma plataforma de Grupo de Recursos para Colaboradores (ERG). O servidor MCP CommunitycliQ permite que os colaboradores interajam com as suas comunidades através de linguagem natural num assistente de IA: descobrir ERGs, navegar por feeds da comunidade e da casa, encontrar e confirmar presença em eventos, ler recursos partilhados e gerir as suas próprias subscrições.

O que faz: Expõe comunidades CommunitycliQ, feeds, eventos, recursos e o perfil/atividade do utilizador a um assistente de IA como um conjunto de ferramentas MCP.
Para quem é: Colaboradores e participantes da comunidade que já usam o CommunitycliQ e querem aceder a ele através do assistente de IA em que trabalham todos os dias.
Valor numa linha: Traga os seus ERGs, eventos e feeds da comunidade para o seu assistente de IA — cada ação é executada como você, com o seu próprio âmbito de permissões.

O servidor é maioritariamente lido: a maioria das ferramentas recupera informação, e o punhado de ferramentas de escrita realiza apenas ações reversíveis na conta do utilizador iniciado (entrar/sair de uma comunidade, reagir a uma publicação, confirmar presença a um evento). Não existem operações administrativas ou destrutivas.

Modelo de dados

Alguns conceitos do CommunitycliQ aparecem em todas as ferramentas:

Redes / Comunidades — Uma "comunidade" (também chamada de rede) é um ERG ou grupo de interesse. Cada uma é identificada por um UUID. As comunidades formam uma hierarquia: as comunidades de topo podem ter capítulos filhos (por exemplo, capítulos regionais ou específicos de um ERG global).
Publicações — Entradas num feed comunitário ou no feed inicial agregado do utilizador. As publicações apresentam reações dos tipos LIKE, LOVE, CELEBRATE, SUPPORT, LAUGH, e INTEREST.
Eventos — Eventos comunitários com anfitriões, descrições, fusos horários e RSVP/inscrição (incluindo listas de espera quando o evento está cheio). Os eventos podem ser visualizados por comunidade, em todas as comunidades de um utilizador, ou como um feed de calendário ao longo de um intervalo de datas.
Adesões — A participação de um utilizador numa comunidade. Os utilizadores podem juntar-se e sair das comunidades por si próprios.
Recursos — Documentos e links partilhados numa comunidade, organizados em pastas e subpastas.

Tools

Todas as ferramentas correm como o utilizador autenticado. As ferramentas de leitura são marcadas (read); as ferramentas de escrita estão marcadas como WRITE) e são descritas abaixo. Cada ferramenta de escrita é reversível e auto-definida — afeta apenas a conta do utilizador iniciado.

Perfil e permissões

whoami (leia-se) — Obtenha a identidade do utilizador autenticado (personId, legacyUserId, superUser). Chama isto primeiro para qualquer pergunta "eu / meu / eu".
get_my_profile (ler) — Obter o perfil do utilizador: nome, nome de visualização, pronomes, biografia, email, foto de perfil.
get_my_user_record (ler) — Obter o registo completo do utilizador (perfil mais datas de criação/última modificação, ID do funcionário, email de notificação).
get_my_platform_permissions (ler) — Listar as permissões do utilizador para toda a plataforma (por exemplo, MANAGE_USERS, MANAGE_COMMUNITIES).
get_my_network_permissions (ler) — Listar as permissões do utilizador dentro de uma comunidade, ou agregadas em todas as comunidades.
get_my_notification_settings (leia-se) — Obtenha as definições/preferências de notificação do utilizador.
get_my_m365_integration(ler) — Obtenha o estado da integração do utilizador com o Microsoft 365 (Outlook).

Communities

list_top_level_communities (leia-se) — Listar as comunidades de topo (ERGs) na plataforma.
get_network_hierarchy (leia-se) — Obtenha toda a hierarquia da comunidade (níveis superiores mais capítulos).
get_community (leia-se) — Obtenha detalhes essenciais para uma comunidade específica.
get_community_branding (leia-se) — Obtenha a marca de uma comunidade (logótipo, banner, cores do tema).
list_community_leaders (leia) — Listar os líderes públicos de uma comunidade.
list_community_sponsors (leia-se) — Listar os patrocinadores executivos/empresariais de uma comunidade.
get_community_chapter_information (leia-se) — Obtenha informações sobre capítulos para uma comunidade (pais ou crianças).
join_community (ESCRITA) — Junte-se ao utilizador a uma comunidade. Reversível via leave_community.
leave_community (ESCREVER) — Remover o utilizador de uma comunidade. Idempotente (tem sucesso mesmo não sendo membro); reversível via join_community.

Feed e publicações

list_home_feed_posts (leia-se) — Liste as publicações no feed inicial do utilizador (agregadas nas suas comunidades).
list_community_feed_posts (ler) — Listar publicações dentro do feed de uma comunidade específica.
get_post_reaction_summary (ler) — Obtenha as contagens de reações para uma publicação, por tipo de reação.
get_post_reactions (ler) — Liste os utilizadores que reagiram a uma publicação, com o seu tipo de reação.
react_to_post (ESCRITA) — Reagir a uma publicação como utilizador. Reversível ao alterar ou eliminar a reação.

Events

list_my_events (ler) — Liste eventos futuros em todas as comunidades a que o utilizador pertence (pesquisável, paginado).
list_upcoming_events (ler) — Lista compacta dos próximos eventos nas comunidades dos utilizadores.
list_community_events (ler) — Liste os eventos de uma comunidade na vista mais detalhada possível (anfitrião, descrição, fuso horário, informações de RSVP).
list_community_upcoming_events (leia-se) — Liste os próximos eventos para uma comunidade (widget compacto).
get_community_calendar (leia-se) — Obtenha os eventos de uma comunidade como um feed de calendário leve para um intervalo de datas.
register_for_event (ESCRITA) — Confirme a presença do utilizador num evento. Idempotente; Entra na lista de espera se o evento estiver cheio. Reversível via unregister_from_event.
unregister_from_event (ESCRITA) — Cancela a confirmação de presença do utilizador. Idempotente (tem sucesso mesmo que não esteja registado); reversível via register_for_event.

Atividade

list_my_activities (ler) — Listar as atividades / notificações recentes do utilizador.
get_my_unread_activity_count (ler) — Obter a contagem das atividades/notificações não lidas do utilizador.
list_my_leaderships (leia-se) — Liste as comunidades onde o utilizador é líder (lista vazia se não houver).

Resources

list_community_resources (ler) — Liste os recursos (documentos e links) partilhados numa comunidade.
list_folder_resources (ler) — Liste os recursos diretamente dentro de uma pasta de recursos.
list_folder_subfolders (ler) — Lista as subpastas dentro de uma pasta de recursos.

Relatórios e envolvimento

get_my_stats (ler) — Estatísticas de utilização vitalícia do utilizador (logins, publicações, comentários, eventos registados/assistidos, gravações visualizadas).
get_my_events_participation (ler) — Os eventos em que o utilizador participou (assistiu / viu a gravação).
get_my_engagement_report (leia-se) — Envolvimento por comunidade ao longo de um prazo mensal (inscrições em eventos, horas investidas, pontos ganhos); Filtro opcional por intervalo de datas.

CommunityLab (requer o módulo CommunityLab)

list_communitylab_resources (ler) — Os recursos de aprendizagem do CommunityLab (categorias → sessões, vídeos, folhas de trabalho, progresso) disponíveis para o utilizador.
get_communitylab_session (leia-se) — O detalhe de uma única sessão do CommunityLab, incluindo a URL do vídeo.
get_worksheet_fields (ler) — Definições de campo/pergunta de uma folha de trabalho (tipos de campo + opções; o texto da pergunta é apenas UI e não é devolvido pela API).
get_my_worksheet_answers (ler) — As respostas atualmente guardadas pelo utilizador para uma folha de exercícios.
save_worksheet_answers_draft (ESCREVER) — Guardar as respostas da folha de trabalho do utilizador como rascunho ("Guardar e rever mais tarde"). Reversível; aceita respostas parciais.
submit_worksheet_answers (ESCREVER) — Finalizar/submeter as respostas da folha de trabalho do utilizador ("Guardar"). Valida que todos os campos estão preenchidos; reversível ao guardar novamente.

Conquistas e recompensas (requer o módulo de Gamificação)

get_my_achievements (ler) — As conquistas (distintivos) que o utilizador conquistou.
list_rewards (ler) — O catálogo de recompensas da plataforma (paginado).

Número de ferramentas: 45 ferramentas — 38 de leitura, 7 de escrita. As 7 ferramentas de escrita (join_community, leave_community, react_to_post, register_for_event, unregister_from_event, save_worksheet_answers_draft, ) submit_worksheet_answerssão todas reversíveis e atuam apenas na conta do utilizador iniciado (membros, reações, confirmações de presença e as respostas da folha de cálculo do utilizador).

Configuração / ligação

O servidor é acedido através de uma única URL partilhada. Quando se liga pela primeira vez, é levado a um /login seletor de sites onde escolhe o seu site CommunitycliQ e inicia sessão — seja através do SSO da sua organização ou com o seu nome de utilizador e palavra-passe. Depois de iniciar sessão, o assistente liga-se como si, e cada chamada de ferramenta é executada com a sua identidade e permissões.

Claude.ai / Claude Desktop

Abrir Definições → Conectores (ou Adicionar conector personalizado).
Adicione a URL do servidor MCP da CommunitycliQ.
Quando solicitado, complete o login: escolha o seu site na /login página e depois autentique com SSO ou nome de utilizador/palavra-passe.
As ferramentas CommunitycliQ ficam disponíveis nas suas conversas.

Microsoft Copilot / Copilot Studio / Teams

Adicione o conector CommunitycliQ usando a mesma URL partilhada do servidor.
Complete o fluxo de iniciação de sessão: escolha o seu site na /login página e depois autentique com SSO ou nome de utilizador/palavra-passe.
O conector fica então disponível para o Copilot e dentro do Teams.

Os detalhes específicos de registo OAuth da plataforma (IDs de cliente, URIs de redirecionamento, etc.) são configurados durante a configuração do conector e documentados separadamente; o mesmo URL único e o mesmo fluxo de seletor de sites aplicam-se a todas as plataformas.

Exemplos de sugestões

Depois de ligados, experimente:

"Quem sou eu na CommunityCliQ?"
"A que comunidades posso juntar-me?"
"Que eventos estão a caminho nas minhas comunidades esta semana?"
"Mostra-me as últimas publicações na Rede das Mulheres."
"Junta-te a mim na comunidade Pride." (uma ação reversível, auto-escopada)

Autenticação e segurança

OAuth 2.1 por utilizador. O servidor é o seu próprio servidor de autorização OAuth 2.1. A autenticação utiliza o fluxo PKCE (Proof Key for Code Exchange).
Opções de iniciação de sessão. Os utilizadores autenticam-se através do SSO da sua organização ou com um nome de utilizador e palavra-passe, após selecionarem o seu site na /login página.
Isolamento de identidade. A identidade é estritamente para cada utilizador. Cada ligação está ligada a um utilizador iniciado sessão, e cada chamada de ferramenta é executada como esse utilizador — não existe conta de serviço partilhada nem acesso entre utilizadores.
Avaliação de permissões. As ferramentas operam dentro das permissões CommunitycliQ existentes do utilizador. Um utilizador só pode ver e fazer através do servidor MCP o que poderia fazer diretamente no CommunitycliQ.
Minimização de dados. Não são recolhidos dados além do que cada ferramenta precisa para satisfazer o pedido. As ferramentas de escrita tocam apenas as próprias subscrições, reações e registos de eventos do utilizador.

Limitações conhecidas

Apenas superfície ao nível do participante (neste conector). O conector certificado expõe capacidades de contacto com os participantes — não existem ferramentas administrativas (não há gestão de utilizadores, gestão de comunidade, moderação de conteúdos ou operações em massa). O servidor pode opcionalmente expor ferramentas de líderes comunitários (criação de eventos, moderação de publicações/feeds), mas estas estão desativadas por defeito, bloqueadas pelas permissões CommunitycliQ do utilizador e não fazem parte deste conector enquanto aguardam revisão separada.
Principalmente lê. A grande maioria das ferramentas são apenas de leitura. As únicas escritas são as sete ações reversíveis e auto-definidas listadas acima (membros, reações, RSVPs e as respostas da própria folha de trabalho do CommunityLab do utilizador); Não existem operações destrutivas na superfície participante.
O local deve ser selecionado no momento da ligação. Como o URL é partilhado entre os sites, deve escolher o seu site CommunitycliQ no início de sessão. Para mudar de site, reconecta-se e escolhe outro site.
Os tipos de reação são fixos. As reações após a publicação limitam-se a LIKE, LOVE, CELEBRATE, SUPPORT, LAUGH, e INTEREST.

Suporte

Contacto: support@communitycliq.com. Se uma ferramenta não se comportar conforme documentado, inclua o prompt e o nome da ferramenta para podermos reproduzi-la.

Ações

Gerir eventos de comunidades CommunitycliQ e CommunityLab

Permite ao colaborador inscrito descobrir e juntar-se a comunidades e Grupos de Recursos para Colaboradores, ver eventos, preencher fichas do CommunityLab e acompanhar a sua participação no CommunitycliQ.

Gerir eventos de comunidades CommunitycliQ e CommunityLab

ID da Operação:: InvokeServer