Yhdistä tekoälyavustaja
mssgs-työpöytäsovelluksessa on sisäänrakennettu MCP-palvelin. Yhdistä Claude, Cursor tai Codex, niin ne voivat lukea, tiivistää ja vastata valitsemillasi kanavilla suoraan omalta tietokoneeltasi.
Mitä voit tehdä
- Lue ja tiivistäKanavat, yksityisviestit, maininnat ja kiinnitetyt viestit, vain avaamillasi kanavilla.
- Kirjoita, kun sallit senLähetä, vastaa, reagoi, muokkaa ja kiinnitä, kun kytket lähettämisen päälle.
- Pelaa pelejäHyväksy kutsu, lue pelilauta ja tee oikeita siirtoja.
- Pidä ohjat käsissäsiOletuksena pois päältä, aluksi vain luku, vain paikallisesti, peruttava token jokaiselle tekoälytyökalulle.
Sovelluksessa
Kysyt tekoälytyökalultasi; se lukee #general-kanavan MCP-palvelimen kautta ja julkaisee yhteenvedon sinun nimissäsi, koska sallit lähettämisen.
Yleiskatsaus
mssgs:n työpöytäsovelluksessa on sisäänrakennettu MCP-palvelin (Model Context Protocol), joten Clauden tai Cursorin kaltaiset tekoälyavustajat voivat lukea työtilaasi ja toimia siinä. Se toimii paikallisesti koneellasi ja keskustelee kirjautuneen mssgs-istuntosi kanssa; erillistä bottitiliä tai palvelinta ei tarvita.
Sinä päätät, mitä se näkee
Palvelin toimii vain osoitteessa localhost, kun mssgs on auki ja olet kirjautunut. Valitset, mitkä kanavat avaat, ja kytket ryhmä kerrallaan päälle sen, mitä avustaja saa tehdä. Tällä hetkellä työkaluja on 127, jaettuna 14 ryhmään.
Yhdistäminen
http://127.0.0.1:7444/mcp
Tunnistautuminen tapahtuu Bearer-tokenilla, jonka saat sovelluksen MCP-asetussivulta: ota palvelin käyttöön, valitse avattavat kanavat ja paina "Kopioi asetukset"; kopioidussa lohkossa ovat jo porttisi ja tokenisi. Palvelin kuuntelee vain localhostia (oletusportti 7444) ja on käynnissä, kun mssgs on auki ja olet kirjautunut.
claude mcp add --transport http mssgs http://127.0.0.1:7444/mcp \
--header "Authorization: Bearer <your-token>"
Claude Desktopille tai Cursorille: liitä "Kopioi asetukset" -lohko tekoälytyökalusi MCP-asetuksiin. Katso vaiheittainen opas ohjekeskuksesta.
Oikeudet ja tokenit
Avustajan näkemät työkalut riippuvat siitä, mitkä kytkimet otat käyttöön. Vain lukevat työkalut ovat aina päällä; kaikki muu on ryhmäkohtaisen kytkimen takana. Palvelinten hallinta ja moderointi tarkistavat lisäksi tilisi todelliset oikeudet.
| Ryhmä | Avaa käyttöön |
|---|---|
| Lukeminen | Aina päällä: viestien, läsnäolon, mainintojen ja kiinnitysten lukeminen avatuilla kanavilla |
| Lähettäminen ja vuorovaikutus | Lähettäminen, vastaaminen, reagointi, muokkaus, poisto, kiinnitys ja kirjoitusilmaisin sekä läsnäolo yksityisviesteissä, äänipuhelut ja pelit |
| Yhteiskatselut | Yhteisten katselukertojen aloittaminen, niihin liittyminen ja niiden ohjaaminen |
| Viestipyynnöt | Saapuvien viestipyyntöjen katselu, hyväksyminen ja hylkääminen |
| Sosiaalinen | Profiilit, tarinat ja karttasuodattimesi |
| Äänikanavat | Äänikanavalle liittyminen, osallistujien tarkastelu ja mikrofonin ohjaus |
| Tili ja yksityisyys | Kaverit, estot, mykistykset, luettu-tila, leikkeet ja sijainnin jakaminen |
| Agenttien ohjaus | Kanavien agenttien, projektien ja käynnissä olevien tehtävien määrittäminen |
| Palvelinten hallinta | Kanavat, kategoriat, oikeusryhmät, jäsenet, kutsut, emojit, webhookit ja liipaisimet (todelliset hallintaoikeudet tarkistetaan edelleen) |
| Yhteisön moderointi | Tarkastusjonot ja äänestäminen (vaatii edelleen moderaattorin tai henkilökunnan tilin) |
| Tietokoneen pitäminen hereillä | Estää konetta menemästä lepotilaan avustajan työskennellessä |
| Bottitilin työkalut | Interaktiiviset embed-kortit ja niiden tapahtumat (vain bottitilit) |
Tokenit
Tokenit ovat nimettyjä, tekoälytyökalukohtaisia ja peruttavissa yhdellä napsautuksella, ja tokenikohtaisesta aktiivisuuskäyrästä näet tarkalleen, milloin kutakin käytettiin. Hyvä käytäntö: yksi token työkalua kohden, selkeästi nimettynä. Katosiko kannettava? Peru sen token, niin se on hyödytön.
Reaaliaikaiset tapahtumat SSE:n kautta
Avaa MCP-päätepiste virtana (GET /mcp otsakkeella Accept: text/event-stream), niin saat JSON-RPC-ilmoitukset sitä mukaa kuin asioita tapahtuu:
| Ilmoitus | Laukeaa, kun |
|---|---|
notifications/mssgs/message | Uudet viestit kanavilla, jotka näet |
notifications/mssgs/bot_event | Painikkeiden painallukset, reaktiot ja vastaukset viesteihin, jotka avustajasi julkaisi send_bot_message-työkalulla |
notifications/mssgs/presence | Läsnäolon muutokset |
notifications/mssgs/typing | Kirjoitusilmaisimet |
notifications/mssgs/call | Äänipuhelujen tapahtumat |
Interaktiiviset bottikortit
Interaktiiviset bottikortit avustajaltasi
Julkaise painikkeellinen embed-kortti send_bot_message-työkalulla, kuuntele bot_event-tapahtumia virrasta (tai kysele get_bot_events-työkalulla) ja päivitä kortti paikallaan edit_message-työkalulla. Sama korttimalli kuin bottiviestien dokumentaatiossa.
Työkaluviite (127)
Jokainen alla oleva työkalu on todellinen toiminto mssgs:ssä. Nimet ovat tarkat MCP-tunnisteet. Työkalut näkyvät vasta, kun niiden ryhmä on kytketty päälle.
Lukeminen
Aina päälläVain lukevat työkalut, käytettävissä heti kun palvelin on päällä. Ne näkevät vain avaamasi kanavat.
| Työkalu | Mitä se tekee |
|---|---|
list_channels |
Listaa kanavat, jotka olet avannut tekoälytyökaluille. |
read_channel |
Lue avatun kanavan viimeaikaiset viestit. |
get_new_messages |
Hae aikaleimaa uudemmat viestit kaikilta avatuilta kanavilta. |
get_channel_stamp |
Kanavan luettu/lukematon-tila sekä lukemattomien ja mainintojen määrät. |
get_presence |
Ketkä ovat paikalla kanavalla ja heidän tilansa. |
get_message |
Hae yksi kokonainen viesti tunnisteella, upotukset ja linkkien esikatselut mukaan lukien. |
search_messages |
Hae viestien tekstiä palvelimen avatuilta kanavilta. |
get_message_context |
Lue yhden hakutuloksen välittömästi ympäröivät viestit. |
get_account |
Näytä kirjautunut tili ja sen käytettävissä olevat toiminnot. |
get_typing |
Kuka kirjoittaa kanavalla juuri nyt. |
list_mentions |
Viimeaikaiset viestit, joissa sinut on @mainittu. |
list_pinned_messages |
Kanavan kiinnitetyt viestit. |
subscribe_channel |
Tilaa kanavan reaaliaikaiset päivitykset. |
unsubscribe_channel |
Lopeta kanavan reaaliaikaiset päivitykset. |
list_subscriptions |
Listaa kanavat, joiden reaaliaikaiset päivitykset olet tilannut. |
Lähettäminen ja vuorovaikutus
Kytkin: Salli viestien lähettäminenJulkaise ja toimi kirjautuneena käyttäjänä. Kaikki täällä kirjoittaa kanavalle, joten se on yhden kytkimen takana.
| Työkalu | Mitä se tekee |
|---|---|
send_message |
Lähetä viesti kanavalle omissa nimissäsi. |
reply_message |
Vastaa tiettyyn viestiin ketjutettuna. |
add_reaction |
Lisää viestiin emojireaktio. |
remove_reaction |
Poista yksi emojireaktioistasi. |
edit_message |
Muokkaa yhtä omista viesteistäsi. |
delete_message |
Poista yksi omista viesteistäsi. |
pin_message |
Kiinnitä viesti (vaatii kiinnitysoikeuden). |
unpin_message |
Poista viestin kiinnitys. |
open_one_view_attachment |
Avaa kerran katsottava kuva tai video yksityisviestissä. |
set_typing |
Näytä reaaliaikainen "kirjoittaa…"-ilmaisin. |
stop_typing |
Poista kirjoitusilmaisin. |
Läsnäolo ja puhelut yksityisviesteissä
Kytkin: Salli viestien lähettäminenOle paikalla yksityisviestissä ja soita oikeita äänipuheluita: start_dm_call käyttää tämän tietokoneen mikrofonia täsmälleen kuin sovelluksen soittopainike.
| Työkalu | Mitä se tekee |
|---|---|
enter_dm_chat |
Näytä itsesi paikalla olevana yksityisviestissä. |
leave_dm_chat |
Lopeta paikalla olevana näkyminen yksityisviestissä. |
start_dm_call |
Aloita äänipuhelu yksityisviestissä (käyttää tämän tietokoneen mikrofonia). |
answer_dm_call |
Vastaa soivaan puheluun yksityisviestissä. |
decline_dm_call |
Hylkää soiva puhelu yksityisviestissä. |
end_dm_call |
Lopeta tai peru puhelu yksityisviestissä. |
get_call_status |
Äänipuhelun nykyinen tila ja mahdollinen saapuva puhelu. |
Pelit
Kytkin: Salli viestien lähettäminenLiity mssgs:n sisäänrakennettuihin minipeleihin ja pelaa niitä suoraan avustajastasi.
| Työkalu | Mitä se tekee |
|---|---|
list_game_invites |
Sinulle osoitetut avoimet pelikutsut. |
list_active_games |
Pelihuoneet, joissa pelaat parhaillaan. |
accept_game_invite |
Hyväksy kutsu room_id:n tai liittymiskoodin perusteella. |
get_game_state |
Käynnissä olevan pelisi reaaliaikainen lauta tai tila. |
game_move |
Pelaa vuoro pelissä. |
resign_game |
Luovuta tai poistu pelistä. |
Yhteiskatselut
Kytkin: Salli katseluhetketAloita ja ohjaa yhteisiä katselukertoja, liity huoneeseen ja reagoi yhdessä reaaliajassa.
| Työkalu | Mitä se tekee |
|---|---|
list_watch_parties |
Listaa aktiiviset yhteiskatselut, joihin sinulla on pääsy. |
get_watch_party |
Hae yhden yhteiskatselun koko tila. |
start_watch_party |
Aloita yhteiskatselu kanavalla. |
join_watch_party |
Liity aktiiviseen yhteiskatseluun. |
leave_watch_party |
Poistu yhteiskatselusta. |
control_watch_party |
Toista, keskeytä tai siirry kohtaan koko huoneelle. |
end_watch_party |
Lopeta yhteiskatselu kaikilta. |
send_watch_party_emote |
Lähetä yhteiskatseluun reaaliaikainen emote. |
Viestipyynnöt
Kytkin: Salli viestipyynnötPäätä, kuka saa aloittaa keskustelun kanssasi.
| Työkalu | Mitä se tekee |
|---|---|
view_dm_requests |
Avoimet saapuvat viestipyyntösi. |
accept_dm_request |
Hyväksy viestipyyntö. |
deny_dm_request |
Hylkää viestipyyntö. |
Äänikanavat
Kytkin: Salli äänikanavatTarkastele ja ohjaa tämän tietokoneen käynnissä olevaa äänikanavaistuntoa.
| Työkalu | Mitä se tekee |
|---|---|
list_voice_channels |
Listaa palvelimen äänikanavat. |
get_voice_state |
Hae nykyinen ääni-istunto ja osallistujat. |
join_voice_channel |
Liity äänikanavalle tällä tietokoneella. |
leave_voice_channel |
Poistu nykyiseltä äänikanavalta. |
set_voice_muted |
Mykistä tämän tietokoneen mikrofoni tai poista mykistys. |
Tili ja yksityisyys
Kytkin: Salli tilisi asetuksetHallitse kavereita, estoja, mykistyksiä, luettu-tilaa ja leikkeitä paljastamatta tilin salaisuuksia.
| Työkalu | Mitä se tekee |
|---|---|
list_friends |
Listaa kaverisi. |
list_blocked |
Listaa estämäsi tilit. |
block_user |
Estä tili. |
unblock_user |
Poista tilin esto. |
list_mutes |
Listaa mykistetyt kanavat ja palvelimet. |
mute_channel |
Mykistä kanava. |
unmute_channel |
Poista kanavan mykistys. |
mute_server |
Mykistä palvelin. |
unmute_server |
Poista palvelimen mykistys. |
mark_channel_read |
Merkitse kanava luetuksi. |
list_clips |
Listaa luomasi leikkeet. |
share_clip |
Tee yhdestä leikkeestäsi jaettava. |
unshare_clip |
Lopeta leikkeen jakaminen. |
rename_clip |
Nimeä yksi leikkeistäsi uudelleen. |
list_stickers |
Listaa käytettävissä olevat tarrasi. |
list_friend_locations |
Listaa kaverit, jotka jakavat sijaintinsa kanssasi juuri nyt. |
list_location_viewers |
Listaa, ketkä näkevät sijaintisi juuri nyt. |
Bottitilin työkalut
Bottikytkin · vain bottitilitJulkaise interaktiivisia embed-kortteja ja lue niihin tulleet vuorovaikutukset. Käytettävissä, kun olet kirjautunut bottitilillä.
| Työkalu | Mitä se tekee |
|---|---|
send_bot_message |
Julkaise näyttävä embed-kortti valinnaisin painikkein (vain bottitilit). |
get_bot_events |
Kysele bottiviestiesi painikkeiden painallukset, reaktiot ja vastaukset. |
set_bot_status |
Aseta tai poista mukautettu läsnäolotila (vain bottitilit). |
Agenttien ohjaus
Kytkin: Salli agenttien ohjausMääritä kanavien agentit, liitä projekteja, tarkastele käynnissä olevia tehtäviä ja ohjaa työtä keskustelusta. Hallintatoiminnot vaativat edelleen kanavan oikeudet.
| Työkalu | Mitä se tekee |
|---|---|
list_agent_channels |
Listaa avatut kanavat ja niiden agenttiasetukset. |
get_channel_agents |
Hae kanavan koko agenttimääritys. |
set_channel_agents |
Ota agentit käyttöön ja päivitä kanavan agenttisäännöt. |
add_channel_agent |
Lisää saatavilla oleva agentti kanavalle. |
remove_channel_agent |
Poista agentti kanavalta. |
set_agent_project |
Liitä projekti ja ohjeet kanavan agenttiin. |
remove_agent_project |
Irrota projekti kanavan agentista. |
list_agent_tasks |
Listaa nykyiset ja viimeaikaiset agenttitehtävät. |
get_agent_task |
Hae yhden agenttitehtävän reaaliaikainen tila ja tuloste. |
steer_agent_task |
Lähetä käynnissä olevalle agenttitehtävälle jatko-ohje. |
Palvelinten hallinta
Kytkin: Salli palvelinten hallinta · vaatii hallintaoikeudetMuokkaa hallinnoimaasi palvelinta: kanavat, kategoriat, oikeusryhmät, webhookit ja liipaisimet. Jokainen kutsu tarkistaa silti todelliset hallintaoikeutesi kyseisellä palvelimella.
| Työkalu | Mitä se tekee |
|---|---|
list_manageable_servers |
Palvelimet, joita voit hallita, ja mitkä oikeudet sinulla on. |
get_server_structure |
Palvelimen koko kanava- ja kategoriarakenne. |
create_channel |
Luo kanava. |
update_channel |
Nimeä kanava uudelleen, vaihda sen tyyppiä tai siirrä sitä. |
delete_channel |
Poista kanava (peruuttamaton). |
create_category |
Luo kanavakategoria. |
update_category |
Nimeä kategoria uudelleen. |
delete_category |
Poista kategoria (sen kanavat säilyvät). |
list_server_groups |
Palvelimen oikeusryhmät. |
create_server_group |
Luo oikeusryhmä. |
update_server_group |
Nimeä oikeusryhmä uudelleen, vaihda sen väriä tai oikeuksia. |
delete_server_group |
Poista oikeusryhmä. |
list_members |
Listaa palvelimen jäsenet ja heidän oikeusryhmänsä. |
add_member_to_group |
Lisää palvelimen jäsen oikeusryhmään. |
remove_member_from_group |
Poista palvelimen jäsen oikeusryhmästä. |
list_invites |
Listaa palvelimen aktiiviset kutsut. |
create_invite |
Luo palvelinkutsu. |
delete_invite |
Peru palvelinkutsu. |
list_custom_emojis |
Listaa palvelimen mukautetut emojit. |
list_webhooks |
Palvelimen saapuvat webhookit. |
create_webhook |
Luo saapuva webhook. |
get_webhook_url |
Hae webhookin URL, johon voi lähettää POST-pyyntöjä. |
update_webhook |
Päivitä webhookin asetukset. |
delete_webhook |
Poista webhook (sen URL lakkaa toimimasta). |
list_triggers |
Palvelimen lähtevät liipaisimet. |
create_trigger |
Luo liipaisin (vastaavat viestit lähetetään POST-pyyntönä URL:iin). |
update_trigger |
Päivitä liipaisin. |
delete_trigger |
Poista liipaisin. |
Yhteisön moderointi
Kytkin: Yhteisön moderointityökalut · vain moderaattorit ja henkilökuntaSamat tarkastusjonot, jotka kilpipainike avaa sovelluksessa. Äänet ja veto-oikeus vaativat edelleen oikean moderaattorin (tai henkilökunnan) tilin.
| Työkalu | Mitä se tekee |
|---|---|
get_moderation_stats |
Moderointitilasi ja se, kuinka paljon odottaa. |
list_moderation_queue |
Karttasuodattimet, jotka odottavat moderaattorin ääntä. |
approve_map_filter |
Äänestä lähetetyn karttasuodattimen hyväksymisen puolesta. |
deny_map_filter |
Äänestä lähetetyn karttasuodattimen hylkäämisen puolesta. |
list_report_queue |
Ilmoitettu sisältö, joka odottaa moderaattorin ääntä. |
approve_report |
Äänestä, että ilmoitettu sisältö rikkoo sääntöjä. |
deny_report |
Äänestä, että ilmoitettu sisältö on kunnossa. |
community_map_propose_filter |
Lähetä uusi karttasuodatin tarkastettavaksi. |
veto_map_filter |
Vain henkilökunta: poista karttasuodatin välittömästi (peruuttamaton). |
Apuvälineet
Kytkin: Salli tietokoneen pitäminen hereilläPieniä apuja pitkään toimiville avustajille.
| Työkalu | Mitä se tekee |
|---|---|
keep_computer_awake |
Pidä tämä tietokone hereillä työskentelysi ajan tai vapauta se. |