Strumenti · Contenuti e coinvolgimento
Strumenti MCP per ciò che accade nel feed: cercare, leggere, pubblicare, modificare, spostare ed eliminare post, post brevi, commentare e rispondere, modificare ed eliminare commenti, reagire, fissare, la galleria (aggiungere, elencare, modificare, reagire ed eliminare), la classifica e i tuoi punti, e la moderazione.
La vita quotidiana della community: la classifica e la coda di moderazione, trovare un post per titolo, pubblicare un avviso con immagine, rispondere alle domande di una diretta, reagire alle presentazioni, fissare ciò che conta, spostare un post nello spazio giusto e curare le foto della galleria. Post e commenti escono con il nome di chi ha collegato l'assistente.
Ogni strumento ha un'etichetta: Solo lettura non cambia nulla, Modifica crea o cambia qualcosa subito, e Chiede conferma agisce solo dopo il tuo sì a un riepilogo. Vedi Denaro e conferma.
In sintesi
| Strumento | Cosa fa | Ruolo minimo | Tipo |
|---|---|---|---|
list_posts | Il feed, con commenti e reazioni | Qualsiasi | Solo lettura |
search_content | Cerca post, eventi, corsi, sezioni, spazi e call per titolo | Qualsiasi | Solo lettura |
list_comments | Commenti di un post | Qualsiasi | Solo lettura |
create_post | Pubblica un post, con copertina tramite link | Qualsiasi | Modifica |
update_post | Modifica titolo, testo, copertina; fissa | Autore o moderatore | Modifica |
delete_post | Elimina un post, con conferma | Autore o moderatore | Chiede conferma |
move_post | Sposta un post in un altro spazio Contenuti o Feed | Moderatore | Modifica |
create_short_post | Pubblica un post breve, senza titolo, in un Feed | Membro (non la finanza) | Modifica |
create_comment | Commenta o risponde | Qualsiasi | Modifica |
update_comment | Modifica un commento | Autore o moderatore | Modifica |
delete_comment | Elimina un commento, con conferma | Autore o moderatore | Chiede conferma |
add_reaction | Reagisce con un'emoji | Qualsiasi | Modifica |
pin_post | Fissa o sgancia nel feed | Moderatore | Modifica |
add_gallery_image | Mette un'immagine, tramite link, in una galleria | Qualsiasi | Modifica |
list_gallery_images | Le immagini di una galleria, con autore e reazioni | Qualsiasi | Solo lettura |
update_gallery_image | Cambia il titolo o la descrizione di un'immagine | Autore o moderatore | Modifica |
react_to_gallery_image | Reagisce a un'immagine della galleria | Qualsiasi | Modifica |
delete_gallery_image | Elimina un'immagine della galleria | Autore o moderatore | Chiede conferma |
get_leaderboard | La parte alta della classifica | Qualsiasi | Solo lettura |
get_my_points | I tuoi punti e la tua posizione in classifica | Qualsiasi | Solo lettura |
get_ranking_rules | Se la classifica è attiva e i punti per azione | Admin | Solo lettura |
update_ranking_rules | Attiva, disattiva e cambia i punti | Admin | Modifica |
list_moderation_queue | Ciò che attende approvazione | Moderatore | Solo lettura |
moderate_item | Approva o rifiuta un elemento della coda | Moderatore | Modifica |
list_posts
Solo lettura
Elencare i post del feed. Il feed (post, stati, eventi e corsi), dal più recente al più vecchio, con il numero di commenti e reazioni. Ruolo minimo: qualsiasi.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
space_id | id | No | Un solo spazio (da list_spaces) |
type | all, status, content, events, courses | No | Un solo tipo di elemento |
page, limit | numero | No | Paginazione |
Restituisce: gli elementi, ciascuno con l'id e il tipo che chiedono create_comment, add_reaction e pin_post, l'autore, il titolo o il testo, i conteggi e se è fissato.
Chiedi così: "Quali sono stati i post più commentati di questa settimana?" · "Cosa è stato pubblicato nello spazio Avvisi?"
search_content
Solo lettura
Cercare per titolo. Cerca per titolo in post, eventi, corsi, sezioni, spazi e call for papers, senza distinguere maiuscole e accenti, con un'unica ricerca su tutta la community. Ruolo minimo: qualsiasi; ognuno trova ciò che può vedere.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
query | testo, da 2 a 200 | Sì | Parte del titolo. Nei post brevi cerca nel testo |
types | elenco: posts, events, courses, spaces, calls | No | Predefinito: tutti. spaces comprende le sezioni |
limit | numero, fino a 50 | No | Predefinito 20 |
Restituisce: i risultati, ciascuno con tipo, id, titolo e, quando ci sono, lo spazio, la sezione, il modulo, la data e lo stato.
Note: chi non fa parte dello staff trova solo ciò che è pubblicato e approvato; gli spazi e le sezioni chiusi per quella persona restano fuori. La ricerca è la stessa di GET /api/search.
Chiedi così: "Trova il post Come funziona la community."
list_comments
Solo lettura
Elencare i commenti di un post. I commenti di un post di contenuto o di uno stato. Ruolo minimo: qualsiasi.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
type | content, status | Sì | Il tipo dell'elemento, da list_posts |
post_id | id | Sì | L'id dell'elemento, da list_posts |
Restituisce: i commenti, con l'id (che create_comment usa in reply_to), l'autore, il testo e la data.
Chiedi così: "Quali commenti del post di benvenuto non hanno ancora una risposta?"
create_post
Modifica
Pubblicare un post. Pubblica un post di testo in uno spazio Feed o Contenuto. Ruolo minimo: qualsiasi ruolo che possa pubblicare in quello spazio.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
space_id | id | Sì | Da list_spaces |
title | testo | Sì | |
text | Markdown | Sì | Il corpo del post, in Markdown: grassetto, corsivo, elenchi, link, sottotitoli, citazione e codice |
image_url | link | No | La copertina del post: un link pubblico (http/https) a un'immagine JPEG, PNG, WebP o GIF fino a 10 MB. Vedi Immagini |
Restituisce: il post creato, con l'id (per pin_post) e la copertina. Il testo torna in Markdown, con text_format: "markdown".
Chiedi così: "Pubblica nel Feed un post di benvenuto per chi è entrato questa settimana, citando ciascuno per nome."
Note: il post esce con il nome e la foto di chi ha collegato l'assistente. Vale la regola Chi può pubblicare dello spazio: in uno spazio riservato allo staff, un membro viene rifiutato. Il post esce subito; programmarlo non è ancora possibile. Se l'immagine non può essere usata, non viene pubblicato nulla e l'assistente riceve il motivo.
update_post
Modifica
Modificare un post. Cambia titolo, testo o copertina di un post, e lo fissa o lo sgancia. Cambia solo ciò che viene inviato. Ruolo minimo: l'autore, oppure moderatore in su.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
post | id o link | Sì | |
type | content, status | No | Predefinito: content. Negli status (post brevi) cambia solo il testo |
title | testo semplice | No | |
text | Markdown | No | In un post breve (status), solo grassetto, corsivo, link e a capo |
image_url o image_base64 | link o file | No | La nuova copertina. Vedi Immagini |
remove_image | sì o no | No | Toglie la copertina |
pinned | sì o no | No | Fissa o sgancia (moderatore in su) |
Chiedi così: "Nel post Come funziona la community, sostituisci la copertina con questa immagine e fissalo in alto."
Note: il post non cambia spazio.
delete_post
Chiede conferma
Eliminare un post. Chiede conferma: la prima chiamata mostra il post, e solo la seconda lo elimina. Ruolo minimo: l'autore, oppure moderatore in su.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
post | id o link | Sì | |
type | content, status | No | Predefinito: content |
move_post
Modifica
Sposta post in un altro spazio. Porta un post in un altro spazio Contenuti o Feed della community; il suo posto nel feed lo segue. Ruolo minimo: moderatore.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
post | id o link | Sì | |
to_space | id, link, indirizzo o nome | Sì | Uno spazio Contenuti o Feed |
Chiedi così: "Questo annuncio di lavoro è finito in Avvisi; spostalo nello spazio Offerte di lavoro."
Note: uno spazio di un altro modulo (Corsi, Eventi…) viene rifiutato.
create_short_post
Modifica
Pubblica post breve. Un post breve, fino a 500 caratteri e senza titolo, in uno spazio Feed, come il campo rapido dell'app. Per un post con titolo e copertina, l'assistente usa create_post. Ruolo: proprietario, Admin, moderatore o membro che può pubblicare nello spazio.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
space | id, link, indirizzo o nome | Sì | Uno spazio Feed |
text | testo, fino a 500 | Sì | Accetta solo grassetto, corsivo, link e a capo, in Markdown |
visibility | public, members, private | No |
Chiedi così: "Scrivi nel Feed: 'Diretta stasera alle 20, il link è nell'evento!'"
create_comment
Modifica
Commentare o rispondere. Commenta un elemento del feed, o risponde a un commento. Ruolo minimo: qualsiasi.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
type | content, status, event, course | Sì | Il tipo dell'elemento, da list_posts |
item_id | id | Sì | L'id dell'elemento |
text | testo semplice, fino a 2.000 | Sì | Senza formattazione: i segni di Markdown vengono tolti |
reply_to | id | No | L'id del commento a cui rispondere (da list_comments). Solo per elementi di tipo content |
Restituisce: il commento creato.
Chiedi così: "Rispondi a ogni domanda senza risposta nel post della live di ieri, ringraziando e dicendo che ne parleremo nella prossima."
update_comment
Modifica
Modificare un commento. Cambia il testo di un commento. Ruolo minimo: l'autore, oppure moderatore in su.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
type | content, status | Sì | |
post | id o link | Sì | Il post del commento |
comment_id | id | Sì | Da list_comments |
text | testo, fino a 2.000 | Sì |
delete_comment
Chiede conferma
Eliminare un commento. Con conferma. Ruolo minimo: l'autore, oppure moderatore in su. Stessi parametri, senza text.
add_reaction
Modifica
Reagire. Reagisce a un elemento del feed. Ruolo minimo: qualsiasi.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
type | content, status, event, course | Sì | |
item_id | id | Sì | |
reaction | 👍 ❤️ 🔥 🙌 😊 👏 🎉 | Sì | Una delle sette reazioni |
Restituisce: la reazione registrata.
Chiedi così: "Reagisci con 🎉 alle presentazioni di chi è entrato oggi."
pin_post
Modifica
Fissare nel feed. Fissa un elemento in cima al feed, o lo sgancia. Ruolo minimo: moderatore.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
type | content, status, event, course | Sì | |
item_id | id | Sì | |
pinned | sì o no | No | Predefinito: fissare. Con false, sgancia |
Restituisce: l'elemento con il nuovo stato.
Chiedi così: "Fissa il post con le regole della community."
add_gallery_image
Modifica
Aggiungere un'immagine a una galleria. Scarica un'immagine da un link e la mette in uno spazio Galleria. Ruolo minimo: qualsiasi ruolo che possa pubblicare in quello spazio.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
space_id | id | Sì | Uno spazio Galleria (list_spaces con module: gallery) |
image_url | link | Sì | Un link pubblico (http/https) a un'immagine JPEG, PNG, WebP o GIF fino a 10 MB. Vedi Immagini |
title | testo, fino a 255 | No | Il titolo dell'immagine nella galleria |
Restituisce: l'immagine nella galleria, con l'indirizzo e la miniatura.
Chiedi così: "Metti questa foto dell'incontro nella galleria Incontri: https://…/foto.jpg"
list_gallery_images
Solo lettura
Elenca immagini della galleria. Le immagini di uno spazio Galleria, dalla più recente alla più vecchia, con titolo, autore e reazioni. Ruolo minimo: qualsiasi ruolo che veda lo spazio.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
space | id, link, indirizzo o nome | Sì | Lo spazio Galleria |
page, limit | numero | No | limit fino a 50 |
Restituisce: le immagini, con l'id che chiedono gli altri strumenti della galleria.
update_gallery_image
Modifica
Modifica immagine della galleria. Cambia il titolo o la descrizione di un'immagine. Ruolo: chi ha caricato l'immagine, o dal moderatore in su.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
image_id | id | Sì | Da list_gallery_images |
title | testo, fino a 255 | No | |
description | testo | No |
react_to_gallery_image
Modifica
Reagisci a immagine della galleria. Con 👍 ❤️ 🔥 👏 😊 o 🙌. La stessa reazione una seconda volta la toglie. Ruolo minimo: qualsiasi.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
image_id | id | Sì | Da list_gallery_images |
reaction | una delle sei emoji | Sì |
delete_gallery_image
Chiede conferma
Elimina immagine della galleria. Ruolo: chi ha caricato l'immagine, o dal moderatore in su.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
image_id | id | Sì | Da list_gallery_images |
Restituisce: alla prima chiamata, il titolo e l'autore dell'immagine, più il codice di conferma.
get_leaderboard
Solo lettura
Vedere la classifica. La parte alta della classifica a punti della community. Ruolo minimo: qualsiasi.
Parametri: nessuno.
Chiedi così: "Chi sono i primi 10 della classifica?"
get_my_points
Solo lettura
I miei punti in classifica. I tuoi punti e la tua posizione nella classifica della community. Ruolo minimo: qualsiasi.
Parametri: nessuno.
Chiedi così: "Quanti punti ho, e in che posizione sono?"
get_ranking_rules
Solo lettura
Vedere le regole della classifica. Se la classifica è attiva e quanti punti vale ogni azione. Ruolo minimo: Admin.
Parametri: nessuno.
Chiedi così: "Quanti punti vale un commento?"
update_ranking_rules
Modifica
Cambiare le regole della classifica. Attiva o disattiva la classifica e cambia i punti per azione. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
enabled | sì o no | No | |
points | azione → punti | No | Le azioni vengono da get_ranking_rules, es.: {"comment": 10} |
Chiedi così: "Commentare d'ora in poi vale 10 punti."
Vedi Classifica.
list_moderation_queue
Solo lettura
Coda di moderazione. Ciò che attende approvazione, o i numeri della moderazione. Ruolo minimo: moderatore.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
type | summary, posts, courses, events, gallery, status | No | Predefinito: posts. summary restituisce i numeri |
Chiedi così: "C'è qualcosa in attesa di approvazione?"
moderate_item
Modifica
Approvare o rifiutare. Approva o rifiuta un elemento della coda di moderazione. Ruolo minimo: moderatore.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
type | posts, courses, events, gallery, status | Sì | |
item_id | id | Sì | Da list_moderation_queue |
decision | approve, reject | Sì | |
reason | testo | No | Obbligatorio per rifiutare |
Chiedi così: "Approva i post in coda che non hanno link esterni."
Vedi Moderazione.