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, ,LAUGHeINTEREST. - 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 tramiteleave_community. -
leave_community(WRITE) - Rimuovere l'utente da una community. Idempotente (riesce anche se non un membro); reversibile tramitejoin_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 tramiteunregister_from_event. -
unregister_from_event(WRITE) - Annullare l'RSVP dell'utente. Idempotente (riesce anche se non registrato); reversibile tramiteregister_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
- Aprire Impostazioni → Connettori (o Aggiungi connettore personalizzato).
- Aggiungere l'URL del server MCP CommunitycliQ.
- Quando richiesto, completare l'accesso: selezionare il sito nella
/loginpagina, quindi eseguire l'autenticazione con SSO o nome utente/password. - Gli strumenti CommunitycliQ diventano disponibili nelle conversazioni.
Microsoft Copilot/Copilot Studio/Teams
- Aggiungere il connettore CommunitycliQ usando lo stesso URL del server condiviso.
- Completare il flusso di accesso: selezionare il sito nella
/loginpagina, quindi eseguire l'autenticazione con SSO o nome utente/password. - 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
/loginpagina. - 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,LAUGHeINTEREST.
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 Community |
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.