Sviluppatori MCP

Collega un assistente IA

L’app desktop di mssgs ha un server MCP integrato. Collega Claude, Cursor o Codex e potranno leggere, riassumere e rispondere nei canali che scegli, direttamente dal tuo computer.

Cosa puoi fare

Leggere e riassumereCanali, messaggi diretti, menzioni e messaggi fissati, solo nei canali che esponi.
Scrivere quando lo permettiInviare, rispondere, reagire, modificare e fissare, dopo che hai attivato l’invio.
GiocareAccettare un invito, leggere il tabellone e fare mosse vere.
Restare al comandoSpento di default, prima in sola lettura, solo locale, un token revocabile per ogni strumento di IA.

Nell'app

> Riassumi #general in tre punti e pubblicalo in #daily

● read_channel (channel: "general", limit: 50)

● send_message (channel: "daily")

Pubblicato in #daily.

daily

maya09:31

Riassunto di #general di oggi:
• Il lancio è stato spostato a venerdì.
• Dani si occupa delle note di rilascio.
• Da ora in poi lo standup è alle 09:30.

Chiedi nel tuo strumento di IA; legge #general tramite il server MCP e pubblica il riassunto a tuo nome, perché hai permesso l’invio.

Panoramica

L’app desktop di mssgs include un server MCP (Model Context Protocol) integrato, così assistenti IA come Claude o Cursor possono leggere e agire nel tuo spazio di lavoro. Gira in locale sul tuo computer e dialoga con la tua sessione mssgs con accesso effettuato; non servono un account bot separato né un hosting.

Decidi tu cosa vede

Il server gira solo su localhost, mentre mssgs è aperto e hai fatto l’accesso. Scegli tu quali canali esporre e attivi, gruppo per gruppo, cosa può fare l’assistente. Al momento ci sono 127 strumenti in 14 gruppi.

Collegamento

MCP http://127.0.0.1:7444/mcp

Autenticato con un Bearer token dalla pagina delle impostazioni AI / MCP dell’app: attiva il server, scegli i canali da esporre e premi “Copia config”; il blocco copiato contiene già la tua porta e il tuo token. Il server è in ascolto solo su localhost (porta predefinita 7444) e gira mentre mssgs è aperto e hai fatto l’accesso.

Collega Claude Code

claude mcp add --transport http mssgs http://127.0.0.1:7444/mcp \
  --header "Authorization: Bearer <your-token>"

Per Claude Desktop o Cursor: incolla il blocco di “Copia config” nelle impostazioni MCP del tuo strumento di IA. Vedi la guida passo passo nel centro assistenza.

Permessi e token

Gli strumenti che un assistente vede dipendono dagli interruttori che attivi. Gli strumenti di sola lettura sono sempre attivi; tutto il resto sta dietro l’interruttore di un gruppo. La gestione dei server e la moderazione verificano in più i tuoi permessi reali sull’account.

Gruppo	Sblocca
Lettura	Sempre attivo: leggere messaggi, presenza, menzioni e messaggi fissati nei canali esposti
Invio e interazione	Inviare, rispondere, reagire, modificare, eliminare, fissare, indicatore di scrittura, più presenza nei DM, chiamate vocali e giochi
Watch party	Avviare, entrare in e controllare sessioni di visione condivisa
Richieste di messaggio	Vedere, accettare e rifiutare le richieste di messaggio in arrivo
Social	Profili, storie e i tuoi filtri della mappa
Canali vocali	Entrare in vocale, vedere i partecipanti e controllare il tuo microfono
Account e privacy	Amici, blocchi, silenziamenti, stato di lettura, clip e condivisione della posizione
Controllo degli agenti	Configurare gli agenti dei canali, i progetti e le attività in corso
Gestione dei server	Canali, categorie, gruppi di permessi, membri, inviti, emoji, webhook e trigger (i permessi di gestione reali restano obbligatori)
Moderazione della community	Code di revisione e voti (serve comunque un account da moderatore o dello staff)
Tieni sveglio il computer	Impedisce alla macchina di andare in stop mentre l’assistente lavora
Strumenti per account bot	Schede embed interattive e i loro eventi (solo account bot)

Token

I token hanno un nome, uno per strumento di IA, e si revocano con un clic, con un piccolo grafico dell’attività per ciascun token così vedi esattamente quando è stato usato. Buona abitudine: un token per strumento, con un nome chiaro. Hai perso il portatile? Revoca il suo token e diventa inutile.

Eventi in tempo reale tramite SSE

Apri l’endpoint MCP come stream (GET /mcp con Accept: text/event-stream) e ricevi le notifiche JSON-RPC nel momento in cui avvengono:

Notifica	Scatta con
`notifications/mssgs/message`	Nuovi messaggi nei canali che puoi vedere
`notifications/mssgs/bot_event`	Pressioni dei pulsanti, reazioni e risposte sui messaggi che il tuo assistente ha pubblicato con send_bot_message
`notifications/mssgs/presence`	Cambi di presenza
`notifications/mssgs/typing`	Indicatori di scrittura
`notifications/mssgs/call`	Eventi delle chiamate vocali

Schede bot interattive

Schede bot interattive dal tuo assistente

Pubblica una scheda embed con pulsanti tramite send_bot_message, ascolta bot_event sullo stream (oppure interroga get_bot_events) e aggiorna la scheda sul posto con edit_message. Lo stesso modello di scheda della documentazione sui messaggi dei bot.

Riferimento degli strumenti (127)

Ogni strumento qui sotto è un’azione reale in mssgs. I nomi sono gli identificatori MCP esatti. Gli strumenti compaiono solo quando il loro gruppo è attivato.

Lettura

Sempre attivo

Strumenti di sola lettura, disponibili appena il server è attivo. Vedono sempre e solo i canali che hai esposto.

Strumento	Cosa fa
`list_channels`	Elenca i canali che hai esposto agli strumenti di IA.
`read_channel`	Legge i messaggi recenti di un canale esposto.
`get_new_messages`	Recupera i messaggi successivi a un timestamp in tutti i canali esposti.
`get_channel_stamp`	Lo stato letto/non letto di un canale, con il numero di messaggi non letti e di menzioni.
`get_presence`	Chi è presente in un canale e il suo stato.
`get_message`	Recupera un messaggio completo per id, con embed e anteprime dei link.
`search_messages`	Cerca nel testo dei messaggi dei canali esposti di un server.
`get_message_context`	Legge i messaggi immediatamente intorno a un risultato di ricerca.
`get_account`	Mostra l’account con accesso effettuato e le sue funzioni disponibili.
`get_typing`	Chi sta scrivendo in questo momento in un canale.
`list_mentions`	I messaggi recenti che ti @menzionano.
`list_pinned_messages`	I messaggi fissati in un canale.
`subscribe_channel`	Si iscrive a un canale per gli aggiornamenti in tempo reale.
`unsubscribe_channel`	Interrompe gli aggiornamenti in tempo reale per un canale.
`list_subscriptions`	Elenca i canali a cui sei iscritto in tempo reale.

Invio e interazione

Interruttore Invio

Pubblica e agisce come l’utente con accesso effettuato. Tutto qui scrive in un canale, quindi sta dietro un unico interruttore.

Strumento	Cosa fa
`send_message`	Invia un messaggio in un canale a tuo nome.
`reply_message`	Risponde a un messaggio specifico, nel thread.
`add_reaction`	Aggiunge una reazione emoji a un messaggio.
`remove_reaction`	Rimuove una delle tue reazioni emoji.
`edit_message`	Modifica uno dei tuoi messaggi.
`delete_message`	Elimina uno dei tuoi messaggi.
`pin_message`	Fissa un messaggio (richiede il permesso di fissare).
`unpin_message`	Toglie un messaggio dai fissati.
`open_one_view_attachment`	Apre una foto o un video visualizzabile una sola volta in un DM.
`set_typing`	Mostra un indicatore “sta scrivendo…” in tempo reale.
`stop_typing`	Toglie l’indicatore di scrittura.

Presenza e chiamate nei DM

Interruttore Invio

Sii presente in un DM ed effettua vere chiamate vocali: start_dm_call usa il microfono di questo computer, esattamente come premere chiama nell’app.

Strumento	Cosa fa
`enter_dm_chat`	Ti mostra come presente in un DM.
`leave_dm_chat`	Smette di mostrarti come presente in un DM.
`start_dm_call`	Avvia una chiamata vocale in un DM (usa il microfono di questo computer).
`answer_dm_call`	Risponde a una chiamata DM in arrivo.
`decline_dm_call`	Rifiuta una chiamata DM in arrivo.
`end_dm_call`	Riaggancia o annulla una chiamata DM.
`get_call_status`	Lo stato attuale della chiamata vocale ed eventuali chiamate in arrivo.

Giochi

Interruttore Invio

Entra e gioca ai minigiochi integrati di mssgs direttamente dal tuo assistente.

Strumento	Cosa fa
`list_game_invites`	Gli inviti ai giochi aperti indirizzati a te.
`list_active_games`	Le stanze di gioco in cui stai giocando.
`accept_game_invite`	Accetta un invito tramite room_id o codice di accesso.
`get_game_state`	La plancia o lo stato in tempo reale di un gioco in cui sei.
`game_move`	Gioca un turno in un gioco.
`resign_game`	Abbandona o lascia un gioco.

Watch party

Interruttore Watch party

Avvia e controlla sessioni di visione condivisa, entra nella stanza e reagisci insieme in tempo reale.

Strumento	Cosa fa
`list_watch_parties`	Elenca i watch party attivi a cui puoi accedere.
`get_watch_party`	Recupera lo stato completo di un watch party.
`start_watch_party`	Avvia un watch party in un canale.
`join_watch_party`	Entra in un watch party attivo.
`leave_watch_party`	Esce da un watch party.
`control_watch_party`	Play, pausa o salto per tutta la stanza.
`end_watch_party`	Termina un watch party per tutti.
`send_watch_party_emote`	Invia un’emote in tempo reale al watch party.

Richieste di messaggio

Interruttore Richieste di messaggio

Decidi chi può iniziare una conversazione con te.

Strumento	Cosa fa
`view_dm_requests`	Le tue richieste di messaggio in arrivo ancora aperte.
`accept_dm_request`	Accetta una richiesta di messaggio.
`deny_dm_request`	Rifiuta una richiesta di messaggio.

Social: profili, storie, mappa

Interruttore Social

Consulta i profili, guarda le storie e vedi i filtri della mappa che hai inviato.

Strumento	Cosa fa
`get_profile`	Il profilo pubblico di un utente tramite user_guid.
`list_story_users`	Le persone con una storia non ancora vista che puoi guardare.
`view_story`	Guarda le storie attive di un utente.
`list_map_filters`	I filtri della mappa inviati da questo account, con il loro stato di moderazione.

Canali vocali

Interruttore Canali vocali

Controlla e gestisci la sessione del canale vocale attiva su questo computer.

Strumento	Cosa fa
`list_voice_channels`	Elenca i canali vocali di un server.
`get_voice_state`	Recupera la sessione vocale attuale e i partecipanti.
`join_voice_channel`	Entra in un canale vocale su questo computer.
`leave_voice_channel`	Esce dal canale vocale attuale.
`set_voice_muted`	Silenzia o riattiva il microfono di questo computer.

Account e privacy

Interruttore Account

Gestisci amici, blocchi, silenziamenti, stato di lettura e clip senza esporre i segreti dell’account.

Strumento	Cosa fa
`list_friends`	Elenca i tuoi amici.
`list_blocked`	Elenca gli account che hai bloccato.
`block_user`	Blocca un account.
`unblock_user`	Sblocca un account.
`list_mutes`	Elenca i canali e i server silenziati.
`mute_channel`	Silenzia un canale.
`unmute_channel`	Riattiva un canale.
`mute_server`	Silenzia un server.
`unmute_server`	Riattiva un server.
`mark_channel_read`	Segna un canale come letto.
`list_clips`	Elenca le clip che hai creato.
`share_clip`	Rende condivisibile una delle tue clip.
`unshare_clip`	Smette di condividere una clip.
`rename_clip`	Rinomina una delle tue clip.
`list_stickers`	Elenca i tuoi sticker disponibili.
`list_friend_locations`	Elenca gli amici che in questo momento condividono la posizione con te.
`list_location_viewers`	Elenca chi in questo momento può vedere la tua posizione.

Strumenti per account bot

Interruttore Bot · solo account bot

Pubblica schede embed interattive e rileggi le interazioni che ricevono. Disponibile quando hai fatto l’accesso con un account bot.

Strumento	Cosa fa
`send_bot_message`	Pubblica una scheda embed ricca con pulsanti opzionali (solo account bot).
`get_bot_events`	Interroga pressioni dei pulsanti, reazioni e risposte sui messaggi del tuo bot.
`set_bot_status`	Imposta o toglie uno stato di presenza personalizzato (solo account bot).

Controllo degli agenti

Interruttore Controllo degli agenti

Configura gli agenti dei canali, collega progetti, controlla le attività in corso e indirizza il lavoro dalla chat. Le azioni di gestione richiedono comunque i permessi sul canale.

Strumento	Cosa fa
`list_agent_channels`	Elenca i canali esposti e la loro configurazione degli agenti.
`get_channel_agents`	Recupera la configurazione completa degli agenti di un canale.
`set_channel_agents`	Attiva gli agenti e aggiorna le regole degli agenti di un canale.
`add_channel_agent`	Aggiunge un agente disponibile a un canale.
`remove_channel_agent`	Rimuove un agente da un canale.
`set_agent_project`	Collega un progetto e delle istruzioni a un agente del canale.
`remove_agent_project`	Scollega un progetto da un agente del canale.
`list_agent_tasks`	Elenca le attività degli agenti in corso e recenti.
`get_agent_task`	Recupera lo stato in tempo reale e l’output di un’attività di un agente.
`steer_agent_task`	Invia un’istruzione aggiuntiva a un’attività di un agente in corso.

Gestione dei server

Interruttore Gestione dei server · richiede permessi di gestione

Dai forma a un server che gestisci: canali, categorie, gruppi di permessi, webhook e trigger. Ogni chiamata verifica comunque i tuoi permessi di gestione reali su quel server.

Strumento	Cosa fa
`list_manageable_servers`	I server che puoi gestire e quali permessi hai.
`get_server_structure`	La struttura completa di canali e categorie di un server.
`create_channel`	Crea un canale.
`update_channel`	Rinomina un canale, ne cambia il tipo o lo sposta.
`delete_channel`	Elimina un canale (irreversibile).
`create_category`	Crea una categoria di canali.
`update_category`	Rinomina una categoria.
`delete_category`	Elimina una categoria (i suoi canali restano).
`list_server_groups`	I gruppi di permessi di un server.
`create_server_group`	Crea un gruppo di permessi.
`update_server_group`	Rinomina un gruppo di permessi, ne cambia il colore o l’ambito.
`delete_server_group`	Elimina un gruppo di permessi.
`list_members`	Elenca i membri del server e i loro gruppi di permessi.
`add_member_to_group`	Aggiunge un membro del server a un gruppo di permessi.
`remove_member_from_group`	Rimuove un membro del server da un gruppo di permessi.
`list_invites`	Elenca gli inviti attivi al server.
`create_invite`	Crea un invito al server.
`delete_invite`	Revoca un invito al server.
`list_custom_emojis`	Elenca le emoji personalizzate di un server.
`list_webhooks`	I webhook in entrata di un server.
`create_webhook`	Crea un webhook in entrata.
`get_webhook_url`	Recupera l’URL a cui un webhook accetta POST.
`update_webhook`	Aggiorna le impostazioni di un webhook.
`delete_webhook`	Elimina un webhook (il suo URL smette di funzionare).
`list_triggers`	I trigger in uscita di un server.
`create_trigger`	Crea un trigger (i messaggi corrispondenti fanno un POST a un URL).
`update_trigger`	Aggiorna un trigger.
`delete_trigger`	Elimina un trigger.

Moderazione della community

Interruttore Moderazione · solo moderatori/staff

Le stesse code di revisione che apre il pulsante con lo scudo nell’app. Voti e veti richiedono comunque un vero account da moderatore (o dello staff).

Strumento	Cosa fa
`get_moderation_stats`	Il tuo stato di moderazione e quanto è in attesa.
`list_moderation_queue`	I filtri della mappa in attesa del voto di un moderatore.
`approve_map_filter`	Vota per approvare un filtro della mappa inviato.
`deny_map_filter`	Vota per rifiutare un filtro della mappa inviato.
`list_report_queue`	I contenuti segnalati in attesa del voto di un moderatore.
`approve_report`	Vota che una segnalazione viola le regole.
`deny_report`	Vota che il contenuto segnalato va bene.
`community_map_propose_filter`	Invia un nuovo filtro della mappa per la revisione.
`veto_map_filter`	Solo staff: rimuove subito un filtro della mappa (irreversibile).

Utilità

Interruttore Tieni sveglio

Piccoli aiuti per gli assistenti che lavorano a lungo.

Strumento	Cosa fa
`keep_computer_awake`	Tiene sveglio questo computer mentre lavori, oppure lo rilascia.

Continua a costruire

AgentiFai prendere attività a un’IA dentro un canale. WebhookPubblica in un canale da uno script. Collegare la tua IALa configurazione, passo dopo passo, nel centro assistenza. Card dei messaggiCosa può mostrare un messaggio bot.