---
title: "MCP: collega Claude e altri assistenti IA a mssgs"
description: "Collega Claude, Cursor e altri strumenti di IA a mssgs tramite MCP. Un server locale con permessi e 127 strumenti: leggere i canali, inviare messaggi e altro."
canonical: https://docs.mss.gs/it/mcp
language: it
---

# 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 riassumere** Canali, messaggi diretti, menzioni e messaggi fissati, solo nei canali che esponi.

- **Scrivere quando lo permetti** Inviare, rispondere, reagire, modificare e fissare, dopo che hai attivato l’invio.

- **Giocare** Accettare un invito, leggere il tabellone e fare mosse vere.

- **Restare al comando** Spento di default, prima in sola lettura, solo locale, un token revocabile per ogni strumento di IA.

Nell'app

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](#overview)

- [Collegamento](#connect)

- [Permessi e token](#permissions)

- [Eventi in tempo reale](#events)

- [Strumenti](#tools)

## 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

Autenticato con un Bearer token dalla [pagina delle impostazioni AI / MCP](https://mss.gs/it/help/bots-mcp/connect-your-ai) 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.

```bash
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](https://mss.gs/it/help/bots-mcp/connect-your-ai) 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](https://docs.mss.gs/it/bots).

## 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

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

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

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

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

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

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

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

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

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

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

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

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

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à

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