Collega le tue app AI alla tua community con il server MCP integrato di Discourse

Discourse ora dispone di un server MCP integrato, che ti permette di chiedere alle tue app AI preferite di trovare un argomento, aggiornarti su una discussione o preparare un report sull’attività della tua community.

MCP (Model Context Protocol) è un metodo che consente alle app AI di utilizzare strumenti forniti da un altro servizio. Discourse fornisce questi strumenti e colleghi la tua app accedendo con il tuo account Discourse e approvando l’accesso richiesto. :slight_smile:

Il server viene eseguito come parte del tuo sito Discourse. Esiste un pacchetto separato discourse-mcp, che è uno strumento che installi ed esegui localmente: non è necessario per questa nuova funzionalità. Puoi collegarti direttamente al nuovo server integrato della tua community senza configurare un ambiente di sviluppo locale. Scorri verso il basso per un’anteprima :backhand_index_pointing_right:t2:

Cosa puoi fare con esso?

Puoi cercare e leggere argomenti, esplorare categorie e tag, consultare profili utente e attività, e controllare i tuoi segnalibri e notifiche. Con l’accesso in scrittura abilitato, la tua app può anche creare argomenti, rispondere, modificare post, salvare bozze e caricare file. I messaggi privati (PM) hanno i propri permessi di lettura e scrittura separati.

Ad esempio, potresti chiedere:

  • «Trova discussioni sulla configurazione SSO e riassumi gli approcci che le persone hanno provato. Includi i link agli argomenti.»
  • «Leggi questo argomento e spiegamelo come se avessi 5 anni»
  • «Trova la mia bozza salvata e aiutami a capire dove mi sono fermato»

Esistono anche strumenti per chat, eventi, reazioni, argomenti risolti e votazione degli argomenti quando i plugin e gli strumenti MCP corrispondenti sono abilitati.

Un’ottima funzionalità è il supporto per la moderazione e le impostazioni del sito. Il personale con accesso appropriato può ispezionare la coda di revisione, leggere i dettagli dietro una segnalazione, controllare le revisioni dei post e consultare la cronologia di moderazione di un utente. Gli amministratori possono anche trovare le impostazioni del sito e aggiornare le impostazioni supportate.

Chi può accedere a cosa?

In qualità di amministratori, scegliete quali strumenti il vostro sito espone e quali permessi ciascun gruppo può concedere a un’app. I permessi di lettura e scrittura sono separati, quindi puoi consentire la ricerca e la lettura senza consentire modifiche.

Gli utenti accedono a Discourse e approvano l’accesso richiesto dall’app. L’app agisce con i normali permessi Discourse di quell’utente, entro l’accesso che le è stato concesso.

:warning: Concedere a un’app il permesso di leggere contenuti non dà all’utente accesso a contenuti che non poteva già vedere. Tutti i permessi tipici dell’app continuano ad applicarsi indipendentemente dagli scope MCP consentiti all’utente. Per ribadire: un utente a cui è stato concesso lo scope PM non sarà in grado di vedere un PM che non può altrimenti vedere nell’app. Gli strumenti per le impostazioni del sito richiedono un account amministratore e i valori delle impostazioni segrete non sono esposti.

Puoi rivedere le app collegate e le autorizzazioni, revocare l’accesso, bloccare un client e ispezionare l’attività degli strumenti dalle pagine di amministrazione MCP. Gli utenti possono anche revocare le proprie connessioni sotto Preferenze → Sicurezza → App MCP.

Configurazione

Il server MCP è disabilitato per impostazione predefinita. Su una versione di Discourse che include questa funzionalità:

  1. Vai su /admin/config/mcp e abilita mcp_server_enabled in Impostazioni.
  2. In Capacità, abilita gli strumenti che desideri che il tuo sito esponga. I nuovi strumenti sono disabilitati finché non li abiliti esplicitamente.
  3. In Accesso, scegli quali gruppi possono connettersi e quali permessi possono concedere. Il gruppo admin è pre-registrato; aggiungi altri gruppi se necessario.
  4. Collega la tua app AI utilizzando l’endpoint del server mostrato in Panoramica, tipicamente https://your-community.example/mcp.
  5. Accedi a Discourse e approva l’accesso richiesto.

La tua app deve supportare MCP remoto tramite Streamable HTTP e OAuth. Alcune app possono identificarsi automaticamente. Se la tua app ha bisogno di un client pre-registrato, usa Client OAuth → Aggiungi client OAuth e inserisci i dettagli corrispondenti del client nella tua app. Il modulo include preset per applicazioni comuni.

L’impostazione mcp_oauth_client_id_metadata_policy controlla se le app possono identificarsi tramite un URL di metadati del client. Puoi consentire qualsiasi dominio, limitarlo a domini approvati o richiedere client pre-registrati.

Ecco una registrazione completa [1] della connessione di ChatGPT al server MCP di Meta (disponibile solo per gli amministratori) :video_camera:

Provalo :woman_technologist:t2:

Facci sapere quale app stai usando e dove gli strumenti potrebbero beneficiare di qualche miglioramento!

Ci sarà più lavoro in arrivo su questo fronte:

  • più scope / strumenti
  • e stiamo esplorando la creazione di plugin ufficiali per app note come ChatGPT, Claude, ecc.

  1. Alcune parti accelerate ↩︎

9 Mi Piace

Ottimo. Seguo il progetto fin dai suoi inizi, direttamente dai repository. La sua pubblicazione arriva proprio dopo che ho riscontrato alcuni problemi (probabilmente dovuti alla mia mancanza di conoscenza) nel tentativo di utilizzare il client precedente tramite un proxy per coprire esigenze simili.

Lo userò e, dopo aver effettuato alcuni test, pubblicherò come funziona e come si presenta da Pi, un’interfaccia leggera, per chi, come me, preferisce scegliere cosa usare e cosa no, mantenendo tutto leggero.

Abilitare il server per lo staff offre possibilità straordinarie che altrimenti sarebbe impossibile fornire.

Congratulazioni al team!


Mi chiedo se ci siano piani per consentire l’uso del server Meta MCP integrato agli utenti.

Ho alcuni flussi di lavoro, prompt e suggerimenti generali sull’uso che potrebbero essere utili alla comunità, e l’uso del server MCP potrebbe semplificare il tempo necessario per pubblicarli tutti.

2 Mi Piace

(post eliminato dall’autore)