Agente CommunitycliQ (anteprima)

CommunitycliQ Agent consente ai dipendenti di cui l'organizzazione usa CommunitycliQ di gestire le community di lavoro da Microsoft Copilot. Fungendo da utente connesso, può individuare e partecipare ai gruppi di risorse dei dipendenti (ERG/BRG) e ai gruppi di affinità, esplorare i leader e i capitoli della community, tenere traccia degli eventi, completare i fogli di lavoro CommunityLab e tenere traccia della partecipazione, dei risultati e dei premi. Richiede un account CommunitycliQ; gli utenti visualizzano solo le autorizzazioni consentite.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Service Class Regions
Copilot Studio Di alta qualità Tutte le aree Power Automate ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica Standard Tutte le aree di App per la logica , ad eccezione delle seguenti:
     - Aree di Azure per enti pubblici
     - Azure cina
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps Di alta qualità Tutte le aree Power Apps ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate Di alta qualità Tutte le aree Power Automate ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Contatto
Nome MentorcliQ, Inc.
URL https://www.communitycliq.com
Posta elettronica support@communitycliq.com
Metadati del connettore
Editore Mentorcliq, Inc.
Sito web https://www.communitycliq.com
Informativa sulla privacy https://www.mentorcliq.com/privacy-policy
Categories IA; Risorse umane

CommunitycliQ MCP Server

Un server MCP (Remote Model Context Protocol) che connette gli assistenti di intelligenza artificiale, ad esempio Claude.ai, Claude Desktop e Microsoft Copilot/Teams, alla piattaforma CommunitycliQ enterprise community.

Overview

CommunitycliQ è una community aziendale e una piattaforma ERG (Employee Resource Group). Il server MCP CommunitycliQ consente ai dipendenti di interagire con le proprie community tramite il linguaggio naturale in un assistente di intelligenza artificiale: individuare i gruppi di sicurezza, esplorare feed della community e della home page, trovare e usare rsvp per eventi, leggere le risorse condivise e gestire le proprie appartenenze.

  • Che cosa fa: Espone community, feed, eventi, risorse e attività dell'utente a un assistente di intelligenza artificiale come set di strumenti MCP.
  • Chi è per: Dipendenti e partecipanti alla community che usano già CommunitycliQ e vogliono raggiungerlo dall'assistente di intelligenza artificiale che lavorano ogni giorno.
  • Valore in una riga: Portare gli ERG, gli eventi e i feed della community nell'assistente per intelligenza artificiale, ogni azione viene eseguita come ambito per le proprie autorizzazioni.

Il server è in lettura per lo più: la maggior parte degli strumenti recupera informazioni e la manciata di strumenti di scrittura esegue solo azioni reversibili sull'account dell'utente connesso (aggiunta/uscita da una community, reazione a un post, RSVP'ing a un evento). Non esistono operazioni amministrative o distruttive.

Modello di dati

Alcuni concetti di CommunitycliQ vengono visualizzati in tutti gli strumenti:

  • Networks/Communities — una "community" (detta anche rete) è un gruppo di interesse o ERG. Ognuno è identificato da un UUID. Le comunità formano una gerarchia: le comunità di primo livello possono avere capitoli figlio (ad esempio, capitoli specifici del sito o regionali di un ERG globale).
  • Post : voci in un feed della community o nel feed home aggregato dell'utente. I post contengono reazioni di tipi LIKE, CELEBRATELOVE, SUPPORT, , LAUGHe INTEREST.
  • Eventi : eventi della community con host, descrizioni, fusi orari e RSVP/registrazione (inclusi gli elenchi di attesa quando un evento è pieno). Gli eventi possono essere visualizzati per community, in tutte le community di un utente o come feed di calendario in un intervallo di date.
  • Appartenenze : appartenenza di un utente a una community. Gli utenti possono partecipare e lasciare le community stesse.
  • Risorse : documenti e collegamenti condivisi in una community, organizzati in cartelle e sottocartelle.

Tools

Tutti gli strumenti vengono eseguiti come utente autenticato. Gli strumenti di lettura sono contrassegnati (lettura); gli strumenti di scrittura sono contrassegnati (WRITE) e sono descritti di seguito. Ogni strumento di scrittura è reversibile e con ambito autonomo, ma influisce solo sul proprio account dell'utente connesso.

Profilo e autorizzazioni

  • whoami (lettura): ottenere l'identità dell'utente autenticato (personId, legacyUserId, superUser). Chiama questo primo per qualsiasi domanda "me / my / I".
  • get_my_profile (lettura) - Ottenere il profilo dell'utente: nome, nome visualizzato, pronomi, biografia, posta elettronica, immagine del profilo.
  • get_my_user_record (lettura): ottiene il record completo dell'utente (profilo più date create/ultime modifiche, ID dipendente, posta elettronica di notifica).
  • get_my_platform_permissions (lettura): elencare le autorizzazioni a livello di piattaforma dell'utente (ad esempio MANAGE_USERS, MANAGE_COMMUNITIES).
  • get_my_network_permissions (lettura): elencare le autorizzazioni dell'utente all'interno di una community o aggregate in tutte le community.
  • get_my_notification_settings (lettura): ottenere le impostazioni/le preferenze di notifica dell'utente.
  • get_my_m365_integration(lettura): ottiene lo stato di integrazione dell'Microsoft 365 (Outlook) dell'utente.

Communities

  • list_top_level_communities (lettura): elencare le community di primo livello (ERG) sulla piattaforma.
  • get_network_hierarchy (lettura): ottenere la gerarchia della community completa (livelli superiori e capitoli).
  • get_community (lettura): ottenere i dettagli di base per una community specifica.
  • get_community_branding (lettura) - Ottieni il marchio di una community (logo, banner, colori del tema).
  • list_community_leaders (lettura) — Elencare i dirigenti pubblici di una comunità.
  • list_community_sponsors (lettura) — Elencare gli sponsor esecutivi/commerciali di una comunità.
  • get_community_chapter_information (lettura) - Ottenere informazioni sul capitolo per una community (padre o figlio).
  • join_community (WRITE) - Aggiungere l'utente a una community. Reversibile tramite leave_community.
  • leave_community (WRITE) - Rimuovere l'utente da una community. Idempotente (riesce anche se non un membro); reversibile tramite join_community.

Feed e post

  • list_home_feed_posts (lettura): elencare i post nel feed home dell'utente (aggregati nelle loro community).
  • list_community_feed_posts (lettura): elencare i post all'interno del feed di una community specifica.
  • get_post_reaction_summary (lettura): ottenere i conteggi delle reazioni per un post, per tipo di reazione.
  • get_post_reactions (lettura): elencare gli utenti che hanno reagito a un post, con il tipo di reazione.
  • react_to_post (WRITE) - Reagire a un post come utente. Reversibile modificando o cancellando la reazione.

Events

  • list_my_events (lettura): elencare gli eventi imminenti in tutte le community a cui appartiene l'utente (ricercabile, impaginato).
  • list_upcoming_events (lettura): elenco compatto di eventi imminenti nelle community degli utenti.
  • list_community_events (lettura): elenca gli eventi di una community nella visualizzazione più dettagliata (host, descrizione, fuso orario, informazioni RSVP).
  • list_community_upcoming_events (lettura) - Elencare i prossimi eventi imminenti per una community (widget compatto).
  • get_community_calendar (lettura): ottenere gli eventi di una community come feed calendario leggero per un intervallo di date.
  • register_for_event (WRITE) - RSVP l'utente a un evento. Idempotente; unisce l'elenco di attesa se l'evento è pieno. Reversibile tramite unregister_from_event.
  • unregister_from_event (WRITE) - Annullare l'RSVP dell'utente. Idempotente (riesce anche se non registrato); reversibile tramite register_for_event.

Attività

  • list_my_activities (lettura): elencare le attività o le notifiche recenti dell'utente.
  • get_my_unread_activity_count (lettura): ottiene il conteggio delle attività/notifiche non lette dell'utente.
  • list_my_leaderships (lettura): elencare le community in cui l'utente è un leader (elenco vuoto se nessuno).

Resources

  • list_community_resources (lettura): elencare le risorse (documenti e collegamenti) condivise in una community.
  • list_folder_resources (lettura): elencare le risorse direttamente all'interno di una cartella di risorse.
  • list_folder_subfolders (lettura): elencare le sottocartelle all'interno di una cartella di risorse.

Report e coinvolgimento

  • get_my_stats (lettura): statistiche di utilizzo della durata dell'utente (account di accesso, post, commenti, eventi registrati/partecipanti, registrazioni visualizzate).
  • get_my_events_participation (lettura): gli eventi a cui l'utente ha partecipato (ha partecipato/visualizzato la registrazione).
  • get_my_engagement_report (lettura): engagement per community su una sequenza temporale mensile (registrazioni di eventi, ore investite, punti ottenuti); filtro facoltativo per l'intervallo di date.

CommunityLab (richiede il modulo CommunityLab)

  • list_communitylab_resources (lettura): le risorse di apprendimento CommunityLab (categorie → sessioni, video, fogli di lavoro, avanzamento) disponibili per l'utente.
  • get_communitylab_session (lettura): dettagli di una singola sessione CommunityLab, incluso l'URL del video.
  • get_worksheet_fields (lettura): definizioni di campo/domanda di un foglio di lavoro (tipi di campo e opzioni; il testo della domanda è solo interfaccia utente e non restituito dall'API).
  • get_my_worksheet_answers (lettura): risposte attualmente salvate dall'utente per un foglio di lavoro.
  • save_worksheet_answers_draft (WRITE) - Salvare le risposte del foglio di lavoro dell'utente come bozza ("Salva e rivedi più tardi"). Reversibile; accetta risposte parziali.
  • submit_worksheet_answers (WRITE) - Finalizzare/inviare le risposte del foglio di lavoro dell'utente ("Salva"). Verifica che tutti i campi siano compilati; reversibile salvando di nuovo.

Obiettivi e ricompense (richiede il modulo Gamification)

  • get_my_achievements (lettura): gli obiettivi (badge) ottenuti dall'utente.
  • list_rewards (lettura): catalogo premi della piattaforma (impaginato).

Conteggio degli strumenti: 45 strumenti - 38 lettura, 7 scrittura. Gli strumenti di scrittura 7 (, leave_community, react_to_postregister_for_eventunregister_from_event, , , save_worksheet_answers_draft) submit_worksheet_answerssono tutti reversibili e agiscono solo sul proprio account dell'utente connesso (join_communityappartenenze, reazioni, RSVP e risposte del foglio di lavoro dell'utente).

Configurazione/connessione

Il server viene raggiunto tramite un singolo URL condiviso. Quando ci si connette per la prima volta, viene visualizzata una /login selezione sito in cui si sceglie il sito CommunitycliQ e si accede tramite l'accesso SSO dell'organizzazione o con il nome utente e la password dell'organizzazione. Dopo l'accesso, l'assistente si connette come utente e ogni chiamata di strumento viene eseguita con l'identità e le autorizzazioni.

Claude.ai/Claude Desktop

  1. Aprire Impostazioni → Connettori (o Aggiungi connettore personalizzato).
  2. Aggiungere l'URL del server MCP CommunitycliQ.
  3. Quando richiesto, completare l'accesso: selezionare il sito nella /login pagina, quindi eseguire l'autenticazione con SSO o nome utente/password.
  4. Gli strumenti CommunitycliQ diventano disponibili nelle conversazioni.

Microsoft Copilot/Copilot Studio/Teams

  1. Aggiungere il connettore CommunitycliQ usando lo stesso URL del server condiviso.
  2. Completare il flusso di accesso: selezionare il sito nella /login pagina, quindi eseguire l'autenticazione con SSO o nome utente/password.
  3. Il connettore è quindi disponibile per Copilot e all'interno di Teams.

I dettagli di registrazione OAuth specifici della piattaforma (ID client, URI di reindirizzamento e così via) vengono configurati durante la configurazione del connettore e sono documentati separatamente; lo stesso URL singolo e lo stesso flusso di selezione sito si applica a ogni piattaforma.

Esempi di suggerimenti

Dopo la connessione, provare:

  • "Chi sono in CommunityCliQ?"
  • "Quali community posso partecipare?"
  • "Quali eventi stanno arrivando nelle mie comunità questa settimana?"
  • "Mostrami i post più recenti nella rete femminile."
  • "Unisciti a me alla comunità Pride." (un'azione reversibile e auto-ambito)

Autenticazione e sicurezza

  • OAuth 2.1 per utente. Il server è il proprio server di autorizzazione OAuth 2.1. L'autenticazione usa il flusso PKCE (Proof Key for Code Exchange).
  • Opzioni di accesso. Gli utenti eseguono l'autenticazione tramite l'accesso SSO dell'organizzazione o con un nome utente e una password, dopo aver selezionato il sito nella /login pagina.
  • Isolamento dell'identità. L'identità è rigorosamente per utente. Ogni connessione è associata a un utente connesso e ogni chiamata allo strumento viene eseguita come tale utente , ovvero non esiste un account del servizio condiviso e nessun accesso tra utenti.
  • Definizione dell'ambito delle autorizzazioni. Gli strumenti operano all'interno delle autorizzazioni CommunitycliQ esistenti dell'utente. Un utente può visualizzare e eseguire solo tramite il server MCP le operazioni che possono eseguire direttamente in CommunitycliQ.
  • Riduzione al minimo dei dati. Non vengono raccolti dati oltre a ciò che ogni strumento deve soddisfare la richiesta. Gli strumenti di scrittura toccano solo le appartenenze, le reazioni e le registrazioni degli eventi dell'utente.

Limitazioni note

  • Solo superficie a livello di partecipante (in questo connettore). Il connettore certificato espone funzionalità rivolte ai partecipanti: non esistono strumenti di amministrazione (nessuna gestione degli utenti, gestione della community, moderazione del contenuto o operazioni bulk). Il server può facoltativamente esporre strumenti leader della community (creazione di eventi, moderazione post/feed), ma sono disabilitati per impostazione predefinita, gestiti dalle autorizzazioni CommunitycliQ dell'utente e non fanno parte di questo connettore in attesa di revisione separata.
  • Lettura per lo più. La maggior parte degli strumenti è di sola lettura. Le uniche scritture sono le sette azioni reversibili con ambito autonomo elencate in precedenza (appartenenze, reazioni, RSVPs e risposte del foglio di lavoro CommunityLab dell'utente); non ci sono operazioni distruttive nella superficie del partecipante.
  • Il sito deve essere selezionato in fase di connessione. Poiché l'URL viene condiviso tra siti, è necessario selezionare il sito CommunitycliQ all'accesso. Per cambiare siti, riconnettersi e scegliere un sito diverso.
  • I tipi di reazione sono fissi. Le reazioni post sono limitate a LIKE, LOVE, CELEBRATE, SUPPORT, LAUGHe INTEREST.

Support

Contatto: support@communitycliq.com. Se uno strumento non si comporta come documentato, includere il prompt e il nome dello strumento in modo da poterlo riprodurre.

Azioni

Gestire gli eventi communitycliQ e CommunityLab

Consente ai dipendenti connessi di individuare e partecipare alle community e ai gruppi di risorse dei dipendenti, visualizzare gli eventi, completare i fogli di lavoro CommunityLab e tenere traccia della partecipazione a CommunitycliQ.

Gestire gli eventi communitycliQ e CommunityLab

Consente ai dipendenti connessi di individuare e partecipare alle community e ai gruppi di risorse dei dipendenti, visualizzare gli eventi, completare i fogli di lavoro CommunityLab e tenere traccia della partecipazione a CommunitycliQ.