CommunitycliQ Agent (versão prévia)
O CommunitycliQ Agent permite que os funcionários cuja organização usa o CommunitycliQ gerenciem suas comunidades no local de trabalho de Microsoft Copilot. Atuando como usuário conectado, ele pode descobrir e ingressar em Grupos de Recursos de Funcionários (ERGs/BRGs) e grupos de afinidade, procurar líderes e capítulos da comunidade, acompanhar eventos, concluir planilhas do CommunityLab e acompanhar sua participação, conquistas e recompensas. Requer uma conta CommunitycliQ; os usuários só veem o que suas permissões permitem.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | MentorcliQ, Inc. |
| URL | https://www.communitycliq.com |
| support@communitycliq.com |
| Metadados do conector | |
|---|---|
| Publicador | Mentorcliq, Inc. |
| Site | https://www.communitycliq.com |
| Política de privacidade | https://www.mentorcliq.com/privacy-policy |
| Categories | IA; Recursos Humanos |
Servidor MCP do CommunitycliQ
Um servidor remoto do PROTOCOLO MCP (Protocolo de Contexto de Modelo) que conecta assistentes de IA , como Claude.ai, Claude Desktop e Microsoft Copilot/Teams, à plataforma da comunidade empresarial CommunitycliQ.
Visão geral
O CommunitycliQ é uma comunidade empresarial e uma plataforma ERG (Employee Resource Group). O servidor MCP do CommunitycliQ permite que os funcionários interajam com suas comunidades por meio da linguagem natural em um assistente de IA: descobrir ERGs, procurar feeds da comunidade e da casa, localizar e RSVP em eventos, ler recursos compartilhados e gerenciar suas próprias associações.
- O que ele faz: Expõe comunidades communitycliQ, feeds, eventos, recursos e o próprio perfil/atividade do usuário a um assistente de IA como um conjunto de ferramentas do MCP.
- Para quem é: Funcionários e participantes da comunidade que já usam o CommunitycliQ e desejam acessá-lo por meio do assistente de IA em que trabalham todos os dias.
- Valor em uma linha: Traga seus ERGs, eventos e feeds de comunidade para seu assistente de IA – cada ação é executada como você, com escopo para suas próprias permissões.
O servidor é lido principalmente: a maioria das ferramentas recupera informações e as poucas ferramentas de gravação executam apenas ações reversíveis na própria conta do usuário conectado (ingressar/sair de uma comunidade, reagir a uma postagem, RSVP'ing a um evento). Não há 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 um é identificado por uma UUID. As comunidades formam uma hierarquia: as comunidades de nível superior podem ter capítulos filho (por exemplo, capítulos regionais ou específicos do site de um ERG global).
-
Postagens – Entradas em um feed da comunidade ou no feed doméstico agregado do usuário. Postagens carregam reações de tipos
LIKE,LOVE,CELEBRATE,SUPPORT, eINTERESTLAUGH. - Eventos – eventos da comunidade com hosts, descrições, fusos horários e RSVP/registro (incluindo listas de espera quando um evento está cheio). Os eventos podem ser exibidos por comunidade, em todas as comunidades de um usuário ou como um feed de calendário em um intervalo de datas.
- Associações – associação de um usuário em uma comunidade. Os usuários podem ingressar e deixar as próprias comunidades.
- Recursos – Documentos e links compartilhados em uma comunidade, organizados em pastas e subpastas .
Tools
Todas as ferramentas são executadas como o usuário autenticado. As ferramentas de leitura são marcadas (leitura); as ferramentas de gravação estão marcadas (WRITE) e são descritas abaixo. Cada ferramenta de gravação é reversível e com escopo próprio , afeta apenas a conta do próprio usuário conectado.
Permissões de Perfil &
-
whoami(leia) — Obtenha a identidade do usuário autenticado (personId, legacyUserId, superUser). Chame isso primeiro para qualquer pergunta "eu/meu/I". -
get_my_profile(leia) — Obtenha o perfil do usuário: nome, nome de exibição, pronomes, biografia, email, imagem de perfil. -
get_my_user_record(leia) — Obtenha o registro completo do usuário (perfil mais datas criadas/última modificação, ID do funcionário, email de notificação). -
get_my_platform_permissions(leia) — Liste as permissões de toda a plataforma do usuário (por exemplo, MANAGE_USERS, MANAGE_COMMUNITIES). -
get_my_network_permissions(leia) — Liste as permissões do usuário em uma comunidade ou agregadas em todas as comunidades. -
get_my_notification_settings(leia) — Obtenha as configurações/preferências de notificação do usuário. -
get_my_m365_integration(leia) — Obtenha o status de integração do Microsoft 365 (Outlook) do usuário.
Communities
-
list_top_level_communities(leia) — Liste as ERGs (comunidades de nível superior) na plataforma. -
get_network_hierarchy(leia) — Obtenha a hierarquia de comunidade completa (níveis superiores mais capítulos). -
get_community(leia) — Obtenha detalhes principais para uma comunidade específica. -
get_community_branding(leia) — Obtenha a identidade visual de uma comunidade (logotipo, faixa, cores do tema). -
list_community_leaders(leia) — Liste os líderes públicos de uma comunidade. -
list_community_sponsors(leia) — Listar os patrocinadores executivos/comerciais de uma comunidade. -
get_community_chapter_information(leia) — Obtenha informações de capítulo para uma comunidade (pai ou filhos). -
join_community(WRITE) — Ingresse o usuário em uma comunidade. Reversível vialeave_community. -
leave_community(WRITE) — Remova o usuário de uma comunidade. Idempotente (é bem-sucedido mesmo que não seja um membro); reversível viajoin_community.
Feed & postagens
-
list_home_feed_posts(leia) — Listar postagens no feed doméstico do usuário (agregado em suas comunidades). -
list_community_feed_posts(leia) — Listar postagens no feed de uma comunidade específica. -
get_post_reaction_summary(leia) — Obter contagens de reação para um post, por tipo de reação. -
get_post_reactions(leia) — Liste os usuários que reagiram a uma postagem, com seu tipo de reação. -
react_to_post(WRITE) — Reaja a uma postagem como o usuário. Reversível alterando ou limpando a reação.
Events
-
list_my_events(leia) — Listar eventos futuros em todas as comunidades às quais o usuário pertence (pesquisável, paginado). -
list_upcoming_events(leia) — Lista compacta de eventos futuros nas comunidades do usuário. -
list_community_events(leia) — Liste os eventos de uma comunidade na exibição mais detalhada (host, descrição, fuso horário, informações do RSVP). -
list_community_upcoming_events(leia) — Liste os próximos eventos futuros para uma comunidade (widget compacto). -
get_community_calendar(leia) — Obtenha os eventos de uma comunidade como um feed de calendário leve para um intervalo de datas. -
register_for_event(WRITE) — RSVP o usuário para um evento. Idempotentes; ingressará na lista de espera se o evento estiver cheio. Reversível viaunregister_from_event. -
unregister_from_event(WRITE) — Cancele o RSVP do usuário. Idempotente (é bem-sucedido mesmo se não estiver registrado); reversível viaregister_for_event.
Atividade
-
list_my_activities(leia) — Liste as atividades/notificações recentes do usuário. -
get_my_unread_activity_count(leia) — Obtenha a contagem das atividades/notificações não lidas do usuário. -
list_my_leaderships(leia) — Liste as comunidades em que o usuário é um líder (lista vazia, se nenhuma).
Resources
-
list_community_resources(leia) — Liste os recursos (documentos e links) compartilhados em uma comunidade. -
list_folder_resources(leia) — Liste os recursos diretamente dentro de uma pasta de recurso. -
list_folder_subfolders(leia) — Liste as subpastas dentro de uma pasta de recurso.
& Participação de relatórios
-
get_my_stats(leia) — As estatísticas de uso de tempo de vida do usuário (logons, postagens, comentários, eventos registrados/assistidos, gravações exibidas). -
get_my_events_participation(leia) — Os eventos dos quais o usuário participou (participação/visualização da gravação). -
get_my_engagement_report(leia) — Participação por comunidade em uma linha do tempo mensal (registros de eventos, horas investidas, pontos ganhos); filtro opcional de intervalo de datas.
CommunityLab (requer o módulo CommunityLab)
-
list_communitylab_resources(leia) — Os recursos de aprendizagem do CommunityLab (categorias → sessões, vídeos, planilhas, progresso) disponíveis para o usuário. -
get_communitylab_session(leia) — Detalhes de uma única sessão do CommunityLab, incluindo sua URL de vídeo. -
get_worksheet_fields(leia) — Definições de campo/pergunta de uma planilha (tipos de campo + opções; o texto da pergunta em si é somente interface do usuário e não retornado pela API). -
get_my_worksheet_answers(leia) — As respostas salvas no momento do usuário para uma planilha. -
save_worksheet_answers_draft(WRITE) — Salve as respostas da própria planilha do usuário como um rascunho ("Salvar e revisar mais tarde"). Reversível; aceita respostas parciais. -
submit_worksheet_answers(WRITE) — Finalize/envie as respostas da própria planilha do usuário ("Salvar"). Valida se todos os campos estão preenchidos; reversível salvando novamente.
Realizações & recompensas (requer o módulo Gamification)
-
get_my_achievements(leia) — As conquistas (selos) que o usuário ganhou. -
list_rewards(leia) — O catálogo de recompensas da plataforma (paginado).
Contagem de ferramentas: 45 ferramentas — 38 leituras, 7 gravações. As 7 ferramentas de gravação (join_community, , leave_community, react_to_postregister_for_event, unregister_from_event, save_worksheet_answers_draft, , ) submit_worksheet_answerssão todas reversíveis e atuam apenas na própria conta do usuário conectado (associações, reações, RSVPs e respostas da planilha do próprio usuário).
Configuração/conexão
O servidor é acessado por meio de uma única URL compartilhada. Quando você se conecta pela primeira vez, você é levado para um /login seletor de site em que escolhe seu site do CommunitycliQ e entra , seja por meio do SSO da sua organização ou com seu nome de usuário e senha. Após a entrada, o assistente se conecta conforme você e cada chamada de ferramenta é executada com sua identidade e permissões.
Claude.ai /Claude Desktop
- Abrir Configurações → Conectores (ou Adicionar conector personalizado).
- Adicione a URL do servidor MCP do CommunitycliQ.
- Quando solicitado, conclua a entrada: escolha seu
/loginsite na página e autentique-se com SSO ou nome de usuário/senha. - As ferramentas CommunitycliQ ficam disponíveis em suas conversas.
Microsoft Copilot/Copilot Studio/Teams
- Adicione o conector CommunitycliQ usando a mesma URL de servidor compartilhado.
- Conclua o fluxo de entrada: escolha seu
/loginsite na página e autentique-se com SSO ou nome de usuário/senha. - Em seguida, o conector está disponível para Copilot e no Teams.
Os detalhes de registro OAuth específicos da plataforma (IDs do cliente, URIs de redirecionamento etc.) são configurados durante a instalação do conector e são documentados separadamente; o mesmo fluxo de URL e seletor de site se aplica a todas as plataformas.
Prompts de exemplo
Uma vez conectado, tente:
- "Quem sou eu no CommunityCliQ?"
- "Em quais comunidades posso participar?"
- "Quais eventos estão chegando em minhas comunidades esta semana?"
- "Mostre-me os últimos posts na Rede Feminina."
- Junte-se a mim na comunidade do Orgulho. (uma ação reversível e auto-escopo)
Autenticação > segurança
- OAuth 2.1 por usuário. O servidor é seu próprio servidor de autorização do OAuth 2.1. A autenticação usa o fluxo PKCE (Chave de Prova para Código Exchange).
- Opções de entrada. Os usuários se autenticam por meio do SSO de sua organização ou com um nome de usuário e senha, depois de selecionarem seu site na
/loginpágina. - Isolamento de identidade. A identidade é estritamente por usuário. Cada conexão é associada a um usuário conectado e cada chamada de ferramenta é executada como esse usuário , não há nenhuma conta de serviço compartilhada e nenhum acesso entre usuários.
- Escopo de permissão. As ferramentas operam dentro das permissões CommunitycliQ existentes do usuário. Um usuário só pode ver e fazer por meio do servidor MCP o que ele poderia fazer diretamente no CommunitycliQ.
- Minimização de dados. Nenhum dado é coletado além do que cada ferramenta precisa para atender à solicitação. As ferramentas de gravação tocam apenas nas associações, reações e registros de eventos do próprio usuário.
Limitações conhecidas
- Somente superfície no nível do participante (neste conector). O conector certificado expõe os recursos voltados para os participantes – não há ferramentas administrativas (nenhum gerenciamento de usuário, gerenciamento de comunidade, moderação de conteúdo ou operações em massa). Opcionalmente, o servidor pode expor ferramentas de líder de comunidade (criação de eventos, moderação pós/feed), mas elas são desabilitadas por padrão, fechadas pelas permissões CommunitycliQ do usuário e não fazem parte desse conector pendente de revisão separada.
- Leitura principalmente. A grande maioria das ferramentas é somente leitura. As únicas gravações são as sete ações reversíveis e auto-escopo listadas acima (associações, reações, RSVPs e respostas da planilha communitylab do próprio usuário); não há operações destrutivas na superfície do participante.
- O site deve ser selecionado no momento da conexão. Como a URL é compartilhada entre sites, você deve escolher seu site do CommunitycliQ na entrada. Para alternar sites, você se reconecta e escolhe um site diferente.
- Os tipos de reação são corrigidos. As reações pós-reações são limitadas a
LIKE,LOVE, ,CELEBRATE,SUPPORT,LAUGHeINTEREST.
Suporte
Contato: support@communitycliq.com. Se uma ferramenta não se comportar como documentada, inclua o prompt e o nome da ferramenta para que possamos reproduzi-la.
Ações
|
Gerenciar eventos de comunidades CommunitycliQ e Community |
Permite que o funcionário conectado descubra e ingresse em comunidades e Grupos de Recursos de Funcionários, exiba eventos, conclua planilhas do CommunityLab e acompanhe sua participação no CommunitycliQ. |
Gerenciar eventos de comunidades CommunitycliQ e CommunityLab
Permite que o funcionário conectado descubra e ingresse em comunidades e Grupos de Recursos de Funcionários, exiba eventos, conclua planilhas do CommunityLab e acompanhe sua participação no CommunitycliQ.